1
|
1 Python re-implementation of predictNLS with Galaxy wrapper
|
|
2 ==========================================================
|
|
3
|
3
|
4 This Galaxy tool is copyright 2011-2015 by Peter Cock, The James Hutton Institute
|
1
|
5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved.
|
|
6 See the licence text below.
|
|
7
|
3
|
8 The tool consists of a Galaxy interface definition (``predictnls.xml``), and a Python
|
|
9 script (``predictnls.py``) which re-implements the command line tool predictNLS. This
|
1
|
10 should match the behaviour of predictNLS v1.0.20 (July 2011), the current latest
|
|
11 release from the Rost Lab, see http://rostlab.org and their paper:
|
|
12
|
|
13 Murat Cokol, Rajesh Nair, and Burkhard Rost.
|
|
14 Finding nuclear localization signals.
|
|
15 EMBO reports 1(5), 411–415, 2000
|
|
16 http://dx.doi.org/10.1093/embo-reports/kvd092
|
|
17
|
|
18 This wrapper is available from the Galaxy Tool Shed at
|
2
|
19 http://toolshed.g2.bx.psu.edu/view/peterjc/predictnls
|
1
|
20
|
|
21
|
|
22 Automatic Installation
|
|
23 ======================
|
|
24
|
|
25 This Galaxy tool is self contained, and so should install automatically via the
|
2
|
26 Galaxy Tool Shed.
|
1
|
27
|
|
28
|
|
29 Manual Installation
|
|
30 ===================
|
|
31
|
|
32 There are just four files which should be moved under the Galaxy tools folder,
|
3
|
33 e.g. in a ``tools/protein_analysis`` filter:
|
1
|
34
|
3
|
35 * ``predictlns.xml`` (the Galaxy tool definition)
|
|
36 * ``predictlns.py`` (the Python script)
|
|
37 * ``predictlns.txt`` (this README file)
|
|
38 * ``My_NLS_list`` (the default set of NLS motifs from the Rost Lab)
|
1
|
39
|
|
40 You will also need to modify the tools_conf.xml file to tell Galaxy to offer the
|
|
41 tool. If you are using other protein analysis tools like TMHMM or SignalP, put
|
|
42 it next to them. Just add the line::
|
|
43
|
|
44 <tool file="protein_analysis/predictnls.xml" />
|
|
45
|
2
|
46 If you wish to run the unit tests, also move/copy the ``test-data/`` files
|
|
47 under Galaxy's ``test-data/`` folder. Then::
|
1
|
48
|
2
|
49 ./run_tests.sh -id predictnls
|
1
|
50
|
|
51 That's it.
|
|
52
|
|
53
|
|
54 History
|
|
55 =======
|
|
56
|
|
57 ======= ======================================================================
|
|
58 Version Changes
|
|
59 ------- ----------------------------------------------------------------------
|
|
60 v0.0.4 - Initial public release.
|
|
61 v0.0.5 - Treat non-zero return codes as errors.
|
|
62 v0.0.6 - Link to Tool Shed added to help text and this documentation.
|
|
63 - Use reStructuredText for this README file.
|
|
64 - Updated citation information (Cock et al. 2013).
|
|
65 - Development moved to GitHub, https://github.com/peterjc/pico_galaxy
|
2
|
66 v0.0.7 - Tool definition now embeds citation information.
|
3
|
67 v0.0.8 - Reorder XML elements (internal change only).
|
|
68 - Planemo for Tool Shed upload (``.shed.yml``, internal change only).
|
1
|
69 ======= ======================================================================
|
|
70
|
|
71
|
|
72 Developers
|
|
73 ==========
|
|
74
|
2
|
75 This script and related tools were initially developed on the following hg branch:
|
1
|
76 http://bitbucket.org/peterjc/galaxy-central/src/tools
|
|
77
|
3
|
78 For pushing a release to the test or main "Galaxy Tool Shed", use the following
|
|
79 Planemo commands (which requires you have set your Tool Shed access details in
|
|
80 ``~/.planemo.yml`` and that you have access rights on the Tool Shed)::
|
1
|
81
|
3
|
82 $ planemo shed_update --shed_target testtoolshed --check_diff ~/repositories/pico_galaxy/tools/predictnls/
|
|
83 ...
|
|
84
|
|
85 or::
|
1
|
86
|
3
|
87 $ planemo shed_update --shed_target toolshed --check_diff ~/repositories/pico_galaxy/tools/predictnls/
|
|
88 ...
|
1
|
89
|
3
|
90 To just build and check the tar ball, use::
|
|
91
|
|
92 $ planemo shed_upload --tar_only ~/repositories/pico_galaxy/tools/predictnls/
|
|
93 ...
|
|
94 $ tar -tzf shed_upload.tar.gz
|
1
|
95 test-data/four_human_proteins.fasta
|
|
96 test-data/four_human_proteins.predictnls.tabular
|
3
|
97 tools/predictnls/My_NLS_list
|
|
98 tools/predictnls/README.rst
|
|
99 tools/predictnls/predictnls.py
|
|
100 tools/predictnls/predictnls.xml
|
1
|
101
|
|
102
|
|
103 Licence (GPL)
|
|
104 =============
|
|
105
|
|
106 This tool is open source, licensed under the GNU GENERAL PUBLIC LICENSE
|
|
107 version 3 (GNU v3), see http://www.gnu.org/licenses/gpl.html
|
|
108
|
|
109 The Python script is my reimplementation of the original Perl program from
|
|
110 the Rost Lab, which was released under the GPL v3. Therefore, as I consider
|
|
111 this to be a derivative work, this too is released under the GPL v3.
|
|
112
|
3
|
113 Please note that the ``My_NLS_list`` file should be an exact copy of the file of the
|
|
114 same name included with ``predictnls-1.0.7.tar.gz`` to ``predictnls-1.0.20.tar.gz``
|
1
|
115 inclusive (the list was extended in v1.0.7 in August 2010, see the change log
|
|
116 included in those tar-balls), available from ftp://rostlab.org/predictnls/
|