Mercurial > repos > peterjc > align_back_trans
annotate tools/align_back_trans/README.rst @ 6:b27388e5a0bb draft
v0.0.10 removed unused reference to muscle format
author | peterjc |
---|---|
date | Mon, 21 Aug 2017 06:26:14 -0400 |
parents | 2c32e8a8990f |
children | 883842b81796 |
rev | line source |
---|---|
0 | 1 Galaxy tool to back-translate a protein alignment to nucleotides |
2 ================================================================ | |
3 | |
4
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
4 This tool is copyright 2012-2017 by Peter Cock, The James Hutton Institute |
0 | 5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved. |
6 See the licence text below (MIT licence). | |
7 | |
8 This tool is a short Python script (using Biopython library functions) to | |
9 load a protein alignment, and matching nucleotide FASTA file of unaligned | |
10 sequences, which are threaded onto the protein alignment in order to produce | |
11 a codon aware nucleotide alignment - which can be viewed as a back translation. | |
12 | |
13 This tool is available from the Galaxy Tool Shed at: | |
14 | |
15 * http://toolshed.g2.bx.psu.edu/view/peterjc/align_back_trans | |
16 | |
1 | 17 The underlying Python script can also be used outside of Galaxy, for |
18 details run:: | |
19 | |
20 $ python align_back_trans.py | |
0 | 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 | |
35 * ``align_back_trans.py`` (the Python script) | |
36 * ``align_back_trans.xml`` (the Galaxy tool definition) | |
37 | |
38 The suggested location is in a dedicated ``tools/align_back_trans`` folder. | |
39 | |
40 You will also need to modify the ``tools_conf.xml`` file to tell Galaxy to offer | |
41 the tool. One suggested location is in the multiple alignments section. Simply | |
42 add the line:: | |
43 | |
44 <tool file="align_back_trans/align_back_trans.xml" /> | |
45 | |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
46 You will also need to install Biopython 1.62 or later. |
0 | 47 |
6 | 48 If you wish to run the unit tests, also move/copy the ``test-data/`` files |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
49 under Galaxy's ``test-data/`` folder. Then:: |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
50 |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
51 ./run_tests.sh -id align_back_trans |
0 | 52 |
53 That's it. | |
54 | |
55 | |
56 History | |
57 ======= | |
58 | |
59 ======= ====================================================================== | |
60 Version Changes | |
61 ------- ---------------------------------------------------------------------- | |
62 v0.0.1 - Initial version, based on a previously written Python script | |
63 v0.0.2 - Optionally check the translation is consistent | |
1 | 64 v0.0.3 - First official release |
65 v0.0.4 - Simplified XML to apply input format to output data. | |
66 - Fixed error message when sequence length not a multiple of three. | |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
67 v0.0.5 - More explicit error messages when seqences lengths do not match. |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
68 - Tool definition now embeds citation information. |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
69 v0.0.6 - Reorder XML elements (internal change only). |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
70 - Use ``format_source=...`` tag. |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
71 - Planemo for Tool Shed upload (``.shed.yml``, internal change only). |
3 | 72 v0.0.7 - Minor Python code style improvements (internal change only). |
4
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
73 v0.0.8 - Python coding style change to avoid lamba (internal change only). |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
74 - Depends on Biopython 1.67 via legacy Tool Shed package or bioconda. |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
75 - Added two recent NCBI genetic code tables, |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
76 |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
77 - Table 24, *Pterobranchia* Mitochondrial Code, |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
78 - Table 25, Candidate Division SR1 and *Gracilibacteria*. |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
79 |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
80 - Use ``<command detect_errors="aggressive">`` (internal change only). |
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
81 - Single quote command line arguments (internal change only). |
5 | 82 v0.0.9 - Python 3 compatible print function. |
6 | 83 v0.0.10 - Remove unused reference to ``muscle`` format in wrapper, reported by |
84 Björn Grüning (internal change only). | |
0 | 85 ======= ====================================================================== |
86 | |
87 | |
88 Developers | |
89 ========== | |
90 | |
91 This script was initially developed on this repository: | |
92 https://github.com/peterjc/picobio/blob/master/align/align_back_trans.py | |
93 | |
94 With the addition of a Galaxy wrapper, developement moved here: | |
95 https://github.com/peterjc/pico_galaxy/tree/master/tools/align_back_trans | |
96 | |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
97 For pushing a release to the test or main "Galaxy Tool Shed", use the following |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
98 Planemo commands (which requires you have set your Tool Shed access details in |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
99 ``~/.planemo.yml`` and that you have access rights on the Tool Shed):: |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
100 |
4
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
101 $ planemo shed_update -t testtoolshed --check_diff tools/align_back_trans/ |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
102 ... |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
103 |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
104 or:: |
0 | 105 |
4
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
106 $ planemo shed_update -t toolshed --check_diff tools/align_back_trans/ |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
107 ... |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
108 |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
109 To just build and check the tar ball, use:: |
0 | 110 |
4
c8469274d136
v0.0.8 Using Biopython 1.67 from Tool Shed or Conda package
peterjc
parents:
3
diff
changeset
|
111 $ planemo shed_upload --tar_only tools/align_back_trans/ |
2
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
112 ... |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
113 $ tar -tzf shed_upload.tar.gz |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
114 test-data/demo_nucs.fasta |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
115 test-data/demo_nucs_trailing_stop.fasta |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
116 test-data/demo_prot_align.fasta |
9fbf29a8c12b
v0.0.6 use format_source; v0.0.5 more explicit error msg, citation info
peterjc
parents:
1
diff
changeset
|
117 test-data/demo_nuc_align.fasta |
0 | 118 tools/align_back_trans/README.rst |
119 tools/align_back_trans/align_back_trans.py | |
120 tools/align_back_trans/align_back_trans.xml | |
121 tools/align_back_trans/tool_dependencies.xml | |
122 | |
123 | |
124 Licence (MIT) | |
125 ============= | |
126 | |
127 Permission is hereby granted, free of charge, to any person obtaining a copy | |
128 of this software and associated documentation files (the "Software"), to deal | |
129 in the Software without restriction, including without limitation the rights | |
130 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
131 copies of the Software, and to permit persons to whom the Software is | |
132 furnished to do so, subject to the following conditions: | |
133 | |
134 The above copyright notice and this permission notice shall be included in | |
135 all copies or substantial portions of the Software. | |
136 | |
137 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
138 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
139 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
140 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
141 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
142 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
143 THE SOFTWARE. |