Detecting clusters of doublet cells with DE analyses
Aaron Lun
infinite.monkeys.with.keyboards@gmail.com2024-09-19
Source:vignettes/findDoubletClusters.Rmd
findDoubletClusters.Rmd
tl;dr
To demonstrate, we’ll use one of the mammary gland datasets from the scRNAseq package. We will subset it down to a random set of 500 cells for speed.
library(scRNAseq)
sce <- BachMammaryData(samples="G_2")
set.seed(1000)
sce <- sce[,sample(ncol(sce), 500)]
For the purposes of this demonstration, we’ll perform an extremely expedited analysis. One would usually take more care here and do some quality control, create some diagnostic plots, etc., but we don’t have the space for that.
library(scuttle)
sce <- logNormCounts(sce)
library(scran)
dec <- modelGeneVar(sce)
library(scater)
set.seed(1000)
sce <- runPCA(sce, ncomponents=10, subset_row=getTopHVGs(dec, n=1000))
library(bluster)
clusters <- clusterRows(reducedDim(sce, "PCA"), NNGraphParam())
sce <- runTSNE(sce, dimred="PCA")
plotTSNE(sce, colour_by=I(clusters), text_by=I(clusters))
We then run findDoubletClusters()
to test each cluster
against the null hypothesis that it does consist of doublets.
The null is rejected if a cluster has many DE genes that lie outside the
expression limits defined by the “source” clusters. On the other hand,
if num.de
is low, the cluster’s expression profile is
consistent with the doublet hypothesis.
library(scDblFinder)
tab <- findDoubletClusters(sce, clusters)
tab
## DataFrame with 7 rows and 9 columns
## source1 source2 num.de median.de best p.value
## <character> <character> <integer> <integer> <character> <numeric>
## 6 2 1 0 122 ENSMUSG00000019256 1.00000e+00
## 3 6 5 8 46 ENSMUSG00000002985 8.41352e-05
## 7 5 1 11 393 ENSMUSG00000075705 2.04690e-10
## 4 7 2 24 63 ENSMUSG00000022491 4.15645e-13
## 1 7 6 86 715 ENSMUSG00000001349 8.49703e-08
## 5 7 2 112 1007 ENSMUSG00000024610 2.38765e-11
## 2 6 5 124 336 ENSMUSG00000023505 4.06936e-06
## lib.size1 lib.size2 prop
## <numeric> <numeric> <numeric>
## 6 0.927081 0.443667 0.084
## 3 2.026090 0.859424 0.242
## 7 1.195040 1.249946 0.030
## 4 0.630479 1.646729 0.150
## 1 0.800035 2.253942 0.192
## 5 0.836792 2.185591 0.032
## 2 1.078655 0.457542 0.270
Mathematical background
Consider a cell population that has mean transcript count for gene . Assume that each population exhibits a unique scaling bias , representing the efficiency of library preparation for that population. The observed read/UMI count for each gene is then . (For simplicity, we will ignore gene-specific scaling biases, as this is easily accommodated by considering for some bias .) The expected total count for each population is .
Now, let us consider a doublet population that forms from two parent populations and . The observed read count for in is . Note that need not be any particular function of and . Rather, this relationship depends on how quickly the reverse transcription and amplification reagents are saturated during library preparation, which is difficult to make assumptions around.
Normalization by library size
We obtain log-normalized expression values for each cell based on the library size. Assume that the library size-normalized expression values are such that , i.e., the proportion of increases in compared to . The contribution of each cancels out, yielding The normalized expression value of the doublet cluster is subsequently and it is fairly easy to show that In other words, the expected library size-normalized expression of our gene in the doublet cluster lies between that of the two parents.
It is harder to provide theoretical guarantees with arbitrary size factors, which is why we only use the library sizes for normalization instead. The exception is that of spike-in size factors that would estimate directly. This would allow us to obtain estimates of for the parent clusters and of for the doublets. In this manner, we could more precisely identify doublet clusters as those where the normalized expression value is equal to the sum of the parents. Unfortunately, spike-ins are generally not available for droplet-based data sets where doublets are most problematic.
Testing for (lack of) intermediacy
We want to identify the clusters that may be comprised of doublets of other clusters. For each cluster , we test for differential expression in the library size-normalized expression profiles against every other cluster . For each pair of other clusters and , we identify genes that change in against both and in the same direction. The presence of such genes violates the intermediacy expected of a doublet cluster and provides evidence that is not a doublet of and .
Significant genes are identified by an intersection-union test on the
-values
from the pairwise comparisons between
and
or
.
(Specifically,
-tests
are used via the findMarkers()
function from scran.) The
-value
for a gene is set to unity when the signs of the log-fold changes are
not the same between comparisons. Multiple correction testing is applied
using the Benjamini-Hochberg method, and the number of genes detected at
a specified false discovery rate (usually 5%) is counted. The pair
with the fewest detected genes are considered as the putative parents of
.
In theory, it is possible to compute the Simes’ combined -value across all genes to reject the doublet hypothesis for . This would provide a more rigorous approach to ruling out potential doublet/parent combinations. However, this is very sensitive to misspecification of clusters – see below.
Calling doublet clusters
Assuming that most clusters are not comprised of doublets, we identify clusters that have an unusually low number of detected genes that violate the intermediacy condition. This is achieved by identifying small outliers on the log-transformed number of detected genes, using the median absolute deviation-based method in the function. (We use a log-transformation simply to improve resolution at low values.) Clusters are likely to be doublets if they are outliers on this metric.
Doublet clusters should also have larger library sizes than the proposed parent clusters. This is consistent with the presence of more RNA in each doublet, though the library size of the doublet cluster need not be a sum of that of the parent clusters (due to factors such as saturation and composition effects). The proportion of cells assigned to the doublet cluster should also be “reasonable”; exactly what this means depends on the experimental setup and the doublet rate of the protocol in use.
Discussion
The biggest advantage of this approach lies in its interpretability. Given a set of existing clusters, we can explicitly identify those that are likely to be doublets. We also gain some insight onto the parental origins of each putative doublet cluster, which may be of some interest. We avoid any assumptions about doublet formation that are otherwise necessary for the simulation-based methods. In particular, we do not require any knowledge about exact the relationship between and , allowing us to identify doublets even when the exact location of the doublet is unknown (e.g., due to differences in RNA content between the parent clusters).
The downside is that, of course, we are dependent on being supplied
with sensible clusters where the parental and doublet cells are
separated. The intermediacy requirement is loose enough to provide some
robustness against misspecification, but this only goes so far. In
addition, this strategy has a bias towards calling clusters with few
cells as doublets (or parents of doublets) because the DE detection
power is low. This can be somewhat offset by comparing
num.de
against median.de
as latter will be low
for clusters involved in systematically low-powered comparisons, though
it is difficult to adjust for the exact effect of the differences of
power on the IUT.
Session information
## R version 4.4.1 (2024-06-14)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 22.04.5 LTS
##
## Matrix products: default
## BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
## LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.20.so; LAPACK version 3.10.0
##
## locale:
## [1] LC_CTYPE=C.UTF-8 LC_NUMERIC=C LC_TIME=C.UTF-8
## [4] LC_COLLATE=C.UTF-8 LC_MONETARY=C.UTF-8 LC_MESSAGES=C.UTF-8
## [7] LC_PAPER=C.UTF-8 LC_NAME=C LC_ADDRESS=C
## [10] LC_TELEPHONE=C LC_MEASUREMENT=C.UTF-8 LC_IDENTIFICATION=C
##
## time zone: UTC
## tzcode source: system (glibc)
##
## attached base packages:
## [1] stats4 stats graphics grDevices utils datasets methods
## [8] base
##
## other attached packages:
## [1] scDblFinder_1.19.6 bluster_1.14.0
## [3] scater_1.32.1 ggplot2_3.5.1
## [5] scran_1.32.0 scuttle_1.14.0
## [7] ensembldb_2.28.1 AnnotationFilter_1.28.0
## [9] GenomicFeatures_1.56.0 AnnotationDbi_1.66.0
## [11] scRNAseq_2.18.0 SingleCellExperiment_1.26.0
## [13] SummarizedExperiment_1.34.0 Biobase_2.64.0
## [15] GenomicRanges_1.56.1 GenomeInfoDb_1.40.1
## [17] IRanges_2.38.1 S4Vectors_0.42.1
## [19] BiocGenerics_0.50.0 MatrixGenerics_1.16.0
## [21] matrixStats_1.4.1 BiocStyle_2.32.1
##
## loaded via a namespace (and not attached):
## [1] jsonlite_1.8.8 magrittr_2.0.3
## [3] ggbeeswarm_0.7.2 gypsum_1.0.1
## [5] farver_2.1.2 rmarkdown_2.28
## [7] fs_1.6.4 BiocIO_1.14.0
## [9] zlibbioc_1.50.0 ragg_1.3.3
## [11] vctrs_0.6.5 memoise_2.0.1
## [13] Rsamtools_2.20.0 DelayedMatrixStats_1.26.0
## [15] RCurl_1.98-1.16 htmltools_0.5.8.1
## [17] S4Arrays_1.4.1 AnnotationHub_3.12.0
## [19] curl_5.2.2 BiocNeighbors_1.22.0
## [21] xgboost_1.7.8.1 Rhdf5lib_1.26.0
## [23] SparseArray_1.4.8 rhdf5_2.48.0
## [25] sass_0.4.9 alabaster.base_1.4.2
## [27] bslib_0.8.0 desc_1.4.3
## [29] alabaster.sce_1.4.0 httr2_1.0.4
## [31] cachem_1.1.0 GenomicAlignments_1.40.0
## [33] igraph_2.0.3 mime_0.12
## [35] lifecycle_1.0.4 pkgconfig_2.0.3
## [37] rsvd_1.0.5 Matrix_1.7-0
## [39] R6_2.5.1 fastmap_1.2.0
## [41] GenomeInfoDbData_1.2.12 digest_0.6.37
## [43] colorspace_2.1-1 dqrng_0.4.1
## [45] irlba_2.3.5.1 ExperimentHub_2.12.0
## [47] textshaping_0.4.0 RSQLite_2.3.7
## [49] beachmat_2.20.0 labeling_0.4.3
## [51] filelock_1.0.3 fansi_1.0.6
## [53] httr_1.4.7 abind_1.4-8
## [55] compiler_4.4.1 bit64_4.0.5
## [57] withr_3.0.1 BiocParallel_1.38.0
## [59] viridis_0.6.5 DBI_1.2.3
## [61] highr_0.11 HDF5Array_1.32.1
## [63] alabaster.ranges_1.4.2 alabaster.schemas_1.4.0
## [65] MASS_7.3-60.2 rappdirs_0.3.3
## [67] DelayedArray_0.30.1 rjson_0.2.23
## [69] tools_4.4.1 vipor_0.4.7
## [71] beeswarm_0.4.0 glue_1.7.0
## [73] restfulr_0.0.15 rhdf5filters_1.16.0
## [75] grid_4.4.1 Rtsne_0.17
## [77] cluster_2.1.6 generics_0.1.3
## [79] gtable_0.3.5 data.table_1.16.0
## [81] metapod_1.12.0 BiocSingular_1.20.0
## [83] ScaledMatrix_1.12.0 utf8_1.2.4
## [85] XVector_0.44.0 ggrepel_0.9.6
## [87] BiocVersion_3.19.1 pillar_1.9.0
## [89] limma_3.60.4 dplyr_1.1.4
## [91] BiocFileCache_2.12.0 lattice_0.22-6
## [93] rtracklayer_1.64.0 bit_4.0.5
## [95] tidyselect_1.2.1 locfit_1.5-9.10
## [97] Biostrings_2.72.1 knitr_1.48
## [99] gridExtra_2.3 bookdown_0.40
## [101] ProtGenerics_1.36.0 edgeR_4.2.1
## [103] xfun_0.47 statmod_1.5.0
## [105] UCSC.utils_1.0.0 lazyeval_0.2.2
## [107] yaml_2.3.10 evaluate_1.0.0
## [109] codetools_0.2-20 tibble_3.2.1
## [111] alabaster.matrix_1.4.2 BiocManager_1.30.25
## [113] cli_3.6.3 systemfonts_1.1.0
## [115] munsell_0.5.1 jquerylib_0.1.4
## [117] Rcpp_1.0.13 dbplyr_2.5.0
## [119] png_0.1-8 XML_3.99-0.17
## [121] parallel_4.4.1 pkgdown_2.1.1
## [123] blob_1.2.4 sparseMatrixStats_1.16.0
## [125] bitops_1.0-8 viridisLite_0.4.2
## [127] alabaster.se_1.4.1 scales_1.3.0
## [129] purrr_1.0.2 crayon_1.5.3
## [131] rlang_1.1.4 KEGGREST_1.44.1