annotate qiime2-2020.8/qiime_vsearch_cluster-features-open-reference.xml @ 20:d93d8888f0b0 draft

Uploaded
author florianbegusch
date Fri, 04 Sep 2020 12:44:24 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
20
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
1 <?xml version="1.0" ?>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
2 <tool id="qiime_vsearch_cluster-features-open-reference" name="qiime vsearch cluster-features-open-reference"
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
3 version="2020.8">
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
4 <description> Open-reference clustering of features.</description>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
5 <requirements>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
6 <requirement type="package" version="2020.8">qiime2</requirement>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
7 </requirements>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
8 <command><![CDATA[
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
9 qiime vsearch cluster-features-open-reference
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
10
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
11 --i-sequences=$isequences
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
12
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
13 --i-table=$itable
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
14
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
15 --i-reference-sequences=$ireferencesequences
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
16
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
17 --p-perc-identity=$ppercidentity
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
18
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
19 #if str($pstrand) != 'None':
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
20 --p-strand=$pstrand
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
21 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
22
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
23 --p-threads=$pthreads
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
24
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
25 --o-clustered-table=oclusteredtable
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
26
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
27 --o-clustered-sequences=oclusteredsequences
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
28
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
29 --o-new-reference-sequences=onewreferencesequences
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
30
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
31 #if str($examples) != 'None':
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
32 --examples=$examples
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
33 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
34
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
35 ;
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
36 cp onewreferencesequences.qza $onewreferencesequences
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
37
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
38 ]]></command>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
39 <inputs>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
40 <param format="qza,no_unzip.zip" label="--i-sequences: ARTIFACT FeatureData[Sequence] The sequences corresponding to the features in table. [required]" name="isequences" optional="False" type="data" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
41 <param format="qza,no_unzip.zip" label="--i-table: ARTIFACT FeatureTable[Frequency] The feature table to be clustered. [required]" name="itable" optional="False" type="data" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
42 <param format="qza,no_unzip.zip" label="--i-reference-sequences: ARTIFACT FeatureData[Sequence] The sequences to use as cluster centroids. [required]" name="ireferencesequences" optional="False" type="data" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
43 <param label="--p-perc-identity: PROPORTION Range(0, 1, inclusive_start=False, inclusive_end=True) The percent identity at which clustering should be performed. This parameter maps to vsearch\'s --id parameter. [required]" name="ppercidentity" optional="False" type="text" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
44 <param label="--p-strand: " name="pstrand" optional="True" type="select">
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
45 <option selected="True" value="None">Selection is Optional</option>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
46 <option value="plus">plus</option>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
47 <option value="both">both</option>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
48 </param>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
49 <param label="--examples: Show usage examples and exit." name="examples" optional="False" type="data" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
50
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
51 </inputs>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
52
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
53 <outputs>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
54 <data format="qza" label="${tool.name} on ${on_string}: clusteredtable.qza" name="oclusteredtable" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
55 <data format="qza" label="${tool.name} on ${on_string}: clusteredsequences.qza" name="oclusteredsequences" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
56 <data format="qza" label="${tool.name} on ${on_string}: newreferencesequences.qza" name="onewreferencesequences" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
57
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
58 </outputs>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
59
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
60 <help><![CDATA[
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
61 Open-reference clustering of features.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
62 ###############################################################
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
63
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
64 Given a feature table and the associated feature sequences, cluster the
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
65 features against a reference database based on user-specified percent
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
66 identity threshold of their sequences. Any sequences that don't match are
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
67 then clustered de novo. This is not a general-purpose clustering method,
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
68 but rather is intended to be used for clustering the results of quality-
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
69 filtering/dereplication methods, such as DADA2, or for re-clustering a
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
70 FeatureTable at a lower percent identity than it was originally clustered
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
71 at. When a group of features in the input table are clustered into a single
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
72 feature, the frequency of that single feature in a given sample is the sum
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
73 of the frequencies of the features that were clustered in that sample.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
74 Feature identifiers will be inherited from the centroid feature of each
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
75 cluster. For features that match a reference sequence, the centroid feature
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
76 is that reference sequence, so its identifier will become the feature
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
77 identifier. The clustered_sequences result will contain feature
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
78 representative sequences that are derived from the sequences input for all
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
79 features in clustered_table. This will always be the most abundant sequence
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
80 in the cluster. The new_reference_sequences result will contain the entire
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
81 reference database, plus feature representative sequences for any de novo
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
82 features. This is intended to be used as a reference database in subsequent
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
83 iterations of cluster_features_open_reference, if applicable. See the
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
84 vsearch documentation for details on how sequence clustering is performed.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
85
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
86 Parameters
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
87 ----------
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
88 sequences : FeatureData[Sequence]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
89 The sequences corresponding to the features in table.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
90 table : FeatureTable[Frequency]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
91 The feature table to be clustered.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
92 reference_sequences : FeatureData[Sequence]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
93 The sequences to use as cluster centroids.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
94 perc_identity : Float % Range(0, 1, inclusive_start=False, inclusive_end=True)
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
95 The percent identity at which clustering should be performed. This
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
96 parameter maps to vsearch's --id parameter.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
97 strand : Str % Choices('plus', 'both'), optional
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
98 Search plus (i.e., forward) or both (i.e., forward and reverse
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
99 complement) strands.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
100 threads : Int % Range(0, 256, inclusive_end=True), optional
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
101 The number of threads to use for computation. Passing 0 will launch one
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
102 thread per CPU core.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
103
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
104 Returns
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
105 -------
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
106 clustered_table : FeatureTable[Frequency]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
107 The table following clustering of features.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
108 clustered_sequences : FeatureData[Sequence]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
109 Sequences representing clustered features.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
110 new_reference_sequences : FeatureData[Sequence]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
111 The new reference sequences. This can be used for subsequent runs of
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
112 open-reference clustering for consistent definitions of features across
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
113 open-reference feature tables.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
114 ]]></help>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
115 <macros>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
116 <import>qiime_citation.xml</import>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
117 </macros>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
118 <expand macro="qiime_citation"/>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
119 </tool>