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.
## 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
Consider a cell population i that has mean transcript count λgi for gene g. Assume that each population exhibits a unique scaling bias si, representing the efficiency of library preparation for that population. The observed read/UMI count for each gene is then μgi = siλgi. (For simplicity, we will ignore gene-specific scaling biases, as this is easily accommodated by considering λgi ≡ ϕgλgi for some bias ϕg.) The expected total count for each population is Ni = ∑gμgi.
Now, let us consider a doublet population j that forms from two parent populations i1 and i2. The observed read count for g in j is μgj = sj(λgi1 + λgi2). Note that sj need not be any particular function of si1 and si2. 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.
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 μgi1Ni1−1 < μgi2Ni2−1, i.e., the proportion of g increases in i2 compared to i1. The contribution of each si cancels out, yielding $$ \frac{\lambda_{gi_1}}{\sum_g \lambda_{gi_1}} < \frac{\lambda_{gi_2}}{\sum_g \lambda_{gi_2}} \;. $$ The normalized expression value of the doublet cluster j is subsequently $$ \frac{\lambda_{gi_1} + \lambda_{gi_2}}{\sum_g (\lambda_{gi_1} + \lambda_{gi_2})} \;, $$ and it is fairly easy to show that $$ \frac{\lambda_{gi_1}}{\sum_g \lambda_{gi_1}} < \frac{\lambda_{gi_1} + \lambda_{gi_2}}{\sum_g (\lambda_{gi_1} + \lambda_{gi_2})} < \frac{\lambda_{gi_2}}{\sum_g \lambda_{gi_2}} \;. $$ 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 si directly. This would allow us to obtain estimates of λgi for the parent clusters and of λgi1 + λgi2 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.
We want to identify the clusters that may be comprised of doublets of other clusters. For each cluster j′, we test for differential expression in the library size-normalized expression profiles against every other cluster i′. For each pair of other clusters i′1 and i′2, we identify genes that change in j′ against both i′1 and i′2 in the same direction. The presence of such genes violates the intermediacy expected of a doublet cluster and provides evidence that j′ is not a doublet of i′1 and i′2.
Significant genes are identified by an intersection-union test on the
p-values from the pairwise
comparisons between j′ and
i′1 or i′2. (Specifically, t-tests are used via the
findMarkers()
function from scran.) The
p-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 (i′1, i′2)
with the fewest detected genes are considered as the putative parents of
j′.
In theory, it is possible to compute the Simes’ combined p-value across all genes to reject the doublet hypothesis for j′. 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.
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.
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 sj and si, 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.
## R version 4.4.2 (2024-10-31)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 24.04.1 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.26.so; LAPACK version 3.12.0
##
## locale:
## [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
## [3] LC_TIME=en_US.UTF-8 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: Etc/UTC
## tzcode source: system (glibc)
##
## attached base packages:
## [1] stats4 stats graphics grDevices utils datasets methods
## [8] base
##
## other attached packages:
## [1] bluster_1.17.0 scDblFinder_1.21.0
## [3] scater_1.35.0 ggplot2_3.5.1
## [5] scran_1.35.0 scuttle_1.17.0
## [7] ensembldb_2.31.0 AnnotationFilter_1.31.0
## [9] GenomicFeatures_1.59.1 AnnotationDbi_1.69.0
## [11] scRNAseq_2.20.0 SingleCellExperiment_1.29.1
## [13] SummarizedExperiment_1.37.0 Biobase_2.67.0
## [15] GenomicRanges_1.59.1 GenomeInfoDb_1.43.2
## [17] IRanges_2.41.1 S4Vectors_0.45.2
## [19] BiocGenerics_0.53.3 generics_0.1.3
## [21] MatrixGenerics_1.19.0 matrixStats_1.4.1
## [23] BiocStyle_2.35.0
##
## loaded via a namespace (and not attached):
## [1] sys_3.4.3 jsonlite_1.8.9 magrittr_2.0.3
## [4] ggbeeswarm_0.7.2 gypsum_1.3.0 farver_2.1.2
## [7] rmarkdown_2.29 BiocIO_1.17.1 zlibbioc_1.52.0
## [10] vctrs_0.6.5 memoise_2.0.1 Rsamtools_2.23.1
## [13] RCurl_1.98-1.16 htmltools_0.5.8.1 S4Arrays_1.7.1
## [16] AnnotationHub_3.15.0 curl_6.0.1 BiocNeighbors_2.1.1
## [19] xgboost_1.7.8.1 Rhdf5lib_1.29.0 SparseArray_1.7.2
## [22] rhdf5_2.51.0 sass_0.4.9 alabaster.base_1.7.2
## [25] bslib_0.8.0 alabaster.sce_1.7.0 httr2_1.0.7
## [28] cachem_1.1.0 buildtools_1.0.0 GenomicAlignments_1.43.0
## [31] igraph_2.1.1 mime_0.12 lifecycle_1.0.4
## [34] pkgconfig_2.0.3 rsvd_1.0.5 Matrix_1.7-1
## [37] R6_2.5.1 fastmap_1.2.0 GenomeInfoDbData_1.2.13
## [40] digest_0.6.37 colorspace_2.1-1 dqrng_0.4.1
## [43] irlba_2.3.5.1 ExperimentHub_2.15.0 RSQLite_2.3.8
## [46] beachmat_2.23.2 labeling_0.4.3 filelock_1.0.3
## [49] fansi_1.0.6 httr_1.4.7 abind_1.4-8
## [52] compiler_4.4.2 bit64_4.5.2 withr_3.0.2
## [55] BiocParallel_1.41.0 viridis_0.6.5 DBI_1.2.3
## [58] HDF5Array_1.35.2 alabaster.ranges_1.7.0 alabaster.schemas_1.7.0
## [61] MASS_7.3-61 rappdirs_0.3.3 DelayedArray_0.33.2
## [64] rjson_0.2.23 tools_4.4.2 vipor_0.4.7
## [67] beeswarm_0.4.0 glue_1.8.0 restfulr_0.0.15
## [70] rhdf5filters_1.19.0 grid_4.4.2 Rtsne_0.17
## [73] cluster_2.1.6 gtable_0.3.6 data.table_1.16.2
## [76] BiocSingular_1.23.0 ScaledMatrix_1.15.0 metapod_1.15.0
## [79] utf8_1.2.4 XVector_0.47.0 ggrepel_0.9.6
## [82] BiocVersion_3.21.1 pillar_1.9.0 limma_3.63.2
## [85] dplyr_1.1.4 BiocFileCache_2.15.0 lattice_0.22-6
## [88] rtracklayer_1.67.0 bit_4.5.0 tidyselect_1.2.1
## [91] locfit_1.5-9.10 maketools_1.3.1 Biostrings_2.75.1
## [94] knitr_1.49 gridExtra_2.3 ProtGenerics_1.39.0
## [97] edgeR_4.5.0 xfun_0.49 statmod_1.5.0
## [100] UCSC.utils_1.3.0 lazyeval_0.2.2 yaml_2.3.10
## [103] evaluate_1.0.1 codetools_0.2-20 tibble_3.2.1
## [106] alabaster.matrix_1.7.2 BiocManager_1.30.25 cli_3.6.3
## [109] munsell_0.5.1 jquerylib_0.1.4 Rcpp_1.0.13-1
## [112] dbplyr_2.5.0 png_0.1-8 XML_3.99-0.17
## [115] parallel_4.4.2 blob_1.2.4 bitops_1.0-9
## [118] viridisLite_0.4.2 alabaster.se_1.7.0 scales_1.3.0
## [121] purrr_1.0.2 crayon_1.5.3 rlang_1.1.4
## [124] KEGGREST_1.47.0