annotate qiime2/qiime_taxa_filter-table.xml @ 29:3ba9833030c1 draft

Uploaded
author florianbegusch
date Fri, 04 Sep 2020 13:12:49 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
29
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
1 <?xml version="1.0" ?>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
2 <tool id="qiime_taxa_filter-table" name="qiime taxa filter-table"
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
3 version="2020.8">
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
4 <description>Taxonomy-based feature table filter.</description>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
5 <requirements>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
6 <requirement type="package" version="2020.8">qiime2</requirement>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
7 </requirements>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
8 <command><![CDATA[
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
9 qiime taxa filter-table
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
10
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
11 --i-table=$itable
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
12
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
13 --i-taxonomy=$itaxonomy
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
14
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
15 #if str($pinclude):
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
16 --p-include=$pinclude
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
17 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
18 #if str($pexclude):
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
19 --p-exclude=$pexclude
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
20 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
21 #if str($pquerydelimiter):
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
22 --p-query-delimiter=$pquerydelimiter
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
23 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
24 #if str($pmode) != 'None':
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
25 --p-mode=$pmode
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
26 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
27
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
28 --o-filtered-table=ofilteredtable
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
29
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
30 #if str($examples) != 'None':
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
31 --examples=$examples
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
32 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
33
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
34 ;
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
35 cp ofilteredtable.qza $ofilteredtable
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
36
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
37 ]]></command>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
38 <inputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
39 <param format="qza,no_unzip.zip" label="--i-table: ARTIFACT FeatureTable[Frequency] Feature table to be filtered. [required]" name="itable" optional="False" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
40 <param format="qza,no_unzip.zip" label="--i-taxonomy: ARTIFACT FeatureData[Taxonomy] Taxonomic annotations for features in the provided feature table. All features in the feature table must have a corresponding taxonomic annotation. Taxonomic annotations for features that are not present in the feature table will be ignored. [required]" name="itaxonomy" optional="False" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
41 <param label="--p-include: TEXT One or more search terms that indicate which taxa should be included in the resulting table. If providing more than one term, terms should be delimited by the query-delimiter character. By default, all taxa will be included. [optional]" name="pinclude" optional="False" type="text" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
42 <param label="--p-exclude: TEXT One or more search terms that indicate which taxa should be excluded from the resulting table. If providing more than one term, terms should be delimited by the query-delimiter character. By default, no taxa will be excluded. [optional]" name="pexclude" optional="False" type="text" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
43 <param label="--p-query-delimiter: TEXT The string used to delimit multiple search terms provided to include or exclude. This parameter should only need to be modified if the default delimiter (a comma) is used in the provided taxonomic annotations. [default: \',\']" name="pquerydelimiter" optional="False" type="text" value="\',\'" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
44 <param label="--p-mode: " name="pmode" optional="True" type="select">
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
45 <option selected="True" value="None">Selection is Optional</option>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
46 <option value="exact">exact</option>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
47 <option value="contains">contains</option>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
48 </param>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
49 <param label="--examples: Show usage examples and exit." name="examples" optional="False" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
50
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
51 </inputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
52
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
53 <outputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
54 <data format="qza" label="${tool.name} on ${on_string}: filteredtable.qza" name="ofilteredtable" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
55
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
56 </outputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
57
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
58 <help><![CDATA[
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
59 Taxonomy-based feature table filter.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
60 ###############################################################
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
61
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
62 This method filters features from a table based on their taxonomic
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
63 annotations. Features can be retained in the resulting table by specifying
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
64 one or more include search terms, and can be filtered out of the resulting
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
65 table by specifying one or more exclude search terms. If both include and
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
66 exclude are provided, the inclusion critera will be applied before the
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
67 exclusion critera. Either include or exclude terms (or both) must be
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
68 provided. Any samples that have a total frequency of zero after filtering
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
69 will be removed from the resulting table.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
70
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
71 Parameters
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
72 ----------
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
73 table : FeatureTable[Frequency]
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
74 Feature table to be filtered.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
75 taxonomy : FeatureData[Taxonomy]
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
76 Taxonomic annotations for features in the provided feature table. All
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
77 features in the feature table must have a corresponding taxonomic
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
78 annotation. Taxonomic annotations for features that are not present in
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
79 the feature table will be ignored.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
80 include : Str, optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
81 One or more search terms that indicate which taxa should be included in
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
82 the resulting table. If providing more than one term, terms should be
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
83 delimited by the query-delimiter character. By default, all taxa will
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
84 be included.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
85 exclude : Str, optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
86 One or more search terms that indicate which taxa should be excluded
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
87 from the resulting table. If providing more than one term, terms should
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
88 be delimited by the query-delimiter character. By default, no taxa will
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
89 be excluded.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
90 query_delimiter : Str, optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
91 The string used to delimit multiple search terms provided to include or
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
92 exclude. This parameter should only need to be modified if the default
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
93 delimiter (a comma) is used in the provided taxonomic annotations.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
94 mode : Str % Choices('exact', 'contains'), optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
95 Mode for determining if a search term matches a taxonomic annotation.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
96 "contains" requires that the annotation has the term as a substring;
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
97 "exact" requires that the annotation is a perfect match to a search
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
98 term.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
99
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
100 Returns
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
101 -------
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
102 filtered_table : FeatureTable[Frequency]
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
103 The taxonomy-filtered feature table.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
104 ]]></help>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
105 <macros>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
106 <import>qiime_citation.xml</import>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
107 </macros>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
108 <expand macro="qiime_citation"/>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
109 </tool>