MIMIC-IV Demo in the Medical Event Data Standard (MEDS)

Provider
van de Water, Steinberg, Wornow, Rockenschaub and McDermott (MEDS working group / PhysioNet)
License
ODbL-1.0 (source)
Format
Parquet (in sampled files)
Stored at
Amazon S3, s3://physionet-open/mimic-iv-demo-meds (us-east-1)
Access
Free and public. No account with the data provider is needed.
DOI
10.13026/t2y8-ea41
Category
Health & Biomedical
Source
https://doi.org/10.13026/t2y8-ea41

About MIMIC-IV Demo in the Medical Event Data Standard (MEDS)

An automated ETL conversion of the MIMIC-IV Clinical Database Demo (v2.2) into the Medical Event Data Standard (MEDS), a minimal schema for streams of medical events from electronic health records or claims, intended to make EHR machine learning more reproducible across datasets and model architectures. It covers routinely collected critical care EHR data for 100 patients (subjects), split into data/train (80 subjects), data/tuning (10, validation) and data/held_out (10, test). Each split holds a Parquet file of event rows with the required MEDS columns subject_id, time and code and the optional numeric_value and text_value. metadata/codes.parquet describes each code with a description and parent_codes, metadata/dataset.json records the ETL and version, and metadata/subject_splits.parquet assigns subjects to splits. Produced with the MIMIC_IV_MEDS package v0.0.6 built on MEDS-Transforms, as a single shard. Measured 2026-11-13 (version 0.0.1): data/train/0.parquet is 4,860,946 bytes and metadata/codes.parquet 390,097 bytes; a full zip (4,923,223 bytes) also sits at the prefix root. Read with pandas, polars or pyarrow, or with the meds Python package. Released on PhysioNet under the Open Data Commons Open Database License v1.0; cite van de Water et al. (2025), doi 10.13026/t2y8-ea41.

How to access MIMIC-IV Demo in the Medical Event Data Standard (MEDS) in Python

import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-east-1', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='physionet-open', Prefix='mimic-iv-demo-meds/', Delimiter='/')

Lists the files with anonymous access. Runs on any machine, with no cloud account.

Data structure

File types in sampled files: Parquet

Files

Example file: mimic-iv-demo-meds/0.0.1/data/held_out/0.parquet

Analyze this dataset without downloading it

On Scigantic, MIMIC-IV Demo in the Medical Event Data Standard (MEDS) opens in a hosted JupyterLab notebook with the data already mounted, so you can read files where they are stored instead of copying them first. Each notebook includes an AI assistant that can see the mounted files and write and run analysis code. Open the dataset page to launch a notebook, or browse the full catalog.

This page is also available as Markdown and as JSON.

Related Health & Biomedical datasets