diff tools/effectiveT3/effectiveT3.txt @ 2:66e9d4c44ca2 draft

Uploaded v0.0.11, auto installation
author peterjc
date Tue, 30 Apr 2013 09:32:56 -0400
parents
children 0c21abf1073b
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tools/effectiveT3/effectiveT3.txt	Tue Apr 30 09:32:56 2013 -0400
@@ -0,0 +1,125 @@
+Galaxy wrapper for EffectiveT3 v1.0.1
+=====================================
+
+This wrapper is copyright 2011-2013 by Peter Cock, The James Hutton Institute
+(formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved.
+See the licence text below.
+
+This is a wrapper for the command line Java tool EffectiveT3, v1.0.1,
+
+Jehl, Arnold and Rattei.
+Effective - a database of predicted secreted bacterial proteins
+Nucleic Acids Research, 39(Database issue), D591-5, 2011.
+http://dx.doi.org/10.1093/nar/gkq1154
+
+Arnold, Brandmaier, Kleine, Tischler, Heinz, Behrens, Niinikoski, Mewes, Horn and Rattei.
+Sequence-based prediction of type III secreted proteins.
+PLoS Pathog. 5(4):e1000376, 2009.
+http://dx.doi.org/10.1371/journal.ppat.1000376
+
+http://effectors.org/
+
+
+Automated Installation
+======================
+
+This should be straightforward, Galaxy should automatically download and install
+the Jar files for effectiveT3 v1.0.1 and the three models (animal, plant and std).
+
+
+Manual Installation
+===================
+
+You can change the path by setting the environment variable EFFECTIVET3 to the
+relevant folder, but by default it expects the following files to be installed
+at these locations:
+
+/opt/EffectiveT3/TTSS_GUI-1.0.1.jar
+/opt/EffectiveT3/module/TTSS_ANIMAL-1.0.1.jar
+/opt/EffectiveT3/module/TTSS_PLANT-1.0.1.jar
+/opt/EffectiveT3/module/TTSS_STD-1.0.1.jar
+
+To install the wrapper copy or move the following files under the Galaxy tools
+folder, e.g. in a tools/effectiveT3 folder:
+
+* effectiveT3.xml (the Galaxy tool definition)
+* effectiveT3.py (the Python wrapper script)
+* effectiveT3.txt (this README file)
+
+Also copy effectiveT3.loc.sample to effectiveT3.loc in the tool-data folder
+(and edit if appropriate, e.g. to add or remove a model).
+
+You will also need to modify the tools_conf.xml file to tell Galaxy to offer the
+tool. If you are using other protein analysis tools like TMHMM or SignalP, put
+it next to them. Just add the line:
+
+<tool file="effectiveT3/effectiveT3.xml" />
+
+If you wish to run the unit tests, also add this to tools_conf.xml.sample
+and move/copy the test-data files under Galaxy's test-data folder.
+
+$ ./run_functional_tests.sh -id effectiveT3
+
+That's it.
+
+
+History
+=======
+
+v0.0.7 - Initial public release
+v0.0.8 - Include effectiveT3.loc.sample in Tool Shed
+v0.0.9 - Check the return code for errors in the XML
+v0.0.10- Added unit test
+v0.0.11- Automated installation
+       - Record version of Python script when called from Galaxy
+
+
+Developers
+==========
+
+This script and related tools are being developed on the following hg branch:
+http://bitbucket.org/peterjc/galaxy-central/src/tools
+
+For making the "Galaxy Tool Shed" http://toolshed.g2.bx.psu.edu/ tarball use
+the following command from the Galaxy root folder:
+
+$ tar -czf effectiveT3.tar.gz tools/effectiveT3/effectiveT3.xml tools/effectiveT3/effectiveT3.py tools/effectiveT3/effectiveT3.txt tools/effectiveT3/tool_dependencies.xml tool-data/effectiveT3.loc.sample test-data/four_human_proteins.fasta test-data/four_human_proteins.effectiveT3.tabular test-data/empty.fasta test-data/empty_effectiveT3.tabular
+
+
+Check this worked:
+
+$ tar -tzf effectiveT3.tar.gz
+tools/effectiveT3/effectiveT3.xml
+tools/effectiveT3/effectiveT3.py
+tools/effectiveT3/effectiveT3.txt
+tools/effectiveT3/tool_dependencies.xml
+tool-data/effectiveT3.loc.sample
+test-data/four_human_proteins.fasta
+test-data/four_human_proteins.effectiveT3.tabular
+test-data/empty.fasta
+test-data/empty_effectiveT3.tabular
+
+
+Licence (MIT/BSD style)
+=======================
+
+Permission to use, copy, modify, and distribute this software and its
+documentation with or without modifications and for any purpose and
+without fee is hereby granted, provided that any copyright notices
+appear in all copies and that both those copyright notices and this
+permission notice appear in supporting documentation, and that the
+names of the contributors or copyright holders not be used in
+advertising or publicity pertaining to distribution of the software
+without specific prior permission.
+
+THE CONTRIBUTORS AND COPYRIGHT HOLDERS OF THIS SOFTWARE DISCLAIM ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE
+CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT
+OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
+OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
+OR PERFORMANCE OF THIS SOFTWARE.
+
+NOTE: This is the licence for the Galaxy Wrapper only.
+EffectiveT3 is available and licenced separately.