man/plotTopHVG.Rd
d53d8022
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/plotTopHVG.R
 \name{plotTopHVG}
 \alias{plotTopHVG}
 \title{Plot highly variable genes}
 \usage{
930ec858
 plotTopHVG(
   inSCE,
   method = c("vst", "mean.var.plot", "dispersion", "modelGeneVar"),
cd24c4e7
   hvgNumber = NULL,
   useFeatureSubset = NULL,
ef10cb29
   labelsCount = 20,
89631c60
   featureDisplay = metadata(inSCE)$featureDisplay,
   labelSize = 2,
   dotSize = 2,
   textSize = 12
930ec858
 )
d53d8022
 }
 \arguments{
3ce6e91e
 \item{inSCE}{Input \code{SingleCellExperiment} object containing the
 computations.}
d53d8022
 
89631c60
 \item{method}{Select either \code{"vst"}, \code{"mean.var.plot"},
ef10cb29
 \code{"dispersion"} or \code{"modelGeneVar"}.}
d53d8022
 
ef10cb29
 \item{hvgNumber}{Specify the number of top genes to highlight in red. Default
cd24c4e7
 \code{NULL}. See details.}
 
89631c60
 \item{useFeatureSubset}{A character string for the \code{rowData} variable
 name to store a logical index of selected features. Default \code{NULL}. See
cd24c4e7
 details.}
93175386
 
89631c60
 \item{labelsCount}{Specify the number of data points/genes to label. Should
cd24c4e7
 be less than \code{hvgNumber}. Default \code{20}. See details.}
93175386
 
ef10cb29
 \item{featureDisplay}{A character string for the \code{rowData} variable name
89631c60
 to indicate what type of feature ID should be displayed. If set by
ef10cb29
 \code{\link{setSCTKDisplayRow}}, will by default use it. If \code{NULL}, will
 use \code{rownames(inSCE)}.}
89631c60
 
 \item{labelSize}{Numeric, size of the text label on top HVGs. Default 
 \code{2}.}
 
 \item{dotSize}{Numeric, size of the dots of the features. Default \code{2}.}
 
 \item{textSize}{Numeric, size of the text of axis title, axis label, etc.
 Default \code{12}.}
d53d8022
 }
 \value{
cd24c4e7
 ggplot of HVG metrics and top HVG labels
d53d8022
 }
 \description{
 Plot highly variable genes
 }
cd24c4e7
 \details{
 When \code{hvgNumber = NULL} and \code{useFeature = NULL}, only plot
 the mean VS variance/dispersion scatter plot. When only \code{hvgNumber} set,
89631c60
 label the top \code{hvgNumber} HVGs ranked by the metrics calculated by
 \code{method}. When \code{useFeatureSubset} set, label the features in
 the subset on the scatter plot created with \code{method} and ignore
cd24c4e7
 \code{hvgNumber}.
 }
930ec858
 \examples{
 data("mouseBrainSubsetSCE", package = "singleCellTK")
ef10cb29
 mouseBrainSubsetSCE <- runModelGeneVar(mouseBrainSubsetSCE)
 plotTopHVG(mouseBrainSubsetSCE, method = "modelGeneVar")
 }
 \seealso{
 \code{\link{runFeatureSelection}}, \code{\link{runSeuratFindHVG}},
 \code{\link{runModelGeneVar}}, \code{\link{getTopHVG}}
930ec858
 }