Repository navigation
Releases
v1.1.0
1.1.0 新增两项测角评估功能:噪声下的测角精度,以及频段评估中把 DBF 字典固定在设计频率。可以直接从 1.0.x 升级,旧的项目、草稿和分享链接都能打开,原有评估结果不变。
新功能
噪声下测角精度(测角性能 → 加噪声)
原来的测角误差是无噪声条件下的系统偏差:字典和通道都理想时,任何布局的误差都是 0,没法用来比较布局好坏。新增的「加噪声(蒙特卡洛)」模式按单通道 SNR(视轴目标、距离-多普勒 FFT 之后、单快拍)在每个视场角度做 200 次蒙特卡洛,给出:
- RMSE 与克拉美-罗界(CRB):理想字典下蒙特卡洛结果贴近 CRB,口径越大、CRB 越小。
- 异常值概率随 SNR 的变化:峰值跳出主瓣(跳到旁瓣或栅瓣)的概率,SNR 从 −20 到 40 dB 扫描。
- 门限 SNR:视场内所有角度异常值都不超过 1% 所需的最低 SNR。旁瓣高、竞争峰裕量小的布局门限更高。
导入的单元方向图会降低偏轴目标的 SNR;导入的通道幅相和自定义字典也会体现在结果中。无噪声模式加了说明,避免把"误差恒为 0"误读为布局没有差别。
频段评估:DBF 字典频率
「频段与对比」新增「DBF 字典频率」开关:
- 跟随工作频率(默认,与 1.0 相同):固件按实际中心频率生成导向矢量。
- 固定在设计频率:整个频段只用一套导向表。偏离设计频率时 sinθ 的估计按 f/f₀ 缩放,例如字典 77 GHz、工作在 81 GHz 时,15° 的目标会测成 15.8°。
其他
- 新增接口
POST /api/noise;项目文件新增band.dictionary_frequency和noise.snr_db两个字段,都有默认值。 - 应用内帮助、README 和三语界面文案同步更新。
升级
- Docker:
git pull && docker compose up -d --build(需要重建镜像)。 - wheel:
pip install下方附件的 wheel 地址,然后重启服务。 - 源码 / systemd:
git pull,再运行scripts/setup_server.sh,然后重启服务。
验证
- CI(Python 测试 + ruff、ESLint + 前端单元测试 + 构建、Playwright 端到端测试)全部通过。
- 后端 246 个测试,前端 230 个单元测试,5 个浏览器端到端用例。新增测试固定了蒙特卡洛结果与 CRB 的一致性(理想字典下比值 0.8–1.25)以及固定字典时 sinθ 的缩放关系。
- 本 wheel 由 GitHub Actions 从标签对应的提交构建,并在全新虚拟环境中安装,启动后检查健康接口和网页。
wheel SHA-256:84d6d03115ecc4e70669d4194f6ee47344aa3481a7e8c6cce07eebe91656a6dd
v1.0.1
1.0.1 是稳定性修复版本,修复了长时间运行(soak)测试中发现的两个问题。接口和数据格式没有变化,可以直接从 1.0.0 升级,项目库、分享链接和导入文件都保留。
修复
- 内存占用:多人并发评估时,glibc 会为每个计算线程保留一块内存,而且空闲后不归还,常驻内存会涨到 2–3 GB。现在 Linux 下
mimo-array-server启动时会自动设置MALLOC_ARENA_MAX=2(如果环境里已经设置,就沿用已有的值),Docker 镜像和 systemd 示例中也写明了这个设置。同样 1200 次混合请求,常驻内存从 2159 MB 降到 466 MB,耗时不变。 - 导出文件占满磁盘:以前导出的报告和图片要 24 小时后才清理,导出频繁时
jobs/目录约每小时增长 100 MB。现在除了 24 小时期限,还限定最多保留最近 100 个、合计不超过 1 GB,超出时先删除最旧的,启动时也会清理上次运行留下的文件。 - 导出排队:同时排队或执行中的导出最多 8 个,再提交会返回 429,界面提示“服务器正在处理其他导出任务,请稍后再试”,不再无限排队。
升级
- Docker:
git pull && docker compose up -d --build(需要重建镜像)。 - wheel:
pip install下方附件的 wheel 地址,然后重启服务。 - 源码 / systemd:
git pull,再运行scripts/setup_server.sh,然后重启服务。如果想在 service 文件里明确写出内存设置,请重新复制deploy/mimo-array.service。
验证
- CI(Python 测试 + ruff、ESLint + 前端单元测试 + 构建、Playwright 端到端测试)全部通过。
- 后端 236 个测试,前端 221 个单元测试,5 个浏览器端到端用例。
- 本 wheel 由 GitHub Actions 从标签对应的提交构建,并在全新虚拟环境中安装,启动后检查健康接口和网页。
wheel SHA-256:776a340f3747833201481993c03587fe10d036e0ceb014905a496fb8aa6f84c7
v1.0.0
MIMO Array Visualizer 的第一个 Web 正式版:面向 60 / 77 / 92 GHz 毫米波 FMCW 雷达的 MIMO 天线阵列性能工作台。部署在局域网服务器上,用浏览器访问,取代此前的 PySide6 桌面版(v0.2.0)。
主要功能
阵列布局:拖拽 + 网格吸附的 Tx/Rx 编辑器,撤销/重做,标准 MIMO 自动排阵(λ/2 虚拟 ULA),λ / mm 坐标表,虚拟阵列实时预览。
视场内测角评估:1D DBF 角谱播放、2D 方位 × 俯仰热图、逐帧测角误差(峰值细化到 0.002°)、竞争峰裕量、不模糊范围与截断原因。
雷达级检查:60G / 77G / 92G 频段预设与扫频范围、扫频起止的频段内性能、实测 3 dB 分辨率、第一零点 PSL、规格逐项判定、多方案对比、阵元重叠检查。
实测数据:HFSS 通道幅相、单元方向图、自定义 / 校准 DBF 字典(范围外不外推,覆盖不足时提示)。
协作:服务器项目库(多人同时修改同一项目时提示冲突,不会静默覆盖)、分享链接 http://服务器:8000/s/、兼容桌面版的阵面 JSON、.mimo.zip 项目包、带 CSV/JSON 数据包的 PDF 报告、REST API(/api/docs)。
中文 / English / 日本語,浅色 / 深色主题,支持手机宽度。
部署
docker compose up -d --build # 推荐
或裸机:scripts/setup_server.sh,然后
.venv/bin/mimo-array-server --host 0.0.0.0 --port 8000 --data-dir ./data
也可以直接安装下方附件中的 wheel(已内置构建好的前端,不需要 Node.js):
pip install mimo_array_visualizer-1.0.0-py3-none-any.whl
mimo-array-server --host 0.0.0.0 --port 8000 --data-dir ./data
需要 Python 3.10+。中文 / 日文 PDF 报告需要系统安装 CJK 字体(如 fonts-noto-cjk),Docker 镜像已内置。
wheel SHA-256:f10e6f25322f8f980195b2fa2606ec200daa6354e7063be334353198e841dada
安全与稳定性
经过四轮外部测试并全部修复:上传文件和项目包按大小、行数、列数和解压量设上限(zip / XLSX 解压炸弹在 0.3 s 内被拒绝,内存不增长);损坏的文件返回 4xx;请求体有大小上限;磁盘满或数据目录只读时返回明确提示,不留残缺文件;项目库的保存与删除在并发下保持一致;坐标和数字输入严格校验。
发布验证
CI(Python 测试 + ruff、ESLint + 前端单元测试 + 构建、Playwright e2e)全部通过
后端 229 个测试在 Python 3.10 / 3.12 / 3.13 下通过;前端 220 个单元测试;5 个浏览器端到端用例
wheel 在全新虚拟环境中安装(Python 3.10 与 3.13,最新依赖)后端到端测试通过
全新克隆执行 scripts/setup_server.sh 后启动,健康检查、界面、评估、中文 PDF 报告正常
npm audit / pip-audit:0 个已知漏洞
已知限制
没有内置登录鉴权,适合在可信局域网使用;需要更大范围访问时请在前面加带认证的反向代理。
自动化端到端测试只覆盖 Chromium;Firefox / WebKit 由人工测试验证,未在真实手机上测试。
未做数小时级的长时间稳定性测试。
本次发布验证的环境无法访问 Debian 软件源,Docker 镜像中安装 CJK 字体这一步沿用上一轮测试的验证结果(该步骤此后未改动)。建议在目标服务器上执行一次 docker compose up -d --build 作为部署验收。