Contents

The scDblFinder package gathers various methods for the detection and handling of doublets/multiplets in single-cell RNA sequencing data (i.e. multiple cells captured within the same droplet or reaction volumne). This vignette provides a brief overview of the different approaches, which are covered in their own vignettes. For a more general introduction to the topic, refer to the OCSA book.

All methods require as an input either a matrix of counts or a SingleCellExperiment containing count data. With the exception of findDoubletClusters, which operates at the level of clusters (and consequently requires clustering information), all methods try to assign each cell a score indicating its likelihood (broadly understood) of being a doublet.

The approaches described here are complementary to doublets identified via cell hashes and SNPs in multiplexed samples: while hashing/genotypes can identify doublets formed by cells of the same type (homotypic doublets) from two samples, which are often nearly undistinguishable from real cells transcriptionally (and hence generally unidentifiable through the present package), it cannot identify doublets made by cells of the same sample, even if they are heterotypic (formed by different cell types). Instead, the methods presented here are primarily geared towards the identification of heterotypic doublets, which for most purposes are also the most critical ones.


0.1 computeDoubletDensity

The computeDoubletDensity method (formerly scran::doubletCells) generates random artificial doublets from the real cells, and tries to identify cells whose neighborhood has a high local density of articial doublets. See computeDoubletDensity for more information.

0.2 recoverDoublets

The recoverDoublets method is meant to be used when some doublets are already known, for instance through genotype-based calls or cell hashing in multiplexed experiments. The function then tries to identify intra-sample doublets that are neighbors to the known inter-sample doublets. See recoverDoublets for more information.

0.3 scDblFinder

The scDblFinder method combines both known doublets (if available) and cluster-based artificial doublets to identify doublets. The approach builds and improves on a variety of earlier efforts, and is at present the most accurate approach included in this package. See scDblFinder for more information.

0.4 directDblClassification

The directDblClassification method identifies doublets by training a classifier directly on gene expression. This follows the same procedure as scDblFinder for doublet generation and iterative training, but skips the k-nearest neighbor step and directly uses the matrix of real cells and artificial doublets. This is computationally more intensive and generally leads to worse predictions than scDblFinder, and it is included chiefly for comparative purposes. See ?directDblClassification for more information.

0.5 findDoubletClusters

The findDoubletClusters method identifies clusters that are likely to be composed of doublets by estimating whether their expression profile lies between two other clusters. See findDoubletClusters for more information.


1 Installation

if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")
BiocManager::install("scDblFinder")

# or, to get that latest developments:
BiocManager::install("plger/scDblFinder")

Session information

