Plot the smoothers estimated by tradeSeq.

plotSmoothers(models, ...)

# S4 method for gam
plotSmoothers(
  models,
  nPoints = 100,
  lwd = 2,
  size = 2/3,
  xlab = "Pseudotime",
  ylab = "Log(expression + 1)",
  border = TRUE,
  alpha = 1,
  sample = 1
)

# S4 method for SingleCellExperiment
plotSmoothers(
  models,
  counts,
  gene,
  nPoints = 100,
  lwd = 2,
  size = 2/3,
  xlab = "Pseudotime",
  ylab = "Log(expression + 1)",
  border = TRUE,
  alpha = 1,
  sample = 1,
  pointCol = NULL,
  curvesCols = NULL,
  plotLineages = TRUE
)

Arguments

models

Either the SingleCellExperiment object obtained after running fitGAM, or the specific GAM model for the corresponding gene, if working with the list output of tradeSeq.

...

parameters including:

nPoints

The number of points used to extrapolate the fit. Defaults to 100.

lwd

Line width of the smoother. Passed to geom_line.

size

Character expansion of the data points. Passed to geom_point.

xlab

x-axis label. Passed to labs.

ylab

y-axis label. Passed to labs.

border

Logical: should a white border be drawn around the mean smoother.

alpha

Numeric between 0 and 1, determines the transparency of data points, see scale_color_viridis_d.

sample

Numeric between 0 and 1, use to subsample the cells when there are too many so that it can plot faster.

counts

The matrix of gene expression counts.

gene

Gene name or row in count matrix of gene to plot.

pointCol

Plotting colors for each cell. Can be either character vector of length 1, denoting a variable in the colData(models) to color cells by, or a vector of length equal to the number of cells.

curvesCols

Plotting colors for each curve Should be a list of colors of the exact same length as the number of curves, i.e. the number of lineages (if there is no conditions) or the number of lineages by the number of conditions. In the second case, the colors are grouped by condition (lineage 1 - condition 1, lineage 1 - condition 2,...).

plotLineages

Logical, should the mean smoothers for each lineage be plotted?

Value

A ggplot object

Examples

set.seed(8) data(crv, package="tradeSeq") data(countMatrix, package="tradeSeq") counts <- as.matrix(countMatrix) sce <- fitGAM(counts = counts, sds = crv, nknots = 5) plotSmoothers(sce, counts, rownames(counts)[1])
# Show only first lineage curve curvesCols <- c("#440154FF", "transparent") plotSmoothers(sce, counts, rownames(counts)[1], curvesCols = curvesCols, border = FALSE)
# Show only first curve and cells assigned to first lineage plotSmoothers(sce, counts, rownames(counts)[1], curvesCols = curvesCols, border = FALSE) + ggplot2::scale_color_manual(values = curvesCols)
#> Scale for 'colour' is already present. Adding another scale for 'colour', #> which will replace the existing scale.