epigraphdb-r

R package for epigraphdb

https://github.com/mrcieu/epigraphdb-r

Science Score: 23.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 6 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
    2 of 3 committers (66.7%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.6%) to scientific vocabulary

Keywords

api-client bioinformatics epidemiology graph-database mendelian-randomization phenotypes
Last synced: 6 months ago · JSON representation

Repository

R package for epigraphdb

Basic Info
Statistics
  • Stars: 28
  • Watchers: 9
  • Forks: 8
  • Open Issues: 2
  • Releases: 0
Topics
api-client bioinformatics epidemiology graph-database mendelian-randomization phenotypes
Created over 6 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

EpiGraphDB R package epigraphdb

CRAN status Codecov test coverage

EpiGraphDB is an analytical platform and database to support data mining in epidemiology. The platform incorporates a graph of causal estimates generated by systematically applying Mendelian randomization to a wide array of phenotypes, and augments this with a wealth of additional data from other bioinformatic sources. EpiGraphDB aims to support appropriate application and interpretation of causal inference in systematic automated analyses of many phenotypes.

epigraphdb is an R package to provide ease of access to EpiGraphDB services. We will refer to epigraphdb as the name of the R package whereas "EpiGraphDB" as the overall platform.

Installation

To install the latest development version from github ( devtools is required ): ```r

install.packages("devtools")

devtools::install_github("MRCIEU/epigraphdb-r") ```

To install a stable version from CRAN: r install.packages("epigraphdb")

NOTE: while the package repository is "epigraphdb-r", the R package name is "epigraphdb".

Using epigraphdb

epigraphdb provides a simple and intuitive way to query the API, as:

```r library("epigraphdb")

>

> EpiGraphDB v1.0 (API: https://api.epigraphdb.org)

>

mr(outcome_trait = "Body mass index")

> # A tibble: 370 x 12

> exposureid exposurename outcomeid outcomename estimate se

>

> 1 627 Epiandroster… 785 Body mass i… 0.0950 2.28e-3

> 2 541 X-11787 835 Body mass i… -0.0578 1.77e-4

> 3 971 Ulcerative c… 835 Body mass i… -0.0111 1.76e-4

> 4 60 Waist circum… 835 Body mass i… 0.861 2.07e-2

> 5 UKB-a:426 Eye problems… 94 Body mass i… -1.12 1.90e-2

> 6 UKB-a:373 Ever depress… 95 Body mass i… -0.616 4.80e-4

> 7 29 Birth length 95 Body mass i… -0.141 5.67e-4

> 8 350 Laurate (12:… 974 Body mass i… 0.418 7.10e-3

> 9 UKB-a:124 Treatment/me… 974 Body mass i… -5.14 1.08e-1

> 10 95 Body mass in… 974 Body mass i… 0.981 2.79e-2

> # … with 360 more rows, and 6 more variables: p , ci_upp ,

> # ci_low , selection , method , moescore )

```

For more information on how to use the epigraphdb R package and how to use the API in R please check out the following articles:

| Article | |---| | Getting started with EpiGraphDB in R | | Using EpiGraphDB R package | | Using EpiGraphDB API (from R and command line) | | Package options| | Meta functionalities of the EpiGraphDB platform| | Case study 1: Distinguishing vertical and horizontal pleiotropy for SNP-protein associations| | Case study 2: Identification of potential drug targets| | Case study 3: Triangulating causal estimates with literature evidence|

Package functionalities

Users can use the general query function query_epigraphdb to get data from an API endpoint on EpiGraphDB without having to deal with HTTP requests by themselves. We also provide a list of functions (see the table below) that are equivalent to the upstream endpoints for the ease of use.

