Mercurial > repos > peterjc > blast2go

annotate tools/ncbi_blast_plus/blast2go.txt @ 0:cd52c931b325

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
author peterjc
date Tue, 07 Jun 2011 16:28:31 -0400
parents
children 0f159cf346c8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
1 Galaxy wrapper for Blast2GO for pipelines, b2g4pipe
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
2 ===================================================
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
3
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
4 This wrapper is copyright 2011 by Peter Cock, The James Hutton Institute
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
6 See the licence text below.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
7
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
8 This is a wrapper for the command line Java tool b2g4pipe v2.3.5,
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
9 Blast2GO for pipelines. See:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
10
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
11 S. Götz et al.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
12 High-throughput functional annotation and data mining with the Blast2GO suite.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
13 Nucleic Acids Res. 36(10):3420–3435, 2008.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
14 http://dx.doi.org/10.1093/nar/gkn176
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
15
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
16 A. Conesa and S. Götz.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
17 Blast2GO: A Comprehensive Suite for Functional Analysis in Plant Genomics.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
18 Int. J. Plant Genomics. 619832, 2008.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
19 http://dx.doi.org/10.1155/2008/619832
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
20
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
21 A. Conesa et al.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
22 Blast2GO: A universal tool for annotation, visualization and analysis in functional genomics research.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
23 Bioinformatics 21:3674-3676, 2005.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
24 http://dx.doi.org/10.1093/bioinformatics/bti610
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
25
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
26 http://www.blast2go.org/
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
27
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
28
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
29
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
30 Installation
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
31 ============
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
32
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
33 You can change the path by editing the definition near the start of the Python
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
34 script blast2go.py, but by default it expects the underlying tool to be here:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
35
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
36 /opt/b2g4pip/blast2go.jar
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
37
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
38 To install the wrapper copy or move the following files under the Galaxy tools
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
39 folder, e.g. in the tools/ncbi_blast_blast folder:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
40
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
41 * blast2go.xml (the Galaxy tool definition)
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
42 * blast2go.py (the Python wrapper script)
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
43 * blast2go.txt (this README file)
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
44
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
45 You will also need to modify the tools_conf.xml file to tell Galaxy to offer the
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
46 tool. We suggest putting it next to the NCBI BLAST+ wrappers. Just add the line:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
47
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
48 <tool file="ncbi_blast_plus/blast2go.xml" />
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
49
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
50 As part of setting up b2g4pipe you will need to setup one or more Blast2GO
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
51 property files which tell the tool which database to use etc. The example
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
52 b2gPipe.properties provided with b2g4pipe v2.3.5 is out of date, with the
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
53 latest server IP address and database name given on the Blast2GO website.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
54 These files can be anywhere accessable to the Galaxy Unix user, we put them
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
55 under /opt/b2g4pipe with the JAR file etc.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
56
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
57 You must tell Galaxy about these Blast2GO property files so that they can be
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
58 offered to the user. Create the file tool-data/blast2go.loc under the Galaxy
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
59 folder. This must be plain text, tab separated, with three columns:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
60
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
61 (1) ID for the setup, e.g. Spain_2010_May
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
62 (2) Description for the setup, e.g. Database in Spain (May 2010)
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
63 (3) Properties filename for the setup, e.g. /opt/b2g4pipe/Spain_2010_May.properties
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
64
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
65 Avoid including "Blast2GO" in the description (column 2) as this will be
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
66 included in the automatically assigned output dataset name. The blast2go.loc
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
67 file allows you to customise the database setup. If for example you have a local
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
68 Blast2GO server running (which we recommend for speed), and you want this to be
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
69 the default setting, include it as the first line in your blast2go.loc file.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
70
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
71 Consult the Blast2GO documentation for details about the property files and
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
72 setting up a local MySQL Blast2GO database.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
73
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
74
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
75 History
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
76 =======
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
77
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
78 v0.0.1 - Initial public release
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
79
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
80
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
81 Developers
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
82 ==========
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
83
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
84 This script and related tools are being developed on the following hg branch:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
85 http://bitbucket.org/peterjc/galaxy-central/src/tools
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
86
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
87 For making the "Galaxy Tool Shed" http://community.g2.bx.psu.edu/ tarball I use
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
88 the following command from the Galaxy root folder:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
89
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
90 $ tar -czf blast2go.tar.gz tools/ncbi_blast_plus/blast2go.xml tools/ncbi_blast_plus/blast2go.py tools/ncbi_blast_plus/blast2go.txt
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
91
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
92 Check this worked:
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
93
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
94 $ tar -tzf blast2go.tar.gz
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
95 tools/ncbi_blast_plus/blast2go.xml
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
96 tools/ncbi_blast_plus/blast2go.py
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
97 tools/ncbi_blast_plus/blast2go.txt
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
98
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
99
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
100 Licence (MIT/BSD style)
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
101 =======================
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
102
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
103 Permission to use, copy, modify, and distribute this software and its
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
104 documentation with or without modifications and for any purpose and
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
105 without fee is hereby granted, provided that any copyright notices
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
106 appear in all copies and that both those copyright notices and this
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
107 permission notice appear in supporting documentation, and that the
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
108 names of the contributors or copyright holders not be used in
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
109 advertising or publicity pertaining to distribution of the software
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
110 without specific prior permission.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
111
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
112 THE CONTRIBUTORS AND COPYRIGHT HOLDERS OF THIS SOFTWARE DISCLAIM ALL
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
113 WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
114 WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
115 CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
116 OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
117 OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
118 OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
119 OR PERFORMANCE OF THIS SOFTWARE.
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
120
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
121 NOTE: This is the licence for the Galaxy Wrapper only. Blast2GO and
cd52c931b325 Migrated tool version 0.0.1 from old tool shed archive to new tool shed repository
peterjc
parents:
diff changeset
122 associated data files are available and licenced separately.