annotate qiime2/qiime_diversity_beta-rarefaction.xml @ 0:51b9b6b57732 draft

Uploaded
author florianbegusch
date Thu, 24 May 2018 05:21:07 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
1 <?xml version="1.0" ?>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
2 <tool id="qiime_diversity_beta-rarefaction" name="qiime diversity beta-rarefaction" version="2018.4">
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
3 <description> - Beta diversity rarefaction</description>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
4 <requirements>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
5 <requirement type="package" version="2018.4">qiime2</requirement>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
6 </requirements>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
7 <command><![CDATA[
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
8 qiime diversity beta-rarefaction --i-table=$itable
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
9
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
10 #def list_dict_to_string(list_dict):
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
11 #set $file_list = list_dict[0]['additional_input'].__getattr__('file_name')
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
12 #for d in list_dict[1:]:
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
13 #set $file_list = $file_list + ',' + d['additional_input'].__getattr__('file_name')
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
14 #end for
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
15 #return $file_list
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
16 #end def
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
17
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
18 --m-metadata-file=$list_dict_to_string($input_files_mmetadatafile) --p-clustering-method=$pclusteringmethod --p-metric=$pmetric --p-sampling-depth="$psamplingdepth"
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
19
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
20 #if str($pcorrelationmethod) != 'None':
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
21 --p-correlation-method=$pcorrelationmethod
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
22 #end if
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
23
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
24 #if str($pcolorscheme) != 'None':
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
25 --p-color-scheme=$pcolorscheme
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
26 #end if
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
27
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
28 --o-visualization=ovisualization
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
29
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
30 #if str($cmdconfig) != 'None':
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
31 --cmd-config=$cmdconfig
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
32 #end if
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
33
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
34 #if str($iphylogeny) != 'None':
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
35 --i-phylogeny=$iphylogeny
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
36 #end if
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
37
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
38 #if $piterations:
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
39 --p-iterations=$piterations
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
40 #end if
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
41 ;
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
42 qiime tools export ovisualization.qzv --output-dir out && mkdir -p '$ovisualization.files_path'
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
43 && cp -r out/* '$ovisualization.files_path'
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
44 && mv '$ovisualization.files_path/index.html' '$ovisualization';
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
45 ]]></command>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
46 <inputs>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
47 <param format="qza,no_unzip.zip" label="--i-table: FeatureTable[Frequency] Feature table upon which to perform beta diversity rarefaction analyses. [required]" name="itable" optional="False" type="data"/>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
48 <param format="qza,no_unzip.zip" label="--i-phylogeny: Phylogeny[Rooted] Phylogenetic tree containing tip identifiers that correspond to the feature identifiers in the table. This tree can contain tip ids that are not present in the table, but all feature ids in the table must be present in this tree. [required for phylogenetic metrics] [optional]" name="iphylogeny" optional="True" type="data"/>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
49
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
50 <param label="--p-metric: The beta diversity metric to be computed.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
51 [required]" name="pmetric" optional="False" type="select">
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
52 <option value="hamming">hamming</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
53 <option value="sqeuclidean">sqeuclidean</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
54 <option value="cityblock">cityblock</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
55 <option value="sokalmichener">sokalmichener</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
56 <option value="braycurtis">braycurtis</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
57 <option value="cosine">cosine</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
58 <option value="euclidean">euclidean</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
59 <option value="rogerstanimoto">rogerstanimoto</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
60 <option value="weighted_unifrac">weighted_unifrac</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
61 <option value="canberra">canberra</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
62 <option value="seuclidean">seuclidean</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
63 <option value="correlation">correlation</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
64 <option value="unweighted_unifrac">unweighted_unifrac</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
65 <option value="sokalsneath">sokalsneath</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
66 <option value="chebyshev">chebyshev</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
67 <option value="mahalanobis">mahalanobis</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
68 <option value="matching">matching</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
69 <option value="kulsinski">kulsinski</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
70 <option value="yule">yule</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
71 <option value="dice">dice</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
72 <option value="russellrao">russellrao</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
73 <option value="wminkowski">wminkowski</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
74 <option value="jaccard">jaccard</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
75 </param>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
76 <param label="--p-clustering-method: Samples can be clustered with neighbor
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
77 joining or UPGMA. An arbitrary rarefaction
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
78 trial will be used for the tree, and the
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
79 remaining trials are used to calculate the
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
80 support of the internal nodes of that tree.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
81 [required]" name="pclusteringmethod" optional="False" type="select">
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
82 <option value="upgma">upgma</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
83 <option value="nj">nj</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
84 </param>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
85
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
86 <repeat name="input_files_mmetadatafile" optional="False" title="--m-metadata-file">
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
87 <param label="--m-metadata-file: Metadata file or artifact viewable as metadata. This option may be supplied multiple times to merge metadata. The sample metadata used for the Emperor jackknifed PCoA plot. [required]" name="additional_input" type="data" format="tabular,qza,no_unzip.zip" />
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
88 </repeat>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
89
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
90 <param label="--p-sampling-depth: The total frequency that each sample should be rarefied to prior to computing the diversity metric. [required]" name="psamplingdepth" optional="False" type="text"/>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
91 <param label="--p-iterations: Number of times to rarefy the feature table at a given sampling depth. [default: 10]" name="piterations" optional="True" type="integer" value="10"/>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
92
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
93 <param label="--p-correlation-method: The Mantel correlation test to be applied
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
94 when computing correlation between beta
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
95 diversity distance matrices. [default:
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
96 spearman]" name="pcorrelationmethod" optional="True" type="select">
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
97 <option selected="True" value="spearman">spearman</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
98 <option value="pearson">pearson</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
99 </param>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
100
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
101 <param label="--p-color-scheme: The matplotlib color scheme to generate the
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
102 heatmap with. [default: BrBG]" name="pcolorscheme" optional="True" type="select">
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
103 <option value="PiYG">PiYG</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
104 <option value="RdYlGn_r">RdYlGn_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
105 <option value="RdYlBu_r">RdYlBu_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
106 <option value="RdYlGn">RdYlGn</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
107 <option value="BrBG_r">BrBG_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
108 <option value="RdYlBu">RdYlBu</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
109 <option value="RdGy">RdGy</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
110 <option value="PuOr">PuOr</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
111 <option value="RdBu_r">RdBu_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
112 <option value="RdGy_r">RdGy_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
113 <option value="PiYG_r">PiYG_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
114 <option value="RdBu">RdBu</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
115 <option value="PuOr_r">PuOr_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
116 <option value="PRGn">PRGn</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
117 <option selected="True" value="BrBG">BrBG</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
118 <option value="PRGn_r">PRGn_r</option>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
119 </param>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
120
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
121 <param label="--cmd-config: Use config file for command options" name="cmdconfig" optional="True" type="data"/>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
122 </inputs>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
123 <outputs>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
124 <data format="html" label="${tool.name} on ${on_string}: visualization.qzv" name="ovisualization"/>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
125 </outputs>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
126 <help><![CDATA[
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
127 Beta diversity rarefaction
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
128 --------------------------
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
129
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
130 Repeatedly rarefy a feature table to compare beta diversity results within
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
131 a given rarefaction depth. For a given beta diversity metric, this
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
132 visualizer will provide: an Emperor jackknifed PCoA plot, samples clustered
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
133 by UPGMA or neighbor joining with support calculation, and a heatmap
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
134 showing the correlation between rarefaction trials of that beta diversity
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
135 metric.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
136
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
137 Parameters
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
138 ----------
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
139 table : FeatureTable[Frequency]
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
140 Feature table upon which to perform beta diversity rarefaction
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
141 analyses.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
142 phylogeny : Phylogeny[Rooted], optional
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
143 Phylogenetic tree containing tip identifiers that correspond to the
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
144 feature identifiers in the table. This tree can contain tip ids that
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
145 are not present in the table, but all feature ids in the table must be
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
146 present in this tree. [required for phylogenetic metrics]
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
147 metric : Str % Choices({'braycurtis', 'canberra', 'chebyshev', 'cityblock', 'correlation', 'cosine', 'dice', 'euclidean', 'hamming', 'jaccard', 'kulsinski', 'mahalanobis', 'matching', 'rogerstanimoto', 'russellrao', 'seuclidean', 'sokalmichener', 'sokalsneath', 'sqeuclidean', 'unweighted_unifrac', 'weighted_unifrac', 'wminkowski', 'yule'})
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
148 The beta diversity metric to be computed.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
149 clustering_method : Str % Choices({'nj', 'upgma'})
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
150 Samples can be clustered with neighbor joining or UPGMA. An arbitrary
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
151 rarefaction trial will be used for the tree, and the remaining trials
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
152 are used to calculate the support of the internal nodes of that tree.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
153 metadata : Metadata
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
154 The sample metadata used for the Emperor jackknifed PCoA plot.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
155 sampling_depth : Int % Range(1, None)
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
156 The total frequency that each sample should be rarefied to prior to
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
157 computing the diversity metric.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
158 iterations : Int % Range(2, None), optional
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
159 Number of times to rarefy the feature table at a given sampling depth.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
160 correlation_method : Str % Choices({'pearson', 'spearman'}), optional
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
161 The Mantel correlation test to be applied when computing correlation
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
162 between beta diversity distance matrices.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
163 color_scheme : Str % Choices({'BrBG', 'BrBG_r', 'PRGn', 'PRGn_r', 'PiYG', 'PiYG_r', 'PuOr', 'PuOr_r', 'RdBu', 'RdBu_r', 'RdGy', 'RdGy_r', 'RdYlBu', 'RdYlBu_r', 'RdYlGn', 'RdYlGn_r'}), optional
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
164 The matplotlib color scheme to generate the heatmap with.
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
165
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
166 Returns
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
167 -------
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
168 visualization : Visualization
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
169 \
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
170 ]]>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
171 </help>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
172 <macros>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
173 <import>qiime_citation.xml</import>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
174 </macros>
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
175 <expand macro="qiime_citation" />
51b9b6b57732 Uploaded
florianbegusch
parents:
diff changeset
176 </tool>