SuperCellCyto 0.99.2
This vignette describes the steps to generate supercells for cytometry data using SuperCellCyto R package.
Briefly, supercells are “mini” clusters of cells that are similar in their marker expressions. The motivation behind supercells is that instead of analysing millions of individual cells, you can analyse thousands of supercells, making downstream analysis much faster while maintaining biological interpretability.
See other vignettes for how to:
You can install stable version of SuperCellCyto from Bioconductor using:
if (!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("SuperCellCyto")For the latest development version, you can install it from GitHub using pak:
if (!requireNamespace("pak", quietly = TRUE))
install.packages("pak")
pak::install_github("phipsonlab/SuperCellCyto")The function which creates supercells is called runSuperCellCyto, and it
operates on a data.table object, an enhanced version of R native
data.frame.
In addition to needing the data stored in a data.table object it also
requires:
runSuperCellCyto does not perform any data transformation or scaling.If you are not sure how to import CSV or FCS files into data.table
object, and/or how to subsequently prepare the object ready for
SuperCellCyto, please consult this vignette.
In that vignette, we also provide an explanation behind why we need to have the
cell ID and sample column.
For this vignette, we will simulate some toy data using the simCytoData function.
Specifically, we will simulate 15 markers and 3 samples,
with each sample containing 10,000 cells.
Hence in total, we will have a toy dataset containing 15 markers and
30,000 cells.
n_markers <- 15
n_samples <- 3
dat <- simCytoData(nmarkers = n_markers, ncells = rep(10000, n_samples))
head(dat)
#> Marker_1 Marker_2 Marker_3 Marker_4 Marker_5 Marker_6 Marker_7 Marker_8
#> <num> <num> <num> <num> <num> <num> <num> <num>
#> 1: 13.57507 9.589640 11.18712 17.12841 16.44202 7.476746 18.20839 16.05122
#> 2: 15.10682 7.901460 10.45289 17.71798 15.92435 7.169872 20.00733 15.87949
#> 3: 14.75749 8.773461 11.50594 20.12960 17.10042 8.921884 19.07679 14.68279
#> 4: 14.11387 7.353623 11.14885 17.88312 17.31890 7.032716 20.19939 15.30157
#> 5: 15.07854 8.068804 12.07585 16.36448 17.27713 8.184523 17.06008 16.88062
#> 6: 14.64285 7.100419 11.89812 19.31147 17.28328 6.850641 17.54267 13.36698
#> Marker_9 Marker_10 Marker_11 Marker_12 Marker_13 Marker_14 Marker_15
#> <num> <num> <num> <num> <num> <num> <num>
#> 1: 15.02519 13.50336 17.56530 15.16226 10.61152 18.62024 9.793648
#> 2: 14.59691 13.07756 16.68306 15.37011 13.54864 16.71947 11.147539
#> 3: 16.17885 12.52770 17.47278 15.99877 12.75646 18.29094 11.297076
#> 4: 15.48584 13.04328 17.84486 15.90105 12.06569 17.43203 10.089960
#> 5: 14.91866 12.65459 17.30539 14.86873 11.27775 19.13542 12.897120
#> 6: 14.21666 12.89595 15.21592 16.54388 10.97748 19.64464 10.734440
#> Sample Cell_Id
#> <char> <char>
#> 1: Sample_1 Cell_1
#> 2: Sample_1 Cell_2
#> 3: Sample_1 Cell_3
#> 4: Sample_1 Cell_4
#> 5: Sample_1 Cell_5
#> 6: Sample_1 Cell_6For our toy dataset, we will transform our data using arcsinh transformation.
We will use the base R asinh function to do this:
# Specify which columns are the markers to transform
marker_cols <- paste0("Marker_", seq_len(n_markers))
# The co-factor for arc-sinh
cofactor <- 5
# Do the transformation
dat_asinh <- asinh(dat[, marker_cols, with = FALSE] / cofactor)
# Rename the new columns
marker_cols_asinh <- paste0(marker_cols, "_asinh")
names(dat_asinh) <- marker_cols_asinh
# Add them our previously loaded data
dat <- cbind(dat, dat_asinh)
head(dat[, marker_cols_asinh, with = FALSE])
#> Marker_1_asinh Marker_2_asinh Marker_3_asinh Marker_4_asinh Marker_5_asinh
#> <num> <num> <num> <num> <num>
#> 1: 1.724253 1.406318 1.545038 1.945101 1.905906
#> 2: 1.825181 1.238492 1.483425 1.977629 1.875341
#> 3: 1.802996 1.328223 1.570752 2.100980 1.943531
#> 4: 1.760861 1.178414 1.541911 1.986560 1.955722
#> 5: 1.823402 1.256254 1.615257 1.901384 1.953402
#> 6: 1.795613 1.149600 1.601572 2.060761 1.953744
#> Marker_6_asinh Marker_7_asinh Marker_8_asinh Marker_9_asinh Marker_10_asinh
#> <num> <num> <num> <num> <num>
#> 1: 1.192181 2.003931 1.882915 1.820038 1.719285
#> 2: 1.157572 2.095068 1.872650 1.792640 1.689297
#> 3: 1.342828 2.048929 1.798191 1.890479 1.649287
#> 4: 1.141779 2.104339 1.837349 1.848734 1.686846
#> 5: 1.268382 1.941265 1.931120 1.813289 1.658653
#> 6: 1.120496 1.968062 1.709772 1.767704 1.676246
#> Marker_11_asinh Marker_12_asinh Marker_13_asinh Marker_14_asinh
#> <num> <num> <num> <num>
#> 1: 1.969302 1.828659 1.497030 2.025516
#> 2: 1.919838 1.841598 1.722425 1.921927
#> 3: 1.964224 1.879790 1.666114 2.008293
#> 4: 1.984498 1.873944 1.614479 1.961979
#> 5: 1.954973 1.810111 1.552410 2.051898
#> 6: 1.832015 1.911816 1.527795 2.077330
#> Marker_15_asinh
#> <num>
#> 1: 1.425025
#> 2: 1.541804
#> 3: 1.553975
#> 4: 1.451653
#> 5: 1.676331
#> 6: 1.507460We will also create a column Cell_id_dummy which uniquely identify each cell.
It will have values such as Cell_1, Cell_2, all the way until Cell_x
where x is the number of cells in the dataset.
dat$Cell_id_dummy <- paste0("Cell_", seq_len(nrow(dat)))
head(dat$Cell_id_dummy, n = 10)
#> [1] "Cell_1" "Cell_2" "Cell_3" "Cell_4" "Cell_5" "Cell_6" "Cell_7"
#> [8] "Cell_8" "Cell_9" "Cell_10"By default, the simCytoData function will generate cells for multiple samples,
and that the resulting data.table object will already have a column
called Sample that denotes the sample the cells come from.
unique(dat$Sample)
#> [1] "Sample_1" "Sample_2" "Sample_3"Let’s take note of the sample and cell id column for later.
sample_col <- "Sample"
cell_id_col <- "Cell_id_dummy"Now that we have our data, let’s create some supercells.
To do this, we will use runSuperCellCyto function and pass the markers,
sample and cell ID columns as parameters.
The reason why we need to specify the markers is because the function will
create supercells based on only the expression of those markers.
We highly recommend creating supercells using all markers in your data, let
that be cell type or cell state markers.
However, if for any reason you only want to only use a subset of the markers in
your data, then make sure you specify them in a vector that you later pass to
runSuperCellCyto function.
For this tutorial, we will use all the arcsinh transformed markers in the toy data.
supercells <- runSuperCellCyto(
dt = dat,
markers = marker_cols_asinh,
sample_colname = sample_col,
cell_id_colname = cell_id_col
)Let’s dig deeper into the object it created:
class(supercells)
#> [1] "list"It is a list containing 3 elements:
names(supercells)
#> [1] "supercell_expression_matrix" "supercell_cell_map"
#> [3] "supercell_object"The supercell_object contains the metadata used to create the supercells.
It is a list, and each element contains the metadata used to create the
supercells for a sample.
This will come in handy if we need to either regenerate the supercells using
different gamma values (so we get more or less supercells) or do some
debugging later down the line.
More on regenerating supercells on
Controlling supercells granularity
section below.
The supercell_expression_matrix contains the marker expression of each
supercell.
These are calculated by taking the average of the marker expression of
all the cells contained within a supercell.
head(supercells$supercell_expression_matrix)
#> Marker_1_asinh Marker_2_asinh Marker_3_asinh Marker_4_asinh Marker_5_asinh
#> <num> <num> <num> <num> <num>
#> 1: 1.838027 1.127618 1.575435 1.990695 1.967999
#> 2: 1.821112 1.317762 1.460035 1.990247 1.985136
#> 3: 1.807352 1.270770 1.552495 1.979339 1.931999
#> 4: 1.821550 1.289031 1.538665 1.980558 1.946576
#> 5: 1.783697 1.356490 1.531521 1.993370 1.967676
#> 6: 1.777448 1.200738 1.446873 1.972640 1.961803
#> Marker_6_asinh Marker_7_asinh Marker_8_asinh Marker_9_asinh Marker_10_asinh
#> <num> <num> <num> <num> <num>
#> 1: 1.326344 2.033410 1.837805 1.826353 1.603296
#> 2: 1.078521 2.041023 1.815229 1.844457 1.611537
#> 3: 1.168049 2.003761 1.797400 1.795964 1.651657
#> 4: 1.278519 2.011057 1.822234 1.751016 1.693804
#> 5: 1.286343 2.022883 1.836549 1.824970 1.634087
#> 6: 1.272313 2.016613 1.804825 1.772076 1.612573
#> Marker_11_asinh Marker_12_asinh Marker_13_asinh Marker_14_asinh
#> <num> <num> <num> <num>
#> 1: 1.981545 1.877245 1.631447 1.994728
#> 2: 1.984501 1.926825 1.545986 2.016226
#> 3: 1.959262 1.846875 1.597907 1.966419
#> 4: 1.962119 1.858156 1.583153 1.955109
#> 5: 1.978481 1.884619 1.564530 1.985479
#> 6: 1.968382 1.898579 1.637675 1.974347
#> Marker_15_asinh Sample SuperCellId
#> <num> <char> <char>
#> 1: 1.411753 Sample_1 SuperCell_1_Sample_Sample_1
#> 2: 1.593787 Sample_1 SuperCell_2_Sample_Sample_1
#> 3: 1.453990 Sample_1 SuperCell_3_Sample_Sample_1
#> 4: 1.544993 Sample_1 SuperCell_4_Sample_Sample_1
#> 5: 1.540101 Sample_1 SuperCell_5_Sample_Sample_1
#> 6: 1.350392 Sample_1 SuperCell_6_Sample_Sample_1Therein, we will have the following columns:
markers_col variable.
In this example, they are the arcsinh transformed markers in our toy data.Sample in this case) denoting which sample a supercell
belongs to, (note the column name is the same as what is stored in sample_col
variable).SuperCellId column denoting the unique ID of the supercell.Let’s have a look at SuperCellId:
head(unique(supercells$supercell_expression_matrix$SuperCellId))
#> [1] "SuperCell_1_Sample_Sample_1" "SuperCell_2_Sample_Sample_1"
#> [3] "SuperCell_3_Sample_Sample_1" "SuperCell_4_Sample_Sample_1"
#> [5] "SuperCell_5_Sample_Sample_1" "SuperCell_6_Sample_Sample_1"Let’s break down one of them, SuperCell_1_Sample_Sample_1.
SuperCell_1 is a numbering (1 to however many supercells there are in
a sample) used to uniquely identify each supercell in a sample.
Notably, you may encounter this (SuperCell_1, SuperCell_2) being repeated
across different samples, e.g.,
supercell_ids <- unique(supercells$supercell_expression_matrix$SuperCellId)
supercell_ids[grep("SuperCell_1_", supercell_ids)]
#> [1] "SuperCell_1_Sample_Sample_1" "SuperCell_1_Sample_Sample_2"
#> [3] "SuperCell_1_Sample_Sample_3"While these 3 supercells’ id are pre-fixed with SuperCell_1, it does
not make them equal to one another!
SuperCell_1_Sample_Sample_1 will only contain cells from Sample_1 while
SuperCell_1_Sample_Sample_2 will only contain cells from Sample_2.
By now, you may have noticed that we appended the sample name into each supercell id. This aids in differentiating the supercells in different samples.
supercell_cell_map maps each cell in our dataset to the supercell it
belongs to.
head(supercells$supercell_cell_map)
#> SuperCellID CellId Sample
#> <char> <char> <char>
#> 1: SuperCell_144_Sample_Sample_1 Cell_1 Sample_1
#> 2: SuperCell_120_Sample_Sample_1 Cell_2 Sample_1
#> 3: SuperCell_5_Sample_Sample_1 Cell_3 Sample_1
#> 4: SuperCell_119_Sample_Sample_1 Cell_4 Sample_1
#> 5: SuperCell_446_Sample_Sample_1 Cell_5 Sample_1
#> 6: SuperCell_38_Sample_Sample_1 Cell_6 Sample_1This map is very useful if we later need to expand the supercells out. Additionally, this is also the reason why we need to have a column in the dataset which uniquely identify each cell.
runSuperCellCyto in parallelBy default, runSuperCellCyto will process each sample one after the other.
As each sample is processed independent of one another, strictly speaking, we
can process all of them in parallel.
To do this, we need to:
BiocParallelParam object from the BiocParallel package.
This object can either be of type MulticoreParamor SnowParam.
We highly recommend consulting their vignette for more information.BiocParallelParam object to the number of
samples we have in the dataset.load_balancing parameter for runSuperCellCyto function to TRUE.
This is to ensure even distribution of the supercell creation jobs.
As each sample will be processed by a parallel job, we don’t want a job that
processs large sample to also be assigned other smaller samples if possible.
If you want to know more how this feature works, please refer to our manuscript.supercell_par <- runSuperCellCyto(
dt = dat,
markers = marker_cols_asinh,
sample_colname = sample_col,
cell_id_colname = cell_id_col,
BPPARAM = MulticoreParam(tasks = n_samples),
load_balancing = TRUE
)This is described in the runSuperCellCyto function’s documentation, but let’s
briefly go through it here.
The runSuperCellCyto function is equipped with various parameters which
can be customised to alter the composition of the supercells.
The one that is very likely to be used the most is the gamma parameter,
denoted as gam in the function.
By default, the value for gam is set to 20, which we found work well for
most cases.
The gamma parameter controls how many supercells to generate, and
indirectly, how many cells are captured within each supercell.
This parameter is resolved into the following formula
gamma=n_cells/n_supercells where n_cell denotes the number of cells and
n_supercells denotes the number of supercells.
In general, the larger gamma parameter is set to, the less supercells we will get. Say for instance we have 10,000 cells. If gamma is set to 10, we will end up with about 1,000 supercells, whereas if gamma is set to 50, we will end up with about 200 supercells.
You may have noticed, after reading the sections above, runSuperCellCyto
is ran on each sample independent of each other, and that we can only set
1 value as the gamma parameter.
Indeed, for now, the same gamma value will be used across all samples,
and that depending on how many cells we have in each sample, we will end up
with different number of supercells for each sample.
For instance, say we have 10,000 cells for sample 1, and 100,000 cells for
sample 2.
If gamma is set to 10, for sample 1, we will get 1,000 supercells (10,000/10)
while for sample 2, we will get 10,000 supercells (100,000/10).
Do note: whatever gamma value you chose, you should not expect each supercell to contain exactly the same number of cells. This behaviour is intentional to ensure rare cell types are not intermixed with non-rare cell types in a supercell.
If you have run runSuperCellCyto once and have not discarded the
SuperCell object it generated (no serious, please don’t!),
you can use the object to quickly
regenerate supercells using different gamma values.
As an example, using the SuperCell object we have generated for our
toy dataset, we will regenerate the supercells using gamma of 10 and 50.
The function to do this is recomputeSupercells.
We will store the output in a list, one element per gamma value.
addt_gamma_vals <- c(10, 50)
supercells_addt_gamma <- lapply(addt_gamma_vals, function(gam) {
recomputeSupercells(
dt = dat,
sc_objects = supercells$supercell_object,
markers = marker_cols_asinh,
sample_colname = sample_col,
cell_id_colname = cell_id_col,
gam = gam
)
})We should end up with a list containing 2 elements. The 1st element contains supercells generated using gamma = 10, and the 2nd contains supercells generated using gamma = 50.
supercells_addt_gamma[[1]]
#> $supercell_expression_matrix
#> Marker_1_asinh Marker_2_asinh Marker_3_asinh Marker_4_asinh
#> <num> <num> <num> <num>
#> 1: 1.818738 1.168653 1.517691 1.9921394
#> 2: 1.808993 1.321053 1.446046 1.9570164
#> 3: 1.804771 1.091474 1.452024 2.0086300
#> 4: 1.612859 1.186295 1.494129 2.0229379
#> 5: 1.801000 1.285193 1.510251 2.0012754
#> ---
#> 2996: 1.899882 1.517782 1.505378 0.8793926
#> 2997: 1.877665 1.478065 1.272809 1.0889517
#> 2998: 1.961054 1.534204 1.425770 0.8416298
#> 2999: 1.899656 1.625632 1.496293 0.9707678
#> 3000: 1.848095 1.616841 1.431651 0.9426167
#> Marker_5_asinh Marker_6_asinh Marker_7_asinh Marker_8_asinh
#> <num> <num> <num> <num>
#> 1: 1.966932 1.073591 2.024391 1.806132
#> 2: 1.942297 1.320060 2.014828 1.854842
#> 3: 1.955500 1.267106 2.037178 1.904281
#> 4: 1.962590 1.341628 2.012896 1.768676
#> 5: 1.976508 1.363973 2.026096 1.881772
#> ---
#> 2996: 2.031241 1.845806 2.042882 1.895553
#> 2997: 2.084411 1.796490 2.114571 1.959733
#> 2998: 2.092683 1.805397 2.077337 1.935993
#> 2999: 2.020680 1.775569 2.042967 1.903298
#> 3000: 1.970839 1.741530 1.998790 1.916541
#> Marker_9_asinh Marker_10_asinh Marker_11_asinh Marker_12_asinh
#> <num> <num> <num> <num>
#> 1: 1.8055286 1.654230 1.993660 1.9123065
#> 2: 1.7907821 1.559810 1.950693 1.8017000
#> 3: 1.7919844 1.627863 1.972062 1.9043233
#> 4: 1.8733415 1.636072 1.992851 1.8922191
#> 5: 1.8382961 1.661317 2.003895 1.8933041
#> ---
#> 2996: 0.9003675 1.553349 1.250823 1.1061322
#> 2997: 1.0219868 1.340655 1.496602 1.0385985
#> 2998: 1.1379625 1.254290 1.321587 0.8907753
#> 2999: 1.1666333 1.259539 1.535105 1.0950674
#> 3000: 1.1038845 1.320499 1.379215 0.9482013
#> Marker_13_asinh Marker_14_asinh Marker_15_asinh Sample
#> <num> <num> <num> <char>
#> 1: 1.572578 1.987166 1.594610 Sample_1
#> 2: 1.601082 1.946115 1.497280 Sample_1
#> 3: 1.580501 1.975310 1.486006 Sample_1
#> 4: 1.605220 1.984517 1.560193 Sample_1
#> 5: 1.477942 1.985251 1.523596 Sample_1
#> ---
#> 2996: 2.050122 1.327988 1.733098 Sample_3
#> 2997: 2.077620 1.322183 1.589272 Sample_3
#> 2998: 2.071670 1.408850 1.692378 Sample_3
#> 2999: 2.054117 1.427779 1.689362 Sample_3
#> 3000: 2.028319 1.406634 1.724500 Sample_3
#> SuperCellId
#> <char>
#> 1: SuperCell_1_Sample_Sample_1
#> 2: SuperCell_2_Sample_Sample_1
#> 3: SuperCell_3_Sample_Sample_1
#> 4: SuperCell_4_Sample_Sample_1
#> 5: SuperCell_5_Sample_Sample_1
#> ---
#> 2996: SuperCell_996_Sample_Sample_3
#> 2997: SuperCell_997_Sample_Sample_3
#> 2998: SuperCell_998_Sample_Sample_3
#> 2999: SuperCell_999_Sample_Sample_3
#> 3000: SuperCell_1000_Sample_Sample_3
#>
#> $supercell_cell_map
#> SuperCellID CellId Sample
#> <char> <char> <char>
#> 1: SuperCell_413_Sample_Sample_1 Cell_1 Sample_1
#> 2: SuperCell_749_Sample_Sample_1 Cell_2 Sample_1
#> 3: SuperCell_66_Sample_Sample_1 Cell_3 Sample_1
#> 4: SuperCell_492_Sample_Sample_1 Cell_4 Sample_1
#> 5: SuperCell_820_Sample_Sample_1 Cell_5 Sample_1
#> ---
#> 29996: SuperCell_125_Sample_Sample_3 Cell_29996 Sample_3
#> 29997: SuperCell_7_Sample_Sample_3 Cell_29997 Sample_3
#> 29998: SuperCell_922_Sample_Sample_3 Cell_29998 Sample_3
#> 29999: SuperCell_39_Sample_Sample_3 Cell_29999 Sample_3
#> 30000: SuperCell_314_Sample_Sample_3 Cell_30000 Sample_3The output generated by recomputeSupercells is essentially a list:
supercell_expression_matrix: A data.table object that contains the marker
expression for each supercell.supercell_cell_map: A data.table that maps each cell to its
corresponding supercell.As mentioned before, gamma dictates the granularity of supercells. Compared to the previous run where gamma was set to 20, we should get more supercells for gamma = 10, and less for gamma = 50. Let’s see if that’s the case.
n_supercells_gamma20 <- nrow(supercells$supercell_expression_matrix)
n_supercells_gamma10 <- nrow(
supercells_addt_gamma[[1]]$supercell_expression_matrix
)
n_supercells_gamma50 <- nrow(
supercells_addt_gamma[[2]]$supercell_expression_matrix
)n_supercells_gamma10 > n_supercells_gamma20
#> [1] TRUEn_supercells_gamma50 < n_supercells_gamma20
#> [1] TRUEIn the future, we may add the ability to specify different gam
value for different samples.
For now, if we want to do this, we will need to break down our data
into multiple data.table objects, each containing data from 1 sample,
and run runSuperCellCyto
function on each of them with different gam parameter value.
Something like the following:
n_markers <- 10
dat <- simCytoData(nmarkers = n_markers)
markers_col <- paste0("Marker_", seq_len(n_markers))
sample_col <- "Sample"
cell_id_col <- "Cell_Id"
samples <- unique(dat[[sample_col]])
gam_values <- c(10, 20, 10)
supercells_diff_gam <- lapply(seq_len(length(samples)), function(i) {
sample <- samples[i]
gam <- gam_values[i]
dat_samp <- dat[dat$Sample == sample, ]
supercell_samp <- runSuperCellCyto(
dt = dat_samp,
markers = markers_col,
sample_colname = sample_col,
cell_id_colname = cell_id_col,
gam = gam
)
return(supercell_samp)
})Subsequently, to extract and combine the supercell_expression_matrix and
supercell_cell_map, we will need to use rbind:
supercell_expression_matrix <- do.call(
"rbind", lapply(
supercells_diff_gam, function(x) x[["supercell_expression_matrix"]]
)
)
supercell_cell_map <- do.call(
"rbind", lapply(
supercells_diff_gam, function(x) x[["supercell_cell_map"]]
)
)rbind(
head(supercell_expression_matrix, n = 3),
tail(supercell_expression_matrix, n = 3)
)
#> Marker_1 Marker_2 Marker_3 Marker_4 Marker_5 Marker_6 Marker_7 Marker_8
#> <num> <num> <num> <num> <num> <num> <num> <num>
#> 1: 10.877936 7.486385 10.25031 19.82196 12.16523 11.30565 12.305742 10.023147
#> 2: 10.135077 6.489983 11.28029 19.84830 12.33060 12.05625 12.570132 9.030151
#> 3: 9.885644 7.037859 11.76525 19.55137 13.73039 11.14037 13.214482 9.845635
#> 4: 9.087028 18.270707 19.11501 20.06782 20.39731 14.24748 7.003236 13.170569
#> 5: 8.769164 18.908626 17.75269 19.51353 19.18193 14.00271 6.420023 13.473778
#> 6: 7.467144 19.689440 19.66855 21.01436 17.80242 15.54600 7.851840 14.014402
#> Marker_9 Marker_10 Sample SuperCellId
#> <num> <num> <char> <char>
#> 1: 7.842908 13.28779 Sample_1 SuperCell_1_Sample_Sample_1
#> 2: 7.947011 14.21341 Sample_1 SuperCell_2_Sample_Sample_1
#> 3: 7.510405 14.37715 Sample_1 SuperCell_3_Sample_Sample_1
#> 4: 13.442312 15.03725 Sample_2 SuperCell_498_Sample_Sample_2
#> 5: 14.274210 17.47895 Sample_2 SuperCell_499_Sample_Sample_2
#> 6: 12.800367 15.32846 Sample_2 SuperCell_500_Sample_Sample_2rbind(head(supercell_cell_map, n = 3), tail(supercell_cell_map, n = 3))
#> SuperCellID CellId Sample
#> <char> <char> <char>
#> 1: SuperCell_58_Sample_Sample_1 Cell_1 Sample_1
#> 2: SuperCell_26_Sample_Sample_1 Cell_2 Sample_1
#> 3: SuperCell_809_Sample_Sample_1 Cell_3 Sample_1
#> 4: SuperCell_99_Sample_Sample_2 Cell_19998 Sample_2
#> 5: SuperCell_9_Sample_Sample_2 Cell_19999 Sample_2
#> 6: SuperCell_294_Sample_Sample_2 Cell_20000 Sample_2If for whatever reason you don’t mind (or perhaps more to the point want)
each supercell to contain cells from different biological samples,
you still need to have the sample column in your data.table.
However, what you need to do is essentially set the value in the column
to exactly one unique value.
That way, SuperCellCyto will treat all cells as coming from one sample.
Just note, the parallel processing feature in SuperCellCyto won’t work for this as you will essentially only have 1 sample and nothing for SuperCellCyto to parallelise.
Is your dataset so huge that you are constantly running out of RAM when generating supercells? This thing happens and we have a solution for it.
Since supercells are generated for each sample independent of others you can easily break up the process. For example:
supercell_expression_matrix and supercell_cell_map,
and export them out as a csv file using data.table’s fwrite function.Once you have processed all the samples, you can then load all
supercell_expression_matrix and supercell_cell_map csv files and
analyse them.
If you want to regenerate the supercells using different gamma values,
load the relevant output saved using the qs package and the relevant data
(remember to note which output belongs to which sets of samples!), and run
recomputeSupercells function.
sessionInfo()
#> R version 4.5.1 Patched (2025-09-10 r88807)
#> Platform: x86_64-apple-darwin20
#> Running under: macOS Monterey 12.7.6
#>
#> Matrix products: default
#> BLAS: /Library/Frameworks/R.framework/Versions/4.5-x86_64/Resources/lib/libRblas.0.dylib
#> LAPACK: /Library/Frameworks/R.framework/Versions/4.5-x86_64/Resources/lib/libRlapack.dylib; LAPACK version 3.12.1
#>
#> locale:
#> [1] C/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8
#>
#> time zone: America/New_York
#> tzcode source: internal
#>
#> attached base packages:
#> [1] parallel stats graphics grDevices utils datasets methods
#> [8] base
#>
#> other attached packages:
#> [1] BiocParallel_1.43.4 SuperCellCyto_0.99.2 BiocStyle_2.37.1
#>
#> loaded via a namespace (and not attached):
#> [1] cli_3.6.5 knitr_1.50 rlang_1.1.6
#> [4] xfun_0.53 jsonlite_2.0.0 data.table_1.17.8
#> [7] plyr_1.8.9 htmltools_0.5.8.1 sass_0.4.10
#> [10] rmarkdown_2.30 grid_4.5.1 evaluate_1.0.5
#> [13] jquerylib_0.1.4 fastmap_1.2.0 yaml_2.3.10
#> [16] lifecycle_1.0.4 bookdown_0.45 BiocManager_1.30.26
#> [19] compiler_4.5.1 igraph_2.1.4 codetools_0.2-20
#> [22] Rcpp_1.1.0 pkgconfig_2.0.3 lattice_0.22-7
#> [25] digest_0.6.37 SuperCell_1.0.1 R6_2.6.1
#> [28] RANN_2.6.2 magrittr_2.0.4 bslib_0.9.0
#> [31] Matrix_1.7-4 tools_4.5.1 cachem_1.1.0