scDesign3 Quickstart
Dongyuan Song
Bioinformatics IDP, University of California, Los Angelesdongyuansong@ucla.edu
Qingyang Wang
Department of Statistics, University of California, Los Angelesqw802@g.ucla.edu
21 August 2024
Source:../../vignettes/scDesign3.Rmd
scDesign3.Rmd
Introduction
scDesign3 is a unified probabilistic framework that generates realistic in silico high-dimensional single-cell omics data of various cell states, including discrete cell types, continuous trajectories, and spatial locations by learning from real datasets. Since the functions of scDesign3 is very comprehensive, here we only introduce how scDesign3 simulates an scRNA-seq dataset with one continuous developmental trajectory. For more information, please check the Articles on our website: (https://songdongyuan1994.github.io/scDesign3/docs/index.html).
Read in the reference data
The raw data is from the scvelo, which describes pancreatic endocrinogenesis. We pre-select the top 1000 highly variable genes and filter out some cell types to ensure a single trajectory.
example_sce <- readRDS((url("https://figshare.com/ndownloader/files/40581992")))
print(example_sce)
#> class: SingleCellExperiment
#> dim: 1000 2087
#> metadata(5): clusters_coarse_colors clusters_colors day_colors
#> neighbors pca
#> assays(6): X spliced ... cpm logcounts
#> rownames(1000): Pyy Iapp ... Eya2 Kif21a
#> rowData names(1): highly_variable_genes
#> colnames(2087): AAACCTGAGAGGGATA AAACCTGGTAAGTGGC ... TTTGTCAAGTGACATA
#> TTTGTCAAGTGTGGCA
#> colData names(7): clusters_coarse clusters ... sizeFactor pseudotime
#> reducedDimNames(4): X_pca X_umap PCA UMAP
#> mainExpName: NULL
#> altExpNames(0):
To save computational time, we only use the top 100 genes.
example_sce <- example_sce[1:100, ]
Simulation
The function scdesign3()
takes in a
SinglecellExperiment
object with the cell covariates (such
as cell types, pseudotime, or spatial coordinates) stored in the
colData
of the SinglecellExperiment
object.
set.seed(123)
example_simu <- scdesign3(
sce = example_sce,
assay_use = "counts",
celltype = "cell_type",
pseudotime = "pseudotime",
spatial = NULL,
other_covariates = NULL,
mu_formula = "s(pseudotime, k = 10, bs = 'cr')",
sigma_formula = "1", # If you want your dispersion also varies along pseudotime, use "s(pseudotime, k = 5, bs = 'cr')"
family_use = "nb",
n_cores = 2,
usebam = FALSE,
corr_formula = "1",
copula = "gaussian",
DT = TRUE,
pseudo_obs = FALSE,
return_model = FALSE,
nonzerovar = FALSE
)
The output of scdesign3()
is a list which includes:
-
new_count
: This is the synthetic count matrix generated byscdesign3()
. -
new_covariate
:- If the parameter
ncell
is set to a number that is different from the number of cells in the input data, this will be a matrix that has the new cell covariates that are used for generating new data. - If the parameter
ncell
is the default value, this will beNULL
.
- If the parameter
-
model_aic
: This is a vector include the genes’ marginal models’ AIC, fitted copula’s AIC, and total AIC, which is the sum of the previous two AIC. -
model_bic
: This is a vector include the genes’ marginal models’ BIC, fitted copula’s BIC, and total BIC, which is the sum of the previous two BIC. -
marginal_list
:- If the parameter
return_model
is set toTRUE
, this will be a list which contains the fitted gam or gamlss model for all genes in the input data. - If the parameter
return_model
is set to the default valueFALSE
, this will beNULL
.
- If the parameter
-
corr_list
:- If the parameter
return_model
is set toTRUE
, this will be a list which contains the either a correlation matrix (whencopula = "gaussian"
) or the fitted vine copula (whencopula = "vine
) for each user specified correlation groups (based on the parametercorr_by
). - If the parameter
return_model
is set to the default valueFALSE
, this will beNULL
.
- If the parameter
In this example, since we did not change the parameter
ncell
, the synthetic count matrix will have the same
dimension as the input count matrix.
dim(example_simu$new_count)
#> [1] 100 2087
Then, we can create the SinglecellExperiment
object
using the synthetic count matrix and store the logcounts
to
the input and synthetic SinglecellExperiment
objects.
Visualization
set.seed(123)
compare_figure <- plot_reduceddim(ref_sce = example_sce,
sce_list = list(simu_sce),
name_vec = c("Reference", "scDesign3"),
assay_use = "logcounts",
if_plot = TRUE,
color_by = "pseudotime",
n_pc = 20)
plot(compare_figure$p_umap)
Session information
sessionInfo()
#> R version 4.4.0 (2024-04-24)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 20.04.6 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/liblapack.so.3; LAPACK version 3.9.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_US.UTF-8 LC_COLLATE=en_US.UTF-8
#> [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/Los_Angeles
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] stats4 stats graphics grDevices utils datasets methods
#> [8] base
#>
#> other attached packages:
#> [1] ggplot2_3.5.0 SingleCellExperiment_1.22.0
#> [3] SummarizedExperiment_1.30.2 Biobase_2.60.0
#> [5] GenomicRanges_1.52.0 GenomeInfoDb_1.36.1
#> [7] IRanges_2.34.1 S4Vectors_0.38.1
#> [9] BiocGenerics_0.46.0 MatrixGenerics_1.12.2
#> [11] matrixStats_1.0.0 scDesign3_1.1.3
#> [13] BiocStyle_2.28.0
#>
#> loaded via a namespace (and not attached):
#> [1] tidyselect_1.2.0 viridisLite_0.4.2 farver_2.1.1
#> [4] dplyr_1.1.4 viridis_0.6.4 bitops_1.0-7
#> [7] fastmap_1.1.1 RCurl_1.98-1.12 coop_0.6-3
#> [10] digest_0.6.33 lifecycle_1.0.4 survival_3.5-8
#> [13] gamlss.dist_6.0-5 magrittr_2.0.3 compiler_4.4.0
#> [16] rlang_1.1.3 sass_0.4.7 tools_4.4.0
#> [19] utf8_1.2.4 yaml_2.3.7 knitr_1.43
#> [22] labeling_0.4.3 askpass_1.1 S4Arrays_1.2.0
#> [25] mclust_6.0.1 reticulate_1.30 DelayedArray_0.26.6
#> [28] abind_1.4-5 withr_3.0.0 purrr_1.0.1
#> [31] desc_1.4.2 grid_4.4.0 fansi_1.0.6
#> [34] colorspace_2.1-0 scales_1.3.0 MASS_7.3-60.0.1
#> [37] cli_3.6.2 mvtnorm_1.2-2 rmarkdown_2.23
#> [40] crayon_1.5.2 ragg_1.2.5 generics_0.1.3
#> [43] umap_0.2.10.0 rstudioapi_0.15.0 RSpectra_0.16-2
#> [46] cachem_1.0.8 stringr_1.5.1 zlibbioc_1.46.0
#> [49] splines_4.4.0 parallel_4.4.0 BiocManager_1.30.21.1
#> [52] XVector_0.40.0 vctrs_0.6.5 Matrix_1.7-0
#> [55] jsonlite_1.8.7 bookdown_0.34 gamlss_5.4-12
#> [58] irlba_2.3.5.1 systemfonts_1.0.4 jquerylib_0.1.4
#> [61] glue_1.7.0 pkgdown_2.0.7 stringi_1.8.3
#> [64] gtable_0.3.4 munsell_0.5.0 tibble_3.2.1
#> [67] pillar_1.9.0 htmltools_0.5.5 openssl_2.1.0
#> [70] gamlss.data_6.0-2 GenomeInfoDbData_1.2.10 R6_2.5.1
#> [73] textshaping_0.3.6 rprojroot_2.0.3 evaluate_0.21
#> [76] lattice_0.22-5 highr_0.10 png_0.1-8
#> [79] memoise_2.0.1 bslib_0.5.0 Rcpp_1.0.12
#> [82] gridExtra_2.3 nlme_3.1-163 mgcv_1.9-1
#> [85] xfun_0.39 fs_1.6.3 pkgconfig_2.0.3