annotate cluster.tools/partition.xml @ 0:0decf3fd54bc draft

Uploaded
author peter-waltman
date Thu, 28 Feb 2013 01:45:39 -0500
parents
children a58527c632b7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
1 <tool id="partiton_clust" name="Partition Clustering" force_history_refresh="True">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
2 <command interpreter="python">partition.py
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
3 -d $dataset
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
4 ${dist_obj}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
5 -n ${direction}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
6 -a $alg_cond.algorithm
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
7 #if $alg_cond.algorithm == 'pam' # -m ${alg_cond.distance_metric}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
8 #end if
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
9 -k ${numk}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
10 -o ${output}
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
11
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
12 </command>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
13 <inputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
14 <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
15 <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"/>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
16
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
17 <param name="direction" type="select" label="Cluster Columns or Rows?" help="Specify the matrix dimension to cluster (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
18 <option value="cols">Columns (Samples)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
19 <option value="rows" selected='true'>Rows (Genes)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
20 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
21
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
22 <conditional name='alg_cond'>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
23 <param name="algorithm" type="select" label="PAM or K-means?" help="Specify the partition cluster method to use (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
24 <option value="km">K-means</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
25 <option value="pam" selected='true'>PAM</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
26 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
27 <when value='pam'>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
28 <param name="distance_metric" type="select" label="Distance Metric" help="Specify the distance metric to use (see help below)">
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
29 <option value="cosine" selected='true'>Cosine</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
30 <option value="abscosine">Absolute Cosine</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
31 <option value="pearson">Pearson</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
32 <option value="abspearson">Absolute Pearson</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
33 <option value="spearman">Spearman</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
34 <option value="kendall">Kendall</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
35 <option value="euclidean">Euclidean</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
36 <option value="maximum">Maximum</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
37 <option value="manhattan">Manhattan (AKA city block)</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
38 <option value="canberra">Canberra</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
39 <option value="binary">Binary</option>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
40 </param>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
41 </when>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
42 </conditional>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
43 <param name="numk" type="integer" label="Number of Clusters" value="50" help="Specify the number of clusters to use"/>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
44
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
45 </inputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
46 <outputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
47 <data format="rdata" name="output" label="Partition Clustering Data (RData)"/>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
48 </outputs>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
49 <help>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
50 .. class:: infomark
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
51
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
52 **Perform Partition Clustering (Cluster Samples) on a specified data set**
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
53
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
54 ----
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
55
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
56 **Parameters**
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
57
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
58 - **Data Set** - Specify the data matrix to be clustered. Data must be formated as follows:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
59
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
60 * Tab-delimited
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
61 * Use row/column headers
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
62
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
63 - **Distance Object** Specify whether or not the data set is a pairwise distance matrix
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
64
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
65 - **Cluster Samples or Genes** - Specify the dimension of the matrix to cluster:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
66
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
67 * Rows (Genes)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
68 * Columns (Samples)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
69
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
70 - **PAM or K-means?** Specify which partition clustering method to use - users have choice of:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
71
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
72 * PAM (Partition Around Mediods)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
73 * K-means
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
74
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
75 - **Distance Metric** Specify the distance metric to use. Note, this is ONLY AVAILABLE IF PAM IS THE ALGORITHM BEING USED. Choice of:
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
76
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
77 * Cosine (AKA uncentered pearson)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
78 * Absolute Cosine (AKA uncentered pearson, absolute value)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
79 * Pearson (pearson correlation)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
80 * Absolute Pearson (pearson correlation, absolute value)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
81 * Spearman (spearman correlation)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
82 * Kendall (Kendall's Tau)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
83 * Euclidean (euclidean distance)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
84 * Maximum
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
85 * Manhattan (AKA city block)
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
86 * Canberra
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
87 * Binary
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
88
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
89
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
90 - **Number of Clusters** Specify the number of clusters to use
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
91
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
92 </help>
0decf3fd54bc Uploaded
peter-waltman
parents:
diff changeset
93 </tool>