Construct Cohort Inclusion and Restriction Criteria Expressions

Wraps the 'CIRCE' (< https://github.com/ohdsi/circe-be>) 'Java' library allowing cohort definition expressions to be edited and converted to 'Markdown' or 'SQL'.

CirceR

CirceR is part of HADES.

Introduction

A R-wrapper for Circe, a library for creating queries for the OMOP Common Data Model. These queries are used in cohort definitions (CohortExpression) as well as custom features (CriteriaFeature). This package provides convenient wrappers for Circe functions, and includes the necessary Java dependencies.

Features

• Convert a JSON cohort expression into a markdown print-friendly presentation.
• Convert a JSON cohort expression into SQL.

Examples

# use an example JSON cohort expression:
data(cohortDefinitionJson)

cohortExpresion <- cohortExpressionFromJson(cohortDefinitionJson)
markdown <- cohortPrintFriendly(cohortExpresion)
writeLines(markdown)
 
# ### Cohort Entry Events
# 
# People enter the cohort when observing any of the following:
# 
# 1. condition occurrences of 'Some ConceptSet'.
# 
# Limit cohort entry events to the earliest event per person.
# 
# ### Cohort Exit
# 
# The person exits the cohort at the end of continuous observation.
# 
# ### Cohort Eras
# 
# Entry events will be combined into cohort eras if they are within 0 days of each other.

Technology

CirceR is an R package wrapped around a Java library.

System Requirements

Requires R (version 3.2.2 or higher). CirceR require Java.

Getting Started

1. See the instructions here for configuring your R environment, including Java.

2. In R, use the following commands to download and install CirceR:

install.packages("remotes")
remotes::install_github("ohdsi/CirceR")

User Documentation

The documentation website can be found at https://ohdsi.github.io/CirceR/. A PDF version of the package manual is here:

• Package manual: CirceR manual

Support

• Developer questions/comments/feedback: OHDSI Forum
• We use the GitHub issue tracker for all bugs/issues/enhancements

Contributing

Read here how you can contribute to this package.

License

CirceR is licensed under Apache License 2.0

Development

CirceR is being developed in R Studio.

Development status

Beta. Use at your own risk.