update at 2026-10-12 13:57:59
This commit is contained in:
18
docs/实现方案.md
18
docs/实现方案.md
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。
|
> 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。
|
||||||
> 配套阅读:`docs/项目说明.md`(阶段一:项目理解 + 简化框图 + 关键参数速查)。
|
> 配套阅读:`docs/项目说明.md`(阶段一:项目理解 + 简化框图 + 关键参数速查)。
|
||||||
> **交付物以任务书(原说明文档)要求为准;任何演示性产物(如网页)仅为交流方便的附加项,不作为主线交付。**
|
> **交付物以任务书(原说明文档)要求为准;展示网站是副产品——不进入交付清单,但与主线里程碑同步增量开发,作为阶段性成果的对外展示窗口。冲突时主线优先。**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -105,10 +105,26 @@ fiber_delay_sim/
|
|||||||
├── experiments/ # 实验脚本:每个脚本产出论文/教学的一个完整记录包
|
├── experiments/ # 实验脚本:每个脚本产出论文/教学的一个完整记录包
|
||||||
├── cli.py # 命令行入口(M0–M4 的主用户界面)
|
├── cli.py # 命令行入口(M0–M4 的主用户界面)
|
||||||
├── gui.py # 简单图形界面 + 一键导出(M5,后置)
|
├── gui.py # 简单图形界面 + 一键导出(M5,后置)
|
||||||
|
├── web/ # 展示网站(副产品,与里程碑同步增量,见附录 B)
|
||||||
|
│ ├── index.html # 静态页 + Pyodide 加载器(复用同一 core/)
|
||||||
|
│ ├── js/ # ECharts 图表渲染与参数交互
|
||||||
|
│ └── cases/ # 预计算记录包 JSON(重计算场景的展示数据)
|
||||||
├── export/ # 记录包导出(JSON + CSV + SVG/PNG)
|
├── export/ # 记录包导出(JSON + CSV + SVG/PNG)
|
||||||
└── tests/ # 单元测试 + 基准测试 + 复现性测试
|
└── tests/ # 单元测试 + 基准测试 + 复现性测试
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**core 层运行环境约束(为网站同步复用而设,M0 起生效)**:
|
||||||
|
|
||||||
|
- 仅依赖 numpy / scipy(Pyodide 可加载的子集),**不依赖**文件 IO、matplotlib 及其他本机库;
|
||||||
|
- 函数输入输出均为纯数据(dict / list / ndarray),绘图与落盘一律放在外层(本地:CLI + matplotlib;浏览器:Pyodide + ECharts);
|
||||||
|
- 由此同一核心既能本地跑论文实验,也能在浏览器跑教学演示——网站每个里程碑只需增加薄壳页面,不重写算法。
|
||||||
|
|
||||||
|
**core 层运行环境约束(为网站同步复用而设,M0 起生效)**:
|
||||||
|
|
||||||
|
- 仅依赖 numpy / scipy(Pyodide 可加载的子集),**不依赖**文件 IO、matplotlib 及其他本机库;
|
||||||
|
- 函数输入输出均为纯数据(dict / list / ndarray),绘图与落盘一律放在外层(本地:CLI + matplotlib;浏览器:Pyodide + ECharts);
|
||||||
|
- 由此同一核心既能本地跑论文实验,也能在浏览器跑教学演示——网站每个里程碑只需增加薄壳页面,不重写算法。
|
||||||
|
|
||||||
### 5.2 数据流(任务书"软件总体流程")
|
### 5.2 数据流(任务书"软件总体流程")
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user