aECG (Python parser for annotated ECG HL7 files)

Python library to parse and visualize aECG files.

Demo

Installation

pip install aecg

Usage

• Read your aECG xml file.

import aecg

file_path = r"tests/data/Example aECG.xml"
aecg_o = aecg.read(file_path)

• Use summary to get an overview of the data.

aecg_o.summary()

{
    'id': UUID('61d1a24f-b47e-41aa-ae95-f8ac302f4eeb'),
    'date': datetime.datetime(2002, 11, 22, 9, 10),
    'series_count': 1,
    'annotations_count': 167,
}

• Get waveforms dataframes and their associated plots.

titles = []
dfs = []
figs = []

for serie in aecg_o.series:
    for i, seq_set in enumerate(serie.sequence_sets, 1):
        title = f"Serie {serie.id} | Sequence set {i}"
        df = seq_set.get_sequences_df()
        fig = aecg.plotter.plot_seq_set(df, title=title)
        dfs.append(df)
        titles.append(title)
        figs.append(fig)

    for i, seq_set in enumerate(serie.derived_sequence_sets, 1):
        title = f"Serie {serie.id} | Derived sequence set {i}"
        df = seq_set.get_sequences_df()
        fig = aecg.plotter.plot_seq_set(df, title=title)
        dfs.append(df)
        titles.append(title)
        figs.append(fig)

dfs[0]

figs[0].show()

• You can choose to plot all the curves together.

aecg.plotter.plot_seq_set(dfs[0], plot_mode="one")