8
|
1 Galaxy wrapper for Blast2GO for pipelines, b2g4pipe
|
|
2 ===================================================
|
|
3
|
9
|
4 This wrapper is copyright 2011-2015 by Peter Cock, The James Hutton Institute
|
8
|
5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved.
|
|
6 See the licence text below (MIT licence).
|
|
7
|
|
8 This is a wrapper for the command line Java tool b2g4pipe v2.5, Blast2GO for
|
|
9 pipelines, currently a free to use download available at:
|
|
10 http://www.blast2go.com/data/blast2go/b2g4pipe_v2.5.zip
|
|
11
|
|
12 Note that this has been superceded by a non-free "Blast2GO Command Line (CLI)":
|
|
13 http://www.blast2go.com/blast2gocli/
|
|
14
|
|
15 This wrapper is freely available from the Galaxy Tool Shed at:
|
|
16 http://toolshed.g2.bx.psu.edu/view/peterjc/blast2go
|
|
17
|
|
18
|
9
|
19 Citation
|
|
20 ========
|
|
21
|
|
22 Please cite the following papers:
|
8
|
23
|
|
24 Peter Cock, Bjoern Gruening, Konrad Paszkiewicz and Leighton Pritchard (2013).
|
|
25 Galaxy tools and workflows for sequence analysis with applications
|
|
26 in molecular plant pathology. PeerJ 1:e167
|
|
27 http://dx.doi.org/10.7717/peerj.167
|
|
28
|
|
29 S. Geotz et al. (2008).
|
|
30 High-throughput functional annotation and data mining with the Blast2GO suite.
|
|
31 Nucleic Acids Res. 36(10):3420-3435.
|
|
32 http://dx.doi.org/10.1093/nar/gkn176
|
|
33
|
|
34 A. Conesa and S. Geotz (2008).
|
|
35 Blast2GO: A Comprehensive Suite for Functional Analysis in Plant Genomics.
|
|
36 International Journal of Plant Genomics. 619832.
|
|
37 http://dx.doi.org/10.1155/2008/619832
|
|
38
|
|
39 A. Conesa et al. (2005).
|
|
40 Blast2GO: A universal tool for annotation, visualization and analysis in functional genomics research.
|
|
41 Bioinformatics 21:3674-3676.
|
|
42 http://dx.doi.org/10.1093/bioinformatics/bti610
|
|
43
|
|
44 See also http://www.blast2go.com/
|
|
45
|
|
46
|
|
47 Automated Installation
|
|
48 ======================
|
|
49
|
|
50 Installation via the Galaxy Tool Shed should take care of the Galaxy side of
|
9
|
51 things, including the dependency on ``blast_datatypes`` which defines the
|
|
52 ``blastxml`` file format. However, you will also probably need to configure
|
8
|
53 the Blast2GO property file(s), for example if you have a local Blast2GO
|
|
54 database (which we recommend for speed).
|
|
55
|
|
56
|
|
57 Manual Installation
|
|
58 ===================
|
|
59
|
|
60 The main dependency is b2g4pipe which must be installed manually. Also we
|
|
61 strongly recommend installing a local Blast2GO database as well (see the
|
|
62 intructions below about the ``blast2go.loc`` file). At the time of writing,
|
|
63 the last free version is b2g4pipe v2.5 which is available here:
|
|
64
|
|
65 * http://www.blast2go.com/data/blast2go/b2g4pipe_v2.5.zip
|
|
66
|
9
|
67 You can change the path by setting the ``$B2G4PIPE`` environment variable to
|
8
|
68 the desired folder, but by default the script looks for the JAR file here::
|
|
69
|
|
70 /opt/b2g4pipe_v2.5/blast2go.jar
|
|
71
|
9
|
72 To install the wrapper manually, first install ``blast_datatypes``, then
|
8
|
73 copy or move the following files under the Galaxy tools folder, e.g. in a
|
9
|
74 ``tools/blast2go/`` folder:
|
8
|
75
|
9
|
76 - ``blast2go.xml`` (the Galaxy tool definition)
|
|
77 - ``blast2go.py`` (the Python wrapper script)
|
|
78 - ``massage_xml_for_blast2go.py`` (Python BLAST XML reformatting script)
|
|
79 - ``README.rst`` (this file)
|
8
|
80
|
|
81 For a manual installation of the wrapper you will also need to modify the
|
9
|
82 ``tools_conf.xml`` file to tell Galaxy to offer the tool. We suggest putting
|
8
|
83 it next to the NCBI BLAST+ wrappers. Just add the line::
|
|
84
|
|
85 <tool file="blast2go/blast2go.xml" />
|
|
86
|
9
|
87 If you wish to run the unit tests, also move/copy the ``test-data/`` files
|
|
88 under Galaxy's ``test-data/`` folder. Then::
|
8
|
89
|
9
|
90 $ ./run_tests.sh -id blast2go
|
8
|
91
|
|
92
|
|
93 Configuration
|
|
94 =============
|
|
95
|
|
96 As part of setting up b2g4pipe you will need to setup one or more Blast2GO
|
|
97 property files which tell the tool which database to use etc. The example
|
|
98 ``b2gPipe.properties`` provided with b2g4pipe is now out of date. The current
|
|
99 server IP address and database name may given on the Blast2GO website, or
|
|
100 can be found by running the latest GUI version via Java web-start, and
|
|
101 looking under the tools/options menu. These property files can be anywhere
|
|
102 accessable to the Galaxy Unix user, we put them with the JAR file etc.
|
|
103
|
|
104 You must tell Galaxy about these Blast2GO property files so that they can
|
|
105 be offered to the user. Copy file ``blast2go.loc.sample`` to
|
|
106 ``tool-data/blast2go.loc`` under the Galaxy folder and edit this to match
|
|
107 your installation. This must be plain text, tab separated, with three columns:
|
|
108
|
|
109 1. ID for the setup, e.g. ``Spain_2012_August``
|
|
110 2. Description for the setup, e.g. ``Database in Spain (August 2012)``
|
|
111 3. Properties filename for the setup, e.g. ``Spain_2012_August.properties``
|
|
112 relative to the main JAR file, or with a full path
|
|
113 e.g. ``/opt/b2g4pipe/Spain_2012_August.properties``
|
|
114
|
|
115 Avoid including "Blast2GO" in the description (column 2) as this text will be
|
|
116 included in the automatically assigned output dataset name. The ``blast2go.loc``
|
|
117 file allows you to customise the database setup. If for example you have a local
|
|
118 Blast2GO server running (which we recommend for speed), and you want this to be
|
|
119 the default setting, include it as the first line in your ``blast2go.loc`` file.
|
|
120
|
|
121 Consult the Blast2GO documentation for details about the property files and
|
|
122 setting up a local MySQL Blast2GO database. e.g.
|
|
123 https://www.blast2go.com/b2gsupport/resources/35-localb2gdb
|
|
124
|
|
125
|
|
126
|
|
127 History
|
|
128 =======
|
|
129
|
|
130 ======= ======================================================================
|
|
131 Version Changes
|
|
132 ------- ----------------------------------------------------------------------
|
|
133 v0.0.1 - Initial public release
|
|
134 v0.0.2 - Documentation clarifications, e.g. concatenated BLAST XML is allowed.
|
|
135 - Fixed error handler in wrapper script (for when b2g4pipe fails).
|
|
136 - Reformats the XML to use old NCBI-style concatenated BLAST XML since
|
|
137 b2g4pipe crashes with heap space error on with large files using
|
|
138 current NCBI output.
|
|
139 v0.0.3 - Include sample loc file, ``tool-data/blast2go.loc.sample``
|
|
140 v0.0.4 - Include ``repository_dependencies.xml`` file for ``blastxml`` format
|
|
141 (previously included in the core Galaxy installation)
|
|
142 v0.0.5 - Quote arguments in case of spaces in filenames (internal change)
|
|
143 - Last release supporting b2g4pipe v2.3.5
|
|
144 v0.0.6 - Support for b2g4pipe v2.5 instead of v2.3.5
|
|
145
|
|
146 - Now invoked with a class path and es.blast2go.prog.B2GAnnotPipe
|
|
147 rather then simply calling the jar file
|
|
148 - Now uses the switch ``-annot`` instead of ``-a`` (this change
|
|
149 breaks support for b2g4pipe v2.3.5 unfortunately)
|
|
150
|
|
151 - Catch a few error messages and treat them explicitly as errors.
|
|
152 v0.0.7 - Update output description in XML file (b2g4pipe v2.3.5 included
|
|
153 the sequence description, b2g4pipe v2.5 omits this).
|
|
154 v0.0.8 - Automated installation via the Galaxy Tool Shed.
|
|
155 - Added unit test.
|
|
156 - Explain how to load the tabular file into the Blast2GO GUI.
|
|
157 - Link to Tool Shed added to help text and this documentation.
|
|
158 - Switch to standard MIT licence.
|
|
159 - Use reStructuredText for this README file.
|
|
160 - Updated citation information (Cock et al. 2013).
|
|
161 - Development moved to GitHub, https://github.com/peterjc/galaxy_blast
|
|
162 - Split out ``massage_xml_for_blast2go.py`` as a standalone file.
|
|
163 v0.0.9 - Update README file now that BioBam are selling the latest version
|
|
164 of the Blast2GO command line tool. For now b2g4pipe v2.5 is still
|
|
165 available as a free download.
|
|
166 - Tool definition now embeds citation information.
|
9
|
167 v0.0.10 - Reorder XML elements (internal change only).
|
|
168 - Planemo for Tool Shed upload (``.shed.yml``, internal change only).
|
8
|
169 ======= ======================================================================
|
|
170
|
|
171
|
|
172 Developers
|
|
173 ==========
|
|
174
|
|
175 This script and related tools were originally developed on the 'tools' branch
|
|
176 of the following BitBucket Mercurial repository:
|
|
177 https://bitbucket.org/peterjc/galaxy-central/
|
|
178
|
|
179 As of September 2013, development is continuing on a dedicated GitHub repository:
|
|
180 https://github.com/peterjc/galaxy_blast
|
|
181
|
9
|
182 For pushing a release to the test or main "Galaxy Tool Shed", use the following
|
|
183 Planemo commands (which requires you have set your Tool Shed access details in
|
|
184 ``~/.planemo.yml`` and that you have access rights on the Tool Shed)::
|
8
|
185
|
9
|
186 $ planemo shed_update -t testtoolshed --check_diff ~/repositories/galaxy_blast/tools/blast2go/
|
|
187 ...
|
|
188
|
|
189 or::
|
|
190
|
|
191 $ planemo shed_update -t toolshed --check_diff ~/repositories/galaxy_blast/tools/blast2go/
|
|
192 ...
|
8
|
193
|
9
|
194 To just build and check the tar ball, use::
|
8
|
195
|
9
|
196 $ planemo shed_upload --tar_only ~/repositories/galaxy_blast/tools/blast2go/
|
|
197 ...
|
|
198 $ tar -tzf shed_upload.tar.gz
|
|
199 test-data/blastp_sample.blast2go.tabular
|
|
200 test-data/blastp_sample.xml
|
|
201 tool-data/blast2go.loc.sample
|
8
|
202 tools/blast2go/README.rst
|
9
|
203 tools/blast2go/blast2go.py
|
8
|
204 tools/blast2go/blast2go.xml
|
|
205 tools/blast2go/massage_xml_for_blast2go.py
|
|
206 tools/blast2go/repository_dependencies.xml
|
|
207 tools/blast2go/tool_dependencies.xml
|
9
|
208
|
8
|
209
|
|
210
|
|
211 Licence (MIT)
|
|
212 =============
|
|
213
|
|
214 Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
215 of this software and associated documentation files (the "Software"), to deal
|
|
216 in the Software without restriction, including without limitation the rights
|
|
217 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
218 copies of the Software, and to permit persons to whom the Software is
|
|
219 furnished to do so, subject to the following conditions:
|
|
220
|
|
221 The above copyright notice and this permission notice shall be included in
|
|
222 all copies or substantial portions of the Software.
|
|
223
|
|
224 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
225 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
226 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
227 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
228 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
229 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
230 THE SOFTWARE.
|
|
231
|
|
232
|
|
233 NOTE: This is the licence for the Galaxy Wrapper only. Blast2GO and
|
|
234 associated data files are available and licenced separately.
|