Back to list
hannesill

mimic-eicu-mapping

by hannesill

Give your AI agents clinical intelligence & access to MIMIC-IV, eICU, and more. This project provides them with MCP, Code Execution, and clinical agent skills.

7🍴 3📅 Jan 21, 2026

SKILL.md


name: mimic-eicu-mapping description: Map equivalent concepts between MIMIC-IV and eICU databases. Use for multi-database studies, external validation, or understanding structural differences between databases. license: Apache-2.0 metadata: author: m4-clinical-extraction version: "1.0" database: both category: data-quality source: https://github.com/MIT-LCP/mimic-code, https://github.com/MIT-LCP/eicu-code validated: true

MIMIC-IV to eICU Mapping

This skill maps equivalent tables, columns, and concepts between MIMIC-IV and eICU databases to enable cross-database research and external validation.

When to Use This Skill

  • External validation of MIMIC-IV models on eICU
  • Multi-center studies combining both databases
  • Understanding structural differences
  • Translating queries between databases

Database Overview

CharacteristicMIMIC-IVeICU
InstitutionBeth Israel Deaconess (single center)208 hospitals (multi-center)
Patients~300,000 admissions~200,000 patients
Time Period2008-20192014-2015
ICU TypesAll ICU typesAll ICU types
GeographyBoston, MAUnited States (nationwide)

Identifier Mapping

ConceptMIMIC-IVeICU
Patient IDsubject_iduniquepid
Hospital Admissionhadm_idpatienthealthsystemstayid
ICU Staystay_idpatientunitstayid
Hospital IDN/A (single center)hospitalid
Unit Visiticustay_sequnitvisitnumber

Core Table Mapping

Patient Demographics

MIMIC-IVeICUNotes
mimiciv_hosp.patientspatientBase demographics
mimiciv_hosp.admissionspatientAdmission info combined
mimiciv_icu.icustayspatientICU stay info in patient table
mimiciv_derived.icustay_detailicustay_detail (concept)Derived convenience table

Vital Signs

MIMIC-IVeICUNotes
mimiciv_derived.vitalsignvitalperiodic, vitalaperiodiceICU splits periodic/aperiodic
mimiciv_icu.charteventsnursechartingRaw charted values

Laboratory Values

MIMIC-IVeICUNotes
mimiciv_hosp.labeventslabDifferent labname conventions
mimiciv_derived.chemistrypivoted_lab (concept)Derived/pivoted
mimiciv_derived.complete_blood_countpivoted_lab (concept)

Medications

MIMIC-IVeICUNotes
mimiciv_hosp.prescriptionsmedicationHospital medications
mimiciv_icu.inputeventsinfusiondrugIV infusions
mimiciv_derived.antibiotic-Concept needs creation for eICU

Diagnoses

MIMIC-IVeICUNotes
mimiciv_hosp.diagnoses_icddiagnosiseICU uses text descriptions
-admissiondxeICU has admission diagnosis
-apacheapsvarAPACHE diagnosis categories

Concept Availability

Available in Both (May Require Recalculation)

ConceptMIMIC-IVeICU
SOFAmimiciv_derived.sofaRequires custom calculation
APACHE IVNot pre-computedapachepatientresult
OASISmimiciv_derived.oasispivoted_oasis (concept)
GCSmimiciv_derived.gcspivoted_score (concept)
Urine Outputmimiciv_derived.urine_outputpivoted_uo (concept)

MIMIC-IV Only

  • Waveform data (vital sign waveforms)
  • Radiology reports
  • Detailed microbiology (organism/sensitivity)
  • ED data

eICU Only

  • APACHE IV scores (pre-computed)
  • Multi-center hospital data
  • Respiratory care plan documentation
  • Nurse care plan

Key Structural Differences

1. Time Representation

MIMIC-IV: Absolute timestamps (DATETIME)
eICU: Offset in minutes from unit admission (INTEGER)

-- MIMIC-IV
WHERE charttime BETWEEN ie.intime AND ie.outtime

-- eICU (convert offset to time)
WHERE chartoffset >= 0 AND chartoffset <= unitdischargeoffset

2. Hospital Structure

MIMIC-IV: Single hospital, no hospital identifier
eICU: hospitalid links to hospital table with region, bed count

3. Diagnosis Coding

MIMIC-IV: ICD-9 and ICD-10 codes
eICU: Free-text diagnosis strings + APACHE categories

4. Lab Value Names

MIMIC-IV: itemid (numeric codes) with d_labitems lookup
eICU: labname (text strings), less standardized

Example: Equivalent Queries

First ICU Stay Selection

MIMIC-IV:

SELECT *
FROM mimiciv_derived.icustay_detail
WHERE first_icu_stay = TRUE;

eICU:

SELECT *
FROM patient
WHERE unitvisitnumber = 1;

Mortality Outcome

MIMIC-IV:

SELECT stay_id, hospital_expire_flag
FROM mimiciv_hosp.admissions a
INNER JOIN mimiciv_icu.icustays ie ON a.hadm_id = ie.hadm_id;

eICU:

SELECT patientunitstayid,
       CASE WHEN hospitaldischargestatus = 'Expired' THEN 1 ELSE 0 END AS hosp_mort
FROM patient;

Age

MIMIC-IV:

SELECT stay_id, admission_age
FROM mimiciv_derived.icustay_detail;
-- Note: Ages > 89 are shifted

eICU:

SELECT patientunitstayid,
       CASE WHEN age = '> 89' THEN 90 ELSE CAST(age AS INT) END AS age
FROM patient;
-- Note: age is stored as string, "> 89" for elderly

Validation Considerations

  1. Population Differences: eICU is multi-center with different case-mix
  2. Time Period: Different years may have different practices
  3. Documentation Patterns: Single vs multi-center charting variability
  4. Missing Data: Different missingness patterns
  5. Outcome Definitions: Verify mortality/LOS definitions match

References

  • Johnson AEW et al. "MIMIC-IV, a freely accessible electronic health record dataset." Scientific Data. 2023.
  • Pollard TJ et al. "The eICU Collaborative Research Database." Scientific Data. 2018.

Score

Total Score

75/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon