Build Status

CohortDiagnostics is part of HADES.


CohortDiagnostics is an R utility package for the development and evaluation of phenotype algorithms for OMOP CDM compliant data sets. This package provides a standard, end to end, set of analytics for understanding patient capture including data generation and result exploration through an R Shiny interface. Analytics computed include cohort characteristics, record counts, index event misclassification, captured observation windows and basic incidence proportions for age, gender and calendar year. Through the identification of errors, CohortDiagnostics enables the comparison of multiple candidate cohort definitions across one or more data sources, facilitating reproducible research.


  • Show cohort inclusion rule attrition.
  • List all source codes used when running a cohort definition on a specific database.
  • Find orphan codes, (source) codes that should be, but are not included in a particular concept set.
  • Compute cohort incidence across calendar years, age, and gender.
  • Break down index events into the specific concepts that triggered them.
  • Compute overlap between two cohorts.
  • Characterize cohorts, and compare these characterizations. Perform cohort comparison and temporal comparisons.
  • Explore patient profiles of a random sample of subjects in a cohort.


The Diagnostics Explorer Shiny app
The Diagnostics Explorer Shiny app


The CohortDiagnostics package is an R package.

System Requirements

Requires R. Some of the packages used by CohortDiagnostics require Java.


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

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


User Documentation

Documentation can be found on the package website.

PDF versions of the documentation are also available:



Read here how you can contribute to this package.


CohortDiagnostics is licensed under Apache License 2.0


CohortDiagnostics is being developed in R Studio.

Development status