cellCellSimulate functionHere, we explain the way to generate CCI simulation data. scTensor
has a function cellCellSimulate to generate the simulation
data.
The simplest way to generate such data is
cellCellSimulate with default parameters.
## Getting the values of params...## Setting random seed...## Generating simulation data...## Done!This function internally generate the parameter sets by
newCCSParams, and the values of the parameter can be
changed, and specified as the input of cellCellSimulate by
users as follows.
## Formal class 'CCSParams' [package "scTensor"] with 5 slots
## ..@ nGene : num 1000
## ..@ nCell : num [1:3] 50 50 50
## ..@ cciInfo:List of 4
## .. ..$ nPair: num 500
## .. ..$ CCI1 :List of 4
## .. .. ..$ LPattern: num [1:3] 1 0 0
## .. .. ..$ RPattern: num [1:3] 0 1 0
## .. .. ..$ nGene : num 50
## .. .. ..$ fc : chr "E10"
## .. ..$ CCI2 :List of 4
## .. .. ..$ LPattern: num [1:3] 0 1 0
## .. .. ..$ RPattern: num [1:3] 0 0 1
## .. .. ..$ nGene : num 50
## .. .. ..$ fc : chr "E10"
## .. ..$ CCI3 :List of 4
## .. .. ..$ LPattern: num [1:3] 0 0 1
## .. .. ..$ RPattern: num [1:3] 1 0 0
## .. .. ..$ nGene : num 50
## .. .. ..$ fc : chr "E10"
## ..@ lambda : num 1
## ..@ seed : num 1234# Setting different parameters
# No. of genes : 1000
setParam(params, "nGene") <- 1000
# 3 cell types, 20 cells in each cell type
setParam(params, "nCell") <- c(20, 20, 20)
# Setting for Ligand-Receptor pair list
setParam(params, "cciInfo") <- list(
nPair=500, # Total number of L-R pairs
# 1st CCI
CCI1=list(
LPattern=c(1,0,0), # Only 1st cell type has this pattern
RPattern=c(0,1,0), # Only 2nd cell type has this pattern
nGene=50, # 50 pairs are generated as CCI1
fc="E10"), # Degree of differential expression (Fold Change)
# 2nd CCI
CCI2=list(
LPattern=c(0,1,0),
RPattern=c(0,0,1),
nGene=30,
fc="E100")
)
# Degree of Dropout
setParam(params, "lambda") <- 10
# Random number seed
setParam(params, "seed") <- 123
# Simulation data
sim <- cellCellSimulate(params)## Getting the values of params...## Setting random seed...## Generating simulation data...## Done!The output object sim has some attributes as follows.
Firstly, sim$input contains a synthetic gene expression matrix. The size can be changed by nGene and nCell parameters described above.
## [1] 1000 60## Cell1 Cell2 Cell3
## Gene1 9105 2 0
## Gene2 4 37 850Next, sim$LR contains a ligand-receptor (L-R) pair list. The size can be changed by nPair parameter of cciInfo, and the differentially expressed (DE) L-R pairs are saved in the upper side of this matrix. Here, two DE L-R patterns are specified as cciInfo, and each number of pairs is 50 and 30, respectively.
## [1] 500 2## GENEID_L GENEID_R
## 1 Gene1 Gene81
## 2 Gene2 Gene82
## 3 Gene3 Gene83
## 4 Gene4 Gene84
## 5 Gene5 Gene85
## 6 Gene6 Gene86
## 7 Gene7 Gene87
## 8 Gene8 Gene88
## 9 Gene9 Gene89
## 10 Gene10 Gene90## GENEID_L GENEID_R
## 46 Gene46 Gene126
## 47 Gene47 Gene127
## 48 Gene48 Gene128
## 49 Gene49 Gene129
## 50 Gene50 Gene130
## 51 Gene51 Gene131
## 52 Gene52 Gene132
## 53 Gene53 Gene133
## 54 Gene54 Gene134
## 55 Gene55 Gene135## GENEID_L GENEID_R
## 491 Gene571 Gene991
## 492 Gene572 Gene992
## 493 Gene573 Gene993
## 494 Gene574 Gene994
## 495 Gene575 Gene995
## 496 Gene576 Gene996
## 497 Gene577 Gene997
## 498 Gene578 Gene998
## 499 Gene579 Gene999
## 500 Gene580 Gene1000Finally, sim$celltypes contains a cell type vector. Since nCell is specified as “c(20, 20, 20)” described above, three cell types are generated.
## [1] 60## Celltype1 Celltype1 Celltype1 Celltype1 Celltype1 Celltype1
## "Cell1" "Cell2" "Cell3" "Cell4" "Cell5" "Cell6"##
## Celltype1 Celltype2 Celltype3
## 20 20 20## R version 4.6.1 (2026-06-24)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 26.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.32.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=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: Etc/UTC
## tzcode source: system (glibc)
##
## attached base packages:
## [1] stats4 stats graphics grDevices utils datasets methods
## [8] base
##
## other attached packages:
## [1] AnnotationHub_4.3.2
## [2] BiocFileCache_3.3.0
## [3] dbplyr_2.6.0
## [4] scTGIF_1.27.0
## [5] Homo.sapiens_1.3.1
## [6] TxDb.Hsapiens.UCSC.hg19.knownGene_3.22.1
## [7] org.Hs.eg.db_3.23.1
## [8] GO.db_3.23.1
## [9] OrganismDbi_1.55.1
## [10] GenomicFeatures_1.65.0
## [11] GenomicRanges_1.65.4
## [12] Seqinfo_1.3.2
## [13] AnnotationDbi_1.75.2
## [14] IRanges_2.47.5
## [15] S4Vectors_0.51.9
## [16] Biobase_2.73.2
## [17] BiocGenerics_0.59.12
## [18] generics_0.1.4
## [19] scTensor_2.23.3
## [20] BiocStyle_2.41.0
##
## loaded via a namespace (and not attached):
## [1] fs_2.1.0 matrixStats_1.5.0
## [3] bitops_1.1-0 enrichplot_1.33.0
## [5] httr_1.4.9 webshot_0.5.5
## [7] RColorBrewer_1.1-3 Rgraphviz_2.57.2
## [9] tools_4.6.1 backports_1.5.1
## [11] R6_2.6.1 lazyeval_0.2.3
## [13] withr_3.0.3 graphite_1.59.0
## [15] gridExtra_2.3.1 schex_1.27.0
## [17] fdrtool_1.2.18 cli_3.6.6
## [19] TSP_1.2.7 scatterpie_0.2.6
## [21] entropy_1.3.2 sass_0.4.10
## [23] S7_0.2.2 genefilter_1.95.0
## [25] meshr_2.19.0 Rsamtools_2.29.0
## [27] systemfonts_1.3.2 yulab.utils_0.2.5
## [29] gson_0.2.1 DOSE_4.7.2
## [31] MeSHDbi_1.49.0 AnnotationForge_1.55.0
## [33] nnTensor_1.4.0 plotrix_3.8-14
## [35] maps_3.4.3 RSQLite_3.53.3
## [37] visNetwork_2.1.4 gridGraphics_0.5-1
## [39] GOstats_2.79.0 BiocIO_1.23.3
## [41] dplyr_1.2.1 dendextend_1.19.1
## [43] Matrix_1.7-6 abind_1.4-8
## [45] lifecycle_1.0.5 yaml_2.3.12
## [47] SummarizedExperiment_1.43.0 SparseArray_1.13.2
## [49] grid_4.6.1 blob_1.3.0
## [51] misc3d_0.9-2 crayon_1.5.3
## [53] ggtangle_0.1.2 lattice_0.23-1
## [55] msigdbr_26.1.1 cigarillo_1.3.1
## [57] annotate_1.91.0 KEGGREST_1.53.6
## [59] sys_3.4.3 maketools_1.3.2
## [61] pillar_1.11.1 knitr_1.52
## [63] tcltk_4.6.1 rjson_0.2.23
## [65] codetools_0.2-20 glue_1.8.1
## [67] ggiraph_0.9.6 outliers_0.15
## [69] ggfun_0.2.1 fontLiberation_0.1.0
## [71] data.table_1.18.6.1 vctrs_0.7.3
## [73] png_0.1-9 treeio_1.37.0
## [75] spam_2.11-4 rTensor_1.5.0
## [77] gtable_0.3.6 assertthat_0.2.1
## [79] cachem_1.1.0 xfun_0.60
## [81] S4Arrays_1.13.0 tidygraph_1.3.1
## [83] survival_3.8-12 SingleCellExperiment_1.35.2
## [85] seriation_1.5.8 iterators_1.0.14
## [87] fields_17.3 nlme_3.1-171
## [89] Category_2.79.0 ggtree_4.3.0
## [91] bit64_4.8.6 fontquiver_0.2.1
## [93] filelock_1.0.3 bslib_0.12.0
## [95] otel_0.2.0 DBI_1.3.0
## [97] tidyselect_1.2.1 bit_4.6.0
## [99] compiler_4.6.1 curl_8.0.0
## [101] httr2_1.3.0 graph_1.91.0
## [103] fontBitstreamVera_0.1.1 DelayedArray_0.39.6
## [105] plotly_4.12.1 rtracklayer_1.73.0
## [107] checkmate_2.3.4 scales_1.4.0
## [109] hexbin_1.28.6 RBGL_1.89.0
## [111] plot3D_1.4.2 rappdirs_0.3.4
## [113] stringr_1.6.0 digest_0.6.39
## [115] rmarkdown_2.32 ca_0.71.1
## [117] XVector_0.53.0 htmltools_0.5.9
## [119] pkgconfig_2.0.3 MatrixGenerics_1.25.0
## [121] fastmap_1.2.0 rlang_1.3.0
## [123] htmlwidgets_1.6.4 farver_2.1.2
## [125] jquerylib_0.1.4 jsonlite_2.0.0
## [127] BiocParallel_1.47.0 GOSemSim_2.39.2
## [129] RCurl_1.98-1.20 magrittr_2.0.5
## [131] ggplotify_0.1.3 dotCall64_1.2
## [133] patchwork_1.3.2 Rcpp_1.1.2
## [135] ape_5.8-1 ggnewscale_0.5.2
## [137] viridis_0.6.5 gdtools_0.5.1
## [139] stringi_1.8.9 tagcloud_0.7.0
## [141] ggraph_2.2.2 MASS_7.3-66
## [143] plyr_1.8.9 parallel_4.6.1
## [145] ggrepel_0.9.8 Biostrings_2.81.9
## [147] graphlayouts_1.2.5 splines_4.6.1
## [149] Vicus_0.99.0 igraph_2.3.3
## [151] enrichit_0.2.1 buildtools_1.0.0
## [153] reshape2_1.4.5 BiocVersion_3.24.0
## [155] XML_3.99-0.24 evaluate_1.0.5
## [157] BiocManager_1.30.27 foreach_1.5.2
## [159] tweenr_2.0.3 RANN_2.6.3
## [161] tidyr_1.3.2 purrr_1.2.2
## [163] polyclip_1.10-7 heatmaply_1.6.0
## [165] ggplot2_4.0.3 ReactomePA_1.57.0
## [167] BiocBaseUtils_1.15.1 ggforce_0.5.0
## [169] xtable_1.8-8 restfulr_0.0.17
## [171] reactome.db_1.96.0 RSpectra_0.16-2
## [173] tidytree_0.4.8 tidydr_0.0.6
## [175] viridisLite_0.4.3 tibble_3.3.1
## [177] aplot_0.3.1 ccTensor_1.0.3
## [179] GenomicAlignments_1.49.2 memoise_2.0.1
## [181] registry_0.5-1 cluster_2.1.8.3
## [183] concaveman_1.2.0 GSEABase_1.75.0