3
|
1 Galaxy datatypes for NCBI BLAST+ suite
|
|
2 ======================================
|
|
3
|
|
4 These Galaxy datatypes are copyright 2010-2012 by Peter Cock, The James Hutton
|
|
5 Institute (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved.
|
|
6 See the licence text below.
|
|
7
|
|
8 Note that these files (and the associated BLAST+ wrappers) were originally
|
|
9 distributed as part of the main Galaxy repository, but as of August 2012 moved
|
|
10 to the Galaxy Tool Shed as 'blast_datatypes' (and 'ncbi_blast_plus' for the
|
|
11 wrappers). My thanks to Dannon Baker from the Galaxy development team for his
|
|
12 assistance with this.
|
|
13
|
|
14
|
|
15 History
|
|
16 =======
|
|
17
|
|
18 These versions numbers match those for 'ncbi_blast_plus', but are not used
|
|
19 explicitly in the datatypes themselves.
|
|
20
|
|
21 v0.0.11 - Final revision as part of the Galaxy main repository, and the
|
|
22 first release via the Tool Shed
|
|
23 v0.0.13 - Uses blast.py instead of xml.py to define the datatypes
|
4
|
24 v0.0.14 - Includes datatypes for protein and nucleotide BLAST databases
|
|
25 (based on work by Edward Kirton)
|
3
|
26
|
|
27
|
|
28 Installation
|
|
29 ============
|
|
30
|
|
31 Doing this automatically via the Galaxy Tool Shed is probably simplest.
|
|
32
|
|
33
|
|
34 Manual Installation
|
|
35 ===================
|
|
36
|
|
37 Normally you would install this via the Galaxy ToolShed, which would move
|
|
38 the provided blast.py file into a suitable location and process the
|
|
39 datatypes_conf.xml entry to be combined with your local configuration.
|
|
40
|
|
41 However, if you really want to this should work for a manual install. Add
|
4
|
42 the following lines to the datatypes_conf.xml file in the Galaxy main folder:
|
3
|
43
|
|
44 <datatype extension="blastxml" type="galaxy.datatypes.blast:BlastXml" mimetype="application/xml" display_in_upload="true"/>
|
4
|
45 <datatype extension="blastdbn" type="galaxy.datatypes.blast:BlastNucDb" mimetype="text/html" display_in_upload="false"/>
|
|
46 <datatype extension="blastdbp" type="galaxy.datatypes.blast:BlastProtDb" mimetype="text/html" display_in_upload="false"/>
|
|
47
|
|
48 and later in the sniffer section:
|
|
49
|
|
50 <sniffer type="galaxy.datatypes.blast:BlastXml"/>
|
3
|
51
|
|
52 Also create the file lib/galaxy/datatypes/blast.py by moving, copying or linking
|
|
53 the blast.py file provided in this tar-ball. Finally add 'import blast' near
|
|
54 the start of file lib/galaxy/datatypes/registry.py (after the other import
|
|
55 lines).
|
|
56
|
|
57
|
|
58 Developers
|
|
59 ==========
|
|
60
|
|
61 BLAST+ datatypes and wrappers, and other tools are being developed on the
|
|
62 following hg branch: http://bitbucket.org/peterjc/galaxy-central/src/tools
|
|
63
|
|
64 For making the "Galaxy Tool Shed" http://community.g2.bx.psu.edu/ tarball I use
|
|
65 the following command from the Galaxy tools/ncbi_blast_plus folder:
|
|
66
|
|
67 $ tar -czf blast_datatypes.tar.gz blast_datatypes.txt datatypes_conf.xml blast.py
|
|
68
|
|
69 Check this worked:
|
|
70
|
|
71 $ tar -tzf blast_datatypes.tar.gz
|
|
72 blast_datatypes.txt
|
|
73 datatypes_conf.xml
|
|
74 blast.py
|
|
75
|
|
76 Note that the placement of these three files under tools/ncbi_blast_plus is
|
|
77 arbitrary - this just puts them next to the tool wrappers which use them.
|
|
78
|
|
79 For development, rather than having a local ToolShed running, I currently
|
|
80 use a symlink from lib/galaxy/datatypes/blast.py to the actual file
|
|
81 tools/ncbi_blast_plus/blast.py as described above.
|
|
82
|
|
83
|
|
84 Licence (MIT/BSD style)
|
|
85 =======================
|
|
86
|
|
87 Permission to use, copy, modify, and distribute this software and its
|
|
88 documentation with or without modifications and for any purpose and
|
|
89 without fee is hereby granted, provided that any copyright notices
|
|
90 appear in all copies and that both those copyright notices and this
|
|
91 permission notice appear in supporting documentation, and that the
|
|
92 names of the contributors or copyright holders not be used in
|
|
93 advertising or publicity pertaining to distribution of the software
|
|
94 without specific prior permission.
|
|
95
|
|
96 THE CONTRIBUTORS AND COPYRIGHT HOLDERS OF THIS SOFTWARE DISCLAIM ALL
|
|
97 WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED
|
|
98 WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE
|
|
99 CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT
|
|
100 OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
|
|
101 OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
|
|
102 OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
|
|
103 OR PERFORMANCE OF THIS SOFTWARE.
|
|
104
|
|
105 NOTE: This is the licence for the Galaxy BLAST datatypes only. BLAST+
|
|
106 and associated data files are available and licenced separately.
|