Install physioKIT and run a synthetic ECG example.
Start here →
physioKITv0.11.0Understand the signals
behind wearable health.
physioKIT is an open-source Python library for physiological signal processing. Generate example waveforms, clean sampled data, and calculate peaks, rates, motion features, and heart rate variability.
From signal to insight
- 01GenerateSynthetic ECG, PPG, and respiratory signals
- 02CleanFilter noise from sampled sensor data
- 03Find eventsLocate peaks and derive intervals
- 04MeasureCalculate rates, motion features, and HRV
What is physioKIT?
Section titled “What is physioKIT?”Raw sensor samples rarely answer a question on their own. With ECG, for example, you can clean a waveform, locate R-peaks, derive RR intervals, and calculate heart rate variability. physioKIT exposes those steps as separate Python functions, so you can inspect the intermediate signals and use the measurements you need. The guides below cover pulse, respiration, and motion workflows too.
New to the library? The quickstart runs that ECG workflow with synthetic data, so no external dataset is needed. Then replace the generated samples with your own recording and set the correct sampling rate. The signal guides show code examples and saved visualizations; the Python API documents parameters and return values.
Explore by signal
Section titled “Explore by signal”ECGSynthesize and clean waveforms, find R-peaks, and derive RR intervals.PPGWork with pulse peaks, heart and respiratory rate estimates, and SpO₂ examples.RespirationExplore respiratory waveforms, peaks, and rate calculations.MotionCalculate ENMO, tilt angles, and activity counts from accelerometer data.Heart rate variabilityCalculate time- and frequency-domain measures from beat intervals.Signal utilitiesFilter, resample, smooth, and inspect sampled signals.
Installation
Section titled “Installation”In a Python 3.12 project, add physioKIT:
uv init --python 3.12 my-physio-projectcd my-physio-projectuv add physiokitThe quickstart runs a synthetic ECG example. For an existing recording, follow Use your own data. The interactive plots show saved example waveforms, not live measurements.
physioKIT is distributed under the BSD-3-Clause license. Refer to the source repository for development and issue tracking.