pmecg 0.2.3

Plot ECGs on a paper-like support. Flexible to variable configurations.

pmecg — Plot My ECG

pmecg is a Python library for plotting ECG signals on a paper-like support, with flexible lead configurations, time scales, and attention map overlays.

1×3 layout	4×3 layout

Interval attention	Line-color attention	Background attention

Installation

pip install pmecg

Quick start

import numpy as np
import pandas as pd
import pmecg

fs = 500
t = np.linspace(0, 10, int(fs * 10))
df = pd.DataFrame({name: np.random.randn(len(t)) * 0.1 for name in pmecg.SUPPORTED_LEADS})

plotter = pmecg.ECGPlotter()
configuration = pmecg.template_factory("4x3", df, leads_map=None)
fig = plotter.plot(df, configuration=configuration, sampling_frequency=fs)
fig.savefig("ecg.png", dpi=300, bbox_inches="tight")

For full documentation, visit pmecg.readthedocs.io.

License

Copyright (C) 2026 Fabio Bonassi — GNU General Public License v3