annotate tools/ncbi_blast_plus/blastxml_to_top_descr.xml @ 7:a7add03a44fd draft

Uploaded v0.0.6, checks return code for error handling
author peterjc
date Wed, 17 Apr 2013 11:46:03 -0400
parents 8a0771c5e236
children a8ef75aab1f9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
a7add03a44fd Uploaded v0.0.6, checks return code for error handling
peterjc
parents: 6
diff changeset
1 <tool id="blastxml_to_top_descr" name="BLAST top hit descriptions" version="0.0.6">
0
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
2 <description>Make a table from BLAST XML</description>
6
8a0771c5e236 Uploaded v0.0.5, reports number of queries with hits in stdout (peek text).
peterjc
parents: 5
diff changeset
3 <version_command interpreter="python">blastxml_to_top_descr.py --version</version_command>
0
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
4 <command interpreter="python">
5
662fea0fe6b2 Uploaded v0.0.4, quotes filenames in case the contain spaces
peterjc
parents: 0
diff changeset
5 blastxml_to_top_descr.py "${blastxml_file}" "${tabular_file}" ${topN}
0
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
6 </command>
7
a7add03a44fd Uploaded v0.0.6, checks return code for error handling
peterjc
parents: 6
diff changeset
7 <stdio>
a7add03a44fd Uploaded v0.0.6, checks return code for error handling
peterjc
parents: 6
diff changeset
8 <!-- Assume anything other than zero is an error -->
a7add03a44fd Uploaded v0.0.6, checks return code for error handling
peterjc
parents: 6
diff changeset
9 <exit_code range="1:" />
a7add03a44fd Uploaded v0.0.6, checks return code for error handling
peterjc
parents: 6
diff changeset
10 <exit_code range=":-1" />
a7add03a44fd Uploaded v0.0.6, checks return code for error handling
peterjc
parents: 6
diff changeset
11 </stdio>
0
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
12 <inputs>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
13 <param name="blastxml_file" type="data" format="blastxml" label="BLAST results as XML"/>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
14 <param name="topN" type="integer" min="1" max="100" optional="false" label="Number of descriptions" value="3"/>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
15 </inputs>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
16 <outputs>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
17 <data name="tabular_file" format="tabular" label="Top $topN descriptions from $blastxml_file.name" />
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
18 </outputs>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
19 <requirements>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
20 </requirements>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
21 <tests>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
22 <test>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
23 <param name="blastxml_file" value="blastp_four_human_vs_rhodopsin.xml" ftype="blastxml" />
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
24 <param name="topN" value="3" />
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
25 <output name="tabular_file" file="blastp_four_human_vs_rhodopsin_top3.tabular" ftype="tabular" />
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
26 </test>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
27 </tests>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
28 <help>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
29
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
30 **What it does**
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
31
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
32 NCBI BLAST+ (and the older NCBI 'legacy' BLAST) can output in a range of
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
33 formats including text, tabular and a more detailed XML format. You can
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
34 do a lot of things with tabular files in Galaxy (sorting, filtering, joins,
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
35 etc) however currently the BLAST tabular output omits the hit descriptions
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
36 found in the other output formats.
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
37
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
38 This tool turns a BLAST XML file into a simple tabular file containing
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
39 one row per query sequence, containing the query identifier and then
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
40 the three (by default) top hit descriptions. If a query doesn't have
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
41 that many hits, then these entries are left blank.
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
42
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
43 **Example Usage**
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
44
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
45 One simple usage would be to take a transcriptome assembly or set of
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
46 gene predictions, run a BLAST search against the NCBI NR database, and
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
47 then use this tool to make a table of the top three BLAST hits. This
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
48 can give you a 'quick and dirty' crude annotation, potentially enough
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
49 to spot some problems (e.g. bacterial contaimination could be very
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
50 obvious).
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
51
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
52 </help>
075fe5424c32 Uploaded v0.0.1
peterjc
parents:
diff changeset
53 </tool>