API r package
General query
query_epigraphdb
Topic queries
GET /mr mr
GET /ontology/gwas-efo ontology_gwas_efo
GET /obs-cor obs_cor
GET /genetic-cor genetic_cor
GET /pqtl/ pqtl
GET /pqtl/pleio/ pqtl_pleio
GET /pqtl/list pqtl_list
GET /confounder confounder
GET /pathway pathway
GET /drugs/risk-factors drugs_risk_factors
GET /xqtl/multi-snp-mr xqtl_multi_snp_mr
GET /xqtl/single-snp-mr xqtl_single_snp_mr
GET /literature/gwas literature_gwas
POST /protein/in-pathway protein_in_pathway
Utilities
POST /mappings/gene-to-protein mappings_gene_to_protein
GET /meta/nodes/list meta_nodes_list
GET /meta/rels/list meta_rels_list
GET /meta/nodes/{meta_node}/list meta_nodes_list_node
GET /meta/rels/{meta_rel}/list meta_rels_list_rel
GET /meta/nodes/{meta_node}/search meta_nodes_search_node
POST /cypher cypher

Contributing

If you would like to contribute to this package, please check out documentation on setting up development and currently planned updates.

EpiGraphDB resources

| link | screenshot | |-----------------------------------------------------|-------------------------------------------------------| | docs | docs | | API | api | | web application | webapp | | r package | epigraphdb-r |

Citation

Please cite EpiGraphDB as

Yi Liu, Benjamin Elsworth, Pau Erola, Valeriia Haberland, Gibran Hemani, Matt Lyon, Jie Zheng, Oliver Lloyd, Marina Vabistsevits, Tom R Gaunt, EpiGraphDB: a database and data mining platform for health data science, Bioinformatics, btaa961, https://doi.org/10.1093/bioinformatics/btaa961

@article{epigraphdb2020bioinformatics, author = {Liu, Yi and Elsworth, Benjamin and Erola, Pau and Haberland, Valeriia and Hemani, Gibran and Lyon, Matt and Zheng, Jie and Lloyd, Oliver and Vabistsevits, Marina and Gaunt, Tom R}, title = {{EpiGraphDB}: a database and data mining platform for health data science}, journal = {Bioinformatics}, year = {2020}, month = {11}, issn = {1367-4803}, doi = {10.1093/bioinformatics/btaa961}, url = {https://doi.org/10.1093/bioinformatics/btaa961}, note = {btaa961}, eprint = {https://academic.oup.com/bioinformatics/advance-article-pdf/doi/10.1093/bioinformatics/btaa961/34178613/btaa961.pdf} }

Contact

Please get in touch with us for issues, comments, suggestions, etc. via the following methods:

Owner

  • Name: MRC Integrative Epidemiology Unit
  • Login: MRCIEU
  • Kind: organization
  • Location: University of Bristol, UK

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 204
  • Total Committers: 3
  • Avg Commits per committer: 68.0
  • Development Distribution Score (DDS): 0.098
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
YiLiu6240 y****0@g****m 184
Marina Vabistsevits n****5@b****k 18
Val Haberland v****2@b****k 2
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 7 months ago

All Time
  • Total issues: 2
  • Total pull requests: 6
  • Average time to close issues: 23 minutes
  • Average time to close pull requests: about 1 hour
  • Total issue authors: 2
  • Total pull request authors: 3
  • Average comments per issue: 1.5
  • Average comments per pull request: 0.17
  • Merged pull requests: 5
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 1.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • lorenzwalthert (1)
  • mcgml (1)
Pull Request Authors
  • mvab (3)
  • remlapmot (2)
  • YiLiu6240 (2)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • cran 313 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 3
  • Total maintainers: 1
cran.r-project.org: epigraphdb

Interface Package for the 'EpiGraphDB' Platform

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 313 Last month
Rankings
Forks count: 9.6%
Stargazers count: 11.2%
Average: 19.5%
Downloads: 23.7%
Dependent repos count: 24.0%
Dependent packages count: 28.8%
Maintainers (1)
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • glue * imports
  • httr * imports
  • jsonlite * imports
  • magrittr * imports
  • purrr * imports
  • tibble * imports
  • covr * suggests
  • devtools * suggests
  • dplyr * suggests
  • ggplot2 * suggests
  • gtools * suggests
  • igraph * suggests
  • knitr * suggests
  • lintr * suggests
  • pkgdown * suggests
  • rmarkdown * suggests
  • roxygen2 * suggests
  • spelling * suggests
  • stringr * suggests
  • styler * suggests
  • testthat * suggests
  • usethis * suggests