Skip to content
Repo for corrcoverage package
R C++
Branch: master
Clone or download
Latest commit a622418 Sep 9, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
R final push for cran release (1050a82) Aug 28, 2019
inst/extdata Slight amendment of vignette and many more tests added Feb 11, 2019
man final push for cran release (1050a82) Aug 28, 2019
src final push for cran release (1050a82) Aug 28, 2019
tests cran resubmission Aug 27, 2019
vignettes
.Rbuildignore
.gitignore v1.1.9000 update Sep 9, 2019
.travis.yml
DESCRIPTION v1.1.9000 update Sep 9, 2019
LICENSE cran Aug 26, 2019
LICENSE.md
NAMESPACE
NEWS.md
README.md v1.1.9000 update Sep 9, 2019
_pkgdown.yml final push for cran release (1050a82) Aug 28, 2019
codecov.yml

README.md

corrcoverage

Coverage status Build Status

Webpage: https://annahutch.github.io/corrcoverage/

The corrcoverage R package uses a computationally efficient algorithm to find accurate coverage estimates of the causal variant in credible sets of prioritised variants from single causal variant genetic fine mapping (Maller et al., 2012, Wakefield, 2009.).

The package only requires GWAS summary statistics and can be used to:

  • Perform single causal variant Bayesian fine-mapping
  • Estimate the true genetic effect at the causal variant (see est_mu function)
  • Obtain an accurate coverage estimate that the causal variant is contained within a credible set, the "corrected coverage estimate" (see Corrected Coverage vignette)
  • Find a new corrected credible set with the desired coverage of the true causal variant (see Corrected Credible Set vignette)

We've strived to make our R package as easy to use as possible. Please see the flowchart below to decide which function is best to solve your problem. The interactive version (click-to-functions) is available here.


Installation

We recommend that all users download the package straight from github, as this contains a more complete version of the package:

install.packages("devtools") # if not already installed
devtools::install_github("annahutch/corrcoverage")

Alternatively (and if using a solaris operating system) download straight from cran using:

install.packages("corrcoverage")

Examples

For examples, please see the relevant vignettes.

  1. The Corrected Coverage vignette here should be read first. This shows readers how to use the corrcoverage R package to get an accurate coverage estimate of the causal variant in a credible set.

  2. The Corrected Credible Set vignette here follows on from the Corrected Coverage vignette and shows readers how the corrcoverage R package can be used to obtain a new credible set with the desired coverage of the causal variant.

  3. The Useful Info vignette here provides supplementary information about the usage of the package, including information about other useful functions.


In brief, the correction method involves simulating many credible sets from the same system as the original and calculating what proportion of these contain the true causal variant. Since the true causal variant is unknown, each variant is considered as causal in turn and the proportions are normalised by that variant’s posterior probability of causality.


Abstract

Genome Wide Association Studies (GWAS) have successfully identified thousands of loci associated with human diseases. Bayesian genetic fine-mapping studies aim to identify the specific causal variants within GWAS loci responsible for each association, reporting credible sets of plausible causal variants, which are interpreted as containing the causal variant with some "coverage probability".

Here, we investigate the coverage probabilities of credible sets through simulations and find that these are systematically biased. We present a method to re-estimate the coverage of credible sets using rapid simulations based on the observed, or estimated, SNP correlation structure, we call this the “corrected coverage estimate”. This is extended to find “corrected credible sets”, which are the smallest set of variants such that their corrected coverage estimate meets the target coverage.

We use our method to improve the resolution of a fine-mapping study of type 1 diabetes. We found that in 27 out of 39 associated genomic regions our method could reduce the number of potentially causal variants to consider for follow-up, and found that none of the 95% or 99% credible sets required the inclusion of more variants – a pattern matched in simulations of well powered GWAS.

Crucially, our correction method requires only GWAS summary statistics and remains accurate when SNP correlations are estimated from a large reference panel. Using our method to improve the resolution of fine-mapping studies will enable more efficient expenditure of resources in the follow-up process of annotating the variants in the credible set to determine the implicated genes and pathways in human diseases.


You can’t perform that action at this time.