Database Credentialed Access
MIMIC-IV-ECG - Diagnostic Electrocardiogram Matched Subset
Brian Gow , Tom Pollard , Larry A Nathanson , Alistair Johnson , Benjamin Moody , Chrystinne Fernandes , Nathaniel Greenbaum , Seth Berkowitz , Dana Moukheiber , Parastou Eslami , Elizabeth Herbst , Roger Mark , Steven Horng
Published: Dec. 23, 2022. Version: 0.1 <View latest version>
MIMIC-IV-ECG module released to consortium members (Dec. 23, 2022, 3:02 p.m.)
A beta release of the MIMIC-IV-ECG module is now available to MIT Critical Data Consortium members. The MIMIC-IV-ECG module contains approximately 800,000 diagnostic electrocardiograms across nearly 160,000 unique patients. All of the ECGs for patients who appear in the MIMIC-IV Clinical Database are included. When a cardiologist report is available for a given ECG, it is also provided. The patients in MIMIC-IV-ECG have been matched against the MIMIC-IV Clinical Database, making it possible to link to information across the MIMIC-IV modules.
A public version of this dataset will be released in approximately six months. During the embargo period we will be carrying out additional tests and data quality checks.
When using this resource, please cite:
(show more options)
Gow, B., Pollard, T., Nathanson, L. A., Johnson, A., Moody, B., Fernandes, C., Greenbaum, N., Berkowitz, S., Moukheiber, D., Eslami, P., Herbst, E., Mark, R., & Horng, S. (2022). MIMIC-IV-ECG - Diagnostic Electrocardiogram Matched Subset (version 0.1). PhysioNet. https://doi.org/10.13026/tw25-ec93.
Please include the standard citation for PhysioNet:
(show more options)
Goldberger, A., Amaral, L., Glass, L., Hausdorff, J., Ivanov, P. C., Mark, R., ... & Stanley, H. E. (2000). PhysioBank, PhysioToolkit, and PhysioNet: Components of a new research resource for complex physiologic signals. Circulation [Online]. 101 (23), pp. e215–e220.
Abstract
The MIMIC-IV-ECG module contains approximately 800,000 diagnostic electrocardiograms across nearly 160,000 unique patients. These diagnostic ECGs use 12 leads and are 10 seconds in length. They are sampled at 500 Hz. This subset contains all of the ECGs for patients who appear in the MIMIC-IV Clinical Database. When a cardiologist report is available for a given ECG, it is also provided. The patients in MIMIC-IV-ECG have been matched against the MIMIC-IV Clinical Database, making it possible to link to information across the MIMIC-IV modules.
Background
An Electrocardiogram or ECG / EKG measures the electrical activity associated with the heart [1]. Diagnostic ECGs are a standard part of a patients care [2]. The standard ECG leads are denoted as lead I, II, III, aVF, aVR, aVL, V1, V2, V3, V4, V5, V6. They are routinely obtained when admitted to the Emergency Department or to a hospital floor. ECGs will typically be repeated for patients who exhibit cardiac symptoms such as chest pain or abnormal rhythms. Daily ECGs may be obtained following acute cardiovascular events such as myocardial infarction. Patients in the ICU are continuously monitored to detect rhythm abnormalities, but full ECGs are needed to evaluate evidence of cardiac ischemia or infarction. However, diagnostic ECGs typically only comprise a small part of understanding the overall condition of a subject at the hospital. To fully understand how to best treat a given patient, a broader set of data is collected which may include: patient demographics, diagnosis, medications, lab tests, and additional information.
This broader set of clinical information is shared as part of the MIMIC-IV Clinical Database [3]. The MIMIC-IV-ECG Matched Subset contains the vast majority of diagnostic ECGs collected between 2008 - 2019 for subjects in MIMIC-IV.
Methods
As part of routine care, diagnostic ECGs are collected across Beth Israel Deaconess Medical Center (BIDMC). Three types of information associated with an ECG are presented here. The electrocardiogram waveforms themselves, the machine measurements (ex: average RR interval as calculated by the machine), and the cardiologist reports. All of this information is connected to the patients overall electronic health record.
Electronic Health Record
Patients from the MIMIC-IV Clinical Database who had ECGs collected between 2008 - 2019 are included as part of MIMIC-IV-ECG. The diagnostic ECGs are collected on machines from various manufacturers. When the ECG is collected, the machine is populated with the patient's demographics and their medical record number (MRN).
As part of deidentification the raw identifiers are shifted. The patient's MRN was used to match a given 12-lead ECG record to the corresponding subject ID in the MIMIC-IV Clinical Database. As another part of the deidentification, the date-time information was shifted to obscure the actual date and time. Relative date-time information for a given subject is preserved though. The shifted date-times were matched against date-times in the subject's MIMIC-IV Clinical Database records. A unique study_id was generated for each record.
Electrocardiogram Waveforms
We converted the ECGs from the manufacturers format to the open WFDB format [4] with each WFDB record comprised of a header (.hea) file and a signal (.dat) file. The files were then transferred from BIDMC to MIT for additional processing.
We scrubbed the WFDB header files for PHI such that only the signal information, subject ID, and shifted date-time are provided. Timestamps for events in the MIMIC-IV Clinical Database, such as drug administration, are aligned with the timestamps in MIMIC-IV-ECG. However, some of the diagnostic ECGs provided here were collected outside of ED or Intensive Care Unit (ICU) visits at the hospital. Since the MIMIC-IV Clinical Database is comprised solely of ED and ICU data, the ECG timestamp can occur before or after a visit from the clinical database.
Machine Measurements
The machine measurements will be released in an upcoming version of this project.
Cardiologist Reports
The reports from a cardiologist’s reading of the diagnostic ECG are provided where available. Most but not all diagnostic ECGs get read by a cardiologist.
These ECG reports were deidentified using a rule-based approach [5], similar to that used for other MIMIC reports. Each instance of PHI was replaced by three underscores.
Data Description
Electrocardiogram Waveforms
Approximately 800,000 ten-second-long 12 lead diagnostic ECGs across nearly 160,000 unique subjects are provided in the MIMIC-IV-ECG module. Around 5% of the available diagnostic ECGs were withheld from this release so they can be used as a hidden test set in workshops and challenges. The ECGs are sampled at 500 Hz. The patients in this module have been matched with the MIMIC-IV Clinical Database. Many of the provided diagnostic ECGs overlap with a MIMIC-IV hospital or emergency department stay but a number of them do not overlap. All available diagnostic ECGs for a particular patient have been placed under a single subdirectory (pXXXXXXX), named according to the patient's MIMIC-IV subject ID, provided as XXXXXXX. These subdirectories are further divided into intermediate group level directories based on the range of subject IDs contained within. Each group directory contains subject IDs within a range of 1000 potential ID values, pNNNN. For example, the p1000 group level directory contains all subject IDs between 1000000 and 1000999, while the p1025 group level directory contains all subject ID's between 1025000 and 1025999.
Each waveform record path is named as files/pNNNN/pXXXXXXX/sZZZZZZZZ/ZZZZZZZZ
, where NNNN is the group level directory, XXXXXXX is the subject ID, and ZZZZZZZZ is the study ID. An example of the file structure is as follows:
files ├── p1000 | └── p10001725 | └── s102147240 | ├── 102147240.dat | └── 102147240.hea └── p1002 └── p10023771 ├── s104496507 │ ├── 104496507.dat │ └── 104496507.hea ├── s108135749 │ ├── 108135749.dat │ └── 108135749.hea └── s105384473 ├── 105384473.dat └── 105384473.hea
Above we find two subjects p10001725
(under the p1000
group level directory) and p10023771
(under the p1002
group level directory). For subject p10001725
we find one study: s102147240
. For p10023771
we find three studies: s104496507
, s108135749
, s105384473
. The study identifiers are completely random, and their order has no implications for the chronological order of the actual studies. Each study has a like named .hea and .dat file, comprising the WFDB record.
The record_list.csv
file contains the file name and path for each WFDB record. It also provides the corresponding subject ID and study ID. The subject ID can be used to link a subject from MIMIC-IV-ECG to the other modules in the MIMIC-IV Clinical Database.
Cardiologist Reports
A little more than 600,000 cardiologist reports are available for the ~800,000 diagnostic ECGs. Not all diagnostic ECGs get read by a cardiologist. This is the primary reason that there are fewer reports than waveforms.
The provided reports.csv
table has a text column which contains the deidentified cardiologist report for a given diagnostic ECG. This table also contains the subject ID, study ID, and waveform path. This information can be used to connect a report to a given subject and their diagnostic ECG waveform. Each report gets a unique ID, which is composed of the subject ID, the abbreviation for the domain (EK) that the report comes from, and a sequential integer. The sequential integer is also listed in its own column and can be used to decipher the order in which ECGs were collected for a given subject.
The information from the reports.csv
table is also available on BigQuery [6].
Usage Notes
This module provides MIMIC-IV users an additional, potentially important piece of information for their research using MIMIC.
A limitation of this dataset is that the 12-lead ECG timestamps may not be perfectly time synced with the other waveforms in MIMIC, as they are collected from different machines. An additional limitation, as noted above, is that some of the ECGs provided here were collected outside of the ED and ICU at the hospital. This means that the timestamps for those ECGs won't overlap with data from the MIMIC-IV Clinical Database.
The signals can be viewed in Lightwave by clicking the Visualize waveforms links in the Files section below. Additionally, the signals can be read by using the WFDB toolboxes provided on PhysioNet: WFDB (in C) [7], WFDB-Matlab [8], and WFDB-Python [9]. Here is a basic script for reading a downloaded record from this project and plotting it by using the WFDB-Python toolbox:
import wfdb
rec_path = '/files/p10001725/s102147240/102147240'
rd_record = wfdb.rdrecord(rec_path)
wfdb.plot_wfdb(record=rd_record, figsize=(24,18), title='Study 102147240 example', ecg_grids='all')
where rec_path
is the path to the name of the .hea and .dat files for the record you'd like to plot.
Here we provide an example of how subject p10023771
from MIMIC-IV-ECG can be linked to their admission information in the MIMIC-IV Clinical Database. Executing this from BigQuery:
SELECT * FROM `physionet-data.mimic_core.admissions` WHERE subject_id=10023771
we see that the patient only has one admission to the hospital with an admittime = 2113-08-25T07:15:00
and a dischtime = 2113-08-30T14:15:00
.
Next, we get the timestamps from the diagnostic ECGs by checking base_date
and base_time
and save the result to a csv file:
from pathlib import Path
import pandas as pd
import wfdb
# get the path to all the study .hea files for p10023771
paths = list(Path("p10023771/.").rglob("*.hea"))
# get date and time for each study
date_times = {'study':[],'date':[],'time':[]} # use a dictionary to store the date and time for each study
for file in paths:
study = file.stem
metadata = wfdb.rdheader(f'{file.parent}/{file.stem}')
date_times['study'].append(study)
date_times['date'].append(metadata.base_date)
date_times['time'].append(metadata.base_time)
df_date_times = pd.DataFrame(data=date_times)
df_date_times.to_csv('p10023771_date_times.csv', index=False)
We observe the following for the 3 diagnostic ECGs for p10023771
:
study | datetime |
104496507 | 2110-07-23T08:43 |
108135749 | 2113-08-19T07:18 |
105384473 | 2113-08-25T13:58 |
where the date is given before the T as YYYY-MM-DD and the time is given after the T as HH:MM. Comparing this to the subjects admission in the MIMIC-IV Clinical Database:
admittime | dischtime |
2113-08-25T07:15 | 2113-08-30T14:15 |
we observe that s104496507
and s108135749
occurred prior to their only hospital admission while s105384473
occurred during their hospital admission.
We can also check the available cardiologist reports for this subject by running this command in BigQuery:
SELECT * FROM `lcp-consortium.mimic_ecg.reports` WHERE subject_id = 10023771
We find that there are cardiologist reports available for s108135749
and s105384473
but not s104496507
.
Release Notes
MIMIC-IV-ECG v0.1
This release contains the ECG signals in WFDB format along with the cardiologist reports where available.
Ethics
The project was approved by the Institutional Review Boards of Beth Israel Deaconess Medical Center (Boston, MA) and the Massachusetts Institute of Technology (Cambridge, MA). Requirement for individual patient consent was waived because the project did not impact clinical care and all protected health information was deidentified.
Acknowledgements
SH, RM, BG, and TP are funded by the Massachusetts Life Sciences Center, Nov. 30, 2020. NG is supported by National Institutes of Health National Library of Medicine Biomedical Informatics and Data Science Research Training Program under grant number T15LM007092-30. BG, TP, AJ, BM, CF, DM, and RM are supported by the National Institute of Biomedical Imaging and Bioengineering (NIBIB) under NIH grant number R01EB030362.
Conflicts of Interest
The author(s) have no conflicts of interest to declare.
References
- Geselowitz DB. On the theory of the electrocardiogram. Proceedings of the IEEE. 1989 Jun;77(6):857-76.
- Harris PR. The Normal electrocardiogram: resting 12-Lead and electrocardiogram monitoring in the hospital. Critical Care Nursing Clinics. 2016 Sep 1;28(3):281-96.
- Johnson, A., Bulgarelli, L., Pollard, T., Horng, S., Celi, L. A., & Mark, R. (2021). MIMIC-IV (version 1.0). PhysioNet. https://doi.org/10.13026/s6n6-xd98.
- Documentation for the Waveform Database (WFDB) file format. https://wfdb.io/ [Accessed 21 June 2022]
- Margaret Douglass, Computer-assisted de-identification of free-text nursing notes. Master's Thesis, 2005. MIT.
- Documentation about using the Medical Information Mart for Intensive Care (MIMIC) Database with Google BigQuery. https://mimic.mit.edu/docs/gettingstarted/cloud/ [Accessed 21 June 2022]
- Documentation for the Waveform Database (WFDB) toolbox in C. https://physionet.org/content/wfdb/10.7.0/ [Accessed 21 June 2022]
- Documentation for the Waveform Database (WFDB) toolbox for Matlab. https://physionet.org/content/wfdb-matlab/0.10.0/ [Accessed 21 June 2022]
- Documentation for the Waveform Database (WFDB) toolbox for Python. https://physionet.org/content/wfdb-python/3.4.1/ [Accessed 21 June 2022]
Parent Projects
Access
Access Policy:
Only credentialed users who sign the DUA can access the files.
License (for files):
PhysioNet Credentialed Health Data License 1.5.0
Data Use Agreement:
PhysioNet Credentialed Health Data Use Agreement 1.5.0
Required training:
CITI Data or Specimens Only Research
Discovery
DOI (version 0.1):
https://doi.org/10.13026/tw25-ec93
DOI (latest version):
https://doi.org/10.13026/b95v-ff39