annotate qiime2/qiime_diversity_beta-phylogenetic.xml @ 14:a0a8d77a991c draft

Uploaded
author florianbegusch
date Thu, 03 Sep 2020 09:51:29 +0000
parents f190567fe3f6
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-phylogenetic" name="qiime diversity beta-phylogenetic"
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
3 version="2020.8">
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
4 <description>Beta diversity (phylogenetic)</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-phylogenetic
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
10
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
11 --i-table=$itable
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
12
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
13 --i-phylogeny=$iphylogeny
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
14
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
15 --p-metric=$pmetric
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
16
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
17 #if str($pthreads) != 'None':
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
18 --p-threads=$pthreads
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
19 #end if
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
20
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
21 #if $pvarianceadjusted:
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
22 --p-variance-adjusted
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
23 #end if
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
24
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
25 #if str($palpha):
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
26 --p-alpha=$palpha
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
27 #end if
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
28 #if $pbypasstips:
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
29 --p-bypass-tips
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
30 #end if
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
31
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
32 --o-distance-matrix=odistancematrix
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
33
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
34 #if str($examples) != 'None':
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
35 --examples=$examples
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
36 #end if
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
37
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
38 ;
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
39 cp odistancematrix.qza $odistancematrix
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
40
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
41 ]]></command>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
42 <inputs>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
43 <param format="qza,no_unzip.zip" label="--i-table: ARTIFACT FeatureTable[Frequency | RelativeFrequency | PresenceAbsence] The feature table containing the samples over which beta diversity should be computed. [required]" name="itable" optional="False" type="data" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
44 <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]" name="iphylogeny" optional="False" type="data" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
45 <param label="--p-metric: " name="pmetric" optional="False" type="select">
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
46 <option value="weighted_unifrac">weighted_unifrac</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
47 <option value="unweighted_unifrac">unweighted_unifrac</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
48 <option value="weighted_normalized_unifrac">weighted_normalized_unifrac</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
49 <option value="generalized_unifrac">generalized_unifrac</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
50 </param>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
51 <param label="--p-threads: " name="pthreads" optional="True" type="select">
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
52 <option selected="True" value="None">Selection is Optional</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
53 <option value="Int % Range(1">Int % Range(1</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
54 <option value="None">None</option>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
55 </param>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
56 <param label="--p-variance-adjusted: --p-variance-adjusted: / --p-no-variance-adjusted Perform variance adjustment based on Chang et al. BMC Bioinformatics 2011. Weights distances based on the proportion of the relative abundance represented between the samples at a given node under evaluation. [default: False]" name="pvarianceadjusted" selected="False" type="boolean" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
57 <param label="--p-alpha: PROPORTION Range(0, 1, inclusive_end=True) This parameter is only used when the choice of metric is generalized_unifrac. The value of alpha controls importance of sample proportions. 1.0 is weighted normalized UniFrac. 0.0 is close to unweighted UniFrac, but only if the sample proportions are dichotomized. [optional]" name="palpha" optional="False" type="text" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
58 <param label="--p-bypass-tips: --p-bypass-tips: / --p-no-bypass-tips In a bifurcating tree, the tips make up about 50% of the nodes in a tree. By ignoring them, specificity can be traded for reduced compute time. This has the effect of collapsing the phylogeny, and is analogous (in concept) to moving from 99% to 97% OTUs [default: False]" name="pbypasstips" selected="False" type="boolean" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
59 <param label="--examples: Show usage examples and exit." name="examples" optional="False" type="data" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
60
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
61 </inputs>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
62
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
63 <outputs>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
64 <data format="qza" label="${tool.name} on ${on_string}: distancematrix.qza" name="odistancematrix" />
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
65
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
66 </outputs>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
67
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
68 <help><![CDATA[
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
69 Beta diversity (phylogenetic)
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
70 ###############################################################
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
71
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
72 Computes a user-specified phylogenetic beta diversity metric for all pairs
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
73 of samples in a feature table.
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
74
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
75 Parameters
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
76 ----------
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
77 table : FeatureTable[Frequency | RelativeFrequency | PresenceAbsence]
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
78 The feature table containing the samples over which beta diversity
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
79 should be computed.
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
80 phylogeny : Phylogeny[Rooted]
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
81 Phylogenetic tree containing tip identifiers that correspond to the
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
82 feature identifiers in the table. This tree can contain tip ids that
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
83 are not present in the table, but all feature ids in the table must be
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
84 present in this tree.
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
85 metric : Str % Choices('generalized_unifrac', 'weighted_normalized_unifrac', 'weighted_unifrac', 'unweighted_unifrac')
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
86 The beta diversity metric to be computed.
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
87 threads : Int % Range(1, None) | Str % Choices('auto'), optional
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
88 The number of CPU threads to use in performing this calculation. May
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
89 not exceed the number of available physical cores. If threads = 'auto',
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
90 one thread will be created for each identified CPU core on the host.
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
91 variance_adjusted : Bool, optional
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
92 Perform variance adjustment based on Chang et al. BMC Bioinformatics
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
93 2011. Weights distances based on the proportion of the relative
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
94 abundance represented between the samples at a given node under
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
95 evaluation.
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
96 alpha : Float % Range(0, 1, inclusive_end=True), optional
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
97 This parameter is only used when the choice of metric is
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
98 generalized_unifrac. The value of alpha controls importance of sample
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
99 proportions. 1.0 is weighted normalized UniFrac. 0.0 is close to
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
100 unweighted UniFrac, but only if the sample proportions are
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
101 dichotomized.
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
102 bypass_tips : Bool, optional
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
103 In a bifurcating tree, the tips make up about 50% of the nodes in a
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
104 tree. By ignoring them, specificity can be traded for reduced compute
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
105 time. This has the effect of collapsing the phylogeny, and is analogous
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
106 (in concept) to moving from 99% to 97% OTUs
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
107
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
108 Returns
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
109 -------
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
110 distance_matrix : DistanceMatrix
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
111 The resulting distance matrix.
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
112 ]]></help>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
113 <macros>
0
370e0b6e9826 Uploaded
florianbegusch
parents:
diff changeset
114 <import>qiime_citation.xml</import>
14
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
115 </macros>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
116 <expand macro="qiime_citation"/>
a0a8d77a991c Uploaded
florianbegusch
parents: 9
diff changeset
117 </tool>