annotate qiime2-2020.8/qiime_taxa_filter-table.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_taxa_filter-table" name="qiime taxa filter-table"
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
3 version="2020.8">
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
4 <description>Taxonomy-based feature table filter.</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 taxa filter-table
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
10
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
11 --i-table=$itable
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
12
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
13 --i-taxonomy=$itaxonomy
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
14
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
15 #if str($pinclude):
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
16 --p-include=$pinclude
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
17 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
18 #if str($pexclude):
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
19 --p-exclude=$pexclude
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
20 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
21 #if str($pquerydelimiter):
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
22 --p-query-delimiter=$pquerydelimiter
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
23 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
24 #if str($pmode) != 'None':
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
25 --p-mode=$pmode
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
26 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
27
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
28 --o-filtered-table=ofilteredtable
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
29
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
30 #if str($examples) != 'None':
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
31 --examples=$examples
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
32 #end if
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
33
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
34 ;
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
35 cp ofilteredtable.qza $ofilteredtable
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
36
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
37 ]]></command>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
38 <inputs>
d93d8888f0b0 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" />
d93d8888f0b0 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" />
d93d8888f0b0 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" />
d93d8888f0b0 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" />
d93d8888f0b0 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="\',\'" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
44 <param label="--p-mode: " name="pmode" 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="exact">exact</option>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
47 <option value="contains">contains</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}: filteredtable.qza" name="ofilteredtable" />
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
55
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
56 </outputs>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
57
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
58 <help><![CDATA[
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
59 Taxonomy-based feature table filter.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
60 ###############################################################
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
61
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
62 This method filters features from a table based on their taxonomic
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
63 annotations. Features can be retained in the resulting table by specifying
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
64 one or more include search terms, and can be filtered out of the resulting
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
65 table by specifying one or more exclude search terms. If both include and
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
66 exclude are provided, the inclusion critera will be applied before the
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
67 exclusion critera. Either include or exclude terms (or both) must be
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
68 provided. Any samples that have a total frequency of zero after filtering
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
69 will be removed from the resulting table.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
70
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
71 Parameters
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
72 ----------
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
73 table : FeatureTable[Frequency]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
74 Feature table to be filtered.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
75 taxonomy : FeatureData[Taxonomy]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
76 Taxonomic annotations for features in the provided feature table. All
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
77 features in the feature table must have a corresponding taxonomic
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
78 annotation. Taxonomic annotations for features that are not present in
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
79 the feature table will be ignored.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
80 include : Str, optional
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
81 One or more search terms that indicate which taxa should be included in
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
82 the resulting table. If providing more than one term, terms should be
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
83 delimited by the query-delimiter character. By default, all taxa will
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
84 be included.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
85 exclude : Str, optional
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
86 One or more search terms that indicate which taxa should be excluded
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
87 from the resulting table. If providing more than one term, terms should
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
88 be delimited by the query-delimiter character. By default, no taxa will
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
89 be excluded.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
90 query_delimiter : Str, optional
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
91 The string used to delimit multiple search terms provided to include or
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
92 exclude. This parameter should only need to be modified if the default
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
93 delimiter (a comma) is used in the provided taxonomic annotations.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
94 mode : Str % Choices('exact', 'contains'), optional
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
95 Mode for determining if a search term matches a taxonomic annotation.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
96 "contains" requires that the annotation has the term as a substring;
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
97 "exact" requires that the annotation is a perfect match to a search
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
98 term.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
99
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
100 Returns
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
101 -------
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
102 filtered_table : FeatureTable[Frequency]
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
103 The taxonomy-filtered feature table.
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
104 ]]></help>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
105 <macros>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
106 <import>qiime_citation.xml</import>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
107 </macros>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
108 <expand macro="qiime_citation"/>
d93d8888f0b0 Uploaded
florianbegusch
parents:
diff changeset
109 </tool>