annotate qiime2/qiime_diversity_beta-rarefaction.xml @ 15:276ec629f09a draft

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