\HeaderA{hclustglad}{Hierarchical Clustering}{hclustglad}
\keyword{multivariate}{hclustglad}
\keyword{cluster}{hclustglad}
\begin{Description}\relax
Hierarchical cluster analysis on a set of dissimilarities and
methods for analyzing it.
\end{Description}
\begin{Usage}
\begin{verbatim}
hclustglad(d, method = "complete", members=NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{d}] a dissimilarity structure as produced by \code{dist}.
\item[\code{method}] the agglomeration method to be used. This should
be (an unambiguous abbreviation of) one of
\code{"ward"}, \code{"single"}, \code{"complete"},
\code{"average"}, \code{"mcquitty"}, \code{"median"} or
\code{"centroid"}.
\item[\code{members}] \code{NULL} or a vector with length size of \code{d}.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This function performs a hierarchical cluster analysis
using a set of dissimilarities for the \eqn{n}{} objects being
clustered.  Initially, each object is assigned to its own
cluster and then the algorithm proceeds iteratively,
at each stage joining the two most similar clusters,
continuing until there is just a single cluster.
At each stage distances between clusters are recomputed
by the Lance--Williams dissimilarity update formula
according to the particular clustering method being used.

A number of different clustering methods are provided.
\emph{Ward's} minimum variance method aims at finding compact,
spherical clusters.  The \emph{complete linkage} method finds
similar clusters. The \emph{single linkage} method
(which is closely related to the minimal spanning tree)
adopts a `friends of friends' clustering strategy.
The other methods can be regarded as aiming
for clusters with characteristics somewhere between
the single and complete link methods.

If \code{members!=NULL}, then \code{d} is taken to be a
dissimilarity matrix between clusters instead of dissimilarities
between singletons and \code{members} gives the number of observations
per cluster. This way the hierarchical cluster algorithm can be ``started
in the middle of the dendrogram'', e.g., in order to reconstruct the
part of the tree above a cut (see examples). Dissimilarities between
clusters can be efficiently computed (i.e., without \code{hclustglad}
itself) only for a limited number of distance/linkage combinations,
the simplest one being squared Euclidean distance and centroid
linkage. In this case the dissimilarities between the clusters are
the squared Euclidean distances between cluster means.

In hierarchical cluster displays, a decision is needed at each merge to
specify which subtree should go on the left and which on the right.
Since, for \eqn{n}{} observations there are \eqn{n-1}{} merges,
there are \eqn{2^{(n-1)}}{} possible orderings for the leaves
in a cluster tree, or dendrogram.
The algorithm used in \code{hclustglad} is to order the subtree so that
the tighter cluster is on the left (the last, i.e. most recent,
merge of the left subtree is at a lower value than the last
merge of the right subtree).
Single observations are the tightest clusters possible,
and merges involving two observations place them in order by their
observation sequence number.
\end{Details}
\begin{Value}
An object of class \bold{hclust} which describes the
tree produced by the clustering process.
The object is a list with components:
\begin{ldescription}
\item[\code{merge}] an \eqn{n-1}{} by 2 matrix.
Row \eqn{i}{} of \code{merge} describes the merging of clusters
at step \eqn{i}{} of the clustering.
If an element \eqn{j}{} in the row is negative,
then observation \eqn{-j}{} was merged at this stage.
If \eqn{j}{} is positive then the merge
was with the cluster formed at the (earlier) stage \eqn{j}{}
of the algorithm.
Thus negative entries in \code{merge} indicate agglomerations
of singletons, and positive entries indicate agglomerations
of non-singletons.
\item[\code{height}] a set of \eqn{n-1}{} non-decreasing real values.
The clustering \emph{height}: that is, the value of
the criterion associated with the clustering
\code{method} for the particular agglomeration.
\item[\code{order}] a vector giving the permutation of the original
observations suitable for plotting, in the sense that a cluster
plot using this ordering and matrix \code{merge} will not have
crossings of the branches.
\item[\code{labels}] labels for each of the objects being clustered.
\item[\code{call}] the call which produced the result.
\item[\code{method}] the cluster method that has been used.
\item[\code{dist.method}] the distance that has been used to create \code{d}
(only returned if the distance object has a \code{"method"}
attribute).
\end{ldescription}
\end{Value}
\begin{Author}\relax
The \code{hclustglad} function is based an Algorithm
contributed to STATLIB by F. Murtagh.
\end{Author}
\begin{References}\relax
Everitt, B. (1974).
\emph{Cluster Analysis}.
London: Heinemann Educ. Books.

Hartigan, J. A. (1975).
\emph{Clustering  Algorithms}.
New York: Wiley.

Sneath, P. H. A. and R. R. Sokal (1973).
\emph{Numerical Taxonomy}.
San Francisco: Freeman.

Anderberg, M. R. (1973).
\emph{Cluster Analysis for Applications}.
Academic Press: New York.

Gordon, A. D. (1999).
\emph{Classification}. Second Edition.
London: Chapman and Hall / CRC

Murtagh, F. (1985).
``Multidimensional Clustering Algorithms'', in
\emph{COMPSTAT Lectures 4}.
Wuerzburg: Physica-Verlag
(for algorithmic details of algorithms used).
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{hclustglad}{hclustglad}} \code{\LinkA{kmeans}{kmeans}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(USArrests)
hc <- hclustglad(dist(USArrests), "ave")
plot(hc)
plot(hc, hang = -1)

## Do the same with centroid clustering and squared Euclidean distance,
## cut the tree into ten clusters and reconstruct the upper part of the
## tree from the cluster centers.
hc <- hclustglad(dist(USArrests)^2, "cen")
memb <- cutree(hc, k = 10)
cent <- NULL
for(k in 1:10){
  cent <- rbind(cent, colMeans(USArrests[memb == k, , drop = FALSE]))
}
hc1 <- hclustglad(dist(cent)^2, method = "cen", members = table(memb))
opar <- par(mfrow = c(1, 2))
plot(hc,  labels = FALSE, hang = -1, main = "Original Tree")
plot(hc1, labels = FALSE, hang = -1, main = "Re-start from 10 clusters")
par(opar)
\end{ExampleCode}
\end{Examples}

