annotate qiime2/qiime_emperor_biplot.xml @ 14:a0a8d77a991c draft

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