vrr/Ruview

mirror of https://github.com/ruvnet/RuView.git synced 2026-04-28 05:59:32 +00:00

ruv 7eba8c7286 feat: 10-in-1 medical vitals suite from single mmWave sensor

examples/medical/vitals_suite.py — all 10 capabilities:
1. Heart rate (continuous)
2. Breathing rate (continuous)
3. Blood pressure estimation (HRV-based)
4. HRV stress analysis (SDNN, RMSSD, pNN50)
5. Sleep stage classification (awake/light/deep/REM)
6. Apnea event detection (BR=0 for >10s, AHI scoring)
7. Cough detection (BR spike > 2.5x baseline)
8. Snoring detection (periodic high-amplitude BR)
9. Activity state (resting/active/exercising)
10. Meditation quality scorer (BR regularity + HR + HRV)

Uses Welford online stats, zero-crossing analysis, and
variability-based state classification. Single $15 sensor.

Co-Authored-By: claude-flow <ruv@ruv.net>

2026-03-15 18:05:42 -04:00

2.1 KiB

Raw Blame History

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

2.1 KiB Raw Blame History