Deterministic biosignal compression where reproducibility is mandatory. ECG round-trip fidelity validated against MIT-BIH, PTB-XL, EDB, and NSTDB records — dual Rust and Python codec with embedded reference builds.
For medical-device firmware teams and clinical-data infrastructure engineers: this is the only lane in the family with both a Rust crate and Python package targeting the same signal domain, plus an embedded reference path. The proof lineage is auditable but the release surface is not green. Bio Wearable is NO_GO — its closure bundles are retained for traceability, not treated as release proof.
Readiness: private-stage (2026-03-09). Not a public release packet. Not a clean green-verification snapshot. Historical validation artifacts preserve host-specific paths (lineage, not path authority).
Part of the Zer0pa family. Platform layer: ZPE-IMC.
| Field | Value |
|---|---|
| Architecture | BIO_WAVEFORM |
| Encoding | ECG_DELTA_V1 |
| Metric | Value | Baseline |
|---|---|---|
| DETERMINISM | 3/3 | strict encode-decode replay |
| MIT-BIH | 48/48 | — |
| PTB-XL | 1.58× | 100/100 entries |
| NSTDB_SNR | 60.49 | dB |
Source:
validation/results/BENCHMARK_SUMMARY.md|validation/results/ptbxl/summary.json|validation/results/edb/summary.json|validation/results/nstdb/summary.json
| Tool | MIT-BIH CR | Notes |
|---|---|---|
| ZPE-Bio | 1.32× | Deterministic, bit-identical domain-aware replay |
| gzip | 2.13× | Higher CR but no deterministic integrity guarantee |
ZPE-Bio targets deterministic integrity, not compression ratio. Gzip achieves higher compression (2.13× vs 1.32×) on MIT-BIH data but does not guarantee bit-identical domain-aware replay. The commercial wedge is determinism + integrity, not raw ratio.
Auditable guarantees backed by committed proof artifacts. Start at
validation/results/BENCHMARK_SUMMARY.md.
- Deterministic round-trip fidelity on ECG waveforms
- Dual implementation: Rust core crate and Python package
- Wave-1 and Wave-2 readiness artifacts committed
- IMC contract-consumption alignment verified
- No claim of fresh green release commit
- No claim of public release readiness
- No claim of Bio Wearable validation (NO_GO)
- No claim of regulatory or FDA compliance
- No claim of NaN-safe input handling — NaN inputs produce silently incorrect reconstruction (PRD=0.0 reported). This is a known limitation with implications for clinical/regulated deployment. Input validation is the caller's responsibility.
| Field | Value |
|---|---|
| Verdict | PRIVATE_STAGE |
| Release posture | Live work in progress; not a final official release |
| Commit SHA | 83dc91685284 |
| Confidence | 100% (MIT-BIH integrity passes) |
| Source | validation/results/BENCHMARK_SUMMARY.md |
Evaluators:
pip install zpe-bio(available on PyPI) closes the public package import surface. Repo-localpytestthat exercises ECG ingest currently needs validation extras as well:python -m pip install -e ".[dev,validation]". Contact hello@zer0pa.com for integration guidance.
| Code | Check | Verdict |
|---|---|---|
| V_01 | MIT-BIH integrity passes (48/48) | PASS |
| V_02 | PTB-XL benchmark summary committed | PASS |
| V_03 | NSTDB benchmark summary committed | PASS |
| V_04 | EDB benchmark summary committed | PASS |
| V_05 | Sleep-EDF single-file benchmark committed | PASS |
| V_06 | Bio Wearable gate | FAIL |
| Path | State |
|---|---|
| validation/results/BENCHMARK_SUMMARY.md | VERIFIED |
| validation/results/ptbxl/summary.json | VERIFIED |
| validation/results/nstdb/summary.json | VERIFIED |
| validation/results/edb/summary.json | VERIFIED |
| validation/results/sleep-edfx/summary.json | VERIFIED |
| docs/family/BIO_IMC_ALIGNMENT_REPORT.md | VERIFIED |
| Field | Value |
|---|---|
| Proof Anchors | 6 |
| Modality Lanes | 2 |
| Authority Source | validation/results/BENCHMARK_SUMMARY.md |
ZPE-Bio is the biosignal sector repository for Zero-Point Encoding. It packages a deterministic 8-primitive biosignal codec, a Rust-backed core codec crate, and Bio-specific validation artifacts for Wave-1 and Wave-2 execution.
This repository is a private staging surface as of 2026-03-09. It is not a public release packet and it is not a clean green-verification snapshot.
# Install from PyPI
pip install zpe-bio
python -c "import zpe_bio; print(zpe_bio.__file__)"Or install from source (development):
python -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
python -m zpe_bio --help
python -m zpe_bio roundtrip --mode clinical --samples 250Repo-local pytest and ECG validation commands require validation extras:
python -m pip install -e ".[dev,validation]"
pytest
python -m zpe_bio encode-ecg --record-id 100 --samples 1000 --jsonOptional EEG support requires extra packages and local dataset acquisition:
python -m pip install -e ".[validation,bioeeg]"- Platform-layer contract surface: ZPE-IMC
- Organization surface: Zer0pa
- Bio-family alignment artifacts in this repo:
docs/family/BIO_IMC_ALIGNMENT_REPORT.md
| Ideal first buyer | Medical-device firmware team or clinical-data infrastructure team evaluating deterministic biosignal encoding |
| Pain statement | Biosignal pipelines require reproducibility and auditability — generic compressors are non-deterministic or domain-agnostic |
| Deployment model | Python package + Rust crate, private staged |
| Family position | Staged validation lane — proves the architecture extends to regulated biosignal domains |
- Runtime/package surface exists under
python/zpe_bio/. - Native codec surface exists under
core/rust/. - Embedded references exist under
embedded/. - Proof and readiness artifacts exist under
validation/results/andvalidation/runbooks/. - Family alignment artifacts exist under
docs/family/. - The source tree contains runnable Python and Rust codec surfaces.
- The source tree contains committed Wave-1 and Wave-2 readiness artifacts.
- The source tree contains IMC contract-consumption artifacts for family alignment.
- Wave-1 repo substance is real.
- Wave-2 execution artifacts are present but mixed.
- Bio Wearable remains
NO_GO; its closure bundles are retained for traceability, not treated as release proof. - Historical validation artifacts preserve host-specific paths and should be read as lineage, not as current path authority.
- It does not prove a fresh green release commit.
- It does not prove public-release readiness.
- It does not prove Bio Wearable closure.
- It does not prove that every historical validation artifact path has been normalized.
python/zpe_bio/: Python package and CLIcore/rust/: Rust codec crateembedded/: embedded reference buildstests/: repo-local pytest suite; ECG ingest checks require validation extrasscripts/: operator scripts and generatorsvalidation/results/: committed proof and readiness artifactsvalidation/runbooks/: execution runbooksdocs/: repo docs, family alignment, and regulatory material
- Proof index:
validation/results/README.md - Short audit path:
validation/results/BENCHMARK_SUMMARY.md - Public/operator limits:
docs/LEGAL_BOUNDARIES.md - Docs landing:
docs/ARCHITECTURE.md - Legal boundary summary:
docs/LEGAL_BOUNDARIES.md
- Historical GO prose exists, but this staged repo still carries unresolved correctness work.
ruffand multimodal manifest verification were not re-cleared in this phase.- Regulatory and startup documents contained historical absolute-path references (scrubbed 2026-04-14; now repo-relative).
Read this repo as a private staged baseline for Phase 4.5 and Phase 5, not as a release verdict.