plotYields: Yield plot
In CATALYST: Cytometry dATa anALYSis Tools

Description Usage Arguments Details Value Author(s) References Examples

Plots the distribution of barcode separations and yields upon debarcoding as a function of separation cutoffs. If available, currently used separation cutoffs as well as their resulting yields will be indicated in the plot.

1	plotYields(x, which = 0, out_path = NULL, out_name = "yield_plot")

`x`	a `SingleCellExperiment`.
`which`	0, numeric or character. Specifies which barcode(s) to plot. Valid values are IDs that occur as row names of `bc_key(x)`; 0 (the default) will generate a summary plot with all barcodes.
`out_path`	character string. If specified, yields plots for all barcodes specified via `which` will be written to a single PDF file in this location.
`out_name`	character strings specifying the output's file name when `!is.null(out_path)`; should be provided without(!) file type extension.

The overall yield that will be achieved upon application of the specified set of separation cutoffs is indicated in the summary plot. Respective separation thresholds and their resulting yields are included in each barcode's plot. The separation cutoff value should be chosen such that it appropriately balances confidence in barcode assignment and cell yield.

a list of ggplot objects.

Helena L Crowell helena.crowell@uzh.ch

Zunder, E.R. et al. (2015). Palladium-based mass tag cell barcoding with a doublet-filtering scheme and single-cell deconvolution algorithm. Nature Protocols 10, 316-333.

# construct SCE & apply arcsinh-transformation
data(sample_ff, sample_key)
sce <- prepData(sample_ff)

# deconvolute samples & estimate separation cutoffs
sce <- assignPrelim(sce, sample_key)
sce <- estCutoffs(sce)

# all barcodes summary plot
plotYields(sce, which = 0)

# plot for specific sample
plotYields(sce, which = "C1")