CLIF Data Dictionary Change Log
Track the evolution of the Common Longitudinal ICU data Format (CLIF) through its version history. This change log documents all updates, improvements, and structural changes to the data dictionary.
Version 2.1.0 (November 2025) Current Version
New Tables (7 tables moved to Beta)
New Fields (10 fields added)
| Field Name | Table | Status |
|---|---|---|
| language_category | patient | |
| hospital_type | adt | Issue #78 |
| loinc_code | microbiology | Issue #25 |
| location_type | adt | Issue #39 |
| admission_type_category | hospitalization | Issue #16 |
| device_id | respiratory_support | Issue #67 |
| code_status_category | code_status | |
| geographic_indicators | hospitalization | |
| mar_action_group | medication_admin_intermittent | Issue #112 |
| mar_action_group | medication_admin_continuous | Issue #112 |
New mCIDE Values (9 updates)
| Category | Description | Status |
|---|---|---|
| Medication categories | Additional med_category and med_group for intermittent medications: steroids, vasopressors, CAR-T therapies, analgesics, paralytics, antipsychotics | Issue #105 |
| Inhaled medications | Continuous medications: epoprostenol, nitric oxide | |
| med_route_category | Finalized med route values for medication intermittent and continuous | Issue #6 |
| mar_action_category | Finalized mar action values for medication intermittent and continuous | Issue #112 |
| Non-culture microbiology | Staphylococcus aureus (nasopharynx), C. difficile (stool), RSV (nasopharynx) | |
| ASE CMS antibiotics | Included all qualifying antibiotics added to intermittent meds | Issue #103 |
| Organism categories | ~24 new organism categories with typo corrections and duplicate removal |
Revisions (11 updates) Last updated: Nov 21, 2025
| Area | Description | Status | Date |
|---|---|---|---|
| Medication standardization | Ensure lower and snake-cased med_category values for intermittent medications | ||
| Organism group values | Updated to cleaner and shortened values | ||
| Fluid category values | Updated to cleaner and shortened values | ||
| Lab order categories | Lower and snake-cased; merged ABG/VBG into "blood_gas"; moved lactate to "misc" | Issue #101 | – |
| Microbiology organism groups | Removed mycobacterium_tuberculosis from organism_group | ||
| Combination medications | Removed hydrocodone_acetaminophen and oxycodone_acetaminophen from mCIDE (see ETL notes) | ||
| Patient assessments | SAT/SBT categories: sbt_screen_performed, sat_screen_performed, sbt_delivery_performed, sat_delivery_performed | Issue #107 | – |
| Trial drug mapping | Map trial drugs to 'trial_drug' as med_category, leave med_group empty if placebo | – | |
| Continuous medication mapping | Removed vague categories (repletion, tocolytics); dropped intermittent categories | Issue #120 | Nov 12, 2025 |
| ECMO MCS | Concept table ECMO_MCS data dictionary revised | Issue #72 | Nov 21, 2025 |
Version 2.0.0 (February 2025)
Major ERD Upgrade
- Combined patient and hospitalization tables for improved data structure
- Introduced maturity concept for ERD and tables (Beta, Concept, Future)
- Added comprehensive Beta tables with production-ready structures
- Defined concept tables for future implementation
- Standardized mCIDE (minimum Common ICU Data Elements) across all tables
- Standardized all datetime variables to be time zone aware with UTC format (Issue #40)
- Revision to Micro culture mCIDE for LOINC compatibility – Issue#25
Note: This version represents a major restructuring of the CLIF data format with significant improvements to standardization and interoperability across institutions.
Version 1.0.0
First official release of the Common Longitudinal ICU data Format (CLIF)
- Initial table structure definitions
- Core entity-relationship model
- Foundation for multi-institutional critical care data standardization