annotate cluster.tools/hclust.xml @ 2:b442996b66ae draft

Uploaded
author peter-waltman
date Wed, 27 Feb 2013 20:17:04 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
1 <tool id="hcluster" name="Hierarchical Clustering (HAC)" force_history_refresh="True">
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
2 <command interpreter="python">hclust.py
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
3 -d $dataset
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
4 ${dist_obj}
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
5 -n ${direction}
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
6 -m ${distance_metric}
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
7 -l ${linkage}
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
8 -k ${numk}
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
9 -o ${rdata_output}
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
10
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
11 </command>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
12 <inputs>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
13 <param name="dataset" type="data" format='tabular' label="Data Set" help="Specify the data matrix (tab-delimited) to be clustered"/>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
14 <param name="dist_obj" type="boolean" label="Distance Object (R dist object)?" truevalue="-D" falsevalue="" checked="False" help="Check if the matrix contains the pairwise distances between a set of objects"/>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
15 <param name="direction" type="select" label="Cluster Samples or Genes?" help="Specify the matrix dimension to cluster (see help below)">
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
16 <option value="cols">Columns (Samples)</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
17 <option value="rows" selected='true'>Rows (Genes)</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
18 </param>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
19
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
20 <param name="distance_metric" type="select" label="Distance Metric" help="Specify the distance metric to use (see help below)">
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
21 <option value="cosine" selected='true'>Cosine</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
22 <option value="abscosine">Absolute Cosine</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
23 <option value="pearson">Pearson</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
24 <option value="abspearson">Absolute Pearson</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
25 <option value="spearman">Spearman</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
26 <option value="kendall">Kendall</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
27 <option value="euclidean">Euclidean</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
28 <option value="maximum">Maximum</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
29 <option value="manhattan">Manhattan (AKA city block)</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
30 <option value="canberra">Canberra</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
31 <option value="binary">Binary</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
32 </param>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
33
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
34 <param name="linkage" type="select" label="Linkage" help="Specify the linkage to use when clustering (see help below)">
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
35 <option value="average">Average</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
36 <option value="centroid">Centroid</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
37 <option value="complete" selected='true'>Complete</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
38 <option value="mcquitty">McQuitty</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
39 <option value="median">Median</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
40 <option value="single">Single</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
41 <option value="ward">Ward</option>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
42 </param>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
43
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
44 <param name="numk" type="integer" label="Number of Clusters" value="50" help="Specify the number of clusters to use"/>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
45
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
46 </inputs>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
47 <outputs>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
48 <data format="rdata" name="rdata_output" label="Hierarchical Clustering Result (RData)"/>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
49 </outputs>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
50 <help>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
51 .. class:: infomark
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
52
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
53 **Perform Hierarchical Clustering (Cluster Samples) on a specified data set**
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
54
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
55 ----
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
56
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
57 **Parameters**
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
58
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
59 - **Data Set** - Specify the data matrix to be clustered. Data must be formated as follows:
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
60
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
61 * Tab-delimited
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
62 * Use row/column headers
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
63
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
64 - **Cluster Samples or Genes** - Specify the dimension of the matrix to cluster:
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
65
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
66 * Rows (Genes)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
67 * Columns (Samples)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
68
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
69 - **Distance Object** Specify whether or not the data set is a pairwise distance matrix
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
70
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
71 - **Distance Metric** Specify the distance metric to use. Choice of:
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
72
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
73 * Cosine (AKA uncentered pearson)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
74 * Absolute Cosine (AKA uncentered pearson, absolute value)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
75 * Pearson (pearson correlation)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
76 * Absolute Pearson (pearson correlation, absolute value)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
77 * Spearman (spearman correlation)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
78 * Kendall (Kendall's Tau)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
79 * Euclidean (euclidean distance)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
80 * Maximum
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
81 * Manhattan (AKA city block)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
82 * Canberra
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
83 * Binary
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
84
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
85 - **Linkage** Specify the linkage to use when clustering. Choice of:
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
86
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
87 * Average (see documentation for R's hclust function for explanation of choices)
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
88 * Single
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
89 * Complete
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
90 * Median
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
91 * Centroid
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
92 * McQuity
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
93 * Ward
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
94
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
95 - **Number of Clusters** Specify the number of clusters to use
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
96
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
97 </help>
b442996b66ae Uploaded
peter-waltman
parents:
diff changeset
98 </tool>