annotate tools/multivariate_stats/cca.xml @ 0:9071e359b9a3

Uploaded
author xuebing
date Fri, 09 Mar 2012 19:37:19 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
1 <tool id="cca1" name="Canonical Correlation Analysis" version="1.0.0">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
2 <description> </description>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
3 <command interpreter="python">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
4 cca.py
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
5 $input1
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
6 $x_cols
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
7 $y_cols
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
8 $x_scale
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
9 $y_scale
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
10 $std_scores
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
11 $out_file1
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
12 $out_file2
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
13 </command>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
14 <inputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
15 <param format="tabular" name="input1" type="data" label="Select data" help="Dataset missing? See TIP below."/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
16 <param name="x_cols" label="Select columns containing X variables " type="data_column" data_ref="input1" numerical="True" multiple="true" >
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
17 <validator type="no_options" message="Please select at least one column."/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
18 </param>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
19 <param name="y_cols" label="Select columns containing Y variables " type="data_column" data_ref="input1" numerical="True" multiple="true" >
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
20 <validator type="no_options" message="Please select at least one column."/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
21 </param>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
22 <param name="x_scale" type="select" label="Type of Scaling for X variables" help="Can be used to center and/or scale variables">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
23 <option value="none" selected="true">None</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
24 <option value="center">Center only</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
25 <option value="scale">Scale only</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
26 <option value="both">Center and Scale</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
27 </param>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
28 <param name="y_scale" type="select" label="Type of Scaling for Y variables" help="Can be used to center and/or scale variables">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
29 <option value="none" selected="true">None</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
30 <option value="center">Center only</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
31 <option value="scale">Scale only</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
32 <option value="both">Center and Scale</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
33 </param>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
34 <param name="std_scores" type="select" label="Report standardized scores?" help="Selecting 'Yes' will rescale scores (and coefficients) to produce scores of unit variance">
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
35 <option value="no" selected="true">No</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
36 <option value="yes">Yes</option>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
37 </param>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
38 </inputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
39 <outputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
40 <data format="input" name="out_file1" metadata_source="input1" />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
41 <data format="pdf" name="out_file2" />
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
42 </outputs>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
43 <requirements>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
44 <requirement type="python-module">rpy</requirement>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
45 </requirements>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
46 <tests>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
47 <test>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
48 <param name="input1" value="iris.tabular"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
49 <param name="x_cols" value="3,4"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
50 <param name="y_cols" value="1,2"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
51 <param name="x_scale" value="both"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
52 <param name="y_scale" value="scale"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
53 <param name="std_scores" value="yes"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
54 <output name="out_file1" file="cca_out1.tabular"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
55 <output name="out_file2" file="cca_out2.pdf"/>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
56 </test>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
57 </tests>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
58 <help>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
59
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
60
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
61 .. class:: infomark
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
62
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
63 **TIP:** If your data is not TAB delimited, use *Edit Datasets-&gt;Convert characters*
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
64
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
65 -----
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
66
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
67 .. class:: infomark
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
68
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
69 **What it does**
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
70
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
71 This tool uses functions from 'yacca' library from R statistical package to perform Canonical Correlation Analysis (CCA) on the input data. It outputs two files, one containing the summary statistics of the performed CCA, and the other containing helioplots, which display structural loadings of X and Y variables on different canonical components.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
72
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
73 *Carter T. Butts (2009). yacca: Yet Another Canonical Correlation Analysis Package. R package version 1.1.*
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
74
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
75 -----
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
76
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
77 .. class:: warningmark
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
78
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
79 **Note**
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
80
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
81 - This tool currently treats all predictor and response variables as continuous numeric variables. Running the tool on categorical variables might result in incorrect results.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
82
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
83 - Rows containing non-numeric (or missing) data in any of the chosen columns will be skipped from the analysis.
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
84
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
85 - The summary statistics in the output are described below:
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
86
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
87 - correlation: Canonical correlation between the canonical variates (i.e. transformed variables)
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
88 - F-statistic: F-value obtained from F Test for Canonical Correlations Using Rao's Approximation
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
89 - p-value: denotes significance of canonical correlations
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
90 - Coefficients: represent the coefficients of X and Y variables on each canonical variate
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
91 - Loadings: represent the correlations between the original variables in each set and their respective canonical variates
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
92 - CrossLoadings: represent the correlations between the original variables in each set and the opposite canonical variates
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
93
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
94 </help>
9071e359b9a3 Uploaded
xuebing
parents:
diff changeset
95 </tool>