sessionInfo()
## R version 4.1.1 (2021-08-10)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.3 LTS
## 
## Matrix products: default
## BLAS:   /home/biocbuild/bbs-3.14-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.14-bioc/R/lib/libRlapack.so
## 
## 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       
## 
## attached base packages:
## [1] stats4    stats     graphics  grDevices utils     datasets  methods  
## [8] base     
## 
## other attached packages:
##  [1] bluster_1.4.0               scDblFinder_1.8.0          
##  [3] scater_1.22.0               ggplot2_3.3.5              
##  [5] scran_1.22.0                scuttle_1.4.0              
##  [7] ensembldb_2.18.0            AnnotationFilter_1.18.0    
##  [9] GenomicFeatures_1.46.0      AnnotationDbi_1.56.0       
## [11] scRNAseq_2.7.2              SingleCellExperiment_1.16.0
## [13] SummarizedExperiment_1.24.0 Biobase_2.54.0             
## [15] GenomicRanges_1.46.0        GenomeInfoDb_1.30.0        
## [17] IRanges_2.28.0              S4Vectors_0.32.0           
## [19] BiocGenerics_0.40.0         MatrixGenerics_1.6.0       
## [21] matrixStats_0.61.0          BiocStyle_2.22.0           
## 
## loaded via a namespace (and not attached):
##   [1] AnnotationHub_3.2.0           BiocFileCache_2.2.0          
##   [3] igraph_1.2.7                  lazyeval_0.2.2               
##   [5] BiocParallel_1.28.0           digest_0.6.28                
##   [7] htmltools_0.5.2               magick_2.7.3                 
##   [9] viridis_0.6.2                 fansi_0.5.0                  
##  [11] magrittr_2.0.1                memoise_2.0.0                
##  [13] ScaledMatrix_1.2.0            cluster_2.1.2                
##  [15] limma_3.50.0                  Biostrings_2.62.0            
##  [17] prettyunits_1.1.1             colorspace_2.0-2             
##  [19] ggrepel_0.9.1                 blob_1.2.2                   
##  [21] rappdirs_0.3.3                xfun_0.27                    
##  [23] dplyr_1.0.7                   crayon_1.4.1                 
##  [25] RCurl_1.98-1.5                jsonlite_1.7.2               
##  [27] glue_1.4.2                    gtable_0.3.0                 
##  [29] zlibbioc_1.40.0               XVector_0.34.0               
##  [31] DelayedArray_0.20.0           BiocSingular_1.10.0          
##  [33] scales_1.1.1                  DBI_1.1.1                    
##  [35] edgeR_3.36.0                  Rcpp_1.0.7                   
##  [37] viridisLite_0.4.0             xtable_1.8-4                 
##  [39] progress_1.2.2                dqrng_0.3.0                  
##  [41] bit_4.0.4                     rsvd_1.0.5                   
##  [43] metapod_1.2.0                 httr_1.4.2                   
##  [45] ellipsis_0.3.2                farver_2.1.0                 
##  [47] pkgconfig_2.0.3               XML_3.99-0.8                 
##  [49] sass_0.4.0                    dbplyr_2.1.1                 
##  [51] locfit_1.5-9.4                utf8_1.2.2                   
##  [53] labeling_0.4.2                tidyselect_1.1.1             
##  [55] rlang_0.4.12                  later_1.3.0                  
##  [57] munsell_0.5.0                 BiocVersion_3.14.0           
##  [59] tools_4.1.1                   cachem_1.0.6                 
##  [61] xgboost_1.4.1.1               generics_0.1.1               
##  [63] RSQLite_2.2.8                 ExperimentHub_2.2.0          
##  [65] evaluate_0.14                 stringr_1.4.0                
##  [67] fastmap_1.1.0                 yaml_2.2.1                   
##  [69] knitr_1.36                    bit64_4.0.5                  
##  [71] purrr_0.3.4                   KEGGREST_1.34.0              
##  [73] sparseMatrixStats_1.6.0       mime_0.12                    
##  [75] xml2_1.3.2                    biomaRt_2.50.0               
##  [77] compiler_4.1.1                beeswarm_0.4.0               
##  [79] filelock_1.0.2                curl_4.3.2                   
##  [81] png_0.1-7                     interactiveDisplayBase_1.32.0
##  [83] tibble_3.1.5                  statmod_1.4.36               
##  [85] bslib_0.3.1                   stringi_1.7.5                
##  [87] highr_0.9                     lattice_0.20-45              
##  [89] ProtGenerics_1.26.0           Matrix_1.3-4                 
##  [91] vctrs_0.3.8                   pillar_1.6.4                 
##  [93] lifecycle_1.0.1               BiocManager_1.30.16          
##  [95] jquerylib_0.1.4               BiocNeighbors_1.12.0         
##  [97] cowplot_1.1.1                 data.table_1.14.2            
##  [99] bitops_1.0-7                  irlba_2.3.3                  
## [101] httpuv_1.6.3                  rtracklayer_1.54.0           
## [103] R6_2.5.1                      BiocIO_1.4.0                 
## [105] bookdown_0.24                 promises_1.2.0.1             
## [107] gridExtra_2.3                 vipor_0.4.5                  
## [109] MASS_7.3-54                   assertthat_0.2.1             
## [111] rjson_0.2.20                  withr_2.4.2                  
## [113] GenomicAlignments_1.30.0      Rsamtools_2.10.0             
## [115] GenomeInfoDbData_1.2.7        parallel_4.1.1               
## [117] hms_1.1.1                     grid_4.1.1                   
## [119] beachmat_2.10.0               rmarkdown_2.11               
## [121] DelayedMatrixStats_1.16.0     Rtsne_0.15                   
## [123] shiny_1.7.1                   ggbeeswarm_0.6.0             
## [125] restfulr_0.0.13