Mercurial > repos > peterjc > nlstradamus
annotate tools/nlstradamus/README.rst @ 4:1458e60f3fd0 draft
v0.0.10 internal changes; v0.0.9 citation
author | peterjc |
---|---|
date | Wed, 05 Aug 2015 12:23:05 -0400 |
parents | b2e648e55ed7 |
children | e8f15b0136cd |
rev | line source |
---|---|
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
1 Galaxy wrapper for NLStradamus v1.7 or v1.8 (C++ version) |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
2 ========================================================= |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
3 |
4 | 4 This wrapper is copyright 2011-2015 by Peter Cock, The James Hutton Institute |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
6 See the licence text below (MIT licence). |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
7 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
8 NLStradamus is a command line tool for predicting nuclear localization |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
9 signals (NLSs) in a FASTA file of proteins using a Hidden Markov Model (HMM). |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
10 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
11 This wrapper is available from the Galaxy Tool Shed at: |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
12 http://toolshed.g2.bx.psu.edu/view/peterjc/nlstradamus |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
13 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
14 A. N. Nguyen Ba, A. Pogoutse, N. Provart, A. M. Moses. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
15 NLStradamus: a simple Hidden Markov Model for nuclear localization signal prediction. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
16 BMC Bioinformatics. 2009 Jun 29;10(1):202. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
17 http://dx.doi.org/10.1186/1471-2105-10-202 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
18 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
19 http://www.moseslab.csb.utoronto.ca/NLStradamus |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
20 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
21 Early versions of NLStradamus did not have a native tabular output format, this |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
22 was added in version 1.7. Additionally a fast C++ implementation was added at |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
23 this point (early versions of NLStradamus came as a perl script only). |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
24 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
25 Version 1.8 fixed a C++ compilation issue on modern compilers, but is otherwise |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
26 unchanged. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
27 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
28 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
29 Automated Installation |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
30 ====================== |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
31 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
32 This should be straightforward, Galaxy should automatically download and install |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
33 the C++ implementation of NLStradamus v1.8, and run the unit tests. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
34 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
35 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
36 Manual Installation |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
37 =================== |
4 | 38 This wrapper expects the compiled C++ binary "NLStradamus" to be on the ``$PATH``. |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
39 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
40 To install the wrapper copy or move the following files under the Galaxy tools |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
41 folder, e.g. in a tools/protein_analysis folder: |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
42 |
4 | 43 * ``nlstradamus.xml`` (the Galaxy tool definition) |
44 * ``nlstradamus.txt`` (this README file) | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
45 |
4 | 46 You will also need to modify the ``tools_conf.xml`` file to tell Galaxy to offer |
47 the tool. If you are using other protein analysis tools like TMHMM or SignalP, | |
48 put it next to them. Just add the line (matching the chosen install path):: | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
49 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
50 <tool file="protein_analysis/nlstradamus.xml" /> |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
51 |
4 | 52 If you wish to run the unit tests, also move/copy the ``test-data/`` files |
53 under Galaxy's ``test-data/`` folder. Then:: | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
54 |
4 | 55 $ ./run_tests.sh -id nlstradamus |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
56 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
57 That's it. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
58 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
59 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
60 History |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
61 ======= |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
62 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
63 ======= ====================================================================== |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
64 Version Changes |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
65 ------- ---------------------------------------------------------------------- |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
66 v0.0.3 - Initial public release |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
67 v0.0.4 - Adding DOI link to reference |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
68 (Documentation change only) |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
69 v0.0.5 - Assume non-zero return codes are errors |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
70 v0.0.6 - Show output help text using a table |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
71 - Added unit tests |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
72 v0.0.7 - Automatic installation of the NLStradamus binary when installed |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
73 via the Galaxy Tool Shed |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
74 v0.0.8 - Link to Tool Shed added to help text and this documentation. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
75 - Use reStructuredText for this README file. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
76 - Adopted standard MIT licence. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
77 - Updated citation information (Cock et al. 2013). |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
78 - Development moved to GitHub, https://github.com/peterjc/pico_galaxy |
4 | 79 v0.0.9 - Tool definition now embeds citation information. |
80 v0.0.10 - Reorder XML elements (internal change only). | |
81 - Planemo for Tool Shed upload (``.shed.yml``, internal change only). | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
82 ======= ====================================================================== |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
83 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
84 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
85 Developers |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
86 ========== |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
87 |
4 | 88 This script and related tools were initially developed on the following hg branch: |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
89 http://bitbucket.org/peterjc/galaxy-central/src/tools |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
90 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
91 Development has now moved to a dedicated GitHub repository: |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
92 https://github.com/peterjc/pico_galaxy/tree/master/tools/nlstradamus |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
93 |
4 | 94 |
95 For pushing a release to the test or main "Galaxy Tool Shed", use the following | |
96 Planemo commands (which requires you have set your Tool Shed access details in | |
97 ``~/.planemo.yml`` and that you have access rights on the Tool Shed):: | |
98 | |
99 $ planemo shed_update --shed_target testtoolshed --check_diff ~/repositories/pico_galaxy/tools/nlstradamus/ | |
100 ... | |
101 | |
102 or:: | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
103 |
4 | 104 $ planemo shed_update --shed_target toolshed --check_diff ~/repositories/pico_galaxy/tools/nlstradamus/ |
105 ... | |
106 | |
107 To just build and check the tar ball, use:: | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
108 |
4 | 109 $ planemo shed_upload --tar_only ~/repositories/pico_galaxy/tools/nlstradamus/ |
110 ... | |
111 $ tar -tzf shed_upload.tar.gz | |
112 test-data/empty.fasta | |
113 test-data/empty_nlstradamus.tabular | |
114 test-data/four_human_proteins.fasta | |
115 test-data/four_human_proteins.nlstradamus.tabular | |
3
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
116 tools/nlstradamus/README.rst |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
117 tools/nlstradamus/nlstradamus.xml |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
118 tools/nlstradamus/tool_dependencies.xml |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
119 test-data/four_human_proteins.fasta |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
120 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
121 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
122 Licence (MIT) |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
123 ============= |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
124 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
125 Permission is hereby granted, free of charge, to any person obtaining a copy |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
126 of this software and associated documentation files (the "Software"), to deal |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
127 in the Software without restriction, including without limitation the rights |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
128 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
129 copies of the Software, and to permit persons to whom the Software is |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
130 furnished to do so, subject to the following conditions: |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
131 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
132 The above copyright notice and this permission notice shall be included in |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
133 all copies or substantial portions of the Software. |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
134 |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
135 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
136 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
137 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
138 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
139 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
140 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
b2e648e55ed7
Uploaded v0.0.8, MIT licence, RST for README, citation information, development moved to GitHub
peterjc
parents:
diff
changeset
|
141 THE SOFTWARE. |