ZPE-Bio

Deterministic ECG codec repository with a Python CLI, a Rust core crate, and committed validation artifacts. This README is intentionally limited to claims that are backed by proof artifacts already on disk and by tests that run in CI. ZPE-Bio is one of 17 independent encoding products in the Zer0pa portfolio, each developed for its own domain.

This repo's claimed surface is ECG staged proof only. It does not use the wearable runbooks as release evidence, and it does not make a generalized biosignal or regulatory claim.

Anchored Proof Surface

Not Claimed

• No public release-readiness verdict
• No generalized biosignal victory claim
• No Bio Wearable closure claim
• No regulatory or FDA claim

Benchmark Results (committed artifacts, beta)

Results below are from committed benchmark artifacts. All runs are CPU-only Python codec; no hardware path is implied.

MIT-BIH Arrhythmia Database (48 records, full corpus)

Source: validation/results/BENCHMARK_SUMMARY.md, validation/results/mitdb_python_only/mitdb_aggregate.json | CI: tests/test_benchmark_mitdb.py

MIT-BIH Noise Stress Test Database (nstdb, 15 entries)

Source: validation/results/nstdb/summary.json | CI: tests/test_benchmark_physionet.py

European ST-T Database (edb, 90 entries)

Source: validation/results/edb/summary.json | CI: tests/test_benchmark_physionet.py

PTB-XL ECG Database (100 records sample)

Source: validation/results/ptbxl/summary.json | CI: tests/test_benchmark_physionet.py

Note on PTB-XL SNR/PRD: PTB-XL records are 12-lead 500 Hz clinical studies; the lower SNR relative to MIT-BIH reflects higher signal diversity and more channels compressed per segment, not codec regression. Integrity passes 100/100.

Local Validation

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev,validation]"
pytest -q
python -m build

Quick ECG smoke check:

python -m zpe_bio roundtrip --mode clinical --samples 250

Repository Map

• python/zpe_bio/: Python package and CLI
• core/rust/: Rust codec crate
• embedded/: embedded reference firmware tree
• tests/: repo-local pytest suite
• scripts/: benchmark and operator scripts
• validation/results/: committed benchmark outputs
• validation/runbooks/: execution and boundary runbooks
• docs/: repo documentation and regulatory/reference material

Read Next

• validation/results/README.md
• validation/results/BENCHMARK_SUMMARY.md
• docs/ARCHITECTURE.md
• docs/LEGAL_BOUNDARIES.md