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

Skip to content

Commit aaec699

Browse files
committed
docs: move AI Backbone into collapsed section under Models & Training
- Remove RuVector AI section from Rust Crates details block - Add as own collapsed <details> in Models & Training with anchor link - Add cross-reference from crates table to new section - Link to issue ruvnet#67 for deep dive with code examples Co-Authored-By: claude-flow <[email protected]>
1 parent 72f031a commit aaec699

1 file changed

Lines changed: 36 additions & 27 deletions

File tree

README.md

Lines changed: 36 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -364,33 +364,7 @@ cargo add wifi-densepose-ruvector # RuVector v2.0.4 integration layer (ADR-017
364364
| [`wifi-densepose-config`](https://crates.io/crates/wifi-densepose-config) | Configuration management | -- | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-config.svg)](https://crates.io/crates/wifi-densepose-config) |
365365
| [`wifi-densepose-db`](https://crates.io/crates/wifi-densepose-db) | Database persistence (PostgreSQL, SQLite, Redis) | -- | [![crates.io](https://img.shields.io/crates/v/wifi-densepose-db.svg)](https://crates.io/crates/wifi-densepose-db) |
366366

367-
#### AI Backbone: [RuVector v2.0.4](https://github.com/ruvnet/ruvector)
368-
369-
Raw WiFi signals are noisy, redundant, and environment-dependent. [RuVector](https://github.com/ruvnet/ruvector) is the AI intelligence layer that transforms them into clean, structured input for the DensePose neural network. It uses **attention mechanisms** to learn which signals to trust, **graph algorithms** that automatically discover which WiFi channels are sensitive to body motion, and **compressed representations** that make edge inference possible on an $8 microcontroller.
370-
371-
```
372-
Raw WiFi CSI (56 subcarriers, noisy)
373-
|
374-
+-- ruvector-mincut ---------- Which channels carry body-motion signal? (learned graph partitioning)
375-
+-- ruvector-attn-mincut ----- Which time frames are signal vs noise? (attention-gated filtering)
376-
+-- ruvector-attention ------- How to fuse multi-antenna data? (learned weighted aggregation)
377-
|
378-
v
379-
Clean, structured signal --> DensePose Neural Network --> 17-keypoint body pose
380-
--> FFT Vital Signs -----------> breathing rate, heart rate
381-
--> ruvector-solver ------------> physics-based localization
382-
```
383-
384-
The [`wifi-densepose-ruvector`](https://crates.io/crates/wifi-densepose-ruvector) crate ([ADR-017](docs/adr/ADR-017-ruvector-signal-mat-integration.md)) connects all 7 integration points:
385-
386-
| AI Capability | What It Replaces | RuVector Crate | Result |
387-
|--------------|-----------------|----------------|--------|
388-
| **Self-optimizing channel selection** | Hand-tuned thresholds that break when rooms change | `ruvector-mincut` | Graph min-cut adapts to any environment automatically |
389-
| **Attention-based signal cleaning** | Fixed energy cutoffs that miss subtle breathing | `ruvector-attn-mincut` | Learned gating amplifies body signals, suppresses noise |
390-
| **Learned signal fusion** | Simple averaging where one bad channel corrupts all | `ruvector-attention` | Transformer-style attention downweights corrupted channels |
391-
| **Physics-informed localization** | Expensive nonlinear solvers | `ruvector-solver` | Sparse least-squares Fresnel geometry in real-time |
392-
| **O(1) survivor triangulation** | O(N^3) matrix inversion | `ruvector-solver` | Neumann series linearization for instant position updates |
393-
| **75% memory compression** | 13.4 MB breathing buffers that overflow edge devices | `ruvector-temporal-tensor` | Tiered 3-8 bit quantization fits 60s of vitals in 3.4 MB |
367+
All crates integrate with [RuVector v2.0.4](https://github.com/ruvnet/ruvector) — see [AI Backbone](#ai-backbone-ruvector) below.
394368

395369
</details>
396370

@@ -724,6 +698,41 @@ See [ADR-014](docs/adr/ADR-014-sota-signal-processing.md) for full mathematical
724698

725699
## 🧠 Models & Training
726700

701+
<details>
702+
<summary><a id="ai-backbone-ruvector"></a><strong>🤖 AI Backbone: RuVector</strong> — Attention, graph algorithms, and edge-AI compression powering the sensing pipeline</summary>
703+
704+
Raw WiFi signals are noisy, redundant, and environment-dependent. [RuVector](https://github.com/ruvnet/ruvector) is the AI intelligence layer that transforms them into clean, structured input for the DensePose neural network. It uses **attention mechanisms** to learn which signals to trust, **graph algorithms** that automatically discover which WiFi channels are sensitive to body motion, and **compressed representations** that make edge inference possible on an $8 microcontroller.
705+
706+
Without RuVector, WiFi DensePose would need hand-tuned thresholds, brute-force matrix math, and 4x more memory — making real-time edge inference impossible.
707+
708+
```
709+
Raw WiFi CSI (56 subcarriers, noisy)
710+
|
711+
+-- ruvector-mincut ---------- Which channels carry body-motion signal? (learned graph partitioning)
712+
+-- ruvector-attn-mincut ----- Which time frames are signal vs noise? (attention-gated filtering)
713+
+-- ruvector-attention ------- How to fuse multi-antenna data? (learned weighted aggregation)
714+
|
715+
v
716+
Clean, structured signal --> DensePose Neural Network --> 17-keypoint body pose
717+
--> FFT Vital Signs -----------> breathing rate, heart rate
718+
--> ruvector-solver ------------> physics-based localization
719+
```
720+
721+
The [`wifi-densepose-ruvector`](https://crates.io/crates/wifi-densepose-ruvector) crate ([ADR-017](docs/adr/ADR-017-ruvector-signal-mat-integration.md)) connects all 7 integration points:
722+
723+
| AI Capability | What It Replaces | RuVector Crate | Result |
724+
|--------------|-----------------|----------------|--------|
725+
| **Self-optimizing channel selection** | Hand-tuned thresholds that break when rooms change | `ruvector-mincut` | Graph min-cut adapts to any environment automatically |
726+
| **Attention-based signal cleaning** | Fixed energy cutoffs that miss subtle breathing | `ruvector-attn-mincut` | Learned gating amplifies body signals, suppresses noise |
727+
| **Learned signal fusion** | Simple averaging where one bad channel corrupts all | `ruvector-attention` | Transformer-style attention downweights corrupted channels |
728+
| **Physics-informed localization** | Expensive nonlinear solvers | `ruvector-solver` | Sparse least-squares Fresnel geometry in real-time |
729+
| **O(1) survivor triangulation** | O(N^3) matrix inversion | `ruvector-solver` | Neumann series linearization for instant position updates |
730+
| **75% memory compression** | 13.4 MB breathing buffers that overflow edge devices | `ruvector-temporal-tensor` | Tiered 3-8 bit quantization fits 60s of vitals in 3.4 MB |
731+
732+
See [issue #67](https://github.com/ruvnet/wifi-densepose/issues/67) for a deep dive with code examples, or [`cargo add wifi-densepose-ruvector`](https://crates.io/crates/wifi-densepose-ruvector) to use it directly.
733+
734+
</details>
735+
727736
<details>
728737
<summary><a id="rvf-model-container"></a><strong>📦 RVF Model Container</strong> — Single-file deployment with progressive loading</summary>
729738

0 commit comments

Comments
 (0)