README.md
In RIVER: R package for RIVER (RNA-Informed Variant Effect on Regulation)

Status: Travis CI

RIVER

RIVER is an R package of a probabilistic modeling framework, RIVER (RNA-Informed Variant Effect on Regulation) that jointly analyzes personal genome (WGS) and transcriptome data (RNA-seq) to estimate the probability that a variant has regulatory impact in that individual. It is based on a generative model assuming that genomic annotations, such as the location of a variant with respect to regulatory elements, determine the prior probability that variant is a functional regulatory variant, which is an unobserved variable. The functional regulatory variant status then influences whether nearby genes are likely to display outlier levels of gene expression in that person. RIVER is trained in an unsupervised manner such that it does not require a labeled set of functional/non-functional variants; rather it derives its predictive power from identifying expression patterns that tend to coincide with particular rare variant annotations.

For more information about RIVER, check the vignettes.

For further details of a list of genomic annotations used for constructing features and how to generate the features and outlier status, please refer to our submitted publication.

Installation

Get most recent version of R (>= 3.3.2) from CRAN.

## try http:// if https:// URLs are not supported
if (!requireNamespace("BiocManager", quietly=TRUE))
    install.packages("BiocManager")
BiocManager::install("RIVER")

Vignettes

The vignettes for this package can be viewed via Bioconductor's website (manual backup).

Citation

Below is the citation output from using citation('RIVER') in R. Please run this yourself to check for any updates on how to cite RIVER.

To cite the RIVER package in publications use:

Xin Li, Yungil Kim, Emily K. Tsang, Joe R. Davis, Farhan N. Damani, Colby Chiang, Zachary Zappala, Benjamin J. Strober, Alexandra J. Scott, Andrea Ganna, Jason Merker, GTEx Consortium, Ira M. Hall, Alexis Battle, Stephen B. Montgomery (2016), "The impact of rare variation on gene expression across tissues", doi: https://doi.org/10.1101/074443, (URL: https://doi.org/10.1101/074443), .

A BibTeX entry for LaTeX users is

@article {Li074443, author = {Li, Xin and Kim, Yungil and Tsang, Emily K. and Davis, Joe R. and Damani, Farhan N. and Chiang, Colby and Zappala, Zachary and Strober, Benjamin J. and Scott, Alexandra J. and Ganna, Andrea and Merker, Jason and , and Hall, Ira M. and Battle, Alexis and Montgomery, Stephen B.}, title = {The impact of rare variation on gene expression across tissues}, year = {2016}, doi = {10.1101/074443}, publisher = {Cold Spring Harbor Labs Journals}, journal = {bioRxiv}, URL = {http://biorxiv.org/content/early/2016/09/09/074443} }