CirceR is part of HADES.


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.


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


# use an example JSON cohort expression:

cohortExpresion <- cohortExpressionFromJson(cohortDefinitionJson)
markdown <- cohortPrintFriendly(cohortExpresion)
# ### 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.


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:


User Documentation

The documentation website can be found at A PDF version of the package manual is here:



Read here how you can contribute to this package.


CirceR is licensed under Apache License 2.0


CirceR is being developed in R Studio.

Development status

Beta. Use at your own risk.