Repository navigation
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
- Under Assets at the bottom of this page, download Source code (zip) and unzip it.
- 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/datasetsWindows (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\datasetsThe 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.