History

rUv 8b850d8b2a research(R6.2.3): chest-centric placement — +26.9 pp coverage gain for vital-signs cogs (#726 ) Direct follow-up from R6.1 (chest contributes 27.6% of CSI energy, 5x per-limb value, limbs are confound not signal). R6.2.3 re-runs R6.2's placement search with chest-only target zones (40x40 cm patches at expected chest positions) vs body-footprint zones (R6.2's default full-area definition). Headline result: \| Configuration \| Coverage \| Placement \| \|----------------------------\|---------:\|----------------------------\| \| Body-centric (R6.2 default)\| 49.3% \| (4.25,0)-(0,3.25), 5.35 m \| \| CHEST-CENTRIC (R6.2.3 new) \| 82.4% \| (2.0,0)-(4.5,5), 5.59 m \| Cross-eval: - Body-optimal on chest zones: 55.5% - Chest-targeting GAIN on chest: +26.9 pp - Chest-optimal on body zones: 40.3% (-9.0 pp loss) The two strategies are genuinely different. Same engine, different zones. Per-cog deployment recommendation surfaced: - --target-mode=body (default): cog-person-count, cog-pose, cog-presence - --target-mode=chest (new): cog-vital-signs, cog-breathing, cog-HR - --target-mode=extremity (future): gesture detection ~20 LOC change to R6.2 CLI. R14 vertical-specific: - V1 stress-responsive lighting: chest mode - V2 adaptive HVAC (presence+breathing): mixed - V3 attention-respecting conversation: chest mode R6.2.3 surfaces a per-cog config that empathic-appliance products need at install time. Why placements differ: when target ~ envelope width, envelope can cover it entirely; when target >> envelope, placement must compromise. 40 cm Fresnel envelope @ 5 m link comfortably covers 40 cm chest patches but must spread to cover 3 m^2 bed. Composes: - R6.1 motivated this tick - R6.2 / R6.2.1 / R6.2.2 -- orthogonal extensions - R14 V1/V3 should use chest mode - R12 PABS improves body-position-detection scenarios Honest scope: - Chest positions approximated - 2D still (3D chest-centric = R6.2.3.1 follow-up) - Single subject (multi-subject = union of chest envelopes) - Per-cog zone schema is deployment-time Coordination: ticks/tick-23.md, no PROGRESS.md edit.		2026-05-22 04:43:34 -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(R6.2.3): chest-centric placement — +26.9 pp coverage gain for vital-signs cogs (#726 )	2026-05-22 04:43:34 -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