require(knitr) opts_chunk$set(error = FALSE, message = FALSE, warning = FALSE, dpi = 30) knitr::opts_chunk$set(dev = "png")
library("BASiCS") library("BiocStyle") library("SingleCellExperiment") library("cowplot") library("ggplot2") theme_set(theme_bw())
Single-cell mRNA sequencing can uncover novel cell-to-cell heterogeneity in gene expression levels within seemingly homogeneous populations of cells. However, these experiments are prone to high levels of technical noise, creating new challenges for identifying genes that show genuine heterogeneous expression within the group of cells under study.
BASiCS (Bayesian Analysis of Single-Cell Sequencing data) is an integrated Bayesian hierarchical model that propagates statistical uncertainty by simultaneously performing data normalisation (global scaling), technical noise quantification and two types of supervised downstream analyses:
Regression = TRUE
as a function parameter
in BASiCS_MCMC
. In all cases, a probabilistic output is provided and a decision rule is calibrated using the expected false discovery rate (EFDR) [@newton2004detecting].
A brief description for the statistical model implemented in BASiCS is
provided in Section \@ref(methodology) of this document. The original
implementation of BASiCS [@vallejos2015basics] requires the use of spike-in
molecules --- that are artificially introduced to each cell's lysate
--- to perform these analyses. More recently, @eling2018correcting extendeded
BASiCS to also address datasets for which spikes-ins are not available
(see Section \@ref(alternative-implementation-modes)). To use this feature,
please set WithSpikes = FALSE
as a function parameter in BASiCS_MCMC
.
Important: BASiCS has been designed in the context of supervised experiments where the groups of cells (e.g. experimental conditions, cell types) under study are known a priori (e.g. case-control studies). Therefore, we DO NOT advise the use of BASiCS in unsupervised settings where the aim is to uncover sub-populations of cells through clustering.
Parameter estimation is performed using the BASiCS_MCMC
function. Downstream
analyses implemented in BASiCS rely on appropriate post-processing of the
output returned by BASiCS_MCMC
. Essential parameters for running
BASiCS_MCMC
are:
Data
: a SingleCellExperiment
object created as in Section
\@ref(the-input-dataset)N
: total number of iterationsThin
: length of the thining period (i.e. only every Thin
iterations will be stored in the output of the BASiCS_MCMC
)Burn
: length of burn-in period (i.e. the initial Burn
iterations that will be discarded from the output of the BASiCS_MCMC
)Regression
: if this parameter is set equal to TRUE
, the regression
BASiCS model will be used [@eling2018correcting]. The latter infers a global
regression trend between mean expression and over-dispersion parameters. This
trend is subsequently used to derive a residual over-dispersion measure that
is defined as departures with respect to this trend. This is now the
recommended default setting for BASiCS*.If the optional parameter PrintProgress
is set to TRUE
, the R
console will display the progress of the MCMC algorithm.
For other optional parameters refer to help(BASiCS_MCMC)
.
Here, we illustrate the usage of BASiCS_MCMC
using a built-in
synthetic dataset.
As the outcome of this function is stochastic, users should expect small
variations across different runs.
To ensure reproducible results, users may consider using a fixed seed (as
illustrated in the following code).
NOTE: WE USE A SMALL NUMBER OF ITERATIONS FOR ILLUSTRATION PURPOSES ONLY.
LARGER NUMBER OF ITERATIONS ARE USUALLY REQUIRED TO ACHIEVE CONVERGENCE. OUR
RECOMMENDED SETTING IS N=20000
, Thin=20
and Burn=10000
.
set.seed(1) Data <- makeExampleBASiCS_Data() Chain <- BASiCS_MCMC( Data = Data, N = 1000, Thin = 10, Burn = 500, PrintProgress = FALSE, Regression = TRUE )
As a default, the code above runs the original implementation mode of BASiCS
(spikes without regression; see Section \@ref(alternative-implementation-modes)).
To use the regression BASiCS model [@eling2018correcting], please set
Regression = TRUE
. To use the no-spikes implementation of BASiCS, please add
WithSpikes = FALSE
as an additional parameter.
The Data
and Chain
(a BASiCS_Chain
object) objects created by the code
above can be use for subsequent downstream analyses. See Section
\@ref(analysis-for-a-single-group-of-cells) for highly/lowly variable gene
detection (single group of cells, see also functions BASiCS_DetectHVG
and
BASiCS_DetectLVG
) and Section \@ref(analysis-for-two-groups-of-cells) for
differential expression analyses (two groups of cells, see also function
BASiCS_TestDE
).
Important remarks:
Please ensure the acceptance rates displayed in the console output of
BASiCS_MCMC
are around 0.44. If they are too far from this value, you
should increase N
and Burn
.
It is essential to assess the convergence of the MCMC algorithm before performing downstream analyses. For guidance regarding this step, refer to the 'Convergence assessment' section of this vignette
Typically, setting N=20000
, Thin=20
and Burn=10000
leads to
stable results.
The input dataset for BASiCS must be stored as an SingleCellExperiment
object (see r Biocpkg("SingleCellExperiment")
package).
The generation of the input SingleCellExperiment
object requires a matrix of
raw counts Counts
(columns: cells, rows: genes) after quality control
(e.g. removing low quality cells) and filtering of lowly expressed genes. If
spike-in molecules are contained in Counts
, a logical vector Tech
is
required to indicate which rows contain technical spike-in molecules and a
data.frame
object SpikeInfo
containing the names of the spike-in molecules
in the first column and the absolute number of molecules per well in the second
column. More details are provided in section \@ref(the-input-dataset). If
spike-ins are not available, a vector BatchInfo
containing batch information
is required.
The newBASiCS_Data
function can be used to create the input data object based
on the following information:
Counts
: a matrix of raw expression counts with dimensions $q$ times $n$.
Within this matrix, $q_0$ rows must correspond to biological genes and $q-q_0$
rows must correspond to technical spike-in genes. Gene names must be stored as
rownames(Counts)
.
Tech
: a logical vector (TRUE
/FALSE
) with $q$ elements. If
Tech[i] = FALSE
the gene i
is biological; otherwise the gene is spike-in.
This vector must be specified in the same order of genes as in the
Counts
matrix.
SpikeInfo
(optional): a data.frame
with $q-q_0$ rows. First column must
contain the names associated to the spike-in genes (as in rownames(Counts)
).
Second column must contain the input number of molecules for the spike-in genes
(amount per cell). If a value for this parameter is not provided when calling
newBASiCS_Data
, SpikeInfo
is set as NULL
as a default value. In those
cases, the BatchInfo
argument has to be provided to allow using the no-spikes
implementation of BASiCS.
BatchInfo
(optional): vector of length $n$ to indicate batch structure
(whenever cells have been processed using multiple batches). If a value for this
parameter is not provided when calling newBASiCS_Data
, BASiCS will assume
the data contains a single batch of samples.
For example, the following code generates a synthetic dataset with 50 genes (40 biological and 10 spike-in) and 40 cells.
set.seed(1) Counts <- matrix(rpois(50 * 40, 2), ncol = 40) rownames(Counts) <- c(paste0("Gene", 1:40), paste0("Spike", 1:10)) colnames(Counts) <- paste0("Cell", 1:40) Tech <- c(rep(FALSE, 40), rep(TRUE, 10)) set.seed(2) SpikeInput <- rgamma(10, 1, 1) SpikeInfo <- data.frame( "SpikeID" = paste0("Spike", 1:10), "SpikeInput" = SpikeInput ) # No batch structure DataExample <- newBASiCS_Data(Counts, Tech, SpikeInfo) # With batch structure DataExample <- newBASiCS_Data( Counts, Tech, SpikeInfo, BatchInfo = rep(c(1, 2), each = 20) )
To convert an existing SingleCellExperiment
object (Data
) into one that can
be used within BASiCS, meta-information must be stored in the object.
If spike-ins are in use, observed counts must be stored in altExp(Data)
metadata(Data)
: the SpikeInfo
object is stored in the
metadata
slot of the SingleCellExperiment
object:
metadata(Data) <- list(SpikeInput = SpikeInfo)
.
colData(Data)$BatchInfo
: the BatchInfo
object is stored in the
colData
slot of the SingleCellExperiment
object.
Once the additional information is included, the object can be used within BASiCS.
NOTE: Input number of molecules for spike-in should be calculated using experimental information. For each spike-in gene $i$, we use \vspace{-0.2cm}
$$ \mu_{i} = C_i \times 10^{-18} \times (6.022 \times 10^{23}) \times V \times D \hspace{0.5cm} \mbox{where,} $$
To run BASiCS without incorporating reads from technical spike-in genes,
and existing SingleCellExperiment
object can be used. The only modification
to the existing object is to assign the colData(Data)$BatchInfo
slot.
set.seed(1) CountsNoSpikes <- matrix(rpois(50 * 40, 2), ncol = 40) rownames(CountsNoSpikes) <- paste0("Gene", 1:50) colnames(CountsNoSpikes) <- paste0("Cell", 1:40) # With batch structure DataExampleNoSpikes <- SingleCellExperiment( assays = list(counts = CountsNoSpikes), colData = data.frame(BatchInfo = rep(c(1, 2), each = 20)) )
Note: BASiCS assumes that a pre-processing quality control step has been applied to remove cells with poor quality data and/or lowly expressed genes that were undetected through sequencing. When analysing multiple groups of cells, the gene filtering step must be jointly applied across all groups to ensure the same genes are retained.
The function BASiCS_Filter
can be used to perform this task. For examples,
refer to help(BASiCS_Filter)
. Moreover, the r Biocpkg("scater")
package
provides enhanced functionality for the pre-processing of scRNA-seq datasets.
We illustrate this analysis using a small extract from the MCMC chain obtained
in [@vallejos2016beyond] when analysing the single cell samples provided in
[@grun2014validation]. This is included within BASiCS
as the ChainSC
dataset.
data(ChainSC)
The following code is used to identify highly variable genes (HVG) and
lowly variable genes (LVG) among these cells. The VarThreshold
parameter
sets a lower threshold for the proportion of variability that is assigned to
the biological component (Sigma
). In the examples below:
For each gene, these functions return posterior probabilities as a measure of HVG/LVG evidence. A cut-off value for these posterior probabilities is set by controlling the EFDR (as a default option, EFDR is set as 0.10).
HVG <- BASiCS_DetectHVG(ChainSC, VarThreshold = 0.6) LVG <- BASiCS_DetectLVG(ChainSC, VarThreshold = 0.2) plot_grid( BASiCS_PlotVG(HVG, "Grid"), BASiCS_PlotVG(HVG, "VG") ) plot_grid( BASiCS_PlotVG(LVG, "Grid"), BASiCS_PlotVG(LVG, "VG") )
To access the results of these tests, please use as.data.frame
.
as.data.frame(HVG) as.data.frame(LVG)
SummarySC <- Summary(ChainSC) plot(SummarySC, Param = "mu", Param2 = "delta", log = "xy") HTable <- as.data.frame(HVG) LTable <- as.data.frame(LVG) with(HTable, points(Mu, Delta)) with(LTable, points(Mu, Delta))
Note: this decision rule implemented in this function has changed with
respect to the original release of BASiCS (where EviThreshold
was defined
such that EFDR = EFNR). However, the new choice is more stable (sometimes, it
was not posible to find a threshold such that EFDR = EFNR).
To illustrate the use of the differential mean expression and differential
over-dispersion tests between two cell populations, we use extracts from the
MCMC chains obtained in [@vallejos2016beyond] when analysing the
[@grun2014validation] dataset (single cells vs pool-and-split samples). These
were obtained by independently running the BASiCS_MCMC
function for each
group of cells.
data(ChainSC) data(ChainRNA)
Test <- BASiCS_TestDE( Chain1 = ChainSC, Chain2 = ChainRNA, GroupLabel1 = "SC", GroupLabel2 = "PaS", EpsilonM = log2(1.5), EpsilonD = log2(1.5), EFDR_M = 0.10, EFDR_D = 0.10, Offset = TRUE, PlotOffset = TRUE, Plot = TRUE )
In BASiCS_TestDE
, EpsilonM
sets the log2 fold change (log2FC) in expression
($\mu$) and EpsilonD
the log2FC in over-dispersion ($\delta$). As a default
option: EpsilonM = EpsilonD = log2(1.5)
(i.e. the test is set to detect
absolute increases of 50\% or above). To adjust for differences in overall mRNA
content, an internal offset correction is performed when OffSet=TRUE
.
This is the recommended default setting.
Previously, the output of this function was a set of plots and a nested list
structure. The new output is an object of S4 class BASiCS_ResultsDE
.
Test
You can access the results of these tests using as.data.frame
. You must specify which
of the mean, dispersion and residual overdispersion results you want using the
Which
argument, as follows.
head(as.data.frame(Test, Parameter = "Mean")) head(as.data.frame(Test, Parameter = "Disp")) ## This object doesn't contain residual overdispersion tests as the chains ## were run using the non-regression version of BASiCS # head(as.data.frame(DE, Parameter = "Disp"))
There's a rowData
field and accessor, so we can add gene information that
will be added when formatting each of the fields (eg different gene
identifiers).
rowData(Test) rowData(Test) <- cbind(rowData(Test), Index = 1:nrow(rowData(Test))) as.data.frame(Test, Parameter = "Mean")
As of BASiCS v2, the differential expression plots have been re-done in ggplot2
and can be generated using BASiCS_PlotDE
.
The default plots are "Grid" (EFDR vs EFNR), "MA", and "Volcano".
These are done for "Mean", "Disp", and "ResDisp".
We can choose to plot eg only mean, or mean and
overdispersion, etc, and only MA plot, MA plot and volcano, etc.
BASiCS_PlotDE(Test) BASiCS_PlotDE(Test, Plots = c("MA", "Volcano")) BASiCS_PlotDE(Test, Plots = "MA", Parameters = "Mean")
Due to the confounding between mean and over-dispersion that is
typically observed in scRNA-seq datasets, the non-regression BASiCS model
(run using Regression = FALSE
as a function parameter in BASiCS_MCMC
)
can only be used to assess changes in over-dispersion for those genes in which
the mean expression does not change between the groups. In this case, we
recommend users to use EpsilonM = 0
as a conservative option to avoid
changes in over-dispersion to be confounded by mean expression (the genes for
which mean expression changes are marked as ExcludedFromTesting
in the
ResultDiffDisp
field).
Test <- BASiCS_TestDE( Chain1 = ChainSC, Chain2 = ChainRNA, GroupLabel1 = "SC", GroupLabel2 = "PaS", EpsilonM = 0, EpsilonD = log2(1.5), EFDR_M = 0.10, EFDR_D = 0.10, Offset = TRUE, PlotOffset = FALSE, Plot = FALSE )
Note: If the regression BASiCS model has been
used (Regression = TRUE
as a function parameter in BASiCS_MCMC
),
BASiCS_TestDE
will also report changes in residual over-dispersion
(not confounded by mean expression) between the groups (see Section
\@ref(alternative-implementation-modes) in this vignette).
Beyond its original implementation, BASiCS has been extended to address experimental designs in which spike-in molecules are not available as well as to address the confounding that is typically observed between mean and over-dispersion for scRNA-seq datasets [@eling2018correcting]. Alternative implementation modes are summarised below:
As a default, the BASiCS_MCMC
function uses WithSpikes = TRUE
.
WithSpikes = FALSE
When technical spike-in genes are not available, BASiCS uses a horizontal
integration strategy which borrows information across multiple technical
replicates [@eling2018correcting]. Therefore, BASiCS_MCMC
will fail to run if a
single batch of samples is provided. Note: batch information must be
provided via the BatchInfo
argument when using the newBASiCS_Data
function
or BatchInfo
must be stored as a slot in colData(Data)
when using an
existing SingleCellExperiment
object.
DataNoSpikes <- newBASiCS_Data( Counts, Tech, SpikeInfo = NULL, BatchInfo = rep(c(1, 2), each = 20) ) # Alternatively DataNoSpikes <- SingleCellExperiment( assays = list(counts = Counts), colData = data.frame(BatchInfo = rep(c(1, 2), each = 20)) ) ChainNoSpikes <- BASiCS_MCMC( Data = DataNoSpikes, N = 1000, Thin = 10, Burn = 500, WithSpikes = FALSE, Regression = TRUE, PrintProgress = FALSE )
Regression = TRUE
The BASiCS model uses a joint informative prior formulation to account for the relationship between mean and over-dispersion gene-specific parameters. The latter is used to infer a global regression trend between these parameters and, subsequently, to derive a residual over-dispersion measure that is defined as departures with respect to this trend.
DataRegression <- newBASiCS_Data( Counts, Tech, SpikeInfo, BatchInfo = rep(c(1, 2), each = 20) ) ChainRegression <- BASiCS_MCMC( Data = DataRegression, N = 1000, Thin = 10, Burn = 500, Regression = TRUE, PrintProgress = FALSE )
This implementation provides additional functionality when performing
downstream analyses. These are illustrated below using a small extract from
the MCMC chain obtained when analysing the dataset provided in
[@grun2014validation] (single cell versus pool-and-split samples). These are
included within BASiCS
as the ChainSCReg
and ChainRNAReg
datasets.
To visualize the fit between over-dispersion $\delta_i$ and mean expression $ \mu_i$ the following function can be used.
data("ChainRNAReg") BASiCS_ShowFit(ChainRNAReg)
The BASiCS_TestDE
test function will automatically perform differential
variability testing based on the residual over-dispersion parameters
$\epsilon_i$ when its output includes two Chain
objects that were generated
by the regression BASiCS model.
data("ChainSCReg") Test <- BASiCS_TestDE( Chain1 = ChainSCReg, Chain2 = ChainRNAReg, GroupLabel1 = "SC", GroupLabel2 = "PaS", EpsilonM = log2(1.5), EpsilonD = log2(1.5), EpsilonR = log2(1.5) / log2(exp(1)), EFDR_M = 0.10, EFDR_D = 0.10, Offset = TRUE, PlotOffset = FALSE, Plot = FALSE )
This test function outputs an extra slot containing the results of the
differential testing residual over-dispersion test. Only genes that are
expressed in at least 2 cells (in both groups) are included in the test.
Genes that do not satisfy this condition are marked as ExcludedFromRegression
in the ResultDiffResDisp
field. By performing the regression,
all genes can be tested for changes in expression variability independent of
changes in mean expression.
head(as.data.frame(Test, Parameter = "ResDisp")) BASiCS_PlotDE(Test, Parameters = "ResDisp")
Note: Additional parameters for this sampler include: k
number of
regression components (k
-2 radial basis functions, one intercept and one
linear component), Var
the scale parameter influencing the width of the basis
functions and eta
the degrees of freedom. For additional details about these
choices, please refer to @eling2018correcting.
To externally store the output of BASiCS_MCMC
(recommended), additional
parameters StoreChains
, StoreDir
and RunName
are required. For example:
Data <- makeExampleBASiCS_Data() Chain <- BASiCS_MCMC( Data, N = 1000, Thin = 10, Burn = 500, Regression = TRUE, PrintProgress = FALSE, StoreChains = TRUE, StoreDir = tempdir(), RunName = "Example" )
In this example, the output of BASiCS_MCMC
will be stored as a BASiCS_Chain
object in the file "chain_Example.Rds", within the tempdir()
directory.
To load pre-computed MCMC chains,
Chain <- BASiCS_LoadChain("Example", StoreDir = tempdir())
To assess convergence of the chain, the convergence diagnostics provided by the
package coda
can be used. Additionally, the chains can be visually inspected.
For example:
plot(Chain, Param = "mu", Gene = 1, log = "y")
See help(BASiCS_MCMC)
for example plots associated to other model parameters.
In the figure above:
?acf
)To access the MCMC chains associated to individual parameter use the function
displayChainBASiCS
. For example,
displayChainBASiCS(Chain, Param = "mu")[1:2, 1:2]
As a summary of the posterior distribution, the function Summary
calculates
posterior medians and the High Posterior Density (HPD) intervals for each model
parameter. As a default option, HPD intervals contain 0.95 probability.
ChainSummary <- Summary(Chain)
The function displaySummaryBASiCS
extract posterior summaries for individual
parameters. For example
head(displaySummaryBASiCS(ChainSummary, Param = "mu"), n = 2)
The following figures display posterior medians and the corresponding HPD 95% intervals for gene-specific parameters $\mu_i$ (mean) and $\delta_i$ (over-dispersion)
par(mfrow = c(1, 2)) plot(ChainSummary, Param = "mu", main = "All genes", log = "y") plot(ChainSummary, Param = "delta", Genes = c(2, 5, 10, 50), main = "5 customized genes" )
See help(BASiCS_MCMC)
for example plots associated to other model parameters.
It is also possible to produce a matrix of normalised and denoised expression
counts for which the effect of technical variation is removed. For this purpose,
we implemented the function BASiCS_DenoisedCounts
. For each gene $i$ and
cell $j$ this function returns
$$
x^*{ij} = \frac{ x{ij} } {\hat{\phi}j \hat{\nu}_j},
$$
where $x{ij}$ is the observed expression count of gene $i$ in cell $j$,
$\hat{\phi}_j$ denotes the posterior median of $\phi_j$ and $\hat{\nu}_j$ is
the posterior median of $\nu_j$.
DenoisedCounts <- BASiCS_DenoisedCounts(Data = Data, Chain = Chain) DenoisedCounts[1:2, 1:2]
Note: the output of BASiCS_DenoisedCounts
requires no further
data normalisation.
Alternativelly, the user can compute the normalised and denoised expression
rates underlying the expression of all genes across cells using
BASiCS_DenoisedRates
. The output of this function is given by
$$
\Lambda_{ij} = \hat{\mu_i} \hat{\rho}{ij},
$$
where $\hat{\mu_i}$ represents the posterior median of $\mu_j$ and
$\hat{\rho}{ij}$ is given by its posterior mean (Monte Carlo estimate based
on the MCMC sample of all model parameters).
DenoisedRates <- BASiCS_DenoisedRates( Data = Data, Chain = Chain, Propensities = FALSE ) DenoisedRates[1:2, 1:2]
Alternative, denoised expression propensities $\hat{\rho}_{ij}$ can also be extracted
DenoisedProp <- BASiCS_DenoisedRates( Data = Data, Chain = Chain, Propensities = TRUE ) DenoisedProp[1:2, 1:2]
We first describe the model introduced in [1], which relates to a single group of cells.
Throughout, we consider the expression counts of $q$ genes, where $q_0$ are
expressed in the population of cells under study (biological genes) and the
remaining $q-q_0$ are extrinsic spike-in (technical) genes. Let $X_{ij}$ be a
random variable representing the expression count of a gene $i$ in cell $j$
($i=1,\ldots,q$; $j=1,\ldots,n$). BASiCS is based on the following hierarchical
model: $$X_{ij} \big| \mu_i, \phi_j, \nu_j, \rho_{ij} \sim \left{ \begin{array}{ll} \mbox{Poisson}(\phi_j \nu_j \mu_i \rho_{ij}), \mbox{ for }i=1,\ldots,q_0, j=1,\ldots,n \ \mbox{Poisson}(\nu_j \mu_i), \mbox{ for }i=q_0+1,\ldots,q, j=1,\ldots,n, \end{array} \right.$$
where $\nu_j$ and $\rho_{ij}$ are mutually independent random effects such that $\nu_j|s_j,\theta \sim \mbox{Gamma}(1/\theta,1/ (s_j \theta))$ and $\rho_{ij} | \delta_i \sim \mbox{Gamma} (1/\delta_i,1/\delta_i)$[^footnoteGamma].
A graphical representation of this model is displayed below. This is based on the expression counts of 2 genes ($i$: biological and $i'$: technical) at 2 cells ($j$ and $j'$). Squared and circular nodes denote known observed quantities (observed expression counts and added number of spike-in mRNA molecules) and unknown elements, respectively. Whereas black circular nodes represent the random effects that play an intermediate role in our hierarchical structure, red circular nodes relate to unknown model parameters in the top layer of hierarchy in our model. Blue, green and grey areas highlight elements that are shared within a biological gene, technical gene or cell, respectively.
In this setting, the key parameters to be used for downstream analyses are:
$\mu_i$: mean expression parameter for gene $i$ in the group of cells under study. In case of the spike-in technical genes, $\mu_i$ is assumed to be known and equal to the input number of molecules of the corresponding spike-in gene).
$\delta_i$: over-dispersion parameter for gene $i$, a measure for the excess of variation that is observed after accounting for technical noise (with respect to Poisson sampling)
Additional (nuisance) parameters are interpreted as follows:
$\phi_j$: cell-specific normalizing parameters related to differences in mRNA content (identifiability constrain: $\sum_{j=1}^n \phi_j = n$).
$s_j$: cell-specific normalizing parameters related to technical cell-specific biases (for more details regarding this interpretation see [@vallejos2017normalizing]).
$\theta$: technical over-dispersion parameter, controlling the strenght of cell-to-cell technical variability.
When cells from the same group are processed in multiple sequencing batches, this model is extended so that the technical over-dispersion parameter $\theta$ is batch-specific. This extension allows a different strenght of technical noise to be inferred for each batch of cells.
[^footnoteGamma]: We parametrize the Gamma distribution such that if $X \sim \mbox{Gamma}(a,b)$, then $\mbox{E}(X)=a/b$ and $\mbox{var}(X)=a/b^2$.
In @vallejos2016beyond, this model has been extended to cases where multiple groups of cells are under study. This is achieved by assuming gene-specific parameters to be also group-specific. Based on this setup, evidence of differential expression is quantified through log2-fold changes of gene-specific parameters (mean and over-dispersion) between the groups. Moreover, @eling2018correcting further extended this model by addressing the mean/over-dispersion confounding that is characteristic of scRNA-seq datasets as well as experimental designs where spike-ins are not available.
More details regarding the model setup, prior specification and implementation are described in @vallejos2015basics, @vallejos2016beyond and @eling2018correcting.
This work has been funded by the MRC Biostatistics Unit (MRC grant no. MRC_MC_UP_0801/1; Catalina Vallejos and Sylvia Richardson), EMBL European Bioinformatics Institute (core European Molecular Biology Laboratory funding; Catalina Vallejos, Nils Eling and John Marioni), CRUK Cambridge Institute (core CRUK funding; John Marioni) and The Alan Turing Institute (EPSRC grant no. EP/N510129/1; Catalina Vallejos).
We thank several members of the Marioni laboratory (EMBL-EBI; CRUK-CI) for support and discussions throughout the development of this R library. In particular, we are grateful to Aaron Lun (LTLA) for advise and support during the preparation the Bioconductor submission.
We also acknowledge feedback, bug reports and contributions from (Github aliases provided within parenthesis): Ben Dulken (bdulken), Chang Xu (xuchang116), Danilo Horta (Horta), Dmitriy Zhukov (dvzhukov), Jens Preußner (jenzopr), Joanna Dreux (Joannacodes), Kevin Rue-Albrecht (kevinrue), Luke Zappia (lazappi), Nitesh Turaga (nturaga), Mike Morgan (MikeDMorgan), Muad Abd El Hay (Cumol), Simon Anders (s-andrews), Shian Su (Shians), Yongchao Ge and Yuan Cao (yuancao90), among others.
sessionInfo()
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.