annotate metaphlan.xml @ 7:db6ad024e739 draft default tip

Add stdio tags to avoid galaxy error on warning message
author Jim Johnson <jj@umn.edu>
date Wed, 10 Oct 2012 14:19:10 -0500
parents a3068eb6b676
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
868624c77941 Add tool_dependencies.xml
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
1 <tool id="metaphlan" name="MetaPhlAn" version="1.7.0">
4
3468e70d3ed0 Indents
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
2 <requirements>
1
868624c77941 Add tool_dependencies.xml
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
3 <requirement type="package" version="1.7.0">metaphlan</requirement>
868624c77941 Add tool_dependencies.xml
Jim Johnson <jj@umn.edu>
parents: 0
diff changeset
4 <requirement type="package">bowtie2</requirement>
4
3468e70d3ed0 Indents
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
5 </requirements>
0
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
6 <description>Metagenomic Phylogenetic Analysis</description>
6
a3068eb6b676 Add python to command line to aloow for non-standard location
Jim Johnson <jj@umn.edu>
parents: 5
diff changeset
7 <command>
a3068eb6b676 Add python to command line to aloow for non-standard location
Jim Johnson <jj@umn.edu>
parents: 5
diff changeset
8 python \${METAPHLAN_PATH}/metaphlan.py
0
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
9 $input
3
51288d868a5c tool_dependencies.xml
Jim Johnson <jj@umn.edu>
parents: 1
diff changeset
10 --bowtie2db \${METAPHLAN_PATH}/bowtie2db/mpa
0
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
11 --no_map
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
12 -o $output
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
13 --bt2_ps $PresetsForBowtie2
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
14 </command>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
15
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
16 <inputs>
5
61f300dbc6ac Enable fastq input
Jim Johnson <jj@umn.edu>
parents: 4
diff changeset
17 <param format="fasta,fastq" name="input" type="data" label="Input metagenome (multi-fasta of metagenomic reads, loaded with the Get Data module, see below for an example)"></param>
0
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
18 <param name="PresetsForBowtie2" type="select" format="text">
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
19 <label>Sensitivity options for read-marker similarity (as described by BowTie2)</label>
5
61f300dbc6ac Enable fastq input
Jim Johnson <jj@umn.edu>
parents: 4
diff changeset
20 <help>sensitive-local is recommended for avoiding overly-sensitive hits when using non-preprocessed fastq files</help>
0
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
21 <option value="very-sensitive-local">Very Sensitive Local</option>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
22 <option value="sensitive-local">Sensitive Local</option>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
23 <option value="very-sensitive">Very Sensitive</option>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
24 <option value="sensitive">Sensitive</option>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
25 </param>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
26 </inputs>
7
db6ad024e739 Add stdio tags to avoid galaxy error on warning message
Jim Johnson <jj@umn.edu>
parents: 6
diff changeset
27 <stdio>
db6ad024e739 Add stdio tags to avoid galaxy error on warning message
Jim Johnson <jj@umn.edu>
parents: 6
diff changeset
28 <exit_code range="1:" level="fatal" description="MetaPhlAn error" />
db6ad024e739 Add stdio tags to avoid galaxy error on warning message
Jim Johnson <jj@umn.edu>
parents: 6
diff changeset
29 </stdio>
0
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
30 <outputs>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
31 <data format="tabular" name="output" />
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
32 </outputs>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
33
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
34 <tests>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
35 </tests>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
36
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
37 <help>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
38
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
39 .. class:: infomark
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
40
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
41 **Input example:** You can try out MetaPhlAn using the synthetic dataset (250,000 reads) available at: http://huttenhower.sph.harvard.edu/sites/default/files/LC1.fna . There is no need to download the file, you can just copy-and-paste the dataset address in the "Upload File" module inside the "Load Data" link here in the left panel.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
42
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
43 .. class:: infomark
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
44
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
45 **Computational time:** Unless the server is overloaded, you should expect the tool to process ~10,000 reads per second. The synthetic metagenome linked above (250,000 reads) should take no more than 30 seconds to complete.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
46
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
47 .. class:: infomark
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
48
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
49 **Tip:** If your input is in FASTQ you can convert it in FASTA using the corresponding Galaxy module included in the "Convert Format" tools.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
50
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
51 ---------
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
52
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
53 **What it does**
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
54
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
55 MetaPhlAn (Metagenomic Phylogenetic Analysis) is a computational tool for profiling the composition of microbial communities from metagenomic shotgun sequencing data. MetaPhlAn relies on unique clade-specific marker genes identified from reference genomes, allowing orders of magnitude speedups and unambiguous taxonomic assignments.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
56
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
57 Although MetaPhlAn can use both BlastN and BowTie2 in the read-to-marker mapping step, this Galaxy module uses only BowTie2 for computational reasons.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
58
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
59 For additional information about MetaPhlAn and the MetaPhlAn command line package, please refer to http://huttenhower.sph.harvard.edu/metaphlan or to the paper reported below. Please notice that most of the additional parameters that can be tuned with the command line version are set here to the default values.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
60
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
61 ---------
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
62
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
63 **Inputs**
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
64
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
65 The input file must be a multi-fasta file containing metagenomic reads loaded with the "Get Data" module in the left panel. Reads can be as short as ~40 nt although lengths higher than 70 nt are recommended.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
66
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
67 A synthetic metagenome you can use as sample input is available at http://huttenhower.sph.harvard.edu/sites/default/files/LC1.fna
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
68
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
69 **Outputs**
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
70
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
71 The output is a two column tab-separated plain file reporting the predicted microbial clades present in the metagenomic samples and the corresponding relative abundances.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
72
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
73 All taxonomic levels from domain to species will be reported and higher taxonomic levelis contain the sum of the abundances of its taxonomic leaf nodes (usually species) and, possibly, some lower level "unclassified" clades.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
74
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
75 -----
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
76
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
77 **Citation and contacts**
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
78
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
79 If you find MetaPhlAn useful in your research, please cite our paper:
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
80
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
81 | `Nicola Segata`_, Levi Waldron, Annalisa Ballarini, Vagheesh Narasimhan, Olivier Jousson, `Curtis Huttenhower`_.
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
82 | **"Fast and accurate metagenomic profiling of microbial community composition using unique clade-specific marker genes"**
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
83 | Nature Methods, 2012 (in press)
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
84
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
85 .. _Nicola Segata: nsegata@hsph.harvard.edu
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
86 .. _Curtis Huttenhower: chuttenh@hsph.harvard.edu
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
87
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
88 If you have any questions or comments, feel free to `contact us`_. Additional information are available at http://huttenhower.sph.harvard.edu/metaphlan and in the FAQ at the same page. You can also join and use our user group at https://groups.google.com/d/forum/metaphlan-users
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
89
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
90 .. _contact us: nsegata@hsph.harvard.edu
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
91
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
92
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
93 </help>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
94 </tool>
0ec6c5781381 Uploaded
jjohnson
parents:
diff changeset
95