Mercurial > repos > peterjc > get_orfs_or_cdss
annotate tools/get_orfs_or_cdss/README.rst @ 8:09a8be9247ca draft
v0.2.0 with GFF3 output
author | peterjc |
---|---|
date | Sat, 09 Jan 2016 23:42:32 -0500 |
parents | 705a2e2df7fb |
children | a06ad07431ba |
rev | line source |
---|---|
5 | 1 Galaxy tool to find ORFs or simple CDSs |
2 ======================================= | |
3 | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
4 This tool is copyright 2011-2015 by Peter Cock, The James Hutton Institute |
5 | 5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved. |
8 | 6 Additions copyright 2015-2016 by Eric Rasche. |
5 | 7 See the licence text below (MIT licence). |
8 | |
9 This tool is a short Python script (using Biopython library functions) | |
10 to search nucleotide sequences for open reading frames (ORFs) or coding | |
11 sequences (CDSs) where the first potential start codon is used. See the | |
12 help text in the XML file for more information. | |
13 | |
14 This tool is available from the Galaxy Tool Shed at: | |
15 | |
16 * http://toolshed.g2.bx.psu.edu/view/peterjc/get_orfs_or_cdss | |
17 | |
18 See also the EMBOSS tool ``getorf`` which offers similar functionality and | |
19 has also been wrapped for use within Galaxy. | |
20 | |
21 | |
22 Automated Installation | |
23 ====================== | |
24 | |
25 This should be straightforward using the Galaxy Tool Shed, which should be | |
26 able to automatically install the dependency on Biopython, and then install | |
27 this tool and run its unit tests. | |
28 | |
29 | |
30 Manual Installation | |
31 =================== | |
32 | |
33 There are just two files to install to use this tool from within Galaxy: | |
34 | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
35 * ``get_orfs_or_cdss.py`` (the Python script) |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
36 * ``get_orfs_or_cdss.xml`` (the Galaxy tool definition) |
5 | 37 |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
38 The suggested location is in a dedicated ``tools/get_orfs_or_cdss`` folder. |
5 | 39 |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
40 You will also need to modify the ``tools_conf.xml`` file to tell Galaxy to offer the |
5 | 41 tool. One suggested location is in the filters section. Simply add the line:: |
42 | |
43 <tool file="get_orfs_or_cdss/get_orfs_or_cdss.xml" /> | |
44 | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
45 You will also need to install Biopython 1.65 or later (slightly older versions |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
46 should be fine, but will not have the latest NCBI genetic code tables). |
5 | 47 |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
48 If you wish to run the unit tests, also move/copy the ``test-data/`` files |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
49 under Galaxy's ``test-data/`` folder. Then:: |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
50 |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
51 ./run_tests.sh -id get_orfs_or_cdss |
5 | 52 |
53 That's it. | |
54 | |
55 | |
56 History | |
57 ======= | |
58 | |
59 ======= ====================================================================== | |
60 Version Changes | |
61 ------- ---------------------------------------------------------------------- | |
62 v0.0.1 - Initial version. | |
63 v0.0.2 - Correct labelling issue on reverse strand. | |
64 - Use the new <stdio> settings in the XML wrappers to catch errors | |
65 v0.0.3 - Include unit tests. | |
66 - Record Python script version when run from Galaxy. | |
67 v0.0.4 - Link to Tool Shed added to help text and this documentation. | |
68 v0.0.5 - Automated intallation of the Biopython dependency. | |
69 - Use reStructuredText for this README file. | |
70 - Adopt standard MIT License. | |
71 - Updated citation information (Cock et al. 2013). | |
72 - Renamed folder and adopted README.rst naming. | |
6
64e67f172188
Uploaded v0.0.6, corrected automated dependency definition
peterjc
parents:
5
diff
changeset
|
73 v0.0.6 - Corrected automated dependency defintion. |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
74 v0.0.7 - Tool definition now embeds citation information. |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
75 v0.1.0 - Tool now outputs BED formatted calls (by @erasche, Eric Rasche). |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
76 - Using ``optparse`` for the Python command line API (Eric Rasche). |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
77 - Added NCBI genetic code table 24, Pterobranchia Mitochondrial. |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
78 v0.1.1 - Reorder XML elements (internal change only). |
8 | 79 v0.2.0 - Tool now also outputs GFF3 formatted calls (Eric Rasche). |
5 | 80 ======= ====================================================================== |
81 | |
82 | |
83 Developers | |
84 ========== | |
85 | |
86 This script and related tools were initially developed on the following hg branch: | |
87 http://bitbucket.org/peterjc/galaxy-central/src/tools | |
88 | |
89 Development has now moved to a dedicated GitHub repository: | |
90 https://github.com/peterjc/pico_galaxy/tree/master/tools | |
91 | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
92 For pushing a release to the test or main "Galaxy Tool Shed", use the following |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
93 Planemo commands (which requires you have set your Tool Shed access details in |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
94 ``~/.planemo.yml`` and that you have access rights on the Tool Shed):: |
5 | 95 |
8 | 96 $ planemo shed_update -t testtoolshed --check_diff ~/repositories/pico_galaxy/tools/get_orfs_or_cdss/ |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
97 ... |
5 | 98 |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
99 or:: |
5 | 100 |
8 | 101 $ planemo shed_update -t toolshed --check_diff ~/repositories/pico_galaxy/tools/get_orfs_or_cdss/ |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
102 ... |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
103 |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
104 To just build and check the tar ball, use:: |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
105 |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
106 $ planemo shed_upload --tar_only ~/repositories/pico_galaxy/tools/get_orfs_or_cdss/ |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
107 ... |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
108 $ tar -tzf shed_upload.tar.gz |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
109 test-data/Ssuis.fasta |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
110 test-data/get_orf_input.Suis_ORF.bed |
5 | 111 test-data/get_orf_input.Suis_ORF.nuc.fasta |
112 test-data/get_orf_input.Suis_ORF.prot.fasta | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
113 test-data/get_orf_input.fasta |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
114 test-data/get_orf_input.t11_bed_out.bed |
5 | 115 test-data/get_orf_input.t11_nuc_out.fasta |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
116 test-data/get_orf_input.t11_open_bed_out.bed |
5 | 117 test-data/get_orf_input.t11_open_nuc_out.fasta |
118 test-data/get_orf_input.t11_open_prot_out.fasta | |
119 test-data/get_orf_input.t11_prot_out.fasta | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
120 test-data/get_orf_input.t1_bed_out.bed |
5 | 121 test-data/get_orf_input.t1_nuc_out.fasta |
122 test-data/get_orf_input.t1_prot_out.fasta | |
7
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
123 tools/get_orfs_or_cdss/get_orfs_or_cdss.py |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
124 tools/get_orfs_or_cdss/get_orfs_or_cdss.xml |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
125 tools/get_orfs_or_cdss/README.rst |
705a2e2df7fb
v0.1.1 fix typo; v0.1.0 BED output (Eric Rasche), NCBI genetic code 24; v0.0.7 embeds citation
peterjc
parents:
6
diff
changeset
|
126 tools/get_orfs_or_cdss/tool_dependencies.xml |
5 | 127 |
128 | |
129 Licence (MIT) | |
130 ============= | |
131 | |
132 Permission is hereby granted, free of charge, to any person obtaining a copy | |
133 of this software and associated documentation files (the "Software"), to deal | |
134 in the Software without restriction, including without limitation the rights | |
135 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
136 copies of the Software, and to permit persons to whom the Software is | |
137 furnished to do so, subject to the following conditions: | |
138 | |
139 The above copyright notice and this permission notice shall be included in | |
140 all copies or substantial portions of the Software. | |
141 | |
142 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
143 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
144 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
145 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
146 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
147 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
148 THE SOFTWARE. |