contourPlot {scDataviz} | R Documentation |
SingleCellExperiment
object.Draw a contour plot, typically relating to co-ordinates of a 2-dimensional reduction / embedding, typically contained within a SingleCellExperiment
object.
contourPlot( indata, reducedDim = "UMAP", dimColnames = c("UMAP1", "UMAP2"), lowcol = "darkblue", highcol = "darkred", alpha = c(0, 0.5), contour = "black", bins = 300, legendPosition = "right", legendLabSize = 12, legendIconSize = 5, legendKeyHeight = 2.5, xlim = NULL, ylim = NULL, celllab = NULL, labSize = 3, labhjust = 1.5, labvjust = 0, drawConnectors = TRUE, widthConnectors = 0.5, colConnectors = "black", xlab = dimColnames[1], xlabAngle = 0, xlabhjust = 0.5, xlabvjust = 0.5, ylab = dimColnames[2], ylabAngle = 0, ylabhjust = 0.5, ylabvjust = 0.5, axisLabSize = 16, title = "Cellular density and contours", subtitle = "", caption = ifelse(is(indata, "SingleCellExperiment"), paste0("Total cells, ", nrow(as.data.frame(reducedDim(indata, reducedDim))), "; Bins, ", bins), paste0("Total cells, ", nrow(indata), "; Bins, ", bins)), titleLabSize = 16, subtitleLabSize = 12, captionLabSize = 12, hline = NULL, hlineType = "longdash", hlineCol = "black", hlineWidth = 0.4, vline = NULL, vlineType = "longdash", vlineCol = "black", vlineWidth = 0.4, gridlines.major = TRUE, gridlines.minor = TRUE, borderWidth = 0.8, borderColour = "black", verbose = TRUE )
indata |
A data-frame or matrix, or |
reducedDim |
A reduced dimensional embedding stored within |
dimColnames |
The column names of the dimensions to use. |
lowcol |
Shade for low-density contours. |
highcol |
Shade for high-density contours. |
alpha |
Control the gradient of colour transparency, with 1 being opaque. |
contour |
The colour of the contour lines. |
bins |
The number of bins that determine the overall density values. |
legendPosition |
Position of legend |
legendLabSize |
Size of plot legend text. |
legendIconSize |
Size of plot legend icons / symbols. |
legendKeyHeight |
Height of the legend key. |
xlim |
Limits of the x-axis. |
ylim |
Limits of the y-axis. |
celllab |
A vector containing any cells that the user wishes to label in the plot. |
labSize |
Size of labels. |
labhjust |
Horizontal adjustment of label. |
labvjust |
Vertical adjustment of label. |
drawConnectors |
Logical, indicating whether or not to connect plot labels to their corresponding points by line connectors. |
widthConnectors |
Line width of connectors. |
colConnectors |
Line colour of connectors. |
xlab |
Label for x-axis. |
xlabAngle |
Rotation angle of x-axis labels. |
xlabhjust |
Horizontal adjustment of x-axis labels. |
xlabvjust |
Vertical adjustment of x-axis labels. |
ylab |
Label for y-axis. |
ylabAngle |
Rotation angle of y-axis labels. |
ylabhjust |
Horizontal adjustment of y-axis labels. |
ylabvjust |
Vertical adjustment of y-axis labels. |
axisLabSize |
Size of x- and y-axis labels. |
title |
Plot title. |
subtitle |
Plot subtitle. |
caption |
Plot caption. |
titleLabSize |
Size of plot title. |
subtitleLabSize |
Size of plot subtitle. |
captionLabSize |
Size of plot caption. |
hline |
Draw one or more horizontal lines passing through this/these values on y-axis. For single values, only a single numerical value is necessary. For multiple lines, pass these as a vector, e.g., c(60,90). |
hlineType |
Line type for hline |
hlineCol |
Colour of hline. |
hlineWidth |
Width of hline. |
vline |
Draw one or more vertical lines passing through this/these values on x-axis. For single values, only a single numerical value is necessary. For multiple lines, pass these as a vector, e.g., c(60,90). |
vlineType |
Line type for vline |
vlineCol |
Colour of vline. |
vlineWidth |
Width of vline. |
gridlines.major |
Logical, indicating whether or not to draw major gridlines. |
gridlines.minor |
Logical, indicating whether or not to draw minor gridlines. |
borderWidth |
Width of the border on the x and y axes. |
borderColour |
Colour of the border on the x and y axes. |
verbose |
Boolean (TRUE / FALSE) to print messages to console or not. |
Draw a contour plot, typically relating to co-ordinates of a 2-dimensional reduction / embedding, typically contained within a SingleCellExperiment
object.
A ggplot2
object.
Kevin Blighe <kevin@clinicalbioinformatics.co.uk>
# create random data that follows a negative binomial mat <- jitter(matrix( MASS::rnegbin(rexp(1000, rate=.1), theta = 4.5), ncol = 20)) colnames(mat) <- paste0('CD', 1:ncol(mat)) u <- umap::umap(mat)$layout colnames(u) <- c('UMAP1','UMAP2') contourPlot(u)