wangsli
11a2d4a4b9
- Core: Python/C++/MATLAB tri-protocol bridge architecture - Validation: 5-type real-time field, type, dimension, completeness, and compatibility checking - UI: Premium Deep Sea theme with visual pipeline preview - Modules: Sea Trial Exclusive + Exception Hub + Algorithm Management - Tests: Full coverage with 5 automated test cases
37 行
1.5 KiB
Markdown
37 行
1.5 KiB
Markdown
# Walkthrough - Phase 2.5（可演示级 MVP）
|
||
|
||
Phase 2.5 将系统从“框架可跑”推进到“可演示、可做现场巡检”的状态，重点补齐真实算法、海试专属流程与异常聚合能力。
|
||
|
||
## 1) 真实水声算法库
|
||
实现于 `src/sample_algorithms.py`：
|
||
- `dc_removal_and_bandpass`: 去直流 + 带通滤波（含参数与短序列兜底）
|
||
- `stft_magnitude`: STFT 幅度谱
|
||
- `snr_estimation`: 简易 SNR 估计（dB）
|
||
- `quality_check`: 掉点/饱和巡检，输出 `quality_score` 等指标
|
||
|
||
对应元数据已更新至 `data/algorithms.json`（含中文描述与输入输出字段映射）。
|
||
|
||
## 2) 海试专属（⛴️ 一键质量巡检）
|
||
实现于 `main.py` 的“海试专属”页：
|
||
- 内置固定流程：去直流+带通 → 质量巡检 → SNR 估计
|
||
- 指标看板：SNR、最大幅值、质量得分
|
||
- 一键导出 `CSV` 报告
|
||
|
||
## 3) 异常中心（🚑）
|
||
实现于 `main.py` 的“异常中心”页：
|
||
- 聚合最近一次链路校验结果（字段/类型/维度/完整性/兼容性）
|
||
- 聚合最近一次执行结果（状态、错误信息、执行日志）
|
||
- 支持导出 `issue_bundle.json`
|
||
- 环境自检入口：`src/env_detect.py`
|
||
|
||
## 4) 加固项
|
||
- `src/bridges.py`: `normalize` 预处理算子增加除零与空数组保护
|
||
- `src/models.py`: 日志统一写入 UTC 时间戳
|
||
|
||
## 5) 验证
|
||
运行 `python tests/test_core.py` 覆盖：
|
||
- 基础链路集成测试
|
||
- 校验拦截（缺字段/类型/维度）
|
||
- 海试一键巡检链路（含真实算法调用）
|
||
|