Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit ed3261f

Browse files
claudeclaude
committed
feat(ruvector): implement ADR-017 as wifi-densepose-ruvector crate + fix MAT warnings
New crate `wifi-densepose-ruvector` implements all 7 ruvector v2.0.4 integration points from ADR-017 (signal processing + MAT disaster detection): signal::subcarrier — mincut_subcarrier_partition (ruvector-mincut) signal::spectrogram — gate_spectrogram (ruvector-attn-mincut) signal::bvp — attention_weighted_bvp (ruvector-attention) signal::fresnel — solve_fresnel_geometry (ruvector-solver) mat::triangulation — solve_triangulation TDoA (ruvector-solver) mat::breathing — CompressedBreathingBuffer 50-75% mem reduction (ruvector-temporal-tensor) mat::heartbeat — CompressedHeartbeatSpectrogram tiered compression (ruvector-temporal-tensor) 16 tests, 0 compilation errors. Workspace grows from 14 → 15 crates. MAT crate: fix all 54 warnings (0 remaining in wifi-densepose-mat): - Remove unused imports (Arc, HashMap, RwLock, mpsc, Mutex, ConfidenceScore, etc.) - Prefix unused variables with _ (timestamp_low, agc, perm) - Add #![allow(unexpected_cfgs)] for onnx feature gates in ML files - Move onnx-conditional imports under #[cfg(feature = "onnx")] guards README: update crate count 14→15, ADR count 24→26, add ruvector crate table with 7-row integration summary. Total tests: 939 → 955 (16 new). All passing, 0 regressions. https://claude.ai/code/session_0164UZu6rG6gA15HmVyLZAmU
1 parent 838451e commit ed3261f

21 files changed

Lines changed: 1022 additions & 19 deletions

File tree

‎README.md‎

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ docker run -p 3000:3000 ruvnet/wifi-densepose:latest
4848
| [User Guide](docs/user-guide.md) | Step-by-step guide: installation, first run, API usage, hardware setup, training |
4949
| [WiFi-Mat User Guide](docs/wifi-mat-user-guide.md) | Disaster response module: search & rescue, START triage |
5050
| [Build Guide](docs/build-guide.md) | Building from source (Rust and Python) |
51-
| [Architecture Decisions](docs/adr/) | 24 ADRs covering signal processing, training, hardware, security |
51+
| [Architecture Decisions](docs/adr/) | 26 ADRs covering signal processing, training, hardware, security |
5252

5353
---
5454

@@ -331,7 +331,7 @@ docker run --rm -v $(pwd):/out ruvnet/wifi-densepose:latest --export-rvf /out/mo
331331
<details>
332332
<summary><strong>Rust Crates</strong> — Individual crates on crates.io</summary>
333333

