mirror of
https://github.com/ruvnet/RuView.git
synced 2026-04-29 22:49:32 +00:00
7eba8c7286
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>
56 lines
2.1 KiB
Markdown
56 lines
2.1 KiB
Markdown
# Examples
|
|
|
|
Real-time sensing applications built on the RuView platform.
|
|
|
|
## Unified Dashboard (start here)
|
|
|
|
```bash
|
|
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**](ruview_live.py) | CSI + mmWave + Light | Unified dashboard: HR, BR, BP, stress, presence, light, RSSI |
|
|
| [Medical: Blood Pressure](medical/) | mmWave | Contactless BP estimation from HRV |
|
|
| [Medical: Vitals Suite](medical/vitals_suite.py) | mmWave | 10-in-1: HR, BR, BP, HRV, sleep stages, apnea, cough, snoring, activity, meditation |
|
|
| [Sleep: Apnea Screener](sleep/) | mmWave | Detects breathing cessation events, computes AHI |
|
|
| [Stress: HRV Monitor](stress/) | mmWave | Real-time stress level from heart rate variability |
|
|
| [Environment: Room Monitor](environment/) | 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
|
|
|
|
```bash
|
|
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
|
|
```
|