

   kmeans {mva}                                 R Documentation

   KK--MMeeaannss CClluusstteerriinngg

   DDeessccrriippttiioonn::

        Perform k-means clustering on a data matrix.

   UUssaaggee::

        kmeans(x, centers, iter.max = 10)

   AArrgguummeennttss::

          x: A data frame or matrix of data.

    centers: Either the number of clusters or a set of initial
             cluster centers.  If the first, a random set of
             rows in `x' are chosen as the initial centers.

   iter.max: The maximum number of iterations allowed.

   DDeettaaiillss::

        The data given by `x' is clustered by the k-Means algo-
        rithm.  When this terminates, all cluster centres are
        at to the mean of their Voronoi sets (the set of data
        points which are nearest to the cluster centre).

        The algorithm of Hartigan and Wong (1979) is used.

   VVaalluuee::

        A list with components:

    cluster: A vector of integers indicating the cluster to
             which each point is allocated.

    centers: A matrix of cluster centres.

   withinss: The within-cluster sum of squares for each clus-
             ter.

       size: The number of points in each cluster.

   RReeffeerreenncceess::

        Hartigan, J.A. and Wong, M.A. (1979).  A K-means clus-
        tering algorithm.  Applied Statistics 28, 100-108.

   EExxaammpplleess::

        # a 2-dimensional example
        x <- rbind(matrix(rnorm(100,sd=0.3),ncol=2),
                   matrix(rnorm(100,mean=1,sd=0.3),ncol=2))
        cl <- kmeans(x,2,20)
        plot(x, col = cl$cluster)
        points(cl$centers,col = 1:2,pch = 8)

