OHDSI / ROhdsiWebApi

An R package for interfacing with a WebAPI instance
https://ohdsi.github.io/ROhdsiWebApi
10 stars 17 forks source link
hades

ROhdsiWebApi

Build Status codecov.io

ROhdsiWebApi is part of HADES.

Introduction

ROhdsiWebApi is a R based interface to ‘WebApi’ (OHDSI RESTful services), and performs GET/PULL/POST/DELETE calls via the WebApi. All objects starting from R or output to R - are analysis ready R-objects like list and data.frame. The package handles the intermediary steps by converting R-objects to JSON and vice versa. To ensure r-objects are analysis ready, the objects are type converted where possible, e.g. date/date time are converted from string to POSIXct.

This package makes reproducible research easier, by offering ability to retrieve detailed study specifications, transport study specifications from one instance to another, programmatically invoke the generation of a sequence of steps that are part of a study, manage running studies in batch mode.

An example of a WebApi endpoint is “http://server.org:80/WebAPI”.

Generic design pattern:

The package follows a consistent naming conventions - with the identifier for the functional category clearly in the name. There are no direct reference to ‘Atlas’, and instead ‘WebApi’ is used = because the package is designed to interface directly with WebApi.

Supported WebApi functional categories.

Category Features
ConceptSet Functions for interfacing with ConceptSet in WebApi
Cohort Functions for interfacing with Cohort in WebApi
IncidenceRate Functions for interfacing with IncidenceRate in WebApi
Estimation Functions for interfacing with Estimation in WebApi
Prediction Functions for interfacing with Prediction in WebApi
Characterization Functions for interfacing with Characterization in WebApi
Pathway Functions for interfacing with Pathway in WebApi

Technology

ROhdsiWebApi is an R package. Note: ROhdsiWebApi relies on the availability of a WebApi. The documentation of the WebApi (OHDSI RESTful services).

Note: As of V1.0.0, we do not support WebApi that has security enabled. This is considered a road map item.

System Requirements

Requires R. WebApi.

Installation

remotes::install_github("OHDSI/ROhdsiWebApi")

User Documentation

Documentation can be found on the package website.

PDF versions of the documentation are also available:

Support

Contributing

Read here how you can contribute to this package.

License

ROhdsiWebApi is licensed under Apache License 2.0

Development

ROhdsiWebApi is being developed in R Studio.