man/runKMeans.Rd
5f5f70dc
 % Generated by roxygen2: do not edit by hand
4611a40d
 % Please edit documentation in R/runCluster.R
5f5f70dc
 \name{runKMeans}
 \alias{runKMeans}
 \title{Get clustering with KMeans}
 \usage{
 runKMeans(
   inSCE,
4611a40d
   nCenters,
5f5f70dc
   useReducedDim = "PCA",
   clusterName = "KMeans_cluster",
4611a40d
   nComp = 10,
5f5f70dc
   nIter = 10,
   nStart = 1,
   seed = 12345,
   algorithm = c("Hartigan-Wong", "Lloyd", "MacQueen")
 )
 }
 \arguments{
6a491cbd
 \item{inSCE}{A \linkS4class{SingleCellExperiment} object.}
5f5f70dc
 
4611a40d
 \item{nCenters}{An \code{integer}, the number of centroids (clusters).}
 
5f5f70dc
 \item{useReducedDim}{A single \code{character}, specifying which
 low-dimension representation to perform the clustering algorithm on. Default
 \code{"PCA"}.}
 
 \item{clusterName}{A single \code{character}, specifying the name to store
4611a40d
 the cluster label in \code{\link{colData}}. Default \code{"KMeans_cluster"}.}
5f5f70dc
 
2f8d6a0e
 \item{nComp}{An \code{integer}. The number of components to use for K-Means.
989bff0c
 Default \code{10}. See Detail.}
5f5f70dc
 
 \item{nIter}{An \code{integer}, the maximum number of iterations allowed.
 Default \code{10}.}
 
 \item{nStart}{An \code{integer}, the number of random sets to choose. Default
 \code{1}.}
 
 \item{seed}{An \code{integer}. The seed for the random number generator.
 Default \code{12345}.}
 
 \item{algorithm}{A single \code{character}. Choose from
 \code{"Hartigan-Wong"}, \code{"Lloyd"}, \code{"MacQueen"}. May be
 abbreviated. Default \code{"Hartigan-Wong"}.}
 }
 \value{
2f8d6a0e
 The input \linkS4class{SingleCellExperiment} object with
 \code{factor} cluster labeling updated in
5f5f70dc
 \code{colData(inSCE)[[clusterName]]}.
 }
 \description{
2f8d6a0e
 Perform KMeans clustering on a
6a491cbd
 \linkS4class{SingleCellExperiment} object, with \code{\link[stats]{kmeans}}.
5f5f70dc
 }
 \examples{
 data("mouseBrainSubsetSCE")
 mouseBrainSubsetSCE <- runKMeans(mouseBrainSubsetSCE,
                                  useReducedDim = "PCA_logcounts",
                                  nCenters = 2)
 }