Release deployment artifacts from CompressionKit

README.md

@@ -0,0 +1,113 @@
+---
+license: apache-2.0
+library_name: compressionkit
+pipeline_tag: other
+tags:
+  - compressionkit
+  - signal-compression
+  - ecg
+  - spiht
+  - wavelet
+  - edge-ai
+  - dsp
+---
+
+# compressionkit-ecg-spiht-8x
+
+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
+
+| Field | Value |
+|-------|-------|
+| Modality | ECG |
+| Sample rate | 256 Hz |
+| Frame size | 512 samples |
+| Target CR | 8x |
+| Wavelet | `bior4.4` |
+| DWT levels | 6 |
+| Bit budget | 1024 bits/frame |
+| Entropy coder | arithmetic coding |
+
+## 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.
+
+| Metric | Value |
+|--------|-------|
+| Truth PRD vs clean (%) | 1.86 |
+| Truth PRD at native noise (%) | 38.31 |
+| Faithful PRD vs input (%) | 3.88 |
+| PRD degradation slope (PRD%/dB) | 3.99 |
+| PRD at 0 dB SNR (%) | 51.77 |
+| PRD at -6 dB SNR (%) | 79.87 |
+| Pure-noise imprint autocorr | 0.2469 |
+
+### Time Domain
+
+_PRD here is faithfulness (vs the recorded input); see **Fidelity & Robustness** above for the clean-truth and noise-regime view._
+
+| Metric | Mean | Median | P90 |
+|--------|------|--------|-----|
+| PRD vs input — faithfulness (%) | 3.8840 | 3.0432 | 7.4458 |
+| RMSE | 0.0388 | 0.0304 | 0.0745 |
+| Cosine Similarity | 0.9987 | 0.9995 | 0.9999 |
+
+### Spectral
+
+- **Band Total Relative Error (median):** 0.0158
+
+### Bitrate
+
+
+## Python quickstart
+
+```python
+from compressionkit.runtime import load_codec
+
+codec = load_codec("Ambiq/compressionkit-ecg-spiht-8x")
+enc = codec.compress(frame)   # frame: (frame_size,) float32
+recon = codec.decompress(enc)
+```
+
+## C quickstart
+
+```c
+#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
+
+| File | Description |
+|------|-------------|
+| `config.json` | Deploy manifest (`family: "spiht"`) |
+| `spiht_config.json` | Codec parameters (language-neutral) |
+| `sample_stimulus.npz` | Synthetic test frames |
+| `reference_vectors.npz` | Reference encode/decode vectors |
+| `c_sources/spiht.[ch]` | Portable C99 reference |
+| `c_sources/spiht_app_config.h` | Codec-specific defines |
+| `model_card.json` | Provenance metadata |
+| `scorecard.json` | Frozen evaluation summary |
+
+## 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
+
+```bibtex
+@software{compressionkit,
+  author = {Ambiq AI},
+  title = {compressionKIT: Signal Compression for Edge AI},
+  url = {https://github.com/AmbiqAI/compressionkit}
+}
+```

checksums.json

@@ -0,0 +1,38 @@
+{
+  "README.md": {
+    "sha256": "0edaab42318beb88b5fb46f92d821cb2827f5e500e515493b0ba23fafbd9a08a",
+    "bytes": 1677
+  },
+  "codec_spec.json": {
+    "sha256": "15801fcdaf136d0505aa596102dd3b93d4b35e8a7c846318f552fd82e0ea5497",
+    "bytes": 575
+  },
+  "deploy_manifest.json": {
+    "sha256": "4349c28c0917f69f783182b7a1b3d964445d04c70a49769d62114032508fd94c",
+    "bytes": 1514
+  },
+  "model_card.json": {
+    "sha256": "134ec34c141d057d60543c687e4eab5c41dd774d4f8b5d84e581083d64a89de0",
+    "bytes": 178
+  },
+  "reference_vectors.npz": {
+    "sha256": "f76f07055e9e022ee8de6d8b7f60751fd7a1f770d5a79a874184c71d471820fe",
+    "bytes": 31175
+  },
+  "sample_stimulus.npz": {
+    "sha256": "c266d1e5539601457ca51ada46e9edb2e99bb6f148cf37be658dcb1670f94dc0",
+    "bytes": 14744
+  },
+  "scorecard.json": {
+    "sha256": "0cd05befba79493545242565d3c3105d724ffbc654d2236ce55470575411a147",
+    "bytes": 211
+  },
+  "spiht_app_config.h": {
+    "sha256": "eeb8986d7033e7d117d634bc487a63289f76be738ae4bfb35afe9953e91f54ba",
+    "bytes": 645
+  },
+  "spiht_config.json": {
+    "sha256": "09a38068ea27f66b4f418b67d95f110489a3d2475909f8a4cd4eb06d6e3e6d93",
+    "bytes": 188
+  }
+}

codec_spec.json

@@ -0,0 +1,27 @@
+{
+  "family": "spiht",
+  "method": "dsp",
+  "modality": "ecg",
+  "sample_rate": 256,
+  "frame_size": 512,
+  "compression_ratio": 8.0,
+  "experiment_id": "ecg-spiht-8x",
+  "run_name": null,
+  "package_version": "1.0",
+  "packet_contract": {
+    "payload_type": "uint8_bitstream",
+    "nbits_field": true,
+    "byte_order": "little-endian-byte-array"
+  },
+  "codec": {
+    "modality": "ecg",
+    "sample_rate": 256,
+    "frame_size": 512,
+    "target_cr": 8.0,
+    "wavelet": "bior4.4",
+    "levels": 6,
+    "use_ac": true,
+    "bits_per_sample": 16,
+    "max_bits": 1024
+  }
+}

config.json

@@ -0,0 +1,60 @@
+{
+  "manifest_version": 1,
+  "package_version": "1.0",
+  "family": "spiht",
+  "method": "dsp",
+  "modality": "ecg",
+  "experiment_id": "ecg-spiht-8x",
+  "run_name": null,
+  "compression_ratio": 8.0,
+  "spec": "codec_spec.json",
+  "scorecard": "scorecard.json",
+  "checksums": "checksums.json",
+  "model_name": "ecg_spiht_8x",
+  "model_version": "1.0",
+  "codec": {
+    "modality": "ecg",
+    "sample_rate": 256,
+    "frame_size": 512,
+    "target_cr": 8.0,
+    "wavelet": "bior4.4",
+    "levels": 6,
+    "use_ac": true,
+    "bits_per_sample": 16,
+    "max_bits": 1024
+  },
+  "artifacts": {
+    "manifest": "deploy_manifest.json",
+    "spiht_config": "spiht_config.json",
+    "sample_stimulus": "sample_stimulus.npz",
+    "reference_vectors": "reference_vectors.npz",
+    "app_config_header": "spiht_app_config.h",
+    "model_card": "model_card.json",
+    "scorecard": "scorecard.json",
+    "codec_spec": "codec_spec.json",
+    "readme": "README.md",
+    "checksums": "checksums.json"
+  },
+  "model_card": {
+    "experiment_id": "ecg-spiht-8x",
+    "modality": "ecg",
+    "method": "spiht",
+    "sample_rate": 256,
+    "compression_ratio": 8,
+    "wavelet": "bior4.4",
+    "levels": 6,
+    "use_ac": true,
+    "frame_size": 512,
+    "dataset_id": "ptb-xl"
+  },
+  "scorecard_summary": {
+    "mean_prd_percent": 3.884,
+    "median_prd_percent": 3.0432,
+    "p95_prd_percent": 9.2236,
+    "mean_snr_db": 30.073,
+    "median_snr_db": 30.333,
+    "actual_cr": 7.999,
+    "bitrate_bps": 512.07,
+    "n_frames": 1000
+  }
+}

model_card.json

@@ -0,0 +1,9 @@
+{
+  "model_name": "ecg_spiht_8x",
+  "model_version": "1.0",
+  "modality": "ecg",
+  "sample_rate": 256,
+  "compression_ratio": 8,
+  "license": "other",
+  "scorecard_summary": {}
+}

quality_scorecard.json

@@ -0,0 +1,1057 @@
+{
+  "headline": {
+    "num_samples": 1000,
+    "compression_ratio": 7.999,
+    "faithful_prd_vs_input_pct": 3.884,
+    "truth_prd_vs_clean_pct": 1.865,
+    "truth_prd_at_native_noise_pct": 38.311,
+    "prd_degradation_slope_per_db": 3.99,
+    "prd_at_0db_pct": 51.771,
+    "prd_at_-6db_pct": 79.867,
+    "imprint_output_autocorr": 0.2469
+  },
+  "run_dir": "results/ecg_spiht_256hz_08x_golden",
+  "modality": "ecg",
+  "sample_rate": 256,
+  "num_samples_loaded": 1000,
+  "num_samples": 1000,
+  "num_samples_rejected": 0,
+  "min_signal_std": 0.0001,
+  "noise_estimator": "bp",
+  "bitrate": {
+    "codec_compression_ratio": 7.9989,
+    "effective_downsample_factor": 1,
+    "downsample_factor": 1,
+    "effective_sample_rate_hz": 256,
+    "uniform_codec_bitrate_bps": 512.07,
+    "uniform_bits_per_frame": 1024.14,
+    "raw_bitrate_bps": 4096,
+    "raw_bits_per_frame": 8192,
+    "encoder_total_params": 0
+  },
+  "time_domain": {
+    "prd_percent": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 3.8840112297936837,
+      "std": 3.2708236210133967,
+      "median": 3.0432137881471792,
+      "p10": 1.5679338246734715,
+      "p90": 7.445797968432937,
+      "max": 35.671991746644096,
+      "min": 0.7942406124415968
+    },
+    "prdn_noise_percent": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 0.0,
+      "std": 0.0,
+      "median": 0.0,
+      "p10": 0.0,
+      "p90": 0.0,
+      "max": 0.0,
+      "min": 0.0
+    },
+    "rmse": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 0.038839771564677224,
+      "std": 0.032707899818936674,
+      "median": 0.03043177752493033,
+      "p10": 0.015679229041446526,
+      "p90": 0.07445699290157669,
+      "max": 0.3567163560396821,
+      "min": 0.007942382927649167
+    },
+    "cosine_similarity": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 0.9987140232920647,
+      "std": 0.003805665156310596,
+      "median": 0.9995369017124176,
+      "p10": 0.9972440659999847,
+      "p90": 0.9998773813247681,
+      "max": 0.9999684691429138,
+      "min": 0.9364176988601685
+    }
+  },
+  "spectral": {
+    "band_total_rel_error": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 0.020497223527047453,
+      "std": 0.0177426692820455,
+      "median": 0.015764304630104344,
+      "p10": 0.005270400632299576,
+      "p90": 0.04202261900666001,
+      "max": 0.24061172996488198,
+      "min": 0.001146485690793292
+    },
+    "per_band_rel_error": {
+      "band_0.5_5_rel_error": {
+        "n": 1000,
+        "n_dropped": 0,
+        "mean": 0.007015147148594202,
+        "std": 0.00976495355927183,
+        "median": 0.004383671426423959,
+        "p10": 0.0006816820331345179,
+        "p90": 0.015630696221016413,
+        "max": 0.16161927154609718,
+        "min": 5.190374105197531e-06
+      },
+      "band_5_15_rel_error": {
+        "n": 1000,
+        "n_dropped": 0,
+        "mean": 0.006810556210992308,
+        "std": 0.010066370453224453,
+        "median": 0.004137277726678313,
+        "p10": 0.0007244281175421973,
+        "p90": 0.01472210792775239,
+        "max": 0.121313366434904,
+        "min": 9.83152114618342e-07
+      },
+      "band_15_40_rel_error": {
+        "n": 1000,
+        "n_dropped": 0,
+        "mean": 0.011296655833779506,
+        "std": 0.01624824833020934,
+        "median": 0.006648023492931011,
+        "p10": 0.001163632370746493,
+        "p90": 0.025950693104023422,
+        "max": 0.15539145716491734,
+        "min": 1.1985245394828982e-05
+      },
+      "band_40_80_rel_error": {
+        "n": 1000,
+        "n_dropped": 0,
+        "mean": 0.05686653491482379,
+        "std": 0.05903794962463782,
+        "median": 0.04075277549157511,
+        "p10": 0.006204828203153473,
+        "p90": 0.12901330518484758,
+        "max": 0.8283902263237897,
+        "min": 8.1587715689226e-06
+      },
+      "band_total_rel_error": {
+        "n": 1000,
+        "n_dropped": 0,
+        "mean": 0.020497223527047453,
+        "std": 0.0177426692820455,
+        "median": 0.015764304630104344,
+        "p10": 0.005270400632299576,
+        "p90": 0.04202261900666001,
+        "max": 0.24061172996488198,
+        "min": 0.001146485690793292
+      }
+    },
+    "weighted_freq_prd_percent": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 2.680039060358527,
+      "std": 2.0713081277358936,
+      "median": 2.1605574292796006,
+      "p10": 1.1193817994946402,
+      "p90": 4.872174661200073,
+      "max": 21.84177016812817,
+      "min": 0.5580532976102264
+    },
+    "coherence": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 1.0,
+      "std": 7.021666937153402e-18,
+      "median": 1.0,
+      "p10": 1.0,
+      "p90": 1.0,
+      "max": 1.0,
+      "min": 0.9999999999999998
+    }
+  },
+  "physiology": {
+    "vs_raw_original": {
+      "num_total_pairs": 1000.0,
+      "num_valid_pairs": 973.0,
+      "hr_mae_bpm": 0.8903444104999889,
+      "hr_median_ae_bpm": 0.0,
+      "hr_std_ae_bpm": 3.519383682396205,
+      "hr_p90_ae_bpm": 0.5121920844449206,
+      "hr_max_ae_bpm": 30.695027774014363,
+      "hr_bias_bpm": 0.24780378638014677,
+      "hr_bias_std_bpm": 3.62179071133064,
+      "peak_count_exact_match_pct": 93.93627954779033,
+      "total_missed_peaks": 27.0,
+      "total_extra_peaks": 32.0,
+      "peak_timing_mae_ms": 8.86750768442623,
+      "peak_timing_median_ms": 0.0,
+      "peak_timing_std_ms": 74.4909559459923,
+      "peak_timing_p90_ms": 0.0,
+      "peak_timing_max_ms": 964.84375,
+      "peak_timing_within_10ms_pct": 97.5,
+      "sdnn_mae_ms": 2.739848379504238,
+      "sdnn_std_ae_ms": 12.556863633614741,
+      "sdnn_p90_ae_ms": 4.510548978043943,
+      "rmssd_mae_ms": 3.1580713068013404,
+      "rmssd_std_ae_ms": 14.098116766676908,
+      "rmssd_p90_ae_ms": 5.524271728019897
+    },
+    "vs_filtered_original": {
+      "num_total_pairs": 1000.0,
+      "num_valid_pairs": 973.0,
+      "hr_mae_bpm": 1.3729838056839319,
+      "hr_median_ae_bpm": 0.14986827983217665,
+      "hr_std_ae_bpm": 5.015107525701715,
+      "hr_p90_ae_bpm": 1.4299190568044486,
+      "hr_max_ae_bpm": 81.4345859971932,
+      "hr_bias_bpm": 0.1270265353283639,
+      "hr_bias_std_bpm": 5.1981008343762225,
+      "peak_count_exact_match_pct": 92.90853031860226,
+      "total_missed_peaks": 36.0,
+      "total_extra_peaks": 33.0,
+      "peak_timing_mae_ms": 12.982536764705882,
+      "peak_timing_median_ms": 0.0,
+      "peak_timing_std_ms": 82.50055129353322,
+      "peak_timing_p90_ms": 3.90625,
+      "peak_timing_max_ms": 1015.625,
+      "peak_timing_within_10ms_pct": 95.87418300653594,
+      "sdnn_mae_ms": 5.739248553333784,
+      "sdnn_std_ae_ms": 20.93350817178139,
+      "sdnn_p90_ae_ms": 6.765823467065928,
+      "rmssd_mae_ms": 6.888278753769465,
+      "rmssd_std_ae_ms": 25.363600477467383,
+      "rmssd_p90_ae_ms": 8.286407592029853
+    },
+    "by_noise_tertile": {
+      "thresholds_bp_noise_rms": {
+        "clean_max": 0.22999871272534286,
+        "median_max": 0.3920438317209633
+      },
+      "buckets": {
+        "clean": {
+          "n": 324,
+          "hr_mae_bpm": {
+            "n": 324,
+            "n_dropped": 0,
+            "mean": 0.5223879590461533,
+            "std": 2.9669948050447847,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 0.27820002063560295,
+            "max": 30.695027774014363,
+            "min": 0.0
+          },
+          "sdnn_mae_ms": {
+            "n": 138,
+            "n_dropped": 0,
+            "mean": 2.9863934786504998,
+            "std": 13.769328025102318,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 4.510548978043951,
+            "max": 117.39815222264123,
+            "min": 0.0
+          },
+          "rmssd_mae_ms": {
+            "n": 138,
+            "n_dropped": 0,
+            "mean": 3.1146520569779357,
+            "std": 13.104907846032265,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 5.524271728019903,
+            "max": 107.7232986963881,
+            "min": 0.0
+          }
+        },
+        "median": {
+          "n": 325,
+          "hr_mae_bpm": {
+            "n": 325,
+            "n_dropped": 0,
+            "mean": 1.1073962555187133,
+            "std": 3.8953160730399143,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 0.8025275379708642,
+            "max": 26.583491821985547,
+            "min": 0.0
+          },
+          "sdnn_mae_ms": {
+            "n": 155,
+            "n_dropped": 0,
+            "mean": 0.8297355181321688,
+            "std": 1.6928539697176916,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 2.2552744890219856,
+            "max": 11.276372445109871,
+            "min": 0.0
+          },
+          "rmssd_mae_ms": {
+            "n": 155,
+            "n_dropped": 0,
+            "mean": 1.0110841056015798,
+            "std": 2.0824097463457987,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 2.762135864009963,
+            "max": 13.810679320049758,
+            "min": 0.0
+          }
+        },
+        "noisy": {
+          "n": 324,
+          "hr_mae_bpm": {
+            "n": 324,
+            "n_dropped": 0,
+            "mean": 1.0405791038331909,
+            "std": 3.6010854670628447,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 1.4961974206996516,
+            "max": 22.32253962486942,
+            "min": 0.0
+          },
+          "sdnn_mae_ms": {
+            "n": 135,
+            "n_dropped": 0,
+            "mean": 4.68091704491525,
+            "std": 17.168888730658267,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 4.715747921940822,
+            "max": 130.80592036327457,
+            "min": 0.0
+          },
+          "rmssd_mae_ms": {
+            "n": 135,
+            "n_dropped": 0,
+            "mean": 5.667514807998323,
+            "std": 20.928626393562887,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 7.129884912731746,
+            "max": 160.2038801125772,
+            "min": 0.0
+          }
+        }
+      }
+    }
+  },
+  "morphology": {
+    "num_windows": 1000,
+    "num_windows_with_beats": 1000,
+    "num_beats_matched": 2469,
+    "r_amplitude": {
+      "orig": {
+        "n": 2469,
+        "mean": 5.106483284762972,
+        "std": 1.7550622785860068,
+        "median": 5.493165615610351,
+        "p10": 2.1655347272038536,
+        "p90": 6.967342533982293,
+        "min": 0.14606412627618914,
+        "max": 10.645864129634788
+      },
+      "recon": {
+        "n": 2469,
+        "mean": 5.109044808938828,
+        "std": 1.7540763176331446,
+        "median": 5.5019502664597875,
+        "p10": 2.1753874102900754,
+        "p90": 6.95601761075717,
+        "min": 0.14656473062072906,
+        "max": 10.651807793753115
+      },
+      "abs_delta": {
+        "n": 2469,
+        "mean": 0.02112243799718501,
+        "std": 0.031743108410785446,
+        "median": 0.013052317521845325,
+        "p10": 0.00235964535197315,
+        "p90": 0.04443346883124699,
+        "min": 4.412151228372352e-06,
+        "max": 0.8856587098212063
+      },
+      "delta": {
+        "n": 2469,
+        "mean": 0.002561524175855769,
+        "std": 0.03804235682000143,
+        "median": 0.0008515002680402617,
+        "p10": -0.027308210024760804,
+        "p90": 0.03231113211629937,
+        "min": -0.29989994932821706,
+        "max": 0.8856587098212063
+      }
+    },
+    "qrs_width_ms": {
+      "orig": {
+        "n": 2469,
+        "mean": 73.41186968408262,
+        "std": 15.74804998325554,
+        "median": 74.21875,
+        "p10": 54.6875,
+        "p90": 101.5625,
+        "min": 23.4375,
+        "max": 101.5625
+      },
+      "recon": {
+        "n": 2469,
+        "mean": 73.46724382341029,
+        "std": 15.688475553768187,
+        "median": 74.21875,
+        "p10": 54.6875,
+        "p90": 101.5625,
+        "min": 27.34375,
+        "max": 101.5625
+      },
+      "abs_delta": {
+        "n": 2469,
+        "mean": 0.9730027339003645,
+        "std": 3.9211019436671415,
+        "median": 0.0,
+        "p10": 0.0,
+        "p90": 3.90625,
+        "min": 0.0,
+        "max": 54.6875
+      },
+      "delta": {
+        "n": 2469,
+        "mean": 0.055374139327663024,
+        "std": 4.039642122453614,
+        "median": 0.0,
+        "p10": 0.0,
+        "p90": 0.0,
+        "min": -50.78125,
+        "max": 54.6875
+      }
+    },
+    "st_deviation": {
+      "orig": {
+        "n": 2379,
+        "mean": -0.08826343352040417,
+        "std": 0.6974349046922551,
+        "median": -0.07900503201612286,
+        "p10": -0.7636725712947089,
+        "p90": 0.45902816028972443,
+        "min": -3.196353637542299,
+        "max": 5.885724864483545
+      },
+      "recon": {
+        "n": 2379,
+        "mean": -0.08924011368353617,
+        "std": 0.6966761584424268,
+        "median": -0.08084547824839872,
+        "p10": -0.7776567703715781,
+        "p90": 0.45741750700865597,
+        "min": -3.167612578354168,
+        "max": 5.881542335100175
+      },
+      "abs_delta": {
+        "n": 2379,
+        "mean": 0.028596220915268148,
+        "std": 0.05646715065772953,
+        "median": 0.016521166838300516,
+        "p10": 0.0028883639610697296,
+        "p90": 0.06257665646197359,
+        "min": 5.107980197704975e-07,
+        "max": 1.3892312137760763
+      },
+      "delta": {
+        "n": 2379,
+        "mean": -0.0009766801631320016,
+        "std": 0.06328766901930018,
+        "median": -0.0003400819536540922,
+        "p10": -0.03807184424051578,
+        "p90": 0.03903506389174415,
+        "min": -1.3194291776642093,
+        "max": 1.3892312137760763
+      }
+    },
+    "t_amplitude": {
+      "orig": {
+        "n": 2316,
+        "mean": 1.1557765006548992,
+        "std": 1.4937146304353133,
+        "median": 1.33907087586785,
+        "p10": -0.9540406520422422,
+        "p90": 2.7505082614262477,
+        "min": -6.4516422819751575,
+        "max": 7.349344800134131
+      },
+      "recon": {
+        "n": 2316,
+        "mean": 1.1538874871639662,
+        "std": 1.4959623034050218,
+        "median": 1.3414300146033193,
+        "p10": -0.9557416245899509,
+        "p90": 2.759208320299438,
+        "min": -6.337218705727515,
+        "max": 7.361900974094114
+      },
+      "abs_delta": {
+        "n": 2316,
+        "mean": 0.041027222977706335,
+        "std": 0.126473210299573,
+        "median": 0.019383074214501805,
+        "p10": 0.0026708838601493257,
+        "p90": 0.07473324026215933,
+        "min": 9.257117981942287e-06,
+        "max": 2.4886252821657155
+      },
+      "delta": {
+        "n": 2316,
+        "mean": -0.0018890134909328145,
+        "std": 0.13294787541278547,
+        "median": -9.223264803176479e-05,
+        "p10": -0.044946568910058105,
+        "p90": 0.04696076913311509,
+        "min": -2.4886252821657155,
+        "max": 1.939513557299418
+      }
+    },
+    "baseline_drift": {
+      "orig": {
+        "n": 2469,
+        "mean": -0.357029214619568,
+        "std": 0.5839703582436081,
+        "median": -0.3684001670187222,
+        "p10": -0.8910601311489106,
+        "p90": 0.29071443871136626,
+        "min": -4.856197967682362,
+        "max": 2.190076471852864
+      },
+      "recon": {
+        "n": 2469,
+        "mean": -0.3559722661136686,
+        "std": 0.582813728220067,
+        "median": -0.3695169945950044,
+        "p10": -0.8880950446227386,
+        "p90": 0.29069232628405806,
+        "min": -4.856719952241616,
+        "max": 2.1916058701139725
+      },
+      "abs_delta": {
+        "n": 2469,
+        "mean": 0.020640527302533636,
+        "std": 0.03472931618244391,
+        "median": 0.011830273442307915,
+        "p10": 0.0021088931286832482,
+        "p90": 0.045082183244476756,
+        "min": 1.5241597167703347e-06,
+        "max": 0.7712792138944913
+      },
+      "delta": {
+        "n": 2469,
+        "mean": 0.0010569485058994083,
+        "std": 0.0403861316503905,
+        "median": -2.0935289426482484e-05,
+        "p10": -0.027729441156817195,
+        "p90": 0.029257557047485033,
+        "min": -0.4014403324483856,
+        "max": 0.7712792138944913
+      }
+    },
+    "beat_shape_correlation": {
+      "n": 2469,
+      "mean": 0.9996073181680776,
+      "std": 0.0012403374253073932,
+      "median": 0.9998789177144909,
+      "p10": 0.999209060097531,
+      "p90": 0.9999751625932705,
+      "min": 0.9686211583786922,
+      "max": 0.9999984455106599
+    },
+    "params": {
+      "sample_rate": 256,
+      "timing_tolerance_ms": 25.0,
+      "min_beats": 1
+    }
+  },
+  "stability": {
+    "hard_concat": {
+      "prd_percent_mean": 3.282201703174477,
+      "cosine_similarity_mean": 0.9994123578071594,
+      "mse_mean": 0.0011756749212509022,
+      "seam_ratio_mean": 0.5731069863747071,
+      "seam_rms_mean": 0.18017865624278784,
+      "non_seam_rms_mean": 0.2848012447357178,
+      "num_recordings": 10
+    },
+    "overlap_add": {
+      "prd_percent_mean": 3.1772366378865406,
+      "cosine_similarity_mean": 0.9994480729103088,
+      "mse_mean": 0.0011040973797207699,
+      "seam_ratio_mean": 0.6181993929472054,
+      "seam_rms_mean": 0.1895649865269661,
+      "non_seam_rms_mean": 0.2848160281777382,
+      "num_recordings": 10
+    },
+    "linear_crossfade": {
+      "prd_percent_mean": 3.1408874162390985,
+      "cosine_similarity_mean": 0.999460083246231,
+      "mse_mean": 0.001080048603762407,
+      "seam_ratio_mean": 0.6182909049593934,
+      "seam_rms_mean": 0.1895568324252963,
+      "non_seam_rms_mean": 0.2847407117486,
+      "num_recordings": 10
+    },
+    "tukey_overlap_add": {
+      "prd_percent_mean": 3.1008192976134863,
+      "cosine_similarity_mean": 0.9994731068611145,
+      "mse_mean": 0.0010540422532358206,
+      "seam_ratio_mean": 0.6185368766940235,
+      "seam_rms_mean": 0.18955991864204408,
+      "non_seam_rms_mean": 0.2846134573221207,
+      "num_recordings": 10
+    }
+  },
+  "by_noise_tertile": {
+    "thresholds_bp_noise_rms": {
+      "clean_max": 0.23304778728471306,
+      "median_max": 0.39769795604024094
+    },
+    "buckets": {
+      "clean": {
+        "n": 333,
+        "time_domain": {
+          "prd_percent": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 3.1024477632606327,
+            "std": 1.8127322994308743,
+            "median": 2.5313865477471302,
+            "p10": 1.4108445168986874,
+            "p90": 5.721060829876195,
+            "max": 10.35516517678904,
+            "min": 0.7942406124415968
+          },
+          "prdn_noise_percent": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.0,
+            "std": 0.0,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 0.0,
+            "max": 0.0,
+            "min": 0.0
+          },
+          "rmse": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.03102423300067677,
+            "std": 0.018127154691452377,
+            "median": 0.025313725156701345,
+            "p10": 0.014108380442527772,
+            "p90": 0.057210114222336135,
+            "max": 0.10355059015203963,
+            "min": 0.007942382927649167
+          },
+          "cosine_similarity": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.9993557682982436,
+            "std": 0.0008165002736565256,
+            "median": 0.9996796250343323,
+            "p10": 0.9983636021614075,
+            "p90": 0.999900484085083,
+            "max": 0.9999684691429138,
+            "min": 0.994625985622406
+          }
+        },
+        "spectral": {
+          "band_total_rel_error": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.019232433094782033,
+            "std": 0.01555242150837912,
+            "median": 0.015142066920613963,
+            "p10": 0.004634220789503501,
+            "p90": 0.03865539049986073,
+            "max": 0.1053433615163589,
+            "min": 0.0012028982790263615
+          },
+          "weighted_freq_prd_percent": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 2.1267163745476063,
+            "std": 1.1537940130117639,
+            "median": 1.8665771918081215,
+            "p10": 1.014640010499677,
+            "p90": 4.028595126502776,
+            "max": 6.278611072935796,
+            "min": 0.5836019432126249
+          },
+          "coherence": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 1.0,
+            "std": 0.0,
+            "median": 1.0,
+            "p10": 1.0,
+            "p90": 1.0,
+            "max": 1.0,
+            "min": 1.0
+          }
+        }
+      },
+      "median": {
+        "n": 334,
+        "time_domain": {
+          "prd_percent": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 3.8744154032605365,
+            "std": 2.5540896498475427,
+            "median": 3.2704982367025037,
+            "p10": 1.7476202879200657,
+            "p90": 7.289068433721563,
+            "max": 16.805563665507577,
+            "min": 0.8372726528556411
+          },
+          "prdn_noise_percent": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 0.0,
+            "std": 0.0,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 0.0,
+            "max": 0.0,
+            "min": 0.0
+          },
+          "rmse": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 0.03874379958471226,
+            "std": 0.02554066329382415,
+            "median": 0.03270461053103901,
+            "p10": 0.017476055876534044,
+            "p90": 0.07289003532063035,
+            "max": 0.16805456985385103,
+            "min": 0.008372697833019046
+          },
+          "cosine_similarity": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 0.9989261646827537,
+            "std": 0.0017820690776030874,
+            "median": 0.9994670152664185,
+            "p10": 0.9973538815975189,
+            "p90": 0.9998475134372711,
+            "max": 0.9999649524688721,
+            "min": 0.9859107136726379
+          }
+        },
+        "spectral": {
+          "band_total_rel_error": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 0.01962949599778787,
+            "std": 0.014854285699743284,
+            "median": 0.01530833392656374,
+            "p10": 0.005507309489765383,
+            "p90": 0.04142927052048217,
+            "max": 0.0942392259009491,
+            "min": 0.001146485690793292
+          },
+          "weighted_freq_prd_percent": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 2.6635029310331264,
+            "std": 1.6291598390106723,
+            "median": 2.2224964679554797,
+            "p10": 1.2076056544884082,
+            "p90": 4.871740869955328,
+            "max": 11.30312328683475,
+            "min": 0.5580532976102264
+          },
+          "coherence": {
+            "n": 334,
+            "n_dropped": 0,
+            "mean": 1.0,
+            "std": 1.2149740217561496e-17,
+            "median": 1.0,
+            "p10": 1.0,
+            "p90": 1.0,
+            "max": 1.0,
+            "min": 0.9999999999999998
+          }
+        }
+      },
+      "noisy": {
+        "n": 333,
+        "time_domain": {
+          "prd_percent": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 4.675199339155779,
+            "std": 4.589238934115222,
+            "median": 3.2904495105509044,
+            "p10": 1.6219601194226116,
+            "p90": 9.230258753496251,
+            "max": 35.671991746644096,
+            "min": 0.8152801652825812
+          },
+          "prdn_noise_percent": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.0,
+            "std": 0.0,
+            "median": 0.0,
+            "p10": 0.0,
+            "p90": 0.0,
+            "max": 0.0,
+            "min": 0.0
+          },
+          "rmse": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.04675157031278666,
+            "std": 0.045891896557329635,
+            "median": 0.03290430584362445,
+            "p10": 0.01621947505174277,
+            "p90": 0.09230178532334445,
+            "max": 0.3567163560396821,
+            "min": 0.008152783186980352
+          },
+          "cosine_similarity": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.9978594998339633,
+            "std": 0.006201095769999017,
+            "median": 0.9994598031044006,
+            "p10": 0.9957409501075745,
+            "p90": 0.9998684287071228,
+            "max": 0.9999668002128601,
+            "min": 0.9364176988601685
+          }
+        },
+        "spectral": {
+          "band_total_rel_error": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 0.02263234727694861,
+            "std": 0.021800192686236095,
+            "median": 0.016444517376322708,
+            "p10": 0.005977950747354246,
+            "p90": 0.04639383468776052,
+            "max": 0.24061172996488198,
+            "min": 0.0023283163483819196
+          },
+          "weighted_freq_prd_percent": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 3.2499475335408703,
+            "std": 2.8738871111303808,
+            "median": 2.407530521721784,
+            "p10": 1.1634408848082476,
+            "p90": 5.946873052434487,
+            "max": 21.84177016812817,
+            "min": 0.5691230325707283
+          },
+          "coherence": {
+            "n": 333,
+            "n_dropped": 0,
+            "mean": 1.0,
+            "std": 0.0,
+            "median": 1.0,
+            "p10": 1.0,
+            "p90": 1.0,
+            "max": 1.0,
+            "min": 1.0
+          }
+        }
+      }
+    }
+  },
+  "context": {
+    "noise_power": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 0.2259401602467991,
+      "std": 0.4306358609000623,
+      "median": 0.08733900095250383,
+      "p10": 0.020580006421658425,
+      "p90": 0.5107709036037087,
+      "max": 4.270555694425935,
+      "min": 0.004356308578118169
+    },
+    "noise_rms": {
+      "n": 1000,
+      "n_dropped": 0,
+      "mean": 0.38253588644594216,
+      "std": 0.28214616039885504,
+      "median": 0.2955315190608555,
+      "p10": 0.14345728777974984,
+      "p90": 0.7146815271273129,
+      "max": 2.066532287293362,
+      "min": 0.06600233767161713
+    },
+    "qrs_snr_db": {
+      "n": 24,
+      "n_dropped": 0,
+      "mean": 12.742358167394059,
+      "std": 5.017646283623076,
+      "median": 13.267522105619305,
+      "p10": 5.140991695074948,
+      "p90": 18.96420766829537,
+      "max": 21.594237327775787,
+      "min": 2.052900271876336
+    }
+  },
+  "robustness": {
+    "n_windows": 500,
+    "prd_threshold": 10.0,
+    "headline": {
+      "empirical_snr": {
+        "prd_at_0db": 51.77107238769531,
+        "prd_at_-6db": 79.86663818359375,
+        "prd_slope_per_db": 3.990253646881387,
+        "robust_snr_db_at_prd_threshold": 12.0
+      },
+      "artifacts": {
+        "prd_by_family_mid_severity": {
+          "colored": 81.16638946533203,
+          "mains": 79.48155975341797,
+          "motion": 83.06532287597656,
+          "lead_off": 94.9478759765625,
+          "weak_leak": 117.25982666015625
+        },
+        "worst_family": "weak_leak",
+        "worst_prd_mid_severity": 117.25982666015625
+      },
+      "imprint_output_autocorr_max": 0.2469116747379303
+    },
+    "empirical_snr_curve": [
+      {
+        "snr_db": 12.0,
+        "prd_mean": 14.9020357131958,
+        "prd_median": 14.329540252685547
+      },
+      {
+        "snr_db": 8.0,
+        "prd_mean": 23.742143630981445,
+        "prd_median": 23.128978729248047
+      },
+      {
+        "snr_db": 6.0,
+        "prd_mean": 28.603673934936523,
+        "prd_median": 27.298553466796875
+      },
+      {
+        "snr_db": 3.0,
+        "prd_mean": 39.11989212036133,
+        "prd_median": 38.58624267578125
+      },
+      {
+        "snr_db": 0.0,
+        "prd_mean": 51.77107238769531,
+        "prd_median": 50.85601043701172
+      },
+      {
+        "snr_db": -3.0,
+        "prd_mean": 66.01786804199219,
+        "prd_median": 65.71646118164062
+      },
+      {
+        "snr_db": -6.0,
+        "prd_mean": 79.86663818359375,
+        "prd_median": 81.61154174804688
+      },
+      {
+        "snr_db": -9.0,
+        "prd_mean": 94.48633575439453,
+        "prd_median": 96.40992736816406
+      },
+      {
+        "snr_db": -12.0,
+        "prd_mean": 106.05288696289062,
+        "prd_median": 108.72895812988281
+      }
+    ],
+    "reference": {
+      "clean": 1.8647409677505493,
+      "native": 38.31148147583008
+    },
+    "artifacts": {
+      "colored": [
+        {
+          "severity": 0.25,
+          "prd_mean": 61.597740173339844
+        },
+        {
+          "severity": 0.5,
+          "prd_mean": 81.16638946533203
+        },
+        {
+          "severity": 0.75,
+          "prd_mean": 100.41177368164062
+        }
+      ],
+      "mains": [
+        {
+          "severity": 0.25,
+          "prd_mean": 62.40423583984375
+        },
+        {
+          "severity": 0.5,
+          "prd_mean": 79.48155975341797
+        },
+        {
+          "severity": 0.75,
+          "prd_mean": 98.35430908203125
+        }
+      ],
+      "motion": [
+        {
+          "severity": 0.25,
+          "prd_mean": 64.58673858642578
+        },
+        {
+          "severity": 0.5,
+          "prd_mean": 83.06532287597656
+        },
+        {
+          "severity": 0.75,
+          "prd_mean": 102.24476623535156
+        }
+      ],
+      "lead_off": [
+        {
+          "severity": 0.25,
+          "prd_mean": 71.43106079101562
+        },
+        {
+          "severity": 0.5,
+          "prd_mean": 94.9478759765625
+        },
+        {
+          "severity": 0.75,
+          "prd_mean": 122.9718017578125
+        }
+      ],
+      "weak_leak": [
+        {
+          "severity": 0.25,
+          "prd_mean": 95.4238052368164
+        },
+        {
+          "severity": 0.5,
+          "prd_mean": 117.25982666015625
+        },
+        {
+          "severity": 0.75,
+          "prd_mean": 131.9951934814453
+        }
+      ]
+    },
+    "imprint": {
+      "pure_noise": {
+        "input_autocorr_mean": 0.24699077010154724,
+        "output_autocorr_mean": 0.2469116747379303,
+        "residual_rms": 1.0
+      }
+    }
+  }
+}

reference_vectors.npz

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f76f07055e9e022ee8de6d8b7f60751fd7a1f770d5a79a874184c71d471820fe
+size 31175

sample_stimulus.npz

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c266d1e5539601457ca51ada46e9edb2e99bb6f148cf37be658dcb1670f94dc0
+size 14744

scorecard.json

@@ -0,0 +1,10 @@
+{
+  "mean_prd_percent": 3.884,
+  "median_prd_percent": 3.0432,
+  "p95_prd_percent": 9.2236,
+  "mean_snr_db": 30.073,
+  "median_snr_db": 30.333,
+  "actual_cr": 7.999,
+  "bitrate_bps": 512.07,
+  "n_frames": 1000
+}

spiht_app_config.h

@@ -0,0 +1,19 @@
+/*
+ * SPIHT codec deploy configuration for ECG @ 8x.
+ *
+ * Generated by compressionkit.export.spiht_deploy.export_spiht_deploy().
+ * Operating-point macros only — pair this with the SPIHT C algorithm
+ * sources shipped from a separate C-module repository.
+ */
+#ifndef COMPRESSIONKIT_SPIHT_APP_CONFIG_H
+#define COMPRESSIONKIT_SPIHT_APP_CONFIG_H
+
+#define APP_SPIHT_FRAME_SIZE   512
+#define APP_SPIHT_LEVELS       6
+#define APP_SPIHT_MAX_BITS     1024
+#define APP_SPIHT_MAX_BYTES    128
+#define APP_SPIHT_USE_AC       1
+#define APP_SPIHT_WAVELET_NAME "bior4.4"
+#define APP_SPIHT_MODALITY     "ecg"
+
+#endif /* COMPRESSIONKIT_SPIHT_APP_CONFIG_H */

spiht_config.json

@@ -0,0 +1,11 @@
+{
+  "modality": "ecg",
+  "sample_rate": 256,
+  "frame_size": 512,
+  "target_cr": 8.0,
+  "wavelet": "bior4.4",
+  "levels": 6,
+  "use_ac": true,
+  "bits_per_sample": 16,
+  "max_bits": 1024
+}