# Grun human pancreas (CEL-seq2) ## Introduction This workflow performs an analysis of the @grun2016denovo CEL-seq2 dataset consisting of human pancreas cells from various donors. ## Data loading ```r library(scRNAseq) sce.grun <- GrunPancreasData() ``` We convert to Ensembl identifiers, and we remove duplicated genes or genes without Ensembl IDs. ```r library(org.Hs.eg.db) gene.ids <- mapIds(org.Hs.eg.db, keys=rowData(sce.grun)$symbol, keytype="SYMBOL", column="ENSEMBL") keep <- !is.na(gene.ids) & !duplicated(gene.ids) sce.grun <- sce.grun[keep,] rownames(sce.grun) <- gene.ids[keep] ``` ## Quality control ```r unfiltered <- sce.grun ``` This dataset lacks mitochondrial genes so we will do without them for quality control. We compute the median and MAD while blocking on the donor; for donors where the assumption of a majority of high-quality cells seems to be violated (Figure \@ref(fig:unref-grun-qc-dist)), we compute an appropriate threshold using the other donors as specified in the `subset=` argument. ```r library(scater) stats <- perCellQCMetrics(sce.grun) qc <- quickPerCellQC(stats, percent_subsets="altexps_ERCC_percent", batch=sce.grun$donor, subset=sce.grun$donor %in% c("D17", "D7", "D2")) sce.grun <- sce.grun[,!qc$discard] ``` ```r colData(unfiltered) <- cbind(colData(unfiltered), stats) unfiltered$discard <- qc$discard gridExtra::grid.arrange( plotColData(unfiltered, x="donor", y="sum", colour_by="discard") + scale_y_log10() + ggtitle("Total count"), plotColData(unfiltered, x="donor", y="detected", colour_by="discard") + scale_y_log10() + ggtitle("Detected features"), plotColData(unfiltered, x="donor", y="altexps_ERCC_percent", colour_by="discard") + ggtitle("ERCC percent"), ncol=2 ) ```
Distribution of each QC metric across cells from each donor of the Grun pancreas dataset. Each point represents a cell and is colored according to whether that cell was discarded.

