annotate qiime2/qiime_emperor_biplot.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_emperor_biplot" name="qiime emperor biplot"
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
3 version="2020.8">
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
4 <description>Visualize and Interact with Principal Coordinates Analysis Biplot</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 emperor biplot
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
10
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
11 --i-biplot=$ibiplot
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
12 # if $input_files_msamplemetadatafile:
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
13 # def list_dict_to_string(list_dict):
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
14 # set $file_list = list_dict[0]['additional_input'].__getattr__('file_name')
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
15 # for d in list_dict[1:]:
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
16 # set $file_list = $file_list + ' --m-sample-metadata-file=' + d['additional_input'].__getattr__('file_name')
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
17 # end for
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
18 # return $file_list
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
19 # end def
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
20 --m-sample-metadata-file=$list_dict_to_string($input_files_msamplemetadatafile)
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
21 # end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
22 # if $input_files_mfeaturemetadatafile:
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
23 # def list_dict_to_string(list_dict):
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
24 # set $file_list = list_dict[0]['additional_input'].__getattr__('file_name')
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
25 # for d in list_dict[1:]:
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
26 # set $file_list = $file_list + ' --m-feature-metadata-file=' + d['additional_input'].__getattr__('file_name')
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
27 # end for
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
28 # return $file_list
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
29 # end def
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
30 --m-feature-metadata-file=$list_dict_to_string($input_files_mfeaturemetadatafile)
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
31 # end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
32
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
33 #if $pignoremissingsamples:
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
34 --p-ignore-missing-samples
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
35 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
36
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
37 #if $pinvert:
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
38 --p-invert
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
39 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
40
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
41 --p-number-of-features=$pnumberoffeatures
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
42
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
43 --o-visualization=ovisualization
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
44
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
45 #if str($examples) != 'None':
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
46 --examples=$examples
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
47 #end if
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
48
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
49 ;
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
50 cp odistancematrix.qza $odistancematrix
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
51
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
52 ;
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
53 qiime tools export ovisualization.qzv --output-path out
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
54 && mkdir -p '$ovisualization.files_path'
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
55 && cp -r out/* '$ovisualization.files_path'
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
56 && mv '$ovisualization.files_path/index.html' '$ovisualization'
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
57
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
58 ]]></command>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
59 <inputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
60 <param format="qza,no_unzip.zip" label="--i-biplot: ARTIFACT PCoAResults % Properties(\'biplot\') The principal coordinates matrix to be plotted. [required]" name="ibiplot" optional="False" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
61 <repeat name="input_files_msamplemetadatafile" optional="False" title="--m-sample-metadata-file">
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
62 <param format="tabular,qza,no_unzip.zip" label="--m-sample-metadata-file: METADATA... (multiple The sample metadata arguments will be merged) [required]" name="additional_input" optional="False" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
63 </repeat>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
64 <repeat name="input_files_mfeaturemetadatafile" optional="True" title="--m-feature-metadata-file">
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
65 <param format="tabular,qza,no_unzip.zip" label="--m-feature-metadata-file: METADATA... (multiple The feature metadata (useful to manipulate the arrows arguments will in the plot). be merged) [optional]" name="additional_input" optional="True" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
66 </repeat>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
67 <param label="--p-ignore-missing-samples: --p-ignore-missing-samples: / --p-no-ignore-missing-samples This will suppress the error raised when the coordinates matrix contains samples that are not present in the metadata. Samples without metadata are included by setting all metadata values to: \'This sample has no metadata\'. This flag is only applied if at least one sample is present in both the coordinates matrix and the metadata. [default: False]" name="pignoremissingsamples" selected="False" type="boolean" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
68 <param label="--p-invert: --p-invert: / --p-no-invert If specified, the point and arrow coordinates will be swapped. [default: False]" name="pinvert" selected="False" type="boolean" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
69 <param label="--p-number-of-features: INTEGER Range(1, None) The number of most important features (arrows) to display in the ordination. “Importance” is calculated for each feature based on the vector’s magnitude (euclidean distance from origin). [default: 5]" min="1" name="pnumberoffeatures" optional="True" type="integer" value="5" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
70 <param label="--examples: Show usage examples and exit." name="examples" optional="False" type="data" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
71
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
72 </inputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
73
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
74 <outputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
75 <data format="html" label="${tool.name} on ${on_string}: visualization.html" name="ovisualization" />
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
76
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
77 </outputs>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
78
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
79 <help><![CDATA[
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
80 Visualize and Interact with Principal Coordinates Analysis Biplot
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
81 ###############################################################
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
82
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
83 Generates an interactive ordination biplot where the user can visually
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
84 integrate sample and feature metadata. Vectors representing the n most
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
85 important features are then plotted in the emperor visualization (5
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
86 largest, by default).
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
87
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
88 Parameters
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
89 ----------
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
90 biplot : PCoAResults % Properties('biplot')
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
91 The principal coordinates matrix to be plotted.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
92 sample_metadata : Metadata
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
93 The sample metadata
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
94 feature_metadata : Metadata, optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
95 The feature metadata (useful to manipulate the arrows in the plot).
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
96 ignore_missing_samples : Bool, optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
97 This will suppress the error raised when the coordinates matrix
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
98 contains samples that are not present in the metadata. Samples without
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
99 metadata are included by setting all metadata values to: "This sample
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
100 has no metadata". This flag is only applied if at least one sample is
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
101 present in both the coordinates matrix and the metadata.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
102 invert : Bool, optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
103 If specified, the point and arrow coordinates will be swapped.
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
104 number_of_features : Int % Range(1, None), optional
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
105 The number of most important features (arrows) to display in the
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
106 ordination. “Importance” is calculated for each feature based on the
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
107 vector’s magnitude (euclidean distance from origin).
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
108
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
109 Returns
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
110 -------
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
111 visualization : Visualization
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
112 ]]></help>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
113 <macros>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
114 <import>qiime_citation.xml</import>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
115 </macros>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
116 <expand macro="qiime_citation"/>
3ba9833030c1 Uploaded
florianbegusch
parents:
diff changeset
117 </tool>