wifi-densepose/examples
rUv db64b4c671
research(R3): cross-room re-ID — MERIDIAN closes the env-shift gap + 4 privacy constraints (#715)
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.
2026-05-22 02:13:10 -04:00
..
environment feat: 4 sensing examples — sleep apnea, stress, room environment 2026-03-15 16:50:04 -04:00
happiness-vector chore(repo): rename rust-port/wifi-densepose-rs → v2/ (flatten to one level) (#427) 2026-04-25 21:28:13 -04:00
medical feat: 10-in-1 medical vitals suite from single mmWave sensor 2026-03-15 18:05:42 -04:00
research-sota research(R3): cross-room re-ID — MERIDIAN closes the env-shift gap + 4 privacy constraints (#715) 2026-05-22 02:13:10 -04:00
sleep feat: 4 sensing examples — sleep apnea, stress, room environment 2026-03-15 16:50:04 -04:00
stress feat: 4 sensing examples — sleep apnea, stress, room environment 2026-03-15 16:50:04 -04:00
three.js fix(three.js): graceful banner when X Bot.fbx 404s on gh-pages (#651) 2026-05-19 18:43:21 -04:00
README.md feat: 10-in-1 medical vitals suite from single mmWave sensor 2026-03-15 18:05:42 -04:00
ruview_live.py feat: happiness scoring pipeline + ESP32 swarm with Cognitum Seed (#285) 2026-03-20 18:46:34 -04:00

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