Simulate RNA-seq Data from Real Data"

  collapse = TRUE,
  echo = requireNamespace("airway", quietly = TRUE),
  eval = requireNamespace("airway", quietly = TRUE),
  comment = "#>",
  fig.align = "center",
  fig.height = 7,
  fig.width = 7

```{block, eval = FALSE, echo = !requireNamespace("airway", quietly = TRUE)} This vignette was not fully built because the airway package was missing:

To install the airway package, run:

if (!requireNamespace("BiocManager", quietly = TRUE))


```{block, eval = FALSE, echo = !requireNamespace("airway", quietly = TRUE)} You can find this vignette online at:

```{block, eval = FALSE}
# Abstract 

```{block, eval = FALSE} We demonstrate how one may use seqgendiff in differential expression simulation studies using the airway data from Himes et al (2014). We use seqgendiff to simulate one dataset which we then analyze with two pipelines: the sva-voom-limma-eBayes-qvalue pipeline, and the sva-DESeq2-qvalue pipeline. In practice, you would simulate many datasets and compare average performance. But playing with a single dataset can help you gain intuition with various methods.

```{block, eval = FALSE}
The methods used here are described in Gerard (2020).

```{block, eval = FALSE}


```{block, eval = FALSE}
Set the seed for reproducibility:

```{block, eval = FALSE} The airway data are available in the airway R package from Bioconductor. If you don't have this package, you can install it with the BiocManager package:

if (!requireNamespace("BiocManager", quietly = TRUE))


```{block, eval = FALSE} Now we can load these data into R.


```{block, eval = FALSE} You can read about these data here.

```{block, eval = FALSE}
These are the other packages that we'll need for this vignette:

``{block, eval = FALSE} The last five packages are all from Bioconductor, which you need to install usingBiocManager::install()`.

```{block, eval = FALSE}
The airway dataset comes with a few observed variables which affect gene
expression. We'll consider these "surrogate variables". That is, we'll
add signal to the data and try to account for these surrogate variables.
coldat <- colData(airway)[, c("cell", "dex")]
true_sv <- model.matrix(~cell + dex, data = coldat)[, -1]

```{block, eval = FALSE} Suppose we want to add a treatment effect to the RNA-seq data. We'll first remove all genes with no counts:

allzero <- rowSums(assay(airway)) < 10^-6
airway <- airway[!allzero, ]

``{block, eval = FALSE} Then we'll use the convenientthin_2group()` function from the seqgendiff package to add a $N(0, 0.8^2)$ log2-effect size to 10% of the genes:

thout <- thin_2group(mat = assay(airway), 
                     prop_null = 0.9, 
                     signal_fun = stats::rnorm,
                     signal_params = list(mean = 0, sd = 0.8))

```{block, eval = FALSE} Let's see how well the sva-voom-limma-ebayes-qvalue pipeline does estimating these effects. First, we'll fit this pipeline.

X <- cbind(thout$design_obs, thout$designmat)
Y <- log2(thout$mat + 0.5)
n_sv <- = Y, mod = X)
svout <- sva(dat = Y, mod = X, = n_sv)
vout <- voom(counts = thout$mat, design = cbind(X, svout$sv))
lout <- lmFit(vout)
eout <- eBayes(lout)
qout <- qvalue(p = eout$p.value[, 2])
bhat <- eout$coefficients[, 2]

```{block, eval = FALSE} We plot the coefficient estimates against their true values.

     xlab = "True Coefficients", 
     ylab = "Estimated Coefficients")
abline(0, 1, col = 2, lwd = 2)

```{block, eval = FALSE} We plot the q-values against the null status of each gene.

is_null_gene <- abs(thout$coefmat) < 10^-6
boxplot(qout$qvalues ~ is_null_gene,
        xlab = "Null Gene",
        ylab = "q-value")

``{block, eval = FALSE} Does the sva-DESeq2 pipeline do any better? We'll first useseqgendiff::ThinDataToDESeqDataSet()to convert theThinDataobjectthoutinto aDESeqDataSet` object.

thout$design_obs <- cbind(thout$design_obs, svout$sv)
dds <- ThinDataToDESeqDataSet(obj = thout)

``{block, eval = FALSE} Note that we added the estimated surrogate variables from sva to theThinDataobject before converting to aDESeqDataSet` object.

```{block, eval = FALSE}
Now we will fit DESeq2.
dds <- DESeq(object = dds)
pval_dds <- rowData(dds)[, "WaldPvalue_P1"]
qval_dds <- qvalue(p = pval_dds)

```{block, eval = FALSE} We plot the coefficient estimates against their true values.

coefmat <- rowData(dds)[, c("true_P1", "P1")]
     xlab = "True Coefficients", 
     ylab = "Estimated Coefficients")
abline(0, 1, col = 2, lwd = 2)

```{block, eval = FALSE} We also plot the q-values against the null status of each gene.

boxplot(qval_dds$qvalues ~ is_null_gene,
        xlab = "Null Gene",
        ylab = "q-value")

```{block, eval = FALSE} The MSE is worse for DESeq2.

mse_limma <- mean((bhat - thout$coefmat) ^ 2)
mse_deseq2 <- mean((coefmat$true_P1 - coefmat$P1) ^ 2, na.rm = TRUE)

```{block, eval = FALSE} The FDP is about the same for the two pipelines. Both are OK, but conservative.

mean(is_null_gene[qval_dds$qvalues < 0.1], na.rm = TRUE)
mean(is_null_gene[qout$qvalues < 0.1], na.rm = TRUE)

```{block, eval = FALSE} DESeq2 has more discoveries

sum(qval_dds$qvalues < 0.1, na.rm = TRUE)
sum(qout$qvalues < 0.1, na.rm = TRUE)

```{block, eval = FALSE} As a side-note, it seems that the second surrogate variable is getting at the dexamethasone variable.

boxplot(svout$sv[, 2] ~ true_sv[, 4], 
        xlab = "Dexamethasone Treatment", 
        ylab = "2nd Surrogate Variable")
points(jitter(true_sv[, 4] + 1), svout$sv[, 2])

```{block, eval = FALSE}


```{block, eval = FALSE}
- Gerard, D (2020). "Data-based RNA-seq simulations by binomial thinning." _BMC Bioinformatics_. 21(1), 206. doi: [10.1186/s12859-020-3450-9](
- Himes, Blanca E., Xiaofeng Jiang, Peter Wagner, Ruoxi Hu, Qiyu Wang, 
  Barbara Klanderman, Reid M. Whitaker et al. "RNA-Seq transcriptome 
  profiling identifies CRISPLD2 as a glucocorticoid responsive gene that 
  modulates cytokine function in airway smooth muscle cells." 
  *PloS one* 9, no. 6 (2014): e99625.

Try the seqgendiff package in your browser

Any scripts or data that you put into this service are public.

seqgendiff documentation built on June 22, 2024, 7 p.m.