annotate qiime2/qiime_diversity_beta-rarefaction.xml @ 2:51025741f326 draft

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