Ambiq / compressionkit-ecg-spiht-4x-v1.0

compressionkit-ecg-spiht-4x

A ECG signal compression codec built on wavelet + SPIHT + arithmetic coding. DSP-only — no trained weights. The deployable artifact is the bitstream contract plus a portable C99 reference implementation.

Operating point

Quality metrics

Fidelity & Robustness

Both fidelity yardsticks are reported so the codec is judged fairly: faithfulness is PRD vs the recorded (still-noisy) input, while truth fidelity is PRD vs clean ground truth. Lower is better.

Time Domain

PRD here is faithfulness (vs the recorded input); see Fidelity & Robustness above for the clean-truth and noise-regime view.

Spectral

• Band Total Relative Error (median): 0.0031

Bitrate

Python quickstart

from compressionkit.runtime import load_codec

codec = load_codec("Ambiq/compressionkit-ecg-spiht-4x")
enc = codec.compress(frame)   # frame: (frame_size,) float32
recon = codec.decompress(enc)

C quickstart

#include "spiht_app_config.h"

float frame[APP_SPIHT_FRAME_SIZE];
uint8_t bitstream[APP_SPIHT_MAX_BYTES];
/* ... fill frame from sensor (post-denoise, if hybrid) ... */
size_t nbits = spiht_encode_frame(&enc, bitstream, APP_SPIHT_MAX_BITS);

Files

Dataset & license

Evaluation data: PTB-XL (CC BY 4.0). Sample data may include excerpts under the original license terms.

Codec source released under the APACHE-2.0 license.

Citation

@software{compressionkit,
  author = {Ambiq AI},
  title = {compressionKIT: Signal Compression for Edge AI},
  url = {https://github.com/AmbiqAI/compressionkit}
}