Release deployment artifacts from CompressionKit

README.md

@@ -88,6 +88,7 @@ codec = RVQCodec("path/to/deploy/")
 | File | Description |
 |------|-------------|
 | `encoder_int8.tflite` | INT8 quantized encoder (on-device) |
+| `encoder_float32.tflite` | Float32 encoder for browser/server runtimes |
 | `encoder.h` | C header for encoder |
 | `encoder.keras` | Float32 Python reference encoder (training/inspection use) |
 | `decoder_float32.tflite` | Float32 decoder (server-side evaluation) |
@@ -97,11 +98,14 @@ codec = RVQCodec("path/to/deploy/")
 | `codebook.h` | C header for codebook |
 | `config.json` | Deployment manifest |
 | `sample_stimulus.npz` | Synthetic test data |
+| `demo_recordings.npz` | 10 real, quality-gated browser-demo recordings |
+| `demo_recordings_manifest.json` | Recording provenance, license, and quality metadata |
 | `quality_scorecard.json` | Full evaluation metrics |
 
 ## Dataset & License
 
 Training data provenance is not recorded in this package; sample data uses synthetic physiokit waveforms only — no patient data is redistributed.
+Demo recordings: BIDMC PPG and Respiration Dataset v1.0.0 ([source](https://physionet.org/content/bidmc/1.0.0/)); real, quality-gated excerpts are released under ODC-By-1.0. [https://opendatacommons.org/licenses/by/1-0/](https://opendatacommons.org/licenses/by/1-0/)
 
 Model weights are released under the **Ambiq Model Weights License** — deployment is restricted to Ambiq silicon devices. See `LICENSE-MODEL-WEIGHTS.md` for full terms.
 

config.json

@@ -32,7 +32,9 @@
     "codec_spec": "codec_spec.json",
     "manifest": "deploy_manifest.json",
     "checksums": "checksums.json",
-    "readme": "README.md"
+    "readme": "README.md",
+    "demo_recordings": "demo_recordings.npz",
+    "demo_recordings_manifest": "demo_recordings_manifest.json"
   },
   "encoder": {
     "tflite": "encoder.tflite",
@@ -85,5 +87,12 @@
       "targets",
       "reconstructions"
     ]
+  },
+  "demo_recordings": {
+    "npz": "demo_recordings.npz",
+    "manifest": "demo_recordings_manifest.json",
+    "num_recordings": 10,
+    "sample_rate": 64,
+    "duration_seconds": 30.0
   }
 }

demo_recordings.npz

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

demo_recordings_manifest.json

