annotate qiime_feature-table_group.xml @ 0:09b7bcb72fa7 draft

Uploaded
author florianbegusch
date Thu, 24 May 2018 02:11:44 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
1 <?xml version="1.0" ?>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
2 <tool id="qiime_feature-table_group" name="qiime feature-table group" version="2018.4">
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
3 <description> - Group samples or features by a metadata column</description>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
4 <requirements>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
5 <requirement type="package" version="2018.4">qiime2</requirement>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
6 </requirements>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
7 <command>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
8 <![CDATA[
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
9 qiime feature-table group --i-table=$itable
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
10
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
11 #def list_dict_to_string(list_dict):
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
12 #set $file_list = list_dict[0]['additional_input'].__getattr__('file_name')
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
13 #for d in list_dict[1:]:
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
14 #set $file_list = $file_list + ',' + d['additional_input'].__getattr__('file_name')
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
15 #end for
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
16 #return $file_list
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
17
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
18 #end def
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
19 --m-metadata-file=$list_dict_to_string($input_files_mmetadatafile) --p-mode=$pmode --m-metadata-column="$mmetadatacolumn" --p-axis=$paxis
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
20 #if str($cmdconfig) != 'None':
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
21 --cmd-config=$cmdconfig
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
22 #end if
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
23 --o-grouped-table=ogroupedtable;
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
24 cp ogroupedtable.qza $ogroupedtable;
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
25 ]]>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
26 </command>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
27 <inputs>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
28 <param format="qza,no_unzip.zip" label="--i-table: FeatureTable[Frequency] The table to group samples or features on. [required]" name="itable" optional="False" type="data"/>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
29
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
30 <param label="--p-axis: Along which axis to group. Each ID in the
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
31 given axis must exist in `metadata`.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
32 [required]" name="paxis" optional="False" type="select">
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
33 <option value="sample">sample</option>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
34 <option value="feature">feature</option>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
35 </param>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
36
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
37 <repeat name="input_files_mmetadatafile" optional="False" title="--m-metadata-file">
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
38 <param label="--m-metadata-file: Metadata file or artifact viewable as metadata. This option may be supplied multiple times to merge metadata. [required]" name="additional_input" type="data" format="tabular,qza,no_unzip.zip" />
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
39 </repeat>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
40
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
41 <param label="--m-metadata-column: MetadataColumn[Categorical] Column from metadata file or artifact viewable as metadata. A column defining the groups. Each unique value will become a new ID for the table on the given `axis`. [required]" name="mmetadatacolumn" optional="False" type="text"/>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
42
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
43 <param label="--p-mode: How to combine samples or features within a
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
44 group. `sum` will sum the frequencies across
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
45 all samples or features within a group;
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
46 `mean-ceiling` will take the ceiling of the
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
47 mean of these frequencies; `median-ceiling`
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
48 will take the ceiling of the median of these
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
49 frequencies. [required]" name="pmode" optional="False" type="select">
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
50 <option value="median-ceiling">median-ceiling</option>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
51 <option value="mean-ceiling">mean-ceiling</option>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
52 <option value="sum">sum</option>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
53 </param>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
54
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
55 <param label="--cmd-config: Use config file for command options" name="cmdconfig" optional="True" type="data"/>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
56 </inputs>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
57 <outputs>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
58 <data format="qza" label="${tool.name} on ${on_string}: grouped-table.qza" name="ogroupedtable"/>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
59 </outputs>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
60 <help>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
61 <![CDATA[
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
62 Group samples or features by a metadata column
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
63 -----------------------------------------------
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
64
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
65 Group samples or features in a feature table using metadata to define the
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
66 mapping of IDs to a group.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
67
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
68 Parameters
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
69 ----------
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
70 table : FeatureTable[Frequency]
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
71 The table to group samples or features on.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
72 axis : Str % Choices({'feature', 'sample'})
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
73 Along which axis to group. Each ID in the given axis must exist in
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
74 `metadata`.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
75 metadata : MetadataColumn[Categorical]
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
76 A column defining the groups. Each unique value will become a new ID
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
77 for the table on the given `axis`.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
78 mode : Str % Choices({'mean-ceiling', 'median-ceiling', 'sum'})
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
79 How to combine samples or features within a group. `sum` will sum the
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
80 frequencies across all samples or features within a group; `mean-
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
81 ceiling` will take the ceiling of the mean of these frequencies;
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
82 `median-ceiling` will take the ceiling of the median of these
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
83 frequencies.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
84
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
85 Returns
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
86 -------
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
87 grouped_table : FeatureTable[Frequency]
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
88 A table that has been grouped along the given `axis`. IDs on that axis
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
89 are replaced by values in the `metadata` column.
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
90 ]]>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
91 </help>
09b7bcb72fa7 Uploaded
florianbegusch
parents:
diff changeset
92 </tool>