Learn R Programming

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:

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.

Copy Link

Version

Install

install.packages('CirceR')

Monthly Downloads

1,373

Version

1.3.3

License

Apache License 2.0

Issues

Pull Requests

Stars

Forks

Maintainer

Chris Knoll

Last Published

April 18th, 2024

Functions in CirceR (1.3.3)

buildConceptSetQuery

Build conceptset SQL
CirceR-package

CirceR: Construct Cohort Inclusion and Restriction Criteria Expressions
conceptSetExpressionFromJson

Render read JSON into a ConceptSetExpression instance
buildCohortQuery

Build cohort SQL
conceptSetListPrintFriendly

Render conceptSet array for print-friendly
cohortPrintFriendly

Render cohort print-friendly
cohortExpressionFromJson

Render read JSON into a CohortExpression instance
conceptSetPrintFriendly

Render conceptSet array for print-friendly
createGenerateOptions

Create Generation Options
conceptSetListJson

An example concept set list
conceptSetJson

An example concept set
cohortDefinitionJson

An example cohort definition