Standard RNA-seq processing

This tutorial assumes that the reader is familiar with the limma/voom workflow for RNA-seq. Process raw count data using limma/voom.

Limma Analysis

Limma has a built-in approach for analyzing repeated measures data using duplicateCorrelation. The model can handle a single random effect, and forces the magnitude of the random effect to be the same across all genes.

Dream Analysis

The dream model operates directly on the results of voom. The only change compared to the standard limma workflow is to replace lmFit with dream.

## Projected run time: ~ 22 min
##                                    logFC  AveExpr        t      P.Value    adj.P.Val        B
## ENST00000283033.5 gene=TXNDC11  1.555819 3.567624 38.95624 6.095513e-23 1.180335e-18 37.34041
## ENST00000257181.9 gene=PRPF38A  1.382756 4.398270 27.97231 1.294100e-19 1.252947e-15 32.37189
## ENST00000525790.1 gene=TDRKH    1.496308 3.184931 21.74513 3.993169e-17 2.577457e-13 27.93311
## ENST00000264485.5 gene=SLC4A4   1.415366 4.476664 21.06019 8.205862e-17 3.179989e-13 27.33875
## ENST00000421974.2 gene=ATP6V0E2 1.372569 3.478030 21.05959 8.211084e-17 3.179989e-13 27.33822
## ENST00000373277.4 gene=SH2D3C   1.383826 3.509569 20.86909 1.007023e-16 3.250000e-13 27.16847
## ENST00000295633.3 gene=FSTL1    1.387415 4.625435 20.11317 2.301915e-16 6.367756e-13 26.47500
## ENST00000339861.4 gene=SEMA4D   1.396601 4.186466 19.27068 5.980852e-16 1.447665e-12 25.66286
## ENST00000231454.1 gene=IL5      1.493454 1.789759 18.88681 9.355289e-16 2.012842e-12 25.27836
## ENST00000577031.1 gene=PAM16    1.460190 1.137609 18.72485 1.132607e-15 2.193180e-12 25.11331

Note that if random effect is not specified, dream() automatically uses lmFit().

Small-sample method

For small datasets, the Kenward-Roger method can be more powerful. But it is substantially more computationally intensive.

Advanced use of contrasts

You can also perform a hypothesis test between two levels. Make sure to inspect your contrast matrix to confirm it is testing what you intend.

## Disease0 Disease1 
##       -1        1

Multiple contrasts can be evaluated at the same time, in order to save computation time:

##                                   logFC  AveExpr         t      P.Value    adj.P.Val        B
## ENST00000555834.1 gene=RPS6KL1 4.823537 5.272063 43.777871 5.746984e-36 5.746984e-35 72.05232
## ENST00000418210.2 gene=TMEM64  4.199542 4.715367 42.831551 1.378099e-35 6.890497e-35 71.19120
## ENST00000589123.1 gene=NFIC    5.470103 5.855335 39.321376 4.187514e-34 1.395838e-33 67.81732
## ENST00000248564.5 gene=GNG11   3.987147 4.511181 30.468062 1.006329e-29 2.515822e-29 57.75474
## ENST00000337859.6 gene=ZC3H15  3.748305 4.169523 25.511167 1.000430e-26 2.000861e-26 50.81190
## ENST00000263773.5 gene=FNBP4   4.895809 5.290530 11.051768 2.139468e-21 3.565780e-21 38.92091
## ENST00000456159.1 gene=MET     1.953973 2.458926 17.662426 9.717046e-21 1.388149e-20 36.86500
## ENST00000317802.7 gene=TSPYL6  3.802265 4.321189 10.576765 2.125997e-20 2.657497e-20 36.64483
## ENST00000360314.3 gene=CASS4   4.305729 4.633301  9.966079 4.441061e-19 4.934512e-19 33.60114
## ENST00000570099.1 gene=YPEL3   1.580904 2.063331  7.695019 7.951197e-14 7.951197e-14 21.17065

variancePartition plot

Dream and variancePartition share the same underlying linear mixed model framework. A variancePartition analysis can indicate important variables that should be included as fixed or random effects in the dream analysis.

## Projected run time: ~ 3 min

Compare p-values from dream and duplicateCorrelation

In order to understand the empircal difference between dream and duplication correlation, we can plot the \(-\log_{10}\) p-values from both methods.

