annotate cluster.tools/consensus.clustering.xml @ 8:a58527c632b7 draft

Uploaded
author peter-waltman
date Mon, 11 Mar 2013 16:31:29 -0400
parents 0decf3fd54bc
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
1 <tool id="consensus_clustering" name="Consensus Clustering" force_history_refresh="True">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
2 <command interpreter="python">consensus.clustering.py
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
3 -d $dataset
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
4 -n ${direction}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
5 -a ${method.algorithm}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
6 #if $method.algorithm == 'hc' # -m ${method.hc_distance_metric}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
7 -i ${method.innerLinkage}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
8 #end if
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
9 #if $method.algorithm == 'pam' # -m ${method.pam_distance_metric}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
10 #end if
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
11 #if $method.algorithm == 'km' # -m euclidean
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
12 #end if
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
13 -k ${kmax}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
14 -r ${reps}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
15 -f ${finalLinkage}
8
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
16 #if str($direction) == "rows":
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
17 -o ${rdata_output_rows}
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
18 #end if
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
19
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
20 #if str($direction) == "cols":
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
21 -o ${rdata_output_cols}
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
22 #end if
0
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
23 -h $report
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
24 -p ${report.files_path}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
25
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
26 </command>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
27 <inputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
28 <param name="dataset" type="data" format='tabular' label="Data Set" help="Specify the data matrix (tab-delimited) to be clustered"/>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
29 <param name="direction" type="select" label="Cluster Samples or Genes?" help="Specify the matrix dimension to cluster (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
30 <option value="rows">Genes (rows)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
31 <option value="cols" selected="true">Samples (columns)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
32 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
33
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
34 <conditional name='method'>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
35 <param name="algorithm" type="select" label="Clustering Algorithm" help="Specify the cluster method to use (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
36 <option value="hc">Hierarchical Clustering</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
37 <option value="pam" selected='true'>Partioning around Medioids</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
38 <option value="km">K-Means Clustering</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
39 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
40 <when value='hc'>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
41 <param name="hc_distance_metric" type="select" label="Distance Metric" help="Specify the distance metric to use (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
42 <option value="cosine" selected='true'>Cosine</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
43 <option value="abscosine">Absolute Cosine</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
44 <option value="pearson">Pearson</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
45 <option value="abspearson">Absolute Pearson</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
46 <option value="spearman">Spearman</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
47 <option value="kendall">Kendall</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
48 <option value="euclidean">Euclidean</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
49 <option value="maximum">Maximum</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
50 <option value="manhattan">Manhattan (AKA city block)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
51 <option value="canberra">Canberra</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
52 <option value="binary">Binary</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
53 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
54
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
55 <param name="innerLinkage" type="select" label="Linkage for inner HAC " help="Specify the linkage to use during the 'inner' hierarchcial clustering (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
56 <option value="average">Average</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
57 <option value="centroid">Centroid</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
58 <option value="complete" selected='true'>Complete</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
59 <option value="mcquitty">McQuitty</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
60 <option value="median">Median</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
61 <option value="single">Single</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
62 <option value="ward">Ward</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
63 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
64 </when>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
65 <when value='pam'>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
66 <param name="pam_distance_metric" type="select" label="Distance Metric" help="Specify the distance metric to use (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
67 <option value="cosine" selected='true'>Cosine</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
68 <option value="abscosine">Absolute Cosine</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
69 <option value="pearson">Pearson</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
70 <option value="abspearson">Absolute Pearson</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
71 <option value="spearman">Spearman</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
72 <option value="kendall">Kendall</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
73 <option value="euclidean">Euclidean</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
74 <option value="maximum">Maximum</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
75 <option value="manhattan">Manhattan (AKA city block)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
76 <option value="canberra">Canberra</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
77 <option value="binary">Binary</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
78 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
79 </when>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
80 </conditional>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
81 <param name="finalLinkage" type="select" label="Final Linkage" help="Specify the linkage to use when clustering the consensus matrix (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
82 <option value="average">Average</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
83 <option value="centroid">Centroid</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
84 <option value="complete" selected='true'>Complete</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
85 <option value="mcquitty">McQuitty</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
86 <option value="median">Median</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
87 <option value="single">Single</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
88 <option value="ward">Ward</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
89 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
90
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
91
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
92 <param name="kmax" type="integer" label="K Max" value="10" help="Maximum number of K to analyze" />
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
93 <param name="reps" type="integer" label="Repetitions" value="500" help="Number of Sample Permutations to Repeat"/>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
94
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
95 </inputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
96 <outputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
97 <data format="html" name="report" label="Consensus Clustering Report (HTML)"/>
8
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
98 <data format="rdata" name="rdata_output_rows" label="Consensus Clustering Results; Gene Clusters (RData)">
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
99 <filter>(direction)=="rows"</filter>
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
100 </data>
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
101 <data format="rdata" name="rdata_output_cols" label="Consensus Clustering Results; Sample Clusters (RData)">
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
102 <filter>(direction)=="cols"</filter>
a58527c632b7 Uploaded
peter-waltman
parents: 0
diff changeset
103 </data>
0
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
104 </outputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
105 <help>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
106 .. class:: infomark
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
107
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
108 **Perform Consensus Clustering (Cluster Samples) on a specified data set**
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
109
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
110 ----
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
111
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
112 **Parameters**
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
113
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
114 - **Data Set** - Specify the data matrix to be clustered. Data must be formated as follows:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
115
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
116 * Tab-delimited
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
117 * Use row/column headers
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
118
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
119 - **Cluster Samples or Genes** - Specify the dimension of the matrix to cluster:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
120
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
121 * Rows (Genes)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
122 * Columns (Samples)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
123
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
124 - **Clustering Algorithm** Specify the choice of algorithm to use. Choice of:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
125
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
126 * Hierarchical Clustering
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
127 * K-Means
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
128
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
129 - **Distance Metric** Specify the choice of distance metric to use. Choice of:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
130
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
131 * Cosine (AKA uncentered pearson)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
132 * Absolute Cosine (AKA uncentered pearson, absolute value)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
133 * Pearson (pearson correlation)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
134 * Absolute Pearson (pearson correlation, absolute value)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
135 * Spearman (spearman correlation)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
136 * Kendall (Kendall's Tau)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
137 * Euclidean (euclidean distance)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
138 * Maximum
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
139 * Manhattan (AKA city block)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
140 * Canberra
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
141 * Binary
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
142
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
143 - **Final Linkage** Specify the choice linkage to use when clustering Consensus Matrix. Choice of:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
144
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
145 * Average (see documentation for R's hclust function for explanation of choices)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
146 * Single
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
147 * Complete
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
148 * Median
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
149 * Centroid
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
150 * McQuity
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
151 * Ward
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
152
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
153 - **Inner Linkage** Specify the choice linkage to use when using HAC as clustering method. Same choices as 'Final Linkage'
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
154
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
155 - **K Max** Specify the number to use for the largest K considered
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
156
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
157 - **Repititions** Specify the number of 'bootstrap' repitions to perform to generate the consensus matrix
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
158
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
159 </help>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
160 </tool>