Synthesis of AETHER (ADR-024) + MERIDIAN (ADR-027) + privacy framing + identified next research lever (physics-informed env prediction). Simulation results (10 subjects, 3 rooms, 128-dim embeddings, env/person scale ratio 4.7x): | Configuration | 1-shot acc | |------------------------------------------|-----------:| | Within-room (matches AETHER ~95% target) | 100% | | Cross-room, raw cosine K-NN | 70% | | Cross-room, MERIDIAN 100% env removal | 100% | | Cross-room, MERIDIAN 70% env removal | 100% | | Chance | 10% | The 30 pp gap from within-room to raw cross-room is the angular contribution of env-shift that cosine similarity can't normalise away. MERIDIAN per-room centroid subtraction recovers it -- robust even at 70% effectiveness (realistic for limited labelled examples). Privacy framing: R14 baseline + 4 new constraints specific to biometric-class re-ID data: 1. No cross-installation linkage 2. Embedding storage requires explicit opt-in (biometric consent class) 3. Cryptographically verifiable forgetting 4. No re-ID across legal entities These rule out cross-building tracking, mass surveillance, long-term unlabelled storage, third-party sharing. They allow per-installation personalisation, household anomaly detection, multi-person pose association in the same room. R3 closes the loop on R14's empathic-appliance vision: re-ID is THE primitive that makes per-occupant features possible. Without R3, R14's verticals can't ship. Identifies next research lever: physics-informed env_sig prediction from R6's forward operator + room map = zero-shot cross-room transfer without labelled examples in the new room. Composes: - R5/R6: person+env decomposition in embedding space - R7: mincut = defence against re-ID spoofing - R9: RSSI K-NN showed env-locality dominance for the K-NN primitive - R14: 4 new constraints extend R14's framework to biometric class Honest scope: additive decomposition is first-order; real CSI env effects are multiplicative in subcarrier domain. Adversarial scenarios not simulated. Coordination: ticks/tick-12.md, no PROGRESS.md edit. |
||
|---|---|---|
| .. | ||
| environment | ||
| happiness-vector | ||
| medical | ||
| research-sota | ||
| sleep | ||
| stress | ||
| three.js | ||
| README.md | ||
| ruview_live.py | ||
README.md
Examples
Real-time sensing applications built on the RuView platform.
Unified Dashboard (start here)
pip install pyserial numpy
python examples/ruview_live.py --csi COM7 --mmwave COM4
The live dashboard auto-detects available sensors and displays fused vitals, environment data, and events in real-time. Works with any combination of sensors.
Individual Examples
| Example | Sensors | What It Does |
|---|---|---|
| ruview_live.py | CSI + mmWave + Light | Unified dashboard: HR, BR, BP, stress, presence, light, RSSI |
| Medical: Blood Pressure | mmWave | Contactless BP estimation from HRV |
| Medical: Vitals Suite | mmWave | 10-in-1: HR, BR, BP, HRV, sleep stages, apnea, cough, snoring, activity, meditation |
| Sleep: Apnea Screener | mmWave | Detects breathing cessation events, computes AHI |
| Stress: HRV Monitor | mmWave | Real-time stress level from heart rate variability |
| Environment: Room Monitor | CSI + mmWave | Occupancy, light, RF fingerprint, activity events |
Hardware
| Port | Device | Cost | What It Provides |
|---|---|---|---|
| COM7 | ESP32-S3 (WiFi CSI) | ~$9 | Presence, motion, breathing, heart rate (through walls) |
| COM4 | ESP32-C6 + Seeed MR60BHA2 | ~$15 | Precise HR/BR, presence, distance, ambient light |
Either sensor works alone. Both together enable fusion (mmWave 80% + CSI 20%).
Quick Start
pip install pyserial numpy
# Unified dashboard (recommended)
python examples/ruview_live.py --csi COM7 --mmwave COM4
# Blood pressure estimation
python examples/medical/bp_estimator.py --port COM4
# Sleep apnea screening (run overnight)
python examples/sleep/apnea_screener.py --port COM4 --duration 28800
# Stress monitoring (workday session)
python examples/stress/hrv_stress_monitor.py --port COM4 --duration 3600
# Room environment monitor
python examples/environment/room_monitor.py --csi-port COM7 --mmwave-port COM4
# CSI only (no mmWave)
python examples/ruview_live.py --csi COM7 --mmwave none