feat: ADR-021 vital sign detection + RVF container format (closes #45)

Implement WiFi CSI-based vital sign detection and RVF model container:

- Pure-Rust radix-2 DIT FFT with Hann windowing and parabolic interpolation
- FIR bandpass filter (windowed-sinc, Hamming) for breathing (0.1-0.5 Hz)
  and heartbeat (0.8-2.0 Hz) band isolation
- VitalSignDetector with rolling buffers (30s breathing, 15s heartbeat)
- RVF binary container with 64-byte SegmentHeader, CRC32 integrity,
  6 segment types (Vec, Manifest, Quant, Meta, Witness, Profile)
- RvfBuilder/RvfReader with file I/O and VitalSignConfig support
- Server integration: --benchmark, --load-rvf, --save-rvf CLI flags
- REST endpoint /api/v1/vital-signs and WebSocket vital_signs field
- 98 tests (32 unit + 16 RVF integration + 18 vital signs integration)
- Benchmark: 7,313 frames/sec (136μs/frame), 365x real-time at 20 Hz

Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
ruv
2026-02-28 22:52:19 -05:00
parent fd8dec5cab
commit 1192de951a
10 changed files with 3227 additions and 2 deletions

View File

@@ -0,0 +1,556 @@
//! Integration tests for the RVF (RuVector Format) container module.
//!
//! These tests exercise the public RvfBuilder and RvfReader APIs through
//! the library crate's public interface. They complement the inline unit
//! tests in rvf_container.rs by testing from the perspective of an external
//! consumer.
//!
//! Test matrix:
//! - Empty builder produces valid (empty) container
//! - Full round-trip: manifest + weights + metadata -> build -> read -> verify
//! - Segment type tagging and ordering
//! - Magic byte corruption is rejected
//! - Float32 precision is preserved bit-for-bit
//! - Large payload (1M weights) round-trip
//! - Multiple metadata segments coexist
//! - File I/O round-trip
//! - Witness/proof segment verification
//! - Write/read benchmark for ~10MB container
use wifi_densepose_sensing_server::rvf_container::{
RvfBuilder, RvfReader, VitalSignConfig,
};
// ---------------------------------------------------------------------------
// Tests
// ---------------------------------------------------------------------------
#[test]
fn test_rvf_builder_empty() {
let builder = RvfBuilder::new();
let data = builder.build();
// Empty builder produces zero bytes (no segments => no headers)
assert!(
data.is_empty(),
"empty builder should produce empty byte vec"
);
// Reader should parse an empty container with zero segments
let reader = RvfReader::from_bytes(&data).expect("should parse empty container");
assert_eq!(reader.segment_count(), 0);
assert_eq!(reader.total_size(), 0);
}
#[test]
fn test_rvf_round_trip() {
let mut builder = RvfBuilder::new();
// Add all segment types
builder.add_manifest("vital-signs-v1", "0.1.0", "Vital sign detection model");
let weights: Vec<f32> = (0..100).map(|i| i as f32 * 0.01).collect();
builder.add_weights(&weights);
let metadata = serde_json::json!({
"training_epochs": 50,
"loss": 0.023,
"optimizer": "adam",
});
builder.add_metadata(&metadata);
let data = builder.build();
assert!(!data.is_empty(), "container with data should not be empty");
// Alignment: every segment should start on a 64-byte boundary
assert_eq!(
data.len() % 64,
0,
"total size should be a multiple of 64 bytes"
);
// Parse back
let reader = RvfReader::from_bytes(&data).expect("should parse container");
assert_eq!(reader.segment_count(), 3);
// Verify manifest
let manifest = reader
.manifest()
.expect("should have manifest");
assert_eq!(manifest["model_id"], "vital-signs-v1");
assert_eq!(manifest["version"], "0.1.0");
assert_eq!(manifest["description"], "Vital sign detection model");
// Verify weights
let decoded_weights = reader
.weights()
.expect("should have weights");
assert_eq!(decoded_weights.len(), weights.len());
for (i, (&original, &decoded)) in weights.iter().zip(decoded_weights.iter()).enumerate() {
assert_eq!(
original.to_bits(),
decoded.to_bits(),
"weight[{i}] mismatch"
);
}
// Verify metadata
let decoded_meta = reader
.metadata()
.expect("should have metadata");
assert_eq!(decoded_meta["training_epochs"], 50);
assert_eq!(decoded_meta["optimizer"], "adam");
}
#[test]
fn test_rvf_segment_types() {
let mut builder = RvfBuilder::new();
builder.add_manifest("test", "1.0", "test model");
builder.add_weights(&[1.0, 2.0]);
builder.add_metadata(&serde_json::json!({"key": "value"}));
builder.add_witness(
"sha256:abc123",
&serde_json::json!({"accuracy": 0.95}),
);
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
assert_eq!(reader.segment_count(), 4);
// Each segment type should be present
assert!(reader.manifest().is_some(), "manifest should be present");
assert!(reader.weights().is_some(), "weights should be present");
assert!(reader.metadata().is_some(), "metadata should be present");
assert!(reader.witness().is_some(), "witness should be present");
// Verify segment order via segment IDs (monotonically increasing)
let ids: Vec<u64> = reader
.segments()
.map(|(h, _)| h.segment_id)
.collect();
assert_eq!(ids, vec![0, 1, 2, 3], "segment IDs should be 0,1,2,3");
}
#[test]
fn test_rvf_magic_validation() {
let mut builder = RvfBuilder::new();
builder.add_manifest("test", "1.0", "test");
let mut data = builder.build();
// Corrupt the magic bytes in the first segment header
// Magic is at offset 0x00..0x04
data[0] = 0xDE;
data[1] = 0xAD;
data[2] = 0xBE;
data[3] = 0xEF;
let result = RvfReader::from_bytes(&data);
assert!(
result.is_err(),
"corrupted magic should fail to parse"
);
let err = result.unwrap_err();
assert!(
err.contains("magic"),
"error message should mention 'magic', got: {}",
err
);
}
#[test]
fn test_rvf_weights_f32_precision() {
// Test specific float32 edge cases
let weights: Vec<f32> = vec![
0.0,
1.0,
-1.0,
f32::MIN_POSITIVE,
f32::MAX,
f32::MIN,
f32::EPSILON,
std::f32::consts::PI,
std::f32::consts::E,
1.0e-30,
1.0e30,
-0.0,
0.123456789,
1.0e-45, // subnormal
];
let mut builder = RvfBuilder::new();
builder.add_weights(&weights);
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
let decoded = reader.weights().expect("should have weights");
assert_eq!(decoded.len(), weights.len());
for (i, (&original, &parsed)) in weights.iter().zip(decoded.iter()).enumerate() {
assert_eq!(
original.to_bits(),
parsed.to_bits(),
"weight[{i}] bit-level mismatch: original={original} (0x{:08X}), parsed={parsed} (0x{:08X})",
original.to_bits(),
parsed.to_bits(),
);
}
}
#[test]
fn test_rvf_large_payload() {
// 1 million f32 weights = 4 MB of payload data
let num_weights = 1_000_000;
let weights: Vec<f32> = (0..num_weights)
.map(|i| (i as f32 * 0.000001).sin())
.collect();
let mut builder = RvfBuilder::new();
builder.add_manifest("large-test", "1.0", "Large payload test");
builder.add_weights(&weights);
let data = builder.build();
// Container should be at least header + weights bytes
assert!(
data.len() >= 64 + num_weights * 4,
"container should be large enough, got {} bytes",
data.len()
);
let reader = RvfReader::from_bytes(&data).expect("should parse large container");
let decoded = reader.weights().expect("should have weights");
assert_eq!(
decoded.len(),
num_weights,
"all 1M weights should round-trip"
);
// Spot-check several values
for idx in [0, 1, 100, 1000, 500_000, 999_999] {
assert_eq!(
weights[idx].to_bits(),
decoded[idx].to_bits(),
"weight[{idx}] mismatch"
);
}
}
#[test]
fn test_rvf_multiple_metadata_segments() {
// The current builder only stores one metadata segment, but we can add
// multiple by adding metadata and then other segments to verify all coexist.
let mut builder = RvfBuilder::new();
builder.add_manifest("multi-meta", "1.0", "Multiple segment types");
let meta1 = serde_json::json!({"training_config": {"optimizer": "adam"}});
builder.add_metadata(&meta1);
builder.add_vital_config(&VitalSignConfig::default());
builder.add_quant_info("int8", 0.0078125, -128);
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
assert_eq!(
reader.segment_count(),
4,
"should have 4 segments (manifest + meta + vital_config + quant)"
);
assert!(reader.manifest().is_some());
assert!(reader.metadata().is_some());
assert!(reader.vital_config().is_some());
assert!(reader.quant_info().is_some());
// Verify metadata content
let meta = reader.metadata().unwrap();
assert_eq!(meta["training_config"]["optimizer"], "adam");
}
#[test]
fn test_rvf_file_io() {
let tmp_dir = tempfile::tempdir().expect("should create temp dir");
let file_path = tmp_dir.path().join("test_model.rvf");
let weights: Vec<f32> = vec![0.1, 0.2, 0.3, 0.4, 0.5];
let mut builder = RvfBuilder::new();
builder.add_manifest("file-io-test", "1.0.0", "File I/O test model");
builder.add_weights(&weights);
builder.add_metadata(&serde_json::json!({"created": "2026-02-28"}));
// Write to file
builder
.write_to_file(&file_path)
.expect("should write to file");
// Read back from file
let reader = RvfReader::from_file(&file_path).expect("should read from file");
assert_eq!(reader.segment_count(), 3);
let manifest = reader.manifest().expect("should have manifest");
assert_eq!(manifest["model_id"], "file-io-test");
let decoded_weights = reader.weights().expect("should have weights");
assert_eq!(decoded_weights.len(), weights.len());
for (a, b) in decoded_weights.iter().zip(weights.iter()) {
assert_eq!(a.to_bits(), b.to_bits());
}
let meta = reader.metadata().expect("should have metadata");
assert_eq!(meta["created"], "2026-02-28");
// Verify file size matches in-memory serialization
let in_memory = builder.build();
let file_meta = std::fs::metadata(&file_path).expect("should stat file");
assert_eq!(
file_meta.len() as usize,
in_memory.len(),
"file size should match serialized size"
);
}
#[test]
fn test_rvf_witness_proof() {
let training_hash = "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855";
let metrics = serde_json::json!({
"accuracy": 0.957,
"loss": 0.023,
"epochs": 200,
"dataset_size": 50000,
});
let mut builder = RvfBuilder::new();
builder.add_manifest("witnessed-model", "2.0", "Model with witness proof");
builder.add_weights(&[1.0, 2.0, 3.0]);
builder.add_witness(training_hash, &metrics);
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
let witness = reader.witness().expect("should have witness segment");
assert_eq!(
witness["training_hash"],
training_hash,
"training hash should round-trip"
);
assert_eq!(witness["metrics"]["accuracy"], 0.957);
assert_eq!(witness["metrics"]["epochs"], 200);
}
#[test]
fn test_rvf_benchmark_write_read() {
// Create a container with ~10 MB of weights
let num_weights = 2_500_000; // 10 MB of f32 data
let weights: Vec<f32> = (0..num_weights)
.map(|i| (i as f32 * 0.0001).sin())
.collect();
let mut builder = RvfBuilder::new();
builder.add_manifest("benchmark-model", "1.0", "Benchmark test");
builder.add_weights(&weights);
builder.add_metadata(&serde_json::json!({"benchmark": true}));
// Benchmark write (serialization)
let write_start = std::time::Instant::now();
let data = builder.build();
let write_elapsed = write_start.elapsed();
let size_mb = data.len() as f64 / (1024.0 * 1024.0);
let write_speed = size_mb / write_elapsed.as_secs_f64();
println!(
"RVF write benchmark: {:.1} MB in {:.2}ms = {:.0} MB/s",
size_mb,
write_elapsed.as_secs_f64() * 1000.0,
write_speed,
);
// Benchmark read (deserialization + CRC validation)
let read_start = std::time::Instant::now();
let reader = RvfReader::from_bytes(&data).expect("should parse benchmark container");
let read_elapsed = read_start.elapsed();
let read_speed = size_mb / read_elapsed.as_secs_f64();
println!(
"RVF read benchmark: {:.1} MB in {:.2}ms = {:.0} MB/s",
size_mb,
read_elapsed.as_secs_f64() * 1000.0,
read_speed,
);
// Verify correctness
let decoded_weights = reader.weights().expect("should have weights");
assert_eq!(decoded_weights.len(), num_weights);
assert_eq!(weights[0].to_bits(), decoded_weights[0].to_bits());
assert_eq!(
weights[num_weights - 1].to_bits(),
decoded_weights[num_weights - 1].to_bits()
);
// Write and read should be reasonably fast
assert!(
write_speed > 10.0,
"write speed {:.0} MB/s is too slow",
write_speed
);
assert!(
read_speed > 10.0,
"read speed {:.0} MB/s is too slow",
read_speed
);
}
#[test]
fn test_rvf_content_hash_integrity() {
let mut builder = RvfBuilder::new();
builder.add_metadata(&serde_json::json!({"integrity": "test"}));
let mut data = builder.build();
// Corrupt one byte in the payload area (after the 64-byte header)
if data.len() > 65 {
data[65] ^= 0xFF;
let result = RvfReader::from_bytes(&data);
assert!(
result.is_err(),
"corrupted payload should fail CRC32 hash check"
);
assert!(
result.unwrap_err().contains("hash mismatch"),
"error should mention hash mismatch"
);
}
}
#[test]
fn test_rvf_truncated_data() {
let mut builder = RvfBuilder::new();
builder.add_manifest("truncation-test", "1.0", "Truncation test");
builder.add_weights(&[1.0, 2.0, 3.0, 4.0, 5.0]);
let data = builder.build();
// Truncating at header boundary or within payload should fail
for truncate_at in [0, 10, 32, 63, 64, 65, 80] {
if truncate_at < data.len() {
let truncated = &data[..truncate_at];
let result = RvfReader::from_bytes(truncated);
// Empty or partial-header data: either returns empty or errors
if truncate_at < 64 {
// Less than one header: reader returns 0 segments (no error on empty)
// or fails if partial header data is present
// The reader skips if offset + HEADER_SIZE > data.len()
if truncate_at == 0 {
assert!(
result.is_ok() && result.unwrap().segment_count() == 0,
"empty data should parse as 0 segments"
);
}
} else {
// Has header but truncated payload
assert!(
result.is_err(),
"truncated at {truncate_at} bytes should fail"
);
}
}
}
}
#[test]
fn test_rvf_empty_weights() {
let mut builder = RvfBuilder::new();
builder.add_weights(&[]);
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
let weights = reader.weights().expect("should have weights segment");
assert!(weights.is_empty(), "empty weight vector should round-trip");
}
#[test]
fn test_rvf_vital_config_round_trip() {
let config = VitalSignConfig {
breathing_low_hz: 0.15,
breathing_high_hz: 0.45,
heartrate_low_hz: 0.9,
heartrate_high_hz: 1.8,
min_subcarriers: 64,
window_size: 1024,
confidence_threshold: 0.7,
};
let mut builder = RvfBuilder::new();
builder.add_vital_config(&config);
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
let decoded = reader
.vital_config()
.expect("should have vital config");
assert!(
(decoded.breathing_low_hz - 0.15).abs() < f64::EPSILON,
"breathing_low_hz mismatch"
);
assert!(
(decoded.breathing_high_hz - 0.45).abs() < f64::EPSILON,
"breathing_high_hz mismatch"
);
assert!(
(decoded.heartrate_low_hz - 0.9).abs() < f64::EPSILON,
"heartrate_low_hz mismatch"
);
assert!(
(decoded.heartrate_high_hz - 1.8).abs() < f64::EPSILON,
"heartrate_high_hz mismatch"
);
assert_eq!(decoded.min_subcarriers, 64);
assert_eq!(decoded.window_size, 1024);
assert!(
(decoded.confidence_threshold - 0.7).abs() < f64::EPSILON,
"confidence_threshold mismatch"
);
}
#[test]
fn test_rvf_info_struct() {
let mut builder = RvfBuilder::new();
builder.add_manifest("info-test", "2.0", "Info struct test");
builder.add_weights(&[1.0, 2.0, 3.0]);
builder.add_vital_config(&VitalSignConfig::default());
builder.add_witness("sha256:test", &serde_json::json!({"ok": true}));
let data = builder.build();
let reader = RvfReader::from_bytes(&data).expect("should parse");
let info = reader.info();
assert_eq!(info.segment_count, 4);
assert!(info.total_size > 0);
assert!(info.manifest.is_some());
assert!(info.has_weights);
assert!(info.has_vital_config);
assert!(info.has_witness);
assert!(!info.has_quant_info, "no quant segment was added");
}
#[test]
fn test_rvf_alignment_invariant() {
// Every container should have total size that is a multiple of 64
for num_weights in [0, 1, 10, 100, 255, 256, 1000] {
let weights: Vec<f32> = (0..num_weights).map(|i| i as f32).collect();
let mut builder = RvfBuilder::new();
builder.add_weights(&weights);
let data = builder.build();
assert_eq!(
data.len() % 64,
0,
"container with {num_weights} weights should be 64-byte aligned, got {} bytes",
data.len()
);
}
}

View File

@@ -0,0 +1,645 @@
//! Comprehensive integration tests for the vital sign detection module.
//!
//! These tests exercise the public VitalSignDetector API by feeding
//! synthetic CSI frames (amplitude + phase vectors) and verifying the
//! extracted breathing rate, heart rate, confidence, and signal quality.
//!
//! Test matrix:
//! - Detector creation and sane defaults
//! - Breathing rate detection from synthetic 0.25 Hz (15 BPM) sine
//! - Heartbeat detection from synthetic 1.2 Hz (72 BPM) sine
//! - Combined breathing + heartbeat detection
//! - No-signal (constant amplitude) returns None or low confidence
//! - Out-of-range frequencies are rejected or produce low confidence
//! - Confidence increases with signal-to-noise ratio
//! - Reset clears all internal buffers
//! - Minimum samples threshold
//! - Throughput benchmark (10000 frames)
use std::f64::consts::PI;
use wifi_densepose_sensing_server::vital_signs::{VitalSignDetector, VitalSigns};
// ---------------------------------------------------------------------------
// Helpers
// ---------------------------------------------------------------------------
const N_SUBCARRIERS: usize = 56;
/// Generate a single CSI frame's amplitude vector with an embedded
/// breathing-band sine wave at `freq_hz` Hz.
///
/// The returned amplitude has `N_SUBCARRIERS` elements, each with a
/// per-subcarrier baseline plus the breathing modulation.
fn make_breathing_frame(freq_hz: f64, t: f64) -> Vec<f64> {
(0..N_SUBCARRIERS)
.map(|i| {
let base = 15.0 + 5.0 * (i as f64 * 0.1).sin();
let breathing = 2.0 * (2.0 * PI * freq_hz * t).sin();
base + breathing
})
.collect()
}
/// Generate a phase vector that produces a phase-variance signal oscillating
/// at `freq_hz` Hz.
///
/// The heartbeat detector uses cross-subcarrier phase variance as its input
/// feature. To produce variance that oscillates at freq_hz, we modulate the
/// spread of phases across subcarriers at that frequency.
fn make_heartbeat_phase_variance(freq_hz: f64, t: f64) -> Vec<f64> {
// Modulation factor: variance peaks when modulation is high
let modulation = 0.5 * (1.0 + (2.0 * PI * freq_hz * t).sin());
(0..N_SUBCARRIERS)
.map(|i| {
// Each subcarrier gets a different phase offset, scaled by modulation
let base = (i as f64 * 0.2).sin();
base * modulation
})
.collect()
}
/// Generate constant-phase vector (no heartbeat signal).
fn make_static_phase() -> Vec<f64> {
(0..N_SUBCARRIERS)
.map(|i| (i as f64 * 0.2).sin())
.collect()
}
/// Feed `n_frames` of synthetic breathing data to a detector.
fn feed_breathing_signal(
detector: &mut VitalSignDetector,
freq_hz: f64,
sample_rate: f64,
n_frames: usize,
) -> VitalSigns {
let phase = make_static_phase();
let mut vitals = VitalSigns::default();
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp = make_breathing_frame(freq_hz, t);
vitals = detector.process_frame(&amp, &phase);
}
vitals
}
// ---------------------------------------------------------------------------
// Tests
// ---------------------------------------------------------------------------
#[test]
fn test_vital_detector_creation() {
let sample_rate = 20.0;
let detector = VitalSignDetector::new(sample_rate);
// Buffer status should be empty initially
let (br_len, br_cap, hb_len, hb_cap) = detector.buffer_status();
assert_eq!(br_len, 0, "breathing buffer should start empty");
assert_eq!(hb_len, 0, "heartbeat buffer should start empty");
assert!(br_cap > 0, "breathing capacity should be positive");
assert!(hb_cap > 0, "heartbeat capacity should be positive");
// Capacities should be based on sample rate and window durations
// At 20 Hz with 30s breathing window: 600 samples
// At 20 Hz with 15s heartbeat window: 300 samples
assert_eq!(br_cap, 600, "breathing capacity at 20 Hz * 30s = 600");
assert_eq!(hb_cap, 300, "heartbeat capacity at 20 Hz * 15s = 300");
}
#[test]
fn test_breathing_detection_synthetic() {
let sample_rate = 20.0;
let breathing_freq = 0.25; // 15 BPM
let mut detector = VitalSignDetector::new(sample_rate);
// Feed 30 seconds of clear breathing signal
let n_frames = (sample_rate * 30.0) as usize; // 600 frames
let vitals = feed_breathing_signal(&mut detector, breathing_freq, sample_rate, n_frames);
// Breathing rate should be detected
let bpm = vitals
.breathing_rate_bpm
.expect("should detect breathing rate from 0.25 Hz sine");
// Allow +/- 3 BPM tolerance (FFT resolution at 20 Hz over 600 samples)
let expected_bpm = 15.0;
assert!(
(bpm - expected_bpm).abs() < 3.0,
"breathing rate {:.1} BPM should be close to {:.1} BPM",
bpm,
expected_bpm,
);
assert!(
vitals.breathing_confidence > 0.0,
"breathing confidence should be > 0, got {}",
vitals.breathing_confidence,
);
}
#[test]
fn test_heartbeat_detection_synthetic() {
let sample_rate = 20.0;
let heartbeat_freq = 1.2; // 72 BPM
let mut detector = VitalSignDetector::new(sample_rate);
// Feed 15 seconds of data with heartbeat signal in the phase variance
let n_frames = (sample_rate * 15.0) as usize;
// Static amplitude -- no breathing signal
let amp: Vec<f64> = (0..N_SUBCARRIERS)
.map(|i| 15.0 + 5.0 * (i as f64 * 0.1).sin())
.collect();
let mut vitals = VitalSigns::default();
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let phase = make_heartbeat_phase_variance(heartbeat_freq, t);
vitals = detector.process_frame(&amp, &phase);
}
// Heart rate detection from phase variance is more challenging.
// We verify that if a heart rate is detected, it's in the valid
// physiological range (40-120 BPM).
if let Some(bpm) = vitals.heart_rate_bpm {
assert!(
bpm >= 40.0 && bpm <= 120.0,
"detected heart rate {:.1} BPM should be in physiological range [40, 120]",
bpm
);
}
// At minimum, heartbeat confidence should be non-negative
assert!(
vitals.heartbeat_confidence >= 0.0,
"heartbeat confidence should be >= 0"
);
}
#[test]
fn test_combined_vital_signs() {
let sample_rate = 20.0;
let breathing_freq = 0.25; // 15 BPM
let heartbeat_freq = 1.2; // 72 BPM
let mut detector = VitalSignDetector::new(sample_rate);
// Feed 30 seconds with both signals
let n_frames = (sample_rate * 30.0) as usize;
let mut vitals = VitalSigns::default();
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
// Amplitude carries breathing modulation
let amp = make_breathing_frame(breathing_freq, t);
// Phase carries heartbeat modulation (via variance)
let phase = make_heartbeat_phase_variance(heartbeat_freq, t);
vitals = detector.process_frame(&amp, &phase);
}
// Breathing should be detected accurately
let breathing_bpm = vitals
.breathing_rate_bpm
.expect("should detect breathing in combined signal");
assert!(
(breathing_bpm - 15.0).abs() < 3.0,
"breathing {:.1} BPM should be close to 15 BPM",
breathing_bpm
);
// Heartbeat: verify it's in the valid range if detected
if let Some(hb_bpm) = vitals.heart_rate_bpm {
assert!(
hb_bpm >= 40.0 && hb_bpm <= 120.0,
"heartbeat {:.1} BPM should be in range [40, 120]",
hb_bpm
);
}
}
#[test]
fn test_no_signal_lower_confidence_than_true_signal() {
let sample_rate = 20.0;
let n_frames = (sample_rate * 30.0) as usize;
// Detector A: constant amplitude (no real breathing signal)
let mut detector_flat = VitalSignDetector::new(sample_rate);
let amp_flat = vec![50.0; N_SUBCARRIERS];
let phase = vec![0.0; N_SUBCARRIERS];
for _ in 0..n_frames {
detector_flat.process_frame(&amp_flat, &phase);
}
let (_, flat_conf) = detector_flat.extract_breathing();
// Detector B: clear 0.25 Hz breathing signal
let mut detector_signal = VitalSignDetector::new(sample_rate);
let phase_b = make_static_phase();
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp = make_breathing_frame(0.25, t);
detector_signal.process_frame(&amp, &phase_b);
}
let (signal_rate, signal_conf) = detector_signal.extract_breathing();
// The real signal should be detected
assert!(
signal_rate.is_some(),
"true breathing signal should be detected"
);
// The real signal should have higher confidence than the flat signal.
// Note: the bandpass filter creates transient artifacts on flat signals
// that may produce non-zero confidence, but a true periodic signal should
// always produce a stronger spectral peak.
assert!(
signal_conf >= flat_conf,
"true signal confidence ({:.3}) should be >= flat signal confidence ({:.3})",
signal_conf,
flat_conf,
);
}
#[test]
fn test_out_of_range_lower_confidence_than_in_band() {
let sample_rate = 20.0;
let n_frames = (sample_rate * 30.0) as usize;
let phase = make_static_phase();
// Detector A: 5 Hz amplitude oscillation (outside breathing band)
let mut detector_oob = VitalSignDetector::new(sample_rate);
let out_of_band_freq = 5.0;
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp: Vec<f64> = (0..N_SUBCARRIERS)
.map(|i| {
let base = 15.0 + 5.0 * (i as f64 * 0.1).sin();
base + 2.0 * (2.0 * PI * out_of_band_freq * t).sin()
})
.collect();
detector_oob.process_frame(&amp, &phase);
}
let (_, oob_conf) = detector_oob.extract_breathing();
// Detector B: 0.25 Hz amplitude oscillation (inside breathing band)
let mut detector_inband = VitalSignDetector::new(sample_rate);
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp = make_breathing_frame(0.25, t);
detector_inband.process_frame(&amp, &phase);
}
let (inband_rate, inband_conf) = detector_inband.extract_breathing();
// The in-band signal should be detected
assert!(
inband_rate.is_some(),
"in-band 0.25 Hz signal should be detected as breathing"
);
// The in-band signal should have higher confidence than the out-of-band one.
// The bandpass filter may leak some energy from 5 Hz harmonics, but a true
// 0.25 Hz signal should always dominate.
assert!(
inband_conf >= oob_conf,
"in-band confidence ({:.3}) should be >= out-of-band confidence ({:.3})",
inband_conf,
oob_conf,
);
}
#[test]
fn test_confidence_increases_with_snr() {
let sample_rate = 20.0;
let breathing_freq = 0.25;
let n_frames = (sample_rate * 30.0) as usize;
// High SNR: large breathing amplitude, no noise
let mut detector_clean = VitalSignDetector::new(sample_rate);
let phase = make_static_phase();
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp: Vec<f64> = (0..N_SUBCARRIERS)
.map(|i| {
let base = 15.0 + 5.0 * (i as f64 * 0.1).sin();
// Strong breathing signal (amplitude 5.0)
base + 5.0 * (2.0 * PI * breathing_freq * t).sin()
})
.collect();
detector_clean.process_frame(&amp, &phase);
}
let (_, clean_conf) = detector_clean.extract_breathing();
// Low SNR: small breathing amplitude, lots of noise
let mut detector_noisy = VitalSignDetector::new(sample_rate);
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp: Vec<f64> = (0..N_SUBCARRIERS)
.map(|i| {
let base = 15.0 + 5.0 * (i as f64 * 0.1).sin();
// Weak breathing signal (amplitude 0.1) + heavy noise
let noise = 3.0
* ((i as f64 * 7.3 + t * 113.7).sin()
+ (i as f64 * 13.1 + t * 79.3).sin())
/ 2.0;
base + 0.1 * (2.0 * PI * breathing_freq * t).sin() + noise
})
.collect();
detector_noisy.process_frame(&amp, &phase);
}
let (_, noisy_conf) = detector_noisy.extract_breathing();
assert!(
clean_conf > noisy_conf,
"clean signal confidence ({:.3}) should exceed noisy signal confidence ({:.3})",
clean_conf,
noisy_conf,
);
}
#[test]
fn test_reset_clears_buffers() {
let mut detector = VitalSignDetector::new(20.0);
let amp = vec![10.0; N_SUBCARRIERS];
let phase = vec![0.0; N_SUBCARRIERS];
// Feed some frames to fill buffers
for _ in 0..100 {
detector.process_frame(&amp, &phase);
}
let (br_len, _, hb_len, _) = detector.buffer_status();
assert!(br_len > 0, "breathing buffer should have data before reset");
assert!(hb_len > 0, "heartbeat buffer should have data before reset");
// Reset
detector.reset();
let (br_len, _, hb_len, _) = detector.buffer_status();
assert_eq!(br_len, 0, "breathing buffer should be empty after reset");
assert_eq!(hb_len, 0, "heartbeat buffer should be empty after reset");
// Extraction should return None after reset
let (breathing, _) = detector.extract_breathing();
let (heartbeat, _) = detector.extract_heartbeat();
assert!(
breathing.is_none(),
"breathing should be None after reset (not enough samples)"
);
assert!(
heartbeat.is_none(),
"heartbeat should be None after reset (not enough samples)"
);
}
#[test]
fn test_minimum_samples_required() {
let sample_rate = 20.0;
let mut detector = VitalSignDetector::new(sample_rate);
let amp = vec![10.0; N_SUBCARRIERS];
let phase = vec![0.0; N_SUBCARRIERS];
// Feed fewer than MIN_BREATHING_SAMPLES (40) frames
for _ in 0..39 {
detector.process_frame(&amp, &phase);
}
let (breathing, _) = detector.extract_breathing();
assert!(
breathing.is_none(),
"with 39 samples (< 40 min), breathing should return None"
);
// One more frame should meet the minimum
detector.process_frame(&amp, &phase);
let (br_len, _, _, _) = detector.buffer_status();
assert_eq!(br_len, 40, "should have exactly 40 samples now");
// Now extraction is at least attempted (may still be None if flat signal,
// but should not be blocked by the min-samples check)
let _ = detector.extract_breathing();
}
#[test]
fn test_benchmark_throughput() {
let sample_rate = 20.0;
let mut detector = VitalSignDetector::new(sample_rate);
let num_frames = 10_000;
let n_sub = N_SUBCARRIERS;
// Pre-generate frames
let frames: Vec<(Vec<f64>, Vec<f64>)> = (0..num_frames)
.map(|tick| {
let t = tick as f64 / sample_rate;
let amp: Vec<f64> = (0..n_sub)
.map(|i| {
let base = 15.0 + 5.0 * (i as f64 * 0.1).sin();
let breathing = 2.0 * (2.0 * PI * 0.25 * t).sin();
let heartbeat = 0.3 * (2.0 * PI * 1.2 * t).sin();
let noise = (i as f64 * 7.3 + t * 13.7).sin() * 0.5;
base + breathing + heartbeat + noise
})
.collect();
let phase: Vec<f64> = (0..n_sub)
.map(|i| (i as f64 * 0.2 + t * 0.5).sin() * PI)
.collect();
(amp, phase)
})
.collect();
let start = std::time::Instant::now();
for (amp, phase) in &frames {
detector.process_frame(amp, phase);
}
let elapsed = start.elapsed();
let fps = num_frames as f64 / elapsed.as_secs_f64();
println!(
"Vital sign benchmark: {} frames in {:.2}ms = {:.0} frames/sec",
num_frames,
elapsed.as_secs_f64() * 1000.0,
fps
);
// Should process at least 100 frames/sec on any reasonable hardware
assert!(
fps > 100.0,
"throughput {:.0} fps is too low (expected > 100 fps)",
fps,
);
}
#[test]
fn test_vital_signs_default() {
let vs = VitalSigns::default();
assert!(vs.breathing_rate_bpm.is_none());
assert!(vs.heart_rate_bpm.is_none());
assert_eq!(vs.breathing_confidence, 0.0);
assert_eq!(vs.heartbeat_confidence, 0.0);
assert_eq!(vs.signal_quality, 0.0);
}
#[test]
fn test_empty_amplitude_frame() {
let mut detector = VitalSignDetector::new(20.0);
let vitals = detector.process_frame(&[], &[]);
assert!(vitals.breathing_rate_bpm.is_none());
assert!(vitals.heart_rate_bpm.is_none());
assert_eq!(vitals.signal_quality, 0.0);
}
#[test]
fn test_single_subcarrier_no_panic() {
let mut detector = VitalSignDetector::new(20.0);
// Single subcarrier should not crash
for i in 0..100 {
let t = i as f64 / 20.0;
let amp = vec![10.0 + (2.0 * PI * 0.25 * t).sin()];
let phase = vec![0.0];
let _ = detector.process_frame(&amp, &phase);
}
}
#[test]
fn test_signal_quality_varies_with_input() {
let mut detector_static = VitalSignDetector::new(20.0);
let mut detector_varied = VitalSignDetector::new(20.0);
// Feed static signal (all same amplitude)
for _ in 0..100 {
let amp = vec![10.0; N_SUBCARRIERS];
let phase = vec![0.0; N_SUBCARRIERS];
detector_static.process_frame(&amp, &phase);
}
// Feed varied signal (moderate CV -- body motion)
for i in 0..100 {
let t = i as f64 / 20.0;
let amp: Vec<f64> = (0..N_SUBCARRIERS)
.map(|j| {
let base = 15.0;
let modulation = 2.0 * (2.0 * PI * 0.25 * t + j as f64 * 0.1).sin();
base + modulation
})
.collect();
let phase: Vec<f64> = (0..N_SUBCARRIERS)
.map(|j| (j as f64 * 0.2 + t).sin())
.collect();
detector_varied.process_frame(&amp, &phase);
}
// The varied signal should have higher signal quality than the static one
let static_vitals =
detector_static.process_frame(&vec![10.0; N_SUBCARRIERS], &vec![0.0; N_SUBCARRIERS]);
let amp_varied: Vec<f64> = (0..N_SUBCARRIERS)
.map(|j| 15.0 + 2.0 * (j as f64 * 0.3).sin())
.collect();
let phase_varied: Vec<f64> = (0..N_SUBCARRIERS).map(|j| (j as f64 * 0.2).sin()).collect();
let varied_vitals = detector_varied.process_frame(&amp_varied, &phase_varied);
assert!(
varied_vitals.signal_quality >= static_vitals.signal_quality,
"varied signal quality ({:.3}) should be >= static ({:.3})",
varied_vitals.signal_quality,
static_vitals.signal_quality,
);
}
#[test]
fn test_buffer_capacity_respected() {
let sample_rate = 20.0;
let mut detector = VitalSignDetector::new(sample_rate);
let amp = vec![10.0; N_SUBCARRIERS];
let phase = vec![0.0; N_SUBCARRIERS];
// Feed more frames than breathing capacity (600)
for _ in 0..1000 {
detector.process_frame(&amp, &phase);
}
let (br_len, br_cap, hb_len, hb_cap) = detector.buffer_status();
assert!(
br_len <= br_cap,
"breathing buffer length {} should not exceed capacity {}",
br_len,
br_cap
);
assert!(
hb_len <= hb_cap,
"heartbeat buffer length {} should not exceed capacity {}",
hb_len,
hb_cap
);
}
#[test]
fn test_run_benchmark_function() {
let (total, per_frame) = wifi_densepose_sensing_server::vital_signs::run_benchmark(50);
assert!(total.as_nanos() > 0, "benchmark total duration should be > 0");
assert!(
per_frame.as_nanos() > 0,
"benchmark per-frame duration should be > 0"
);
}
#[test]
fn test_breathing_rate_in_physiological_range() {
// If breathing is detected, it must always be in the physiological range
// (6-30 BPM = 0.1-0.5 Hz)
let sample_rate = 20.0;
let mut detector = VitalSignDetector::new(sample_rate);
let n_frames = (sample_rate * 30.0) as usize;
let mut vitals = VitalSigns::default();
for frame in 0..n_frames {
let t = frame as f64 / sample_rate;
let amp = make_breathing_frame(0.3, t); // 18 BPM
let phase = make_static_phase();
vitals = detector.process_frame(&amp, &phase);
}
if let Some(bpm) = vitals.breathing_rate_bpm {
assert!(
bpm >= 6.0 && bpm <= 30.0,
"breathing rate {:.1} BPM must be in range [6, 30]",
bpm
);
}
}
#[test]
fn test_multiple_detectors_independent() {
// Two detectors should not interfere with each other
let sample_rate = 20.0;
let mut detector_a = VitalSignDetector::new(sample_rate);
let mut detector_b = VitalSignDetector::new(sample_rate);
let phase = make_static_phase();
// Feed different breathing rates
for frame in 0..(sample_rate * 30.0) as usize {
let t = frame as f64 / sample_rate;
let amp_a = make_breathing_frame(0.2, t); // 12 BPM
let amp_b = make_breathing_frame(0.4, t); // 24 BPM
detector_a.process_frame(&amp_a, &phase);
detector_b.process_frame(&amp_b, &phase);
}
let (rate_a, _) = detector_a.extract_breathing();
let (rate_b, _) = detector_b.extract_breathing();
if let (Some(a), Some(b)) = (rate_a, rate_b) {
// They should detect different rates
assert!(
(a - b).abs() > 2.0,
"detector A ({:.1} BPM) and B ({:.1} BPM) should detect different rates",
a,
b
);
}
}