annotate metaphlan.xml @ 4:80b22b31633f

Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
author Jim Johnson <jj@umn.edu>
date Thu, 11 Oct 2012 12:01:20 -0500
parents e88fa24fa837
children 73f082e9fa2d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
1 <tool id="metaphlan" name="MetaPhlAn" version="1.7.0">
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
2 <requirements>
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
3 <requirement type="package" version="1.7.0">metaphlan</requirement>
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
4 <requirement type="package">bowtie2</requirement>
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
5 </requirements>
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
6 <description>Metagenomic Phylogenetic Analysis</description>
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
7 <command>
4
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
8 python \${METAPHLAN_PATH}/metaphlan.py
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
9 $input
4
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
10 --bowtie2db \${METAPHLAN_PATH}/bowtie2db/mpa
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
11 --no_map
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
12 -o $output
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
13 --bt2_ps $PresetsForBowtie2
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
14 </command>
2
1f80b01e1490 changed metaphlan.xml
nsegata
parents: 0
diff changeset
15
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
16 <inputs>
4
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
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>
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
18 <param name="PresetsForBowtie2" type="select" format="text">
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
19 <label>Sensitivity options for read-marker similarity (as described by BowTie2)</label>
4
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
20 <help>sensitive-local is recommended for avoiding overly-sensitive hits when using non-preprocessed fastq files</help>
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
21 <option value="very-sensitive-local">Very Sensitive Local</option>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
22 <option value="sensitive-local">Sensitive Local</option>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
23 <option value="very-sensitive">Very Sensitive</option>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
24 <option value="sensitive">Sensitive</option>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
25 </param>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
26 </inputs>
4
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
27 <stdio>
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
28 <exit_code range="1:" level="fatal" description="MetaPhlAn error" />
80b22b31633f Updated for MetaPhlAn v1.7 and tool_dependencies added for auto install
Jim Johnson <jj@umn.edu>
parents: 3
diff changeset
29 </stdio>
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
30 <outputs>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
31 <data format="tabular" name="output" />
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
32 </outputs>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
33
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
34 <tests>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
35 </tests>
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
36
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
37 <help>
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
38
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
39 .. class:: infomark
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
40
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
42
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
43 .. class:: infomark
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
44
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
46
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
47 .. class:: infomark
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
48
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
50
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
51 ---------
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
52
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
53 **What it does**
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
54
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
56
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
58
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
60
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
61 ---------
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
62
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
63 **Inputs**
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
64
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
66
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
68
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
69 **Outputs**
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
70
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
72
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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.
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
74
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
75 -----
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
76
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
77 **Citation and contacts**
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
78
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
79 If you find MetaPhlAn useful in your research, please cite our paper:
3
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
80
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
81 | `Nicola Segata`_, Levi Waldron, Annalisa Ballarini, Vagheesh Narasimhan, Olivier Jousson, `Curtis Huttenhower`_.
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
82 | **"Fast and accurate metagenomic profiling of microbial community composition using unique clade-specific marker genes"**
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
83 | Nature Methods, 2012 (in press)
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
84
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
85 .. _Nicola Segata: nsegata@hsph.harvard.edu
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
86 .. _Curtis Huttenhower: chuttenh@hsph.harvard.edu
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
87
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
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
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
89
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
90 .. _contact us: nsegata@hsph.harvard.edu
e88fa24fa837 updated to version 1.6.0
nsegata
parents: 2
diff changeset
91
0
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
92
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
93 </help>
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
94 </tool>
4f3fe44edb3f Initial upload. Still needs tests.
dannon
parents:
diff changeset
95