Skip to main content
Version: 1.0.0

Electrocardiogram

Overview of Data Domain

An electrocardiogram (ECG) is a non-invasive diagnostic test that records the electrical activity of the heart over a period of time, typically displayed as a graph of voltage versus time. It is commonly used to detect and diagnose various heart conditions, such as arrhythmias, heart attacks, and abnormalities in heart structure or function. During an ECG, electrodes are placed on the skin of the chest, arms, and legs to measure the electrical impulses generated by the heart's natural rhythm.

In the AI-READI study, a 12-lead ECG procedure was conducted using the Philips Pagewriter TC30. Although a supine (0 degrees) or reclined (30 degrees) position was preferred for measurement, it should be noted that the data may occasionally include other positions.

Limitations: Some limitations of ECG include its inability to detect all heart conditions, especially those that occur infrequently or irregularly, as well as its potential for false positives or false negatives in interpretation. Additionally, ECG recordings may be affected by factors such as body position, motion artifacts, and electrode placement, which can impact the accuracy of results.

Data Processing

File Format

Data is exported from the ECG device in a proprietary compressed .xml format. Key information and waveforms are extracted and converted to the wfdb standard, comprised of a _.dat binary file for waveforms and a _.hea ASCII file that outlines the data structure and contains annotations. Data fields that are printed on a standard ECG paper printout are included in the annotations section of the *.hea file.

The processed data is then uploaded onto Fair Data Innovations hub (fairhub.io). FAIRhub.io is a user-friendly platform designed for securely uploading and managing research data, facilitating collaboration among researchers and ensuring compliance with FAIR data principles..

File organization is as follows:

pilot_data_root
└── cardiac_ecg
├── manifest.tsv
└── ecg_12lead
└── philips_tc30
├── 0001
│ └── 0001_ecg_25aafb4b.hea
├── 0001_ecg_25aafb4b.dat
│ └── 0002
│ └── 0002_ecg_27bafg4b.hea
└── 0002_ecg_27bagb4b.dat
└── ... etc.
DomainVariableMethodData Standard/ File ExtensionOpen Source vs. Protected Database?
CardiologyECGdevice; Philips Pagewriter TC30.xmlOpen source

Data Standards

The WFDB (WaveForm DataBase) standard is a comprehensive framework designed for the storage, sharing, and analysis of physiological signals, with a particular emphasis on cardiopulmonary data.

For the description of the wfdb standard and python libraries to access it, please refer to https://physionet.org/content/wfdb-python/4.1.0/ and https://github.com/MIT-LCP/wfdb-python.

PhysioNet contains other types of ECG data alongside supplementary resources to assist researchers in understanding and working with this standard. These resources include links to WFDB materials tailored for various programming languages: https://physionet.org/ and https://physionet.org/about/software/.

File Processing

The .hea and .dat files are designed for easy opening in Python and/or Jupyter Notebook, and will require installation of wfdb library which is a library of tools for reading, writing, and processing WFDB signals and annotations.

No signal processing was conducted in the raw data. If the activity monitor did not record a measurement, the corresponding field was left blank. Protected health information was removed from the data. Data fields that are printed on a standard ECG paper printout were included; fields without public descriptions were not included.

Users are reminded that these files have not undergone physician review, meaning the diagnoses provided might be affected by noise or other discrepancies and lack medical confirmation.

Metadata and Example Outputs

Metadata elementDescriptionExample output
participant_idParticipants study ID0000
modalityData domainECG
wfdb_hea_filepathFile path for .hea file/cardiac_ecg/ecg_12lead/philips_tc30/0000/000_ecg_25aafb4b.hea
wfdb_dat_filepathFile path for .dat file/cardiac_ecg/ecg_12lead/philips_tc30/0000/0000_ecg_25aafb4b.dat
machine_textECG model informationPageWriter TC 30
machine_detail_descriptionDetailed description of ECG devicePhilips Medical Products 860306 A.07.07.07
device_documentation_type_and_versionDetails of device manualPhilipsECG 1.04.01
internalmeasurements_versionIdentifier for the version of the internal measurements10
participant_positionPosition of the participant while recording ECG0 degrees (supine)
RatePatient heart rate or pulse60
PRTime from P wave start to QRS complex start159
QRSDLength of the QRS complex85
QTDuration from QRS start to T wave end403
QTcHeart rate-adjusted QT interval403
PIndicates atrial depolarization72
QRSReflects ventricular depolarization48
TRepresents ventricular repolarization76
report_descriptionECG protocol for measurementStandard 12 Lead Report
manufacturerManufacturer of ECGPhilips
manufacturer_device_modelECG device modelPageWriter TC30

Data (.hea)

The ASCII .hea file includes some of the same elements as the table mentioned above.

Field nameDescriptionExample output
header_versionVersion information1.0
dataset_informationDetails about the data setsee docs.aireadi.org and fairhub.io
dataset_usage_and_licenseLicensing and usage information about the datasetsee docs.aireadi.org
interpretation_criteriaversionReflects the software version used for the interpretation criteria (0B or 0C).0B
patient_criteriaversionReflects the software version used for the patient criteria (0B or 0C).0B
internalmeasurements_versionIdentifier for the version of the internal measurements10
Time_axisECG recording speed25.00 mm/sec
AmplitudeVertical voltage measurement unit10.00 mm/mV
interpretation_comment_1Interpretation of the ECG report provided by the device; not reviewed by a PhysicianUnconfirmed Diagnosis
interpretation_comment_2Interpretation of the ECG report provided by the device; not reviewed by a PhysicianOTHERWISE NORMAL ECG
comment_1_keyComments generated in pairs (key) by the device; not reviewed by a Physician.Sinus rhythm
comment_1_valComments generated in pairs (value) by the device; not reviewed by a Physician.normal P axis, V-rate 60- 99
# comment_2_keyComments generated in pairs (key) by the device; not reviewed by a Physician.RBBB and LAFB
# comment_2_valComments generated in pairs (value) by the device; not reviewed by a Physician.QRSd >120mS, axis(-40,240)
comment_3_keyComments generated in pairs (key) by the device; not reviewed by a Physician.Minimal ST elevation, anterior leads
comment_3_val:Comments generated in pairs (value) by the device; not reviewed by a Physician.ST >0.10mV, V1-V4

Additional resources

There is more than one protocol for obtaining and reporting ECG information. This study used the common 12-lead protocol which is described in several resources.