mirror of
https://github.com/ruvnet/RuView
synced 2026-07-24 17:43:20 +00:00
rUv
eb88035699
PR #744 moved the files into 9 thematic folders via git mv but missed the READMEs due to a working-directory issue with git add. This PR adds the actual READMEs: - examples/research-sota/README.md (main overview) - examples/research-sota/01-physics-floor/README.md - examples/research-sota/02-placement/README.md - examples/research-sota/03-spatial-intelligence/README.md - examples/research-sota/04-rssi/README.md - examples/research-sota/05-cross-room-reid/README.md - examples/research-sota/06-structure-detection/README.md - examples/research-sota/07-negative-results/README.md - examples/research-sota/08-verticals/README.md - examples/research-sota/09-quantum-fusion/README.md Each sub-README documents: - Scripts + headlines table - Why this folder bounds/composes with others - Sample output / honest scope - Cross-references to related loop notes + ADRs Main README covers: - Folder map with thread numbers - Cross-folder dependency graph - 8-entry headline findings table - Reading order for newcomers (4 scripts in suggested order) - Honest scope (synthetic-physics caveats)
63 lines
2.7 KiB
Markdown
63 lines
2.7 KiB
Markdown
# 09 — Quantum-classical fusion (ADR-114 demo)
|
||
|
||
Working numpy demo of the cog-quantum-vitals architecture: **classical CSI for multi-subject context, NV-diamond magnetometry for per-patient HRV contour fidelity**.
|
||
|
||
## Scripts
|
||
|
||
| Script | Thread | Headline |
|
||
|---|---|---|
|
||
| `r20_1_quantum_classical_fusion.py` | R20.1 | Bayesian fusion of CSI (R14 V1 breathing) + NV-diamond cardiac magnetometry. **Empirically confirms R13 NEGATIVE** (classical HR conf 38%, 105 BPM estimate vs 72 truth) AND **doc 16's cube-of-distance bound** (27× signal drop 1 m → 3 m). |
|
||
|
||
## Five confirmations from the demo
|
||
|
||
1. **Classical breathing rate is reliable** — 15.00 BPM correct (14 dB SNR)
|
||
2. **Classical HR is unreliable** — 105 BPM vs 72 truth, conf 38% (R13 NEGATIVE empirically confirmed)
|
||
3. **NV cardiac at 1 m works** — 72.00 BPM correct, SDNN 119 ms (R13 recovery validated)
|
||
4. **Cube-of-distance falloff is real** — 6.25 pT @ 1 m → 0.23 pT @ 3 m (27× drop, matches 1/r³)
|
||
5. **Fusion produces correct breathing + improved HR** at bedside
|
||
|
||
## The arc that produced this demo
|
||
|
||
| Tick | Output | Time |
|
||
|---|---|---|
|
||
| 37 | R20 — quantum-classical vision | 11:15 UTC |
|
||
| 38 | Doc 17 — quantum-classical bridge | 11:25 UTC |
|
||
| 39 | ADR-114 — shippable cog spec | 11:35 UTC |
|
||
| **40** | **R20.1 — working numpy demo** | **11:40 UTC** |
|
||
|
||
**Vision → integration → spec → working code in 25 minutes.**
|
||
|
||
## Production status
|
||
|
||
ADR-114 specifies ~200 LOC Rust port; this 140 LOC numpy demo runs in <100 ms and validates the architecture. Engineering risk for `cog-quantum-vitals` (Tier 4.x in `PRODUCTION-ROADMAP.md`) is substantially lowered.
|
||
|
||
## Bedside cost (per ADR-114)
|
||
|
||
| Component | Cost |
|
||
|---|---|
|
||
| 4× ESP32-S3 | $60 |
|
||
| 1× NV-diamond (today / 2028) | $200-2,000 / ~$200 |
|
||
| Mount + calibration | $50 |
|
||
| **Total** | **$310-$2,110** |
|
||
|
||
vs clinical continuous monitor: $3,000-$10,000.
|
||
|
||
## Honest scope
|
||
|
||
- Synthetic NV signals (`nvsim` is also a simulator)
|
||
- Cube-of-distance assumes clean dipole field
|
||
- HRV extraction = simple threshold (production needs Pan-Tompkins QRS)
|
||
- Naive Bayesian fusion (production needs threshold-based hand-off when NV confidence > 60%)
|
||
|
||
## Composes with
|
||
|
||
- `01-physics-floor/r6_1_multiscatterer.py` — provides the forward operator the fusion extends
|
||
- `06-structure-detection/r12_1_pose_pabs_loop.py` — pose-PABS hook in ADR-114 architecture
|
||
- `07-negative-results/r13_bp_physics_floor.py` — the negative result this demo recovers
|
||
|
||
## See also
|
||
|
||
- ADR-114: `docs/adr/ADR-114-cog-quantum-vitals.md`
|
||
- Quantum-sensing series: `docs/research/quantum-sensing/{11..17}-*.md` (especially doc 17 which bridges the loop with the existing series)
|
||
- Research notes: `docs/research/sota-2026-05-22/R20-*.md`, `R20_1-*.md`
|