The duplicateCorrelation method estimates a single variance term genome-wide even though the donor contribution of a particular gene can vary substantially from the genome-wide trend. Using a single value genome-wide for the within-donor variance can reduce power and increase the false positive rate in a particular, reproducible way. Let \(\tau^2_g\) be the value of the donor component for gene \(g\) and \(\bar{\tau}^2\) be the genome-wide mean. For genes where \(\tau^2_g>\bar{\tau}^2\), using \(\bar{\tau}^2\) under-corrects for the donor component so that it increases the false positive rate compared to using \(\tau^2_g\). Conversely, for genes where \(\tau^2_g<\bar{\tau}^2\), using \(\bar{\tau}^2\) over-corrects for the donor component so that it decreases power. Increasing sample size does not overcome this issue. The dream method overcomes this issue by using a \(\tau^2_g\).

Here, the \(-\log_{10}\) p-values from both methods are plotted and colored by the donor contribution estiamted by variancePartition. The green value indicates \(\bar{\tau}^2\), while red and blue indicate higher and lower values, respectively. When only one variance component is used and the contrast matrix is simple, the effect of using dream versus duplicateCorrelation is determined by the comparison of \(\tau^2_g\) to \(\bar{\tau}^2\):

dream can increase the \(-\log_{10}\) p-value for genes with a lower donor component (i.e. \(\tau^2_g<\bar{\tau}^2\)) and decrease \(-\log_{10}\) p-value for genes with a higher donor component (i.e. \(\tau^2_g>\bar{\tau}^2\))

Note that using more variance components or a more complicated contrast matrix can make the relationship more complicated.

Session info

## R version 3.5.1 Patched (2018-07-12 r74967)
## Platform: x86_64-apple-darwin15.6.0 (64-bit)
## Running under: OS X El Capitan 10.11.6
## 
## Matrix products: default
## BLAS: /Library/Frameworks/R.framework/Versions/3.5/Resources/lib/libRblas.0.dylib
## LAPACK: /Library/Frameworks/R.framework/Versions/3.5/Resources/lib/libRlapack.dylib
## 
## locale:
## [1] C/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8
## 
## attached base packages:
## [1] parallel  stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
##  [1] doParallel_1.0.14        iterators_1.0.10         edgeR_3.22.5            
##  [4] variancePartition_1.10.4 Biobase_2.40.0           BiocGenerics_0.26.0     
##  [7] scales_1.0.0             foreach_1.4.4            limma_3.36.5            
## [10] ggplot2_3.0.0            pander_0.6.2            
## 
## loaded via a namespace (and not attached):
##  [1] Rcpp_0.12.19       locfit_1.5-9.1     lattice_0.20-35    gtools_3.8.1       assertthat_0.2.0  
##  [6] rprojroot_1.3-2    digest_0.6.18      R6_2.3.0           plyr_1.8.4         backports_1.1.2   
## [11] evaluate_0.12      pillar_1.3.0       gplots_3.0.1       rlang_0.2.2        lazyeval_0.2.1    
## [16] minqa_1.2.4        gdata_2.18.0       nloptr_1.2.1       Matrix_1.2-14      rmarkdown_1.10    
## [21] labeling_0.3       splines_3.5.1      lme4_1.1-18-1      statmod_1.4.30     stringr_1.3.1     
## [26] munsell_0.5.0      compiler_3.5.1     numDeriv_2016.8-1  pkgconfig_2.0.2    lmerTest_3.0-1    
## [31] htmltools_0.3.6    tidyselect_0.2.5   tibble_1.4.2       codetools_0.2-15   crayon_1.3.4      
## [36] dplyr_0.7.6        withr_2.1.2        MASS_7.3-50        bitops_1.0-6       grid_3.5.1        
## [41] nlme_3.1-137       gtable_0.2.0       magrittr_1.5       KernSmooth_2.23-15 stringi_1.2.4     
## [46] reshape2_1.4.3     bindrcpp_0.2.2     colorRamps_2.3     tools_3.5.1        glue_1.3.0        
## [51] purrr_0.2.5        pbkrtest_0.4-7     yaml_2.2.0         colorspace_1.3-2   caTools_1.17.1.1  
## [56] knitr_1.20         bindr_0.1.1

References

Law, C. W., Y. Chen, W. Shi, and G. K. Smyth. 2014. “Voom: precision weights unlock linear model analysis tools for RNA-seq read counts.” Genome Biology 15 (2):R29. https://doi.org/10.1186/gb-2014-15-2-r29.