scuttle 1.10.3
scuttle provides various low-level utilities for single-cell RNA-seq data analysis, typically used at the start of the analysis workflows or within high-level functions in other packages. This vignette will discuss the use of scaling normalization for removing cell-specific biases. To demonstrate, we will obtain the classic Zeisel dataset from the scRNAseq package and apply some quick quality control to remove damaged cells.
library(scRNAseq)
sce <- ZeiselBrainData()
library(scuttle)
sce <- quickPerCellQC(sce, subsets=list(Mito=grep("mt-", rownames(sce))),
sub.fields=c("subsets_Mito_percent", "altexps_ERCC_percent"))
sce## class: SingleCellExperiment
## dim: 20006 2816
## metadata(0):
## assays(1): counts
## rownames(20006): Tspan12 Tshz1 ... mt-Rnr1 mt-Nd4l
## rowData names(1): featureType
## colnames(2816): 1772071015_C02 1772071017_G12 ... 1772063068_D01
## 1772066098_A12
## colData names(27): tissue group # ... high_altexps_ERCC_percent discard
## reducedDimNames(0):
## mainExpName: endogenous
## altExpNames(2): ERCC repeatNote: A more comprehensive description of the use of scuttle functions (along with other packages) in a scRNA-seq analysis workflow is available at https://osca.bioconductor.org.
Scaling normalization involves dividing the counts for each cell by a cell-specific “size factor” to adjust for uninteresting differences in sequencing depth and capture efficiency.
The librarySizeFactors() function provides a simple definition of the size factor for each cell,
computed as the library size of each cell after scaling them to have a mean of 1 across all cells.
This is fast but inaccurate in the presence of differential expression between cells that introduce composition biases.
summary(librarySizeFactors(sce))## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 0.1757 0.5680 0.8680 1.0000 1.2783 4.0839The geometricSizeFactors() function instead computes the geometric mean within each cell.
This is more robust to composition biases but is only accurate when the counts are large and there are few zeroes.
summary(geometricSizeFactors(sce))## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 0.8261 0.9104 0.9758 1.0000 1.0640 1.5189The medianSizeFactors() function uses a DESeq2-esque approach based on the median ratio from an average pseudo-cell.
Briefly, we assume that most genes are non-DE, such that any systematic fold difference in coverage (as defined by the median ratio) represents technical biases that must be removed.
This is highly robust to composition biases but relies on sufficient sequencing coverage to obtain well-defined ratios.
summary(medianSizeFactors(sce))## Min. 1st Qu. Median Mean 3rd Qu. Max. NA's
## NA NA NA NaN NA NA 2816All of these size factors can be stored in the SingleCellExperiment via the sizeFactors<-() setter function.
Most downstream functions will pick these up automatically for any calculations that rely on size factors.
sizeFactors(sce) <- librarySizeFactors(sce)Alternatively, functions like computeLibraryFactors() can automatically compute and attach the size factors to our SingleCellExperiment object.
sce <- computeLibraryFactors(sce)
summary(sizeFactors(sce))## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 0.1757 0.5680 0.8680 1.0000 1.2783 4.0839The computePooledFactors method implements the pooling strategy for scaling normalization.
This uses an approach similar to medianSizeFactors() to remove composition biases,
but pools cells together to overcome problems with discreteness at low counts.
Per-cell factors are then obtained from the pools using a deconvolution strategy.
library(scran)
clusters <- quickCluster(sce)
sce <- computePooledFactors(sce, clusters=clusters)
summary(sizeFactors(sce))## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 0.1340 0.4910 0.8281 1.0000 1.3181 4.4579For larger data sets, a rough clustering should be performed prior to normalization.
computePooledFactors() will then automatically apply normalization within each cluster first, before adjusting the scaling factors to be comparable across clusters.
This reduces the risk of violating our assumptions (of a non-DE majority of genes) when many genes are DE between clusters in a heterogeneous population.
In this case, we use the quickCluster() function from the scran package, but any clustering function can be used, for example:
sce <- computePooledFactors(sce, clusters=sce$level1class)
summary(sizeFactors(sce))## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 0.1322 0.4797 0.8265 1.0000 1.3355 4.4953We assume that quality control on the cells has already been performed prior to running this function. Low-quality cells with few expressed genes can often have negative size factor estimates.
An alternative approach is to normalize based on the spike-in counts. The idea is that the same quantity of spike-in RNA was added to each cell prior to library preparation. Size factors are computed to scale the counts such that the total coverage of the spike-in transcripts is equal across cells.
sce2 <- computeSpikeFactors(sce, "ERCC")
summary(sizeFactors(sce2))## Min. 1st Qu. Median Mean 3rd Qu. Max.
## 0.1600 0.7746 0.9971 1.0000 1.1851 3.4923The main practical difference from the other strategies is that spike-in normalization preserves differences in total RNA content between cells, whereas computePooledFactors and other non-DE methods do not.
This can be important in certain applications where changes in total RNA content are associated with a biological phenomenon of interest.
Regardless of which size factor calculation we pick, the calculation of normalized expression values simply involves dividing each count by the size factor for the cell.
This eliminates the cell-specific scaling effect for valid comparisons between cells in downstream analyses.
The simplest approach to computing these values is to use the logNormCounts() function:
sce <- logNormCounts(sce)
assayNames(sce)## [1] "counts" "logcounts"This computes log2-transformed normalized expression values by adding a constant pseudo-count and log-transforming.
The resulting values can be roughly interpreted on the same scale as log-transformed counts and are stored in "logcounts".
This is the most common expression measure for downstream analyses as differences between values can be treated as log-fold changes.
For example, Euclidean distances between cells are analogous to the average log-fold change across genes.
Of course, users can construct any arbitrary matrix of the same dimensions as the count matrix and store it as an assay.
Here, we use the normalizeCounts() function to perform some custom normalization with random size factors.
assay(sce, "normed") <- normalizeCounts(sce, log=FALSE,
size.factors=runif(ncol(sce)), pseudo.count=1.5)scuttle can also calculate counts-per-million using the aptly-named calculateCPM() function.
The output is most appropriately stored as an assay named "cpm" in the assays of the SingleCellExperiment object.
Related functions include calculateTPM() and calculateFPKM(), which do pretty much as advertised.
assay(sce, "cpm") <- calculateCPM(sce)sessionInfo()## R version 4.3.1 (2023-06-16)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 22.04.3 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.17-bioc/R/lib/libRblas.so
## LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.10.0
##
## locale:
## [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
## [3] LC_TIME=en_GB LC_COLLATE=C
## [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
## [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
## [9] LC_ADDRESS=C LC_TELEPHONE=C
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
##
## time zone: America/New_York
## tzcode source: system (glibc)
##
## attached base packages:
## [1] stats4 stats graphics grDevices utils datasets methods
## [8] base
##
## other attached packages:
## [1] scran_1.28.2 ensembldb_2.24.1
## [3] AnnotationFilter_1.24.0 GenomicFeatures_1.52.2
## [5] AnnotationDbi_1.62.2 scuttle_1.10.3
## [7] scRNAseq_2.14.0 SingleCellExperiment_1.22.0
## [9] SummarizedExperiment_1.30.2 Biobase_2.60.0
## [11] GenomicRanges_1.52.1 GenomeInfoDb_1.36.4
## [13] IRanges_2.34.1 S4Vectors_0.38.2
## [15] BiocGenerics_0.46.0 MatrixGenerics_1.12.3
## [17] matrixStats_1.0.0 BiocStyle_2.28.1
##
## loaded via a namespace (and not attached):
## [1] jsonlite_1.8.7 magrittr_2.0.3
## [3] rmarkdown_2.25 BiocIO_1.10.0
## [5] zlibbioc_1.46.0 vctrs_0.6.3
## [7] memoise_2.0.1 Rsamtools_2.16.0
## [9] DelayedMatrixStats_1.22.6 RCurl_1.98-1.12
## [11] htmltools_0.5.6.1 S4Arrays_1.0.6
## [13] progress_1.2.2 AnnotationHub_3.8.0
## [15] curl_5.1.0 BiocNeighbors_1.18.0
## [17] sass_0.4.7 bslib_0.5.1
## [19] cachem_1.0.8 GenomicAlignments_1.36.0
## [21] igraph_1.5.1 mime_0.12
## [23] lifecycle_1.0.3 pkgconfig_2.0.3
## [25] rsvd_1.0.5 Matrix_1.6-1.1
## [27] R6_2.5.1 fastmap_1.1.1
## [29] GenomeInfoDbData_1.2.10 shiny_1.7.5
## [31] digest_0.6.33 dqrng_0.3.1
## [33] irlba_2.3.5.1 ExperimentHub_2.8.1
## [35] RSQLite_2.3.1 beachmat_2.16.0
## [37] filelock_1.0.2 fansi_1.0.5
## [39] httr_1.4.7 abind_1.4-5
## [41] compiler_4.3.1 bit64_4.0.5
## [43] withr_2.5.1 BiocParallel_1.34.2
## [45] DBI_1.1.3 biomaRt_2.56.1
## [47] rappdirs_0.3.3 DelayedArray_0.26.7
## [49] rjson_0.2.21 bluster_1.10.0
## [51] tools_4.3.1 interactiveDisplayBase_1.38.0
## [53] httpuv_1.6.11 glue_1.6.2
## [55] restfulr_0.0.15 promises_1.2.1
## [57] grid_4.3.1 cluster_2.1.4
## [59] generics_0.1.3 hms_1.1.3
## [61] BiocSingular_1.16.0 ScaledMatrix_1.8.1
## [63] metapod_1.8.0 xml2_1.3.5
## [65] utf8_1.2.3 XVector_0.40.0
## [67] BiocVersion_3.17.1 pillar_1.9.0
## [69] stringr_1.5.0 limma_3.56.2
## [71] later_1.3.1 dplyr_1.1.3
## [73] BiocFileCache_2.8.0 lattice_0.21-9
## [75] rtracklayer_1.60.1 bit_4.0.5
## [77] tidyselect_1.2.0 locfit_1.5-9.8
## [79] Biostrings_2.68.1 knitr_1.44
## [81] bookdown_0.35 ProtGenerics_1.32.0
## [83] edgeR_3.42.4 xfun_0.40
## [85] statmod_1.5.0 stringi_1.7.12
## [87] lazyeval_0.2.2 yaml_2.3.7
## [89] evaluate_0.22 codetools_0.2-19
## [91] tibble_3.2.1 BiocManager_1.30.22
## [93] cli_3.6.1 xtable_1.8-4
## [95] jquerylib_0.1.4 Rcpp_1.0.11
## [97] dbplyr_2.3.4 png_0.1-8
## [99] XML_3.99-0.14 parallel_4.3.1
## [101] ellipsis_0.3.2 blob_1.2.4
## [103] prettyunits_1.2.0 sparseMatrixStats_1.12.2
## [105] bitops_1.0-7 purrr_1.0.2
## [107] crayon_1.5.2 rlang_1.1.1
## [109] KEGGREST_1.40.1