RuView RF Topological Sensing 研究索引解读:把房间建模为动态信号图,用最小割检测射频拓扑边界
【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView
导读
RF Topological Sensing(射频拓扑感知)是 RuView 项目中一种把"房间"当作动态信号图来理解的感知范式:ESP32 节点是图的顶点,TX-RX 链路是边,边权由 CSI(信道状态信息)相干性刻画。它不做位置估计,而是通过**最小割(minimum cut)**找出射频场拓扑结构发生变化的位置,从而揭示对应物体、人体与环境变化的物理边界。本文以仓库中的研究索引 00-rf-topological-sensing-index.md 为主线,串起整套研究文档(总计 12 份、约 14,322 行)的核心结论、算法选型、硬件约束、实现阶段与仓储内已有代码佐证,帮助读者在最短时间内建立起对这套"无线电神经系统"的完整认知。
一、核心概念:为什么"检测边界"比"估计位置"更本质
索引文档开篇即给出核心概念:
RF Topological Sensing treats a room as a dynamic signal graph where ESP32 nodes are vertices and TX-RX links are edges weighted by CSI coherence. Instead of estimating position, minimum cut detects where the RF field topology changes — revealing physical boundaries corresponding to objects, people, and environmental shifts.
把房间建模为图,天然获得了三层结构:
| 结构 | 图论对应 | 物理含义 |
|---|---|---|
| 节点(vertices) | ESP32 节点 | 无线收发顶点(典型 16 节点部署) |
| 边(edges) | TX-RX 链路 | 两个节点之间的双向射频链路 |
| 边权(edge weight) | CSI 相干性 | 链路所在菲涅尔区是否被扰动 |
当一个人进入房间,他会沿着若干传播路径散射、吸收、反射射频能量。关键洞察是这种扰动在空间上是局部的:只有菲涅尔区与该人体相交的链路才会出现明显的相干性退化。受影响的链路形成一个连通子图,其边界——即连接"被扰动区"与"未被扰动区"的那组边——构成了扰动的拓扑签名(topological signature)。
由此,"最小割"成为提取这一边界的自然计算工具:边权编码相干性(高权 = 链路稳定),最小割会恰好穿过被扰动、权值塌陷的边,从而精准圈出扰动边界。
二、文档全景:12 份研究文档的分层结构
索引把整套研究文档划分为五个层次,每份文档聚焦一个可独立引用的技术点:
基础理论(文档 1–2)
- 01-rf-graph-theory-foundations.md(1,112 行):最大流/最小割定理、Stoer-Wagner 与 Karger 算法、Fiedler 向量、Cheeger 不等式、谱图理论,以及与经典 RF 感知的对比;
- 02-csi-edge-weight-computation.md(1,059 行):CSI 特征提取、相干性度量、MUSIC/ESPRIT 多径分解、边权卡尔曼滤波、噪声鲁棒性与归一化。
机器学习(文档 3–4)
- 03-attention-mechanisms-rf-sensing.md(1,110 行):面向射频图的 GAT、CSI 自注意力、交叉注意力融合、可微最小割、天线级注意力与高效注意力变体;
- 04-transformer-architectures-graph-sensing.md(896 行):Graphormer/SAN/GPS、时序图 Transformer、谱图 ViT、基于 Transformer 的最小割预测、射频基础模型与边缘部署。
算法(文档 5)
- 05-sublinear-mincut-algorithms.md(1,170 行):次线性近似、动态最小割、流式算法、Benczúr-Karger 稀疏化、局部划分、Rust 实现。
硬件与系统(文档 6、10)
- 06-esp32-mesh-hardware-constraints.md(1,122 行):ESP32 CSI 能力、16 节点拓扑、TDM 同步、计算预算、信道跳变、功耗分析与固件架构;
- 10-system-architecture-prototype.md(1,625 行):端到端流水线、crate 集成、DDD 模块设计、100ms 延迟预算、三阶段原型、基准设计、ADR-044 与 Rust trait 定义。
学习与时序(文档 7–8)
- 07-contrastive-learning-rf-coherence.md(1,226 行):面向 CSI 的 SimCLR/MoCo、AETHER-Topo 扩展、delta 驱动更新、自监督预训练、三元组边分类、MERIDIAN 迁移;
- 08-temporal-graph-evolution-ruvector.md(1,528 行):TGN/TGAT/DyRep、RuVector 图记忆、割轨迹跟踪、事件检测、压缩存储、跨房间迁移与漂移检测。
分析与量子(文档 9、11–12)
- 09-resolution-spatial-granularity.md(1,383 行):菲涅尔区分析、节点密度与分辨率、Cramér-Rao 界、割分辨率理论、多频增强与标度律;
- 11-quantum-level-sensors.md(934 行):NV 色心、里德伯原子、SQUID、量子照明、量子图算法、混合架构、量子 ML 与 NISQ 应用;
- 12-quantum-biomedical-sensing.md(1,157 行):生物磁图、神经场成像、循环感知、相干性诊断、非接触生命体征、环境健康监测与 BCI。
三、关键结论:分辨率、计算可行性与量子增强
索引文档汇总了三组可量化的关键结论,这些数据也是整套研究的核心锚点。
3.1 空间分辨率
- 16 个 ESP32 节点、间距 1 m →30–60 cm空间粒度;
- 双频段(2.4 + 5 GHz)→6 cm理论相干极限;
- 信息论极限:密集部署下8.8 cm。
3.2 计算可行性
- 16 节点图上运行 Stoer-Wagner:每轮扫描约2,000 次操作;
- 在 20 Hz 频率下,仅占一个 ESP32 核心的0.07%;
- 完整流水线 CSI → 最小割:< 100 ms延迟预算。
这一结论与仓库中的实际实现相互印证:scripts/mincut-person-counter.js正是将 Stoer-Wagner 最小割应用于子载波相关图来分离人员,README 头注释明确标注"Each group = one person's Fresnel zone perturbation",说明最小割在 RuView 中已有落地的 JS 实现(详见后文第五节)。
3.3 量子增强(远景路线)
- NV 金刚石:室温下灵敏度提升 100–1000 倍;
- 里德伯原子:自校准、可溯源至 SI 单位的射频场测量;
- D-Wave 量子退火:图割的原生 QUBO 求解器。
3.4 生物医学扩展
- 非接触式心脏监测:量子传感器在 1–3 m 距离;
- 基于相干性的诊断视角:把疾病建模为人体电磁图的拓扑变化;
- 同一套图算法(最小割、谱方法)同时适用于房间感知与医疗场景。
四、提出的 ADR 与实现阶段路线图
索引明确了该研究方向对应的两条 ADR 与五个实现阶段:
Proposed ADRs
- ADR-044:RF Topological Sensing(对应 10-system-architecture-prototype.md);
- ADR-045:Quantum Biomedical Sensing Extension(对应文档 12)。
Implementation Phases
| 阶段 | 周期 | 目标 |
|---|---|---|
| Phase 1 | 4 周 | 4 节点 POC——检测房间内是否有人 |
| Phase 2 | 8 周 | 16 节点房间——追踪运动边界,精度 < 50 cm |
| Phase 3 | 16 周 | 多房间网格——跨房间转移检测 |
| Phase 4 | 2027–2028 | 量子增强——NV 金刚石 + ESP32 混合 |
| Phase 5 | 2029+ | 生物医学——相干性诊断、环境健康监测 |
五、仓库实证:最小割感知在 RuView 中的落地形态
研究索引本身是"研究纲领",而仓库代码提供了可运行的实证。最直接的对应实现是 scripts/mincut-person-counter.js,其文件头注释标明:
ADR-075: Min-Cut Person Counter — Subcarrier correlation graph partitioning。将子载波相关图用 Stoer-Wagner 最小割划分为自然独立的子载波相关组,每组对应一个人的菲涅尔区扰动。
该脚本的使用方式(可直接复制运行):
# 从 ESP32 节点经 UDP 实时读取 node scripts/mincut-person-counter.js --port 5006 # 从录制的 CSI 数据回放 node scripts/mincut-person-counter.js --replay data/recordings/pretrain-1775182186.csi.jsonl # JSON 输出,便于管道化到 seed bridge node scripts/mincut-person-counter.js --replay FILE --json # 覆盖特征向量维度并转发到 seed bridge node scripts/mincut-person-counter.js --port 5006 --forward 5007其 CLI 参数与索引中的研究结论高度对应:--corr-threshold(默认 0.3)控制边是否纳入相关图,--cut-threshold(默认 2.0)控制最小割分组阈值,--window/--interval控制滑动窗口与输出间隔,--max-persons限制最大人数。这说明研究文档 1 中"用相干性建图、用最小割找边界"的范式并非纸上谈兵,而是已进入可运行的感知工具链。
此外,docs/adr/ADR-075-mincut-person-separation.md 记录了该方案从阈值计数(issue #348 中 n_persons 恒为 4 的问题)转向图划分的决策过程,可作为理解这一演进的补充材料。
六、延伸阅读与证据边界说明
- 图论基础:需要理解最大流/最小割对偶、Stoer-Wagner 与 Karger 的算法细节、Fiedler 向量与 Cheeger 不等式在连通性监测中的应用,可读 01-rf-graph-theory-foundations.md;
- 边权计算:从 CSI 幅相特征、相位清洗、差分相位相干性(RuView coherence gate 的核心度量)到多径稳定性评分与卡尔曼滤波边权,详见 02-csi-edge-weight-computation.md;
- 系统架构:端到端五级流水线(CSI 提取 → 边权 → 图构建 → 动态最小割 → 边界可视化)、RfGraph/CutBoundary 等数据结构、TDM 协议与 Rust trait 定义,详见 10-system-architecture-prototype.md。
需要说明的证据边界:索引中涉及的量子感知(NV 色心、里德伯原子、D-Wave)与生物医学扩展属于 2027 年之后的研究路线规划,当前仓库中尚未有对应的可运行实现;Phase 1–3 的原型目标(4 节点 POC → 16 节点房间 → 多房间网格)也属于文档规划的演进路径,实际完成度应以仓库当前状态为准。图论部分引用的算法复杂度(如 Stoer-Wagner 的 O(nm + n²log n))来自标准算法文献,属于公开学术事实,可用于理解系统设计动机。
结语
RF Topological Sensing 的研究索引为 RuView 描绘了一条从"估计位置"走向"理解结构"的感知路径:以 CSI 相干性为边权的图模型把空间变成了可计算的拓扑对象,最小割与谱方法则提供了实时提取物理边界的数学工具。无论是 16 节点的房间级部署、多房间网格的跨域迁移,还是远景的量子增强,这套"把房间当作无线电神经系统"的框架都贯穿始终——而仓库中 scripts/mincut-person-counter.js 的存在,意味着这套框架已经开始从研究文档走向真实可运行的代码。
【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考