1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Command (Cluster 3.0 for Windows, Mac OS X, Linux, Unix)</title>
<meta name="description" content="Command (Cluster 3.0 for Windows, Mac OS X, Linux, Unix)">
<meta name="keywords" content="Command (Cluster 3.0 for Windows, Mac OS X, Linux, Unix)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Contents.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="TreeView.html#TreeView" rel="next" title="TreeView">
<link href="PCA.html#PCA" rel="prev" title="PCA">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="Command"></span><div class="header">
<p>
Next: <a href="TreeView.html#TreeView" accesskey="n" rel="next">TreeView</a>, Previous: <a href="Cluster.html#Cluster" accesskey="p" rel="prev">Cluster</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Contents.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<hr>
<span id="Running-Cluster-3_002e0-as-a-command-line-program"></span><h2 class="chapter">5 Running Cluster 3.0 as a command line program</h2>
<p>Cluster 3.0 can also be run as a command line program. This may be useful if you want to run Cluster 3.0 on a remote server, and also allows automatic processing a large number of data files by running a batch script. Note, however, that the Python and Perl interfaces to the C Clustering Library may be better suited for this task, as they are more powerful than the command line program (see the manual for the C Clustering Library at <a href="http://bonsai.hgc.jp/~mdehoon/software/cluster/cluster.pdf">http://bonsai.hgc.jp/~mdehoon/software/cluster/cluster.pdf</a>).
</p>
<p>The GUI version of Cluster 3.0 can be used as a command line program by applying the appropriate command line parameters. You can also compile Cluster 3.0 without GUI support (if you will be using it from the command line only) by downloading the source code from <a href="http://bonsai.hgc.jp/~mdehoon/software/cluster">http://bonsai.hgc.jp/~mdehoon/software/cluster</a>, and running <br>
<code>configure --without-x</code> <br>
<code>make</code> <br>
<code>make install</code> <br>
The executable is called <code>cluster</code>. To run this program, execute <br>
<code>cluster [options]</code> <br>
in which the options consist of the following command line parameters:
</p><dl compact="compact">
<dt><code>-f <var>filename</var></code></dt>
<dd><p>File loading
</p></dd>
<dt><code>-l</code></dt>
<dd><p>Specifies to log-transform the data before clustering (default is no log-transform)
</p></dd>
<dt><code>-cg a|m</code></dt>
<dd><p>Specifies whether to center each row (gene) in the data set: <br>
<code>a</code>: Subtract the mean of each row <br>
<code>m</code>: Subtract the median of each row <br>
(default is no centering)
</p></dd>
<dt><code>-ng</code></dt>
<dd><p>Specifies to normalize each row (gene) in the data set (default is no normalization)
</p></dd>
<dt><code>-ca a|m</code></dt>
<dd><p>Specifies whether to center each column (microarray) in the data set: <br>
<code>a</code>: Subtract the mean of each column <br>
<code>m</code>: Subtract the median of each column <br>
(default is no centering)
</p></dd>
<dt><code>-na</code></dt>
<dd><p>Specifies to normalize each column (microarray) in the data set (default is no normalization)
</p></dd>
<dt><code>-u <var>jobname</var></code></dt>
<dd><p>Allows you to specify a different name for the output files
(default is derived from the input file name)
</p></dd>
<dt><code>-g [0..9]</code></dt>
<dd><p>Specifies the distance measure for gene clustering. 0 means no gene clustering; for the values 1 through 9, see below (default: 0)
</p></dd>
<dt><code>-e [0..9]</code></dt>
<dd><p>Specifies the distance measure for microarray clustering. 0 means no microarray clustering; for the values 1 through 9, see below (default: 0)
</p></dd>
<dt><code>-m [msca]</code></dt>
<dd><p>Specifies which hierarchical clustering method to use: <br>
<code>m</code>: Pairwise complete- (maximum-) linkage (default) <br>
<code>s</code>: Pairwise single-linkage <br>
<code>c</code>: Pairwise centroid-linkage <br>
<code>a</code>: Pairwise average-linkage
</p></dd>
<dt><code>-k <var>number</var></code></dt>
<dd><p>Specifies whether to run <em>k</em>-means clustering instead of hierarchical clustering, and the number of clusters
<i>k</i> to use (default: 0, no <i>k</i>-means clustering)
</p></dd>
<dt><code>-pg</code></dt>
<dd><p>Specifies to apply Principal Component Analysis to genes instead of clustering
</p></dd>
<dt><code>-pa</code></dt>
<dd><p>Specifies to apply Principal Component Analysis to arrays instead of clustering
</p></dd>
<dt><code>-s</code></dt>
<dd><p>Specifies to calculate an SOM instead of hierarchical clustering
</p></dd>
<dt><code>-x <var>number</var></code></dt>
<dd><p>Specifies the horizontal dimension of the SOM grid (default: 2)
</p></dd>
<dt><code>-y <var>number</var></code></dt>
<dd><p>Specifies the vertical dimension of the SOM grid (default: 1)
</p></dd>
<dt><code>-v, --version</code></dt>
<dd><p>Display version information
</p></dd>
<dt><code>-h, --help</code></dt>
<dd><p>Display help information
</p></dd>
</dl>
<p>For the command line options <samp>-g</samp>, <samp>-e</samp>, the following integers can be used to specify the distance measure:
</p><dl compact="compact">
<dt><code>0</code></dt>
<dd><p>No clustering
</p></dd>
<dt><code>1</code></dt>
<dd><p>Uncentered correlation
</p></dd>
<dt><code>2</code></dt>
<dd><p>Pearson correlation
</p></dd>
<dt><code>3</code></dt>
<dd><p>Uncentered correlation, absolute value
</p></dd>
<dt><code>4</code></dt>
<dd><p>Pearson correlation, absolute value
</p></dd>
<dt><code>5</code></dt>
<dd><p>Spearman’s rank correlation
</p></dd>
<dt><code>6</code></dt>
<dd><p>Kendall’s
<i>τ</i>
</p></dd>
<dt><code>7</code></dt>
<dd><p>Euclidean distance
</p></dd>
<dt><code>8</code></dt>
<dd><p>City-block distance
</p></dd>
</dl>
<p>By default, no clustering is done, allowing you to use <code>cluster</code> for normalizing a data set only.
</p>
<hr>
<div class="header">
<p>
Next: <a href="TreeView.html#TreeView" accesskey="n" rel="next">TreeView</a>, Previous: <a href="Cluster.html#Cluster" accesskey="p" rel="prev">Cluster</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Contents.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
</body>
</html>
|
