Description Usage Arguments Details Value Author(s) See Also Examples
A convenient utility that identifies low-quality cells based on frequently used QC metrics.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | quickPerCellQC(x, ...)
## S4 method for signature 'ANY'
quickPerCellQC(
x,
sum.field = "sum",
detected.field = "detected",
sub.fields = NULL,
...,
lib_size = NULL,
n_features = NULL,
percent_subsets = NULL
)
## S4 method for signature 'SummarizedExperiment'
quickPerCellQC(
x,
...,
subsets = NULL,
assay.type = "counts",
other.args = list()
)
|
x |
A DataFrame containing per-cell QC statistics, as computed by |
... |
For the generic, further arguments to pass to specific methods. For the ANY method, further arguments to pass to For the SummarizedExperiment method, further arguments to pass to the ANY method. |
sum.field |
String specifying the column of |
detected.field |
String specifying the column of |
sub.fields |
Character vector specifying the column(s) of If set to |
lib_size, n_features, percent_subsets |
Soft-deprecated equivalents of the arguments above. |
subsets, assay.type |
Arguments to pass to the |
other.args |
A named list containing other arguments to pass to the |
The ANY method simply calls isOutlier
on the various QC metrics in x
.
For sum.field
, small outliers are detected.
These are considered to represent low-quality cells that have not been insufficiently sequenced.
Detection is performed on the log-scale to adjust for a heavy right tail and to improve resolution at zero.
For detected.field
, small outliers are detected.
These are considered to represent low-quality cells with low-complexity libraries.
Detection is performed on the log-scale to adjust for a heavy right tail.
This is done on the log-scale to adjust for a heavy right tail and to improve resolution at zero.
For each column specified by sub.fields
, large outliers are detected.
This aims to remove cells with high spike-in or mitochondrial content, usually corresponding to damaged cells.
While these distributions often have heavy right tails, the putative low-quality cells are often present in this tail;
thus, transformation is not performed to ensure maintain resolution of the filter.
Users can control the outlier detection (e.g., change the number of MADs, specify batches)
by passing appropriate arguments to ...
.
The SummarizedExperiment method calls perCellQCMetrics
before running outlier detection.
This is simply a convenient wrapper that avoids the need for two separate function calls in routine applications.
A DataFrame with one row per cell and containing columns of logical vectors.
Each column specifies a reason for why a cell was considered to be low quality,
with the final discard
column indicating whether the cell should be discarded.
Aaron Lun
perCellQCMetrics
, for calculation of these metrics.
isOutlier
, to identify outliers with a MAD-based approach.
1 2 3 4 5 6 | example_sce <- mockSCE()
x <- perCellQCMetrics(example_sce, subsets=list(Mito=1:100))
discarded <- quickPerCellQC(x, percent_subsets=c(
"subsets_Mito_percent", "altexps_Spikes_percent"))
colSums(as.data.frame(discarded))
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.