@@ -0,0 +1,180 @@
+{
+  "format_version": 1,
+  "modality": "ppg",
+  "sample_rate": 64,
+  "num_recordings": 10,
+  "samples_per_recording": 1920,
+  "duration_seconds": 30.0,
+  "signal_representation": "raw source waveform resampled to sample_rate",
+  "framing_note": "Apply the selected codec's framing and normalization policy before inference.",
+  "source": {
+    "dataset": "BIDMC PPG and Respiration Dataset v1.0.0",
+    "license": "ODC-By-1.0",
+    "license_url": "https://opendatacommons.org/licenses/by/1-0/",
+    "url": "https://physionet.org/content/bidmc/1.0.0/",
+    "citation": "Pimentel MAF, et al. Toward a robust estimation of respiratory rate from pulse oximeters. IEEE Trans Biomed Eng. 2017;64(8):1914-1923."
+  },
+  "seed": 42,
+  "recordings": [
+    {
+      "index": 0,
+      "source_record": "bidmc08",
+      "source_sample_rate": 125,
+      "start_seconds": 129.752,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.5380354523658752,
+        "heart_rate_bpm": 100.24507192328183,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 49,
+        "pulse_snr_db": 31.943447392542407,
+        "rr_cv": 0.016121769527323103,
+        "standard_deviation": 0.16130027174949646
+      }
+    },
+    {
+      "index": 1,
+      "source_record": "bidmc38",
+      "source_sample_rate": 125,
+      "start_seconds": 212.208,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.371447890996933,
+        "heart_rate_bpm": 88.55345911949685,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 44,
+        "pulse_snr_db": 24.855584306405454,
+        "rr_cv": 0.04498476838589164,
+        "standard_deviation": 0.09077844768762589
+      }
+    },
+    {
+      "index": 2,
+      "source_record": "bidmc40",
+      "source_sample_rate": 125,
+      "start_seconds": 62.904,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 3.356215000152588,
+        "heart_rate_bpm": 110.13789299503586,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 52,
+        "pulse_snr_db": 14.390795816553823,
+        "rr_cv": 0.027838849653013684,
+        "standard_deviation": 0.5166902542114258
+      }
+    },
+    {
+      "index": 3,
+      "source_record": "bidmc18",
+      "source_sample_rate": 125,
+      "start_seconds": 156.376,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.4979526400566101,
+        "heart_rate_bpm": 90.04689942678478,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 45,
+        "pulse_snr_db": 23.259163443389603,
+        "rr_cv": 0.011282521582364993,
+        "standard_deviation": 0.11267337203025818
+      }
+    },
+    {
+      "index": 4,
+      "source_record": "bidmc06",
+      "source_sample_rate": 125,
+      "start_seconds": 196.528,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.5146859288215637,
+        "heart_rate_bpm": 81.92,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 40,
+        "pulse_snr_db": 28.839203282626812,
+        "rr_cv": 0.009877171819074283,
+        "standard_deviation": 0.15620273351669312
+      }
+    },
+    {
+      "index": 5,
+      "source_record": "bidmc51",
+      "source_sample_rate": 125,
+      "start_seconds": 442.248,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.6119970679283142,
+        "heart_rate_bpm": 89.25515055467511,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 44,
+        "pulse_snr_db": 25.53853846554274,
+        "rr_cv": 0.02122839838399622,
+        "standard_deviation": 0.14699383080005646
+      }
+    },
+    {
+      "index": 6,
+      "source_record": "bidmc35",
+      "source_sample_rate": 125,
+      "start_seconds": 96.56,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.6456499695777893,
+        "heart_rate_bpm": 99.18819188191881,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 49,
+        "pulse_snr_db": 20.389177511669683,
+        "rr_cv": 0.036614241605405655,
+        "standard_deviation": 0.15375757217407227
+      }
+    },
+    {
+      "index": 7,
+      "source_record": "bidmc41",
+      "source_sample_rate": 125,
+      "start_seconds": 225.472,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.36978062987327576,
+        "heart_rate_bpm": 81.26984126984127,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 40,
+        "pulse_snr_db": 24.898295030679385,
+        "rr_cv": 0.01838423694638895,
+        "standard_deviation": 0.07590621709823608
+      }
+    },
+    {
+      "index": 8,
+      "source_record": "bidmc30",
+      "source_sample_rate": 125,
+      "start_seconds": 68.536,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.546328067779541,
+        "heart_rate_bpm": 89.06694781233526,
+        "heart_rate_qos": 1.0,
+        "num_peaks": 44,
+        "pulse_snr_db": 28.012824779061738,
+        "rr_cv": 0.015179339028554787,
+        "standard_deviation": 0.14343491196632385
+      }
+    },
+    {
+      "index": 9,
+      "source_record": "bidmc19",
+      "source_sample_rate": 125,
+      "start_seconds": 222.784,
+      "quality": {
+        "clipping_fraction": 0.0010416666666666667,
+        "dynamic_range": 0.22125974297523499,
+        "heart_rate_bpm": 71.60362280234416,
+        "heart_rate_qos": 0.9722222222222222,
+        "num_peaks": 35,
+        "pulse_snr_db": 28.726471239263375,
+        "rr_cv": 0.16466715957353617,
+        "standard_deviation": 0.03653288260102272
+      }
+    }
+  ]
+}