(\#fig:unref-grun-qc-dist)Distribution of each QC metric across cells from each donor of the Grun pancreas dataset. Each point represents a cell and is colored according to whether that cell was discarded.

```r colSums(as.matrix(qc), na.rm=TRUE) ``` ``` ## low_lib_size low_n_features high_altexps_ERCC_percent ## 452 511 606 ## discard ## 665 ``` ## Normalization ```r library(scran) set.seed(1000) # for irlba. clusters <- quickCluster(sce.grun) sce.grun <- computeSumFactors(sce.grun, clusters=clusters) sce.grun <- logNormCounts(sce.grun) ``` ```r summary(sizeFactors(sce.grun)) ``` ``` ## Min. 1st Qu. Median Mean 3rd Qu. Max. ## 0.099 0.499 0.794 1.000 1.227 11.884 ``` ```r plot(librarySizeFactors(sce.grun), sizeFactors(sce.grun), pch=16, xlab="Library size factors", ylab="Deconvolution factors", log="xy") ```
Relationship between the library size factors and the deconvolution size factors in the Grun pancreas dataset.

(\#fig:unref-grun-norm)Relationship between the library size factors and the deconvolution size factors in the Grun pancreas dataset.

## Variance modelling We block on a combined plate and donor factor. ```r block <- paste0(sce.grun$sample, "_", sce.grun$donor) dec.grun <- modelGeneVarWithSpikes(sce.grun, spikes="ERCC", block=block) top.grun <- getTopHVGs(dec.grun, prop=0.1) ``` We examine the number of cells in each level of the blocking factor. ```r table(block) ``` ``` ## block ## CD13+ sorted cells_D17 CD24+ CD44+ live sorted cells_D17 ## 86 87 ## CD63+ sorted cells_D10 TGFBR3+ sorted cells_D17 ## 40 90 ## exocrine fraction, live sorted cells_D2 exocrine fraction, live sorted cells_D3 ## 82 7 ## live sorted cells, library 1_D10 live sorted cells, library 1_D17 ## 33 88 ## live sorted cells, library 1_D3 live sorted cells, library 1_D7 ## 25 85 ## live sorted cells, library 2_D10 live sorted cells, library 2_D17 ## 35 83 ## live sorted cells, library 2_D3 live sorted cells, library 2_D7 ## 27 84 ## live sorted cells, library 3_D3 live sorted cells, library 3_D7 ## 16 83 ## live sorted cells, library 4_D3 live sorted cells, library 4_D7 ## 29 83 ``` ```r par(mfrow=c(6,3)) blocked.stats <- dec.grun$per.block for (i in colnames(blocked.stats)) { current <- blocked.stats[[i]] plot(current$mean, current$total, main=i, pch=16, cex=0.5, xlab="Mean of log-expression", ylab="Variance of log-expression") curfit <- metadata(current) points(curfit$mean, curfit$var, col="red", pch=16) curve(curfit$trend(x), col='dodgerblue', add=TRUE, lwd=2) } ```
Per-gene variance as a function of the mean for the log-expression values in the Grun pancreas dataset. Each point represents a gene (black) with the mean-variance trend (blue) fitted to the spike-in transcripts (red) separately for each donor.

(\#fig:unref-416b-variance)Per-gene variance as a function of the mean for the log-expression values in the Grun pancreas dataset. Each point represents a gene (black) with the mean-variance trend (blue) fitted to the spike-in transcripts (red) separately for each donor.

## Data integration ```r library(batchelor) set.seed(1001010) merged.grun <- fastMNN(sce.grun, subset.row=top.grun, batch=sce.grun$donor) ``` ```r metadata(merged.grun)$merge.info$lost.var ``` ``` ## D10 D17 D2 D3 D7 ## [1,] 0.029649 0.030526 0.000000 0.00000 0.00000 ## [2,] 0.007617 0.012135 0.037904 0.00000 0.00000 ## [3,] 0.004059 0.005165 0.007903 0.05212 0.00000 ## [4,] 0.013790 0.016263 0.016526 0.01525 0.05497 ``` ## Dimensionality reduction ```r set.seed(100111) merged.grun <- runTSNE(merged.grun, dimred="corrected") ``` ## Clustering ```r snn.gr <- buildSNNGraph(merged.grun, use.dimred="corrected") colLabels(merged.grun) <- factor(igraph::cluster_walktrap(snn.gr)$membership) ``` ```r table(Cluster=colLabels(merged.grun), Donor=merged.grun$batch) ``` ``` ## Donor ## Cluster D10 D17 D2 D3 D7 ## 1 17 74 3 2 78 ## 2 6 12 5 7 8 ## 3 12 128 0 0 61 ## 4 27 107 43 13 115 ## 5 32 70 31 80 29 ## 6 5 13 0 0 10 ## 7 4 13 0 0 1 ## 8 5 17 0 2 33 ``` ```r gridExtra::grid.arrange( plotTSNE(merged.grun, colour_by="label"), plotTSNE(merged.grun, colour_by="batch"), ncol=2 ) ```
Obligatory $t$-SNE plots of the Grun pancreas dataset. Each point represents a cell that is colored by cluster (left) or batch (right).

(\#fig:unref-grun-tsne)Obligatory $t$-SNE plots of the Grun pancreas dataset. Each point represents a cell that is colored by cluster (left) or batch (right).

## Session Info {-}
``` R version 4.2.1 (2022-06-23) Platform: x86_64-pc-linux-gnu (64-bit) Running under: Ubuntu 20.04.5 LTS Matrix products: default BLAS: /home/biocbuild/bbs-3.16-bioc/R/lib/libRblas.so LAPACK: /home/biocbuild/bbs-3.16-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] batchelor_1.14.0 scran_1.26.0 [3] scater_1.26.0 ggplot2_3.3.6 [5] scuttle_1.8.0 org.Hs.eg.db_3.16.0 [7] AnnotationDbi_1.60.0 scRNAseq_2.11.0 [9] SingleCellExperiment_1.20.0 SummarizedExperiment_1.28.0 [11] Biobase_2.58.0 GenomicRanges_1.50.0 [13] GenomeInfoDb_1.34.0 IRanges_2.32.0 [15] S4Vectors_0.36.0 BiocGenerics_0.44.0 [17] MatrixGenerics_1.10.0 matrixStats_0.62.0 [19] BiocStyle_2.26.0 rebook_1.8.0 loaded via a namespace (and not attached): [1] AnnotationHub_3.6.0 BiocFileCache_2.6.0 [3] igraph_1.3.5 lazyeval_0.2.2 [5] BiocParallel_1.32.0 digest_0.6.30 [7] ensembldb_2.22.0 htmltools_0.5.3 [9] viridis_0.6.2 fansi_1.0.3 [11] magrittr_2.0.3 memoise_2.0.1 [13] ScaledMatrix_1.6.0 cluster_2.1.4 [15] limma_3.54.0 Biostrings_2.66.0 [17] prettyunits_1.1.1 colorspace_2.0-3 [19] blob_1.2.3 rappdirs_0.3.3 [21] ggrepel_0.9.1 xfun_0.34 [23] dplyr_1.0.10 crayon_1.5.2 [25] RCurl_1.98-1.9 jsonlite_1.8.3 [27] graph_1.76.0 glue_1.6.2 [29] gtable_0.3.1 zlibbioc_1.44.0 [31] XVector_0.38.0 DelayedArray_0.24.0 [33] BiocSingular_1.14.0 scales_1.2.1 [35] edgeR_3.40.0 DBI_1.1.3 [37] Rcpp_1.0.9 viridisLite_0.4.1 [39] xtable_1.8-4 progress_1.2.2 [41] dqrng_0.3.0 bit_4.0.4 [43] rsvd_1.0.5 ResidualMatrix_1.8.0 [45] metapod_1.6.0 httr_1.4.4 [47] dir.expiry_1.6.0 ellipsis_0.3.2 [49] pkgconfig_2.0.3 XML_3.99-0.12 [51] farver_2.1.1 CodeDepends_0.6.5 [53] sass_0.4.2 dbplyr_2.2.1 [55] locfit_1.5-9.6 utf8_1.2.2 [57] labeling_0.4.2 tidyselect_1.2.0 [59] rlang_1.0.6 later_1.3.0 [61] munsell_0.5.0 BiocVersion_3.16.0 [63] tools_4.2.1 cachem_1.0.6 [65] cli_3.4.1 generics_0.1.3 [67] RSQLite_2.2.18 ExperimentHub_2.6.0 [69] evaluate_0.17 stringr_1.4.1 [71] fastmap_1.1.0 yaml_2.3.6 [73] knitr_1.40 bit64_4.0.5 [75] purrr_0.3.5 KEGGREST_1.38.0 [77] AnnotationFilter_1.22.0 sparseMatrixStats_1.10.0 [79] mime_0.12 xml2_1.3.3 [81] biomaRt_2.54.0 compiler_4.2.1 [83] beeswarm_0.4.0 filelock_1.0.2 [85] curl_4.3.3 png_0.1-7 [87] interactiveDisplayBase_1.36.0 statmod_1.4.37 [89] tibble_3.1.8 bslib_0.4.0 [91] stringi_1.7.8 highr_0.9 [93] GenomicFeatures_1.50.0 bluster_1.8.0 [95] lattice_0.20-45 ProtGenerics_1.30.0 [97] Matrix_1.5-1 vctrs_0.5.0 [99] pillar_1.8.1 lifecycle_1.0.3 [101] BiocManager_1.30.19 jquerylib_0.1.4 [103] BiocNeighbors_1.16.0 cowplot_1.1.1 [105] bitops_1.0-7 irlba_2.3.5.1 [107] httpuv_1.6.6 rtracklayer_1.58.0 [109] R6_2.5.1 BiocIO_1.8.0 [111] bookdown_0.29 promises_1.2.0.1 [113] gridExtra_2.3 vipor_0.4.5 [115] codetools_0.2-18 assertthat_0.2.1 [117] rjson_0.2.21 withr_2.5.0 [119] GenomicAlignments_1.34.0 Rsamtools_2.14.0 [121] GenomeInfoDbData_1.2.9 parallel_4.2.1 [123] hms_1.1.2 grid_4.2.1 [125] beachmat_2.14.0 rmarkdown_2.17 [127] DelayedMatrixStats_1.20.0 Rtsne_0.16 [129] shiny_1.7.3 ggbeeswarm_0.6.0 [131] restfulr_0.0.15 ```