Skip to content

Verisian CORE Rules Engine v1.0.0

Latest

Choose a tag to compare

@rich-verisian rich-verisian released this 03 Nov 16:46
· 9 commits to main since this release
4a73410

The first official release of Verisian's version of the open source CDISC Rules Engine (CORE), a tool for validating clinical trial data against CDISC standards. It runs the rules with an engine built on a PostgreSQL database.

Note

This is Verisian's fork, validating SDTMIG and FDA Rules.

What's included

  • SDTM: complete rules for SDTMIG 3.2, 3.3 and 3.4, implementing the CDISC SDTM and SDTMIG Conformance Rules v2.0 and the FDA Business Rules v1.5.
  • ADaM and Define-XML rules are in development and will come in a later release. A validation against ADaMIG (-s adamig) currently finds no rules to run.
  • The rules, controlled terminology and other standards metadata are included, so no CDISC Library API key is needed to get started.
  • No PostgreSQL installation is needed: by default the engine creates a temporary database for each run.

The engine supports submissions of up to about 2.5 GB; datasets no larger than 1.5 GB are recommended for best results.

Requirements

  • Python 3.12 (python.org). On Windows, tick "Add python.exe to PATH" in the installer.
  • Mac, Linux or Windows.

Download and install

  1. Under Assets at the bottom of this page, download Source code (zip) and unzip it.
  2. Open a terminal in the unzipped folder and run:

Mac / Linux

python3.12 -m venv venv
source ./venv/bin/activate
python -m pip install -r requirements.txt
python core.py validate -s sdtmig -v 3-4 -d path/to/datasets

Windows (PowerShell)

py -3.12 -m venv venv
.\venv\Scripts\Activate
python -m pip install -r requirements.txt
python core.py validate -s sdtmig -v 3-4 -d path\to\datasets

The report is written to the folder you ran the command from, as an Excel file named CORE-Report-<date and time>.xlsx. Run python core.py version to check you are on 1.0.0.

With Git, you can instead run git clone --branch v1.0.0 https://github.com/verisianHQ/cdisc-rules-engine.

Each step, all validation options and troubleshooting tips are explained in the README.

Writing or testing rules?

You don't need to install this repository: the core-contributor guide installs and runs this engine for you.

Feedback and issues

Please report bugs, questions and feature requests in Issues. Include your operating system, the command you ran, and any error message.

Licence

MIT. Adapted from the open source CDISC Rules Engine by CDISC.