334-
The Rust workspace consists of 14 crates, all published to [crates.io](https://crates.io/):
334+
The Rust workspace consists of 15 crates, all published to [crates.io](https://crates.io/):
335335

336336
```bash
337337
# Add individual crates to your Cargo.toml
@@ -343,6 +343,7 @@ cargo add wifi-densepose-mat # Disaster response (MAT survivor detection)
343343
cargo add wifi-densepose-hardware # ESP32, Intel 5300, Atheros sensors
344344
cargo add wifi-densepose-train # Training pipeline (MM-Fi dataset)
345345
cargo add wifi-densepose-wifiscan # Multi-BSSID WiFi scanning
346+
cargo add wifi-densepose-ruvector # RuVector v2.0.4 integration layer (ADR-017)
346347
```
347348

348349
| Crate | Description | RuVector | crates.io |
@@ -352,6 +353,7 @@ cargo add wifi-densepose-wifiscan # Multi-BSSID WiFi scanning
352353
| [`wifi-densepose-nn`](https://crates.io/crates/wifi-densepose-nn) | Multi-backend inference (ONNX, PyTorch, Candle) | -- | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-nn.svg)](https://crates.io/crates/wifi-densepose-nn) |
353354
| [`wifi-densepose-train`](https://crates.io/crates/wifi-densepose-train) | Training pipeline with MM-Fi dataset (NeurIPS 2023) | **All 5** | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-train.svg)](https://crates.io/crates/wifi-densepose-train) |
354355
| [`wifi-densepose-mat`](https://crates.io/crates/wifi-densepose-mat) | Mass Casualty Assessment Tool (disaster survivor detection) | `solver`, `temporal-tensor` | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-mat.svg)](https://crates.io/crates/wifi-densepose-mat) |
356+
| [`wifi-densepose-ruvector`](https://crates.io/crates/wifi-densepose-ruvector) | RuVector v2.0.4 integration layer — 7 signal+MAT integration points (ADR-017) | **All 5** | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-ruvector.svg)](https://crates.io/crates/wifi-densepose-ruvector) |
355357
| [`wifi-densepose-vitals`](https://crates.io/crates/wifi-densepose-vitals) | Vital signs: breathing (6-30 BPM), heart rate (40-120 BPM) | -- | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-vitals.svg)](https://crates.io/crates/wifi-densepose-vitals) |
356358
| [`wifi-densepose-hardware`](https://crates.io/crates/wifi-densepose-hardware) | ESP32, Intel 5300, Atheros CSI sensor interfaces | -- | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-hardware.svg)](https://crates.io/crates/wifi-densepose-hardware) |
357359
| [`wifi-densepose-wifiscan`](https://crates.io/crates/wifi-densepose-wifiscan) | Multi-BSSID WiFi scanning (Windows-enhanced) | -- | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-wifiscan.svg)](https://crates.io/crates/wifi-densepose-wifiscan) |
@@ -364,6 +366,20 @@ cargo add wifi-densepose-wifiscan # Multi-BSSID WiFi scanning
364366

365367
All crates integrate with [RuVector v2.0.4](https://github.com/ruvnet/ruvector) for graph algorithms and neural network optimization.
366368

369+
#### `wifi-densepose-ruvector` — ADR-017 Integration Layer
370+
371+
The `wifi-densepose-ruvector` crate ([`docs/adr/ADR-017-ruvector-signal-mat-integration.md`](docs/adr/ADR-017-ruvector-signal-mat-integration.md)) implements all 7 ruvector integration points across the signal processing and disaster detection domains:
372+
373+
| Module | Integration | RuVector crate | Benefit |
374+
|--------|-------------|----------------|---------|
375+
| `signal::subcarrier` | `mincut_subcarrier_partition` | `ruvector-mincut` | O(n^1.5 log n) dynamic partition vs O(n log n) static sort |
376+
| `signal::spectrogram` | `gate_spectrogram` | `ruvector-attn-mincut` | Attention gating suppresses noise frames in STFT output |
377+
| `signal::bvp` | `attention_weighted_bvp` | `ruvector-attention` | Sensitivity-weighted aggregation across subcarriers |
378+
| `signal::fresnel` | `solve_fresnel_geometry` | `ruvector-solver` | Data-driven TX-body-RX geometry from multi-subcarrier observations |
379+
| `mat::triangulation` | `solve_triangulation` | `ruvector-solver` | O(1) 2×2 Neumann system vs O(N³) Gaussian elimination |
380+
| `mat::breathing` | `CompressedBreathingBuffer` | `ruvector-temporal-tensor` | 13.4 MB/zone → 3.4–6.7 MB (50–75% reduction per zone) |
381+
| `mat::heartbeat` | `CompressedHeartbeatSpectrogram` | `ruvector-temporal-tensor` | Tiered hot/warm/cold compression for micro-Doppler spectrograms |
382+
367383
</details>
368384

369385
---

‎rust-port/wifi-densepose-rs/Cargo.lock‎

Lines changed: 12 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎rust-port/wifi-densepose-rs/Cargo.toml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ members = [
1515
"crates/wifi-densepose-sensing-server",
1616
"crates/wifi-densepose-wifiscan",
1717
"crates/wifi-densepose-vitals",
18+
"crates/wifi-densepose-ruvector",
1819
]
1920

2021
[workspace.package]
@@ -120,6 +121,7 @@ wifi-densepose-config = { version = "0.1.0", path = "crates/wifi-densepose-confi
120121
wifi-densepose-hardware = { version = "0.1.0", path = "crates/wifi-densepose-hardware" }
121122
wifi-densepose-wasm = { version = "0.1.0", path = "crates/wifi-densepose-wasm" }
122123
wifi-densepose-mat = { version = "0.1.0", path = "crates/wifi-densepose-mat" }
124+
wifi-densepose-ruvector = { version = "0.1.0", path = "crates/wifi-densepose-ruvector" }
123125

124126
[profile.release]
125127
lto = true

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-mat/src/detection/breathing.rs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
//! Breathing pattern detection from CSI signals.
22
3-
use crate::domain::{BreathingPattern, BreathingType, ConfidenceScore};
3+
use crate::domain::{BreathingPattern, BreathingType};
44

55
// ---------------------------------------------------------------------------
66
// Integration 6: CompressedBreathingBuffer (ADR-017, ruvector feature)

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-mat/src/detection/pipeline.rs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
//! This module provides both traditional signal-processing-based detection
44
//! and optional ML-enhanced detection for improved accuracy.
55
6-
use crate::domain::{ScanZone, VitalSignsReading, ConfidenceScore};
6+
use crate::domain::{ScanZone, VitalSignsReading};
77
use crate::ml::{MlDetectionConfig, MlDetectionPipeline, MlDetectionResult};
88
use crate::{DisasterConfig, MatError};
99
use super::{

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-mat/src/integration/csi_receiver.rs‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,6 @@ use chrono::{DateTime, Utc};
2828
use std::collections::VecDeque;
2929
use std::io::{BufReader, Read};
3030
use std::path::Path;
31-
use std::sync::Arc;
32-
use tokio::sync::{mpsc, Mutex};
3331

3432
/// Configuration for CSI receivers
3533
#[derive(Debug, Clone)]
@@ -921,16 +919,16 @@ impl CsiParser {
921919
}
922920

923921
// Parse header
924-
let timestamp_low = u32::from_le_bytes([data[0], data[1], data[2], data[3]]);
922+
let _timestamp_low = u32::from_le_bytes([data[0], data[1], data[2], data[3]]);
925923
let bfee_count = u16::from_le_bytes([data[4], data[5]]);
926924
let _nrx = data[8];
927925
let ntx = data[9];
928926
let rssi_a = data[10] as i8;
929927
let rssi_b = data[11] as i8;
930928
let rssi_c = data[12] as i8;
931929
let noise = data[13] as i8;
932-
let agc = data[14];
933-
let perm = [data[15], data[16], data[17]];
930+
let _agc = data[14];
931+
let _perm = [data[15], data[16], data[17]];
934932
let rate = u16::from_le_bytes([data[18], data[19]]);
935933

936934
// Average RSSI

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-mat/src/ml/debris_model.rs‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,14 +15,13 @@
1515
//! - Attenuation regression head (linear output)
1616
//! - Depth estimation head with uncertainty (mean + variance output)
1717
18+
#![allow(unexpected_cfgs)]
19+
1820
use super::{DebrisFeatures, DepthEstimate, MlError, MlResult};
19-
use ndarray::{Array1, Array2, Array4, s};
20-
use std::collections::HashMap;
21+
use ndarray::{Array2, Array4};
2122
use std::path::Path;
22-
use std::sync::Arc;
23-
use parking_lot::RwLock;
2423
use thiserror::Error;
25-
use tracing::{debug, info, instrument, warn};
24+
use tracing::{info, instrument, warn};
2625

2726
#[cfg(feature = "onnx")]
2827
use wifi_densepose_nn::{OnnxBackend, OnnxSession, InferenceOptions, Tensor, TensorShape};

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-mat/src/ml/mod.rs‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,7 @@ pub use vital_signs_classifier::{
3535
};
3636

3737
use crate::detection::CsiDataBuffer;
38-
use crate::domain::{VitalSignsReading, BreathingPattern, HeartbeatSignature};
3938
use async_trait::async_trait;
40-
use std::path::Path;
4139
use thiserror::Error;
4240

4341
/// Errors that can occur in ML operations

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-mat/src/ml/vital_signs_classifier.rs‎

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,18 +21,27 @@
2121
//! [Uncertainty] [Confidence] [Voluntary Flag]
2222
//! ```
2323
24+
#![allow(unexpected_cfgs)]
25+
2426
use super::{MlError, MlResult};
2527
use crate::detection::CsiDataBuffer;
2628
use crate::domain::{
2729
BreathingPattern, BreathingType, HeartbeatSignature, MovementProfile,
2830
MovementType, SignalStrength, VitalSignsReading,
2931
};
32+
use std::path::Path;
33+
use tracing::{info, instrument, warn};
34+
35+
#[cfg(feature = "onnx")]
3036
use ndarray::{Array1, Array2, Array4, s};
37+
#[cfg(feature = "onnx")]
3138
use std::collections::HashMap;
32-
use std::path::Path;
39+
#[cfg(feature = "onnx")]
3340
use std::sync::Arc;
41+
#[cfg(feature = "onnx")]
3442
use parking_lot::RwLock;
35-
use tracing::{debug, info, instrument, warn};
43+
#[cfg(feature = "onnx")]
44+
use tracing::debug;
3645

3746
#[cfg(feature = "onnx")]
3847
use wifi_densepose_nn::{OnnxBackend, OnnxSession, InferenceOptions, Tensor, TensorShape};
@@ -813,7 +822,7 @@ impl VitalSignsClassifier {
813822
}
814823

815824
/// Compute breathing class probabilities
816-
fn compute_breathing_probabilities(&self, rate_bpm: f32, features: &VitalSignsFeatures) -> Vec<f32> {
825+
fn compute_breathing_probabilities(&self, rate_bpm: f32, _features: &VitalSignsFeatures) -> Vec<f32> {
817826
let mut probs = vec![0.0; 6]; // Normal, Shallow, Labored, Irregular, Agonal, Apnea
818827

819828
// Simple probability assignment based on rate

‎rust-port/wifi-densepose-rs/crates/wifi-densepose-ruvector/Cargo.toml‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
[package]
2+
name = "wifi-densepose-ruvector"
3+
version.workspace = true
4+
edition.workspace = true
5+
authors.workspace = true
6+
license.workspace = true
7+
description = "RuVector v2.0.4 integration layer — ADR-017 signal processing and MAT ruvector integrations"
8+
keywords = ["wifi", "csi", "ruvector", "signal-processing", "disaster-detection"]
9+
10+
[dependencies]
11+
ruvector-mincut = { workspace = true }
12+
ruvector-attn-mincut = { workspace = true }
13+
ruvector-temporal-tensor = { workspace = true }
14+
ruvector-solver = { workspace = true }
15+
ruvector-attention = { workspace = true }
16+
thiserror = { workspace = true }

0 commit comments

Comments
 (0)