418 lines
26 KiB
Markdown
418 lines
26 KiB
Markdown
# 实现方案:光纤延时等效采样综合教学实验与仿真软件
|
||
|
||
> 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。
|
||
> 配套阅读:`docs/项目说明.md`(阶段一:项目理解 + 简化框图 + 关键参数速查)。
|
||
> **交付物以任务书(原说明文档)要求为准;展示网站是副产品——不进入交付清单,但与主线里程碑同步增量开发,作为阶段性成果的对外展示窗口。冲突时主线优先。**
|
||
|
||
---
|
||
|
||
## 1. 交付物清单(以任务书为准)
|
||
|
||
| # | 交付物 | 对应本文档章节 | 状态 |
|
||
|---|---|---|---|
|
||
| 1 | 原项目理解说明 + 简化系统框图 | `docs/项目说明.md` | ✅ 已完成 |
|
||
| 2 | 完整综合教学实验方案 | §2–§3 | 本文档 |
|
||
| 3 | 可调光纤长度与算法选择功能的仿真软件 | §4–§11 | 本文档 + 后续代码 |
|
||
| 4 | 可重复生成的原始数据、结果图、统计表 | §10 实验记录包 | 软件 M0 起产出 |
|
||
| 5 | 至少一项可追溯的真实硬件模块记录 | §13 | 待实施 |
|
||
| 6 | 学生实验指导内容 | 基于 §2 扩写 | 待实施 |
|
||
| 7 | 面向《实验科学与技术》的论文初稿 | §15 映射 | 待实施 |
|
||
|
||
**最终判断标准**(任务书原文):能否清楚回答——①为什么需要光纤延时等效采样;②学生通过调节参数和比较算法能学到什么;③论文中每一项结果是否能够被重新生成和验证。
|
||
|
||
---
|
||
|
||
## 2. 教学命题与统一实验任务
|
||
|
||
### 2.1 教学命题(新核心问题)
|
||
|
||
> **在 ADC 采样率有限的条件下,能否通过改变光纤长度产生不同的采样相位,重建更密集的荧光衰减曲线,并提高荧光寿命估计的稳定性?**
|
||
|
||
### 2.2 统一实验任务
|
||
|
||
在采样周期 **10 ns** 的条件下,对约 **50 ns 量级**的荧光衰减(YAG:Ce,基准真值 τ=52.8 ns)进行测量。学生先评价直接采样的局限,再通过调整四路光纤长度设计不同采样相位,完成校准、重建、寿命拟合和误差分析。
|
||
|
||
### 2.3 实验六步流程(学生操作主线)
|
||
|
||
| 步骤 | 学生完成的任务 | 教学价值 | 软件支撑 |
|
||
|---|---|---|---|
|
||
| 1 直接测量 | 单通道 10ns 采样数据拟合荧光寿命 | 认识采样点数量、噪声与拟合稳定性的关系 | 单通道仿真 + 拟合 |
|
||
| 2 延时设计 | 改变各通道光纤长度,计算传播延时与等效相位 | 把光纤传播与 ADC 采样相位联系起来 | 光纤设计模块 |
|
||
| 3 通道校准 | 处理基线偏移、通道增益差异、延时误差 | 理解真实多通道测量为什么必须校准 | 误差注入 + 校准算法 |
|
||
| 4 波形重建 | 不同相位的采样点归位并合并到统一时间轴 | 理解等效时间采样的条件和实现过程 | 时间重建模块 |
|
||
| 5 算法比较 | 比较不同预处理、重建和寿命拟合算法 | 认识算法选择会改变结果偏差和稳定性 | 算法切换框架 |
|
||
| 6 可信度评价 | 重复仿真、参数扫描、不确定度分析 | 从"得到一个数值"提升到"判断数值是否可信" | 统计分析模块 |
|
||
|
||
### 2.4 实验完成后的学习成果(验收依据)
|
||
|
||
- 解释**采样间隔、等效采样间隔、模拟带宽、时间分辨能力**四个概念的区别;
|
||
- 根据光纤长度和群折射率计算传播延时,并换算为采样相位(δ = L·n_g/c,n_g=1.468,1m≈4.90ns);
|
||
- 根据目标等效采样网格**反向设计**光纤长度;
|
||
- 完成多通道基线、增益、延时校准;
|
||
- 使用不同算法重建衰减曲线并拟合荧光寿命;
|
||
- 通过误差统计判断方案的有效范围和失效条件。
|
||
|
||
---
|
||
|
||
## 3. 实验设计要点
|
||
|
||
### 3.1 三组核心对比(论文与软件的主线,必须做透)
|
||
|
||
| 对比 | 复现的原项目结果 | 教学结论 |
|
||
|---|---|---|
|
||
| **单通道直接采样 vs 四相位等效采样** | 5 点/窗口 0.76τ → 拟合 56.66ns;41 点 → 53.18ns(真值 52.8);蒙特卡洛 σ:7.65% → 0.60% | 采样点密度决定信息量,等效采样用光学手段换电子学带宽 |
|
||
| **名义延时重建 vs 校准延时重建** | 延时标定残差 0.01ns 在错误模型下→0.019% 偏差;自由 t_k 下→0 | 真实多通道系统必须校准;校准前后重建曲线连续性差异 |
|
||
| **对数线性拟合 vs 非线性最小二乘** | 标准数据反演基准:NLS 偏差为零(PPT p22) | 对数变换放大低信噪比尾部噪声权重;NLS 在双指数+基线下更稳 |
|
||
|
||
稳健拟合(Huber/Soft-L1)与复杂滤波作为**扩展功能**,不挤占主线。
|
||
|
||
### 3.2 基准真值预设(软件内置,论文需区分表述)
|
||
|
||
| 预设 | 模型 | 用途 |
|
||
|---|---|---|
|
||
| A 仿真基准 | I(t) = 0.16·e^(−t/0.60) + 0.84·e^(−t/52.80) | 复现报告 5.4.4 蒙特卡洛(τ₁=0.60ns 为**仿真设定值**) |
|
||
| B 实测参考 | τ₁=5.0 ns,τ₂=52.5 ns | 对应附图 A1 实测截图标注,用于虚实结合叙述 |
|
||
| C 单指数教学 | I(t) = e^(−t/52.8) | 最小程序与入门教学(对数线性适用) |
|
||
|
||
> 注意(见项目说明 §6):原项目材料中 τ₁(0.6 vs 5.0)、τ₂(52.5 vs 52.8)存在不一致。软件以预设 A 为默认仿真基准,论文中明确区分"仿真设定值"与"实测拟合值"。
|
||
|
||
---
|
||
|
||
## 4. 软件定位与设计原则
|
||
|
||
1. **软件是教学实验的主要实施平台**,不是数据生成器——学生主动修改物理参数、观察数据变化、选择处理算法、比较结果,看到"参数改变 → 测量过程改变 → 结果可信度改变"的完整因果链。
|
||
2. **计算正确、结果可重复、参数含义清楚 > 界面美观**(任务书原文)。前五个里程碑未完成前,不制作复杂界面。
|
||
3. **一次运行 = 一个可复现实验记录包**:参数、随机种子、原始数据、算法版本、运行日期全部落盘(诚信红线内建)。
|
||
4. 所有输出默认标注数据来源为**软件仿真**;等效采样网格措辞固定为"等效时间细分"(不得表述为整机时间分辨率)。
|
||
|
||
---
|
||
|
||
## 5. 软件总体架构
|
||
|
||
### 5.1 分层设计(核心与界面解耦)
|
||
|
||
```
|
||
fiber_delay_sim/
|
||
├── core/ # 算法核心层:纯 Python,无界面依赖,可独立测试与复用
|
||
│ ├── signal.py # 荧光信号生成(单/双指数 + 基线 B0+B1·t)
|
||
│ ├── fiber.py # 光纤延时与相位(正向计算 / 反向设计 / 均匀性指标)
|
||
│ ├── acquisition.py # 测量链仿真:前端展宽/增益/基线/噪声/饱和/ADC量化/时钟抖动/多通道采样
|
||
│ ├── calibration.py # 通道校准:基线扣除 / 增益归一化 / 延时校准
|
||
│ ├── reconstruction.py # 时间重建:名义/校准延时交织、线性插值显示
|
||
│ ├── fitting.py # 寿命拟合:对数线性 / 非线性最小二乘 / 稳健(扩展)
|
||
│ └── statistics.py # 蒙特卡洛 / 参数扫描 / 置信区间 / 失败率
|
||
├── pipeline.py # 流程编排:参数→生成→采样→校准→重建→拟合→统计
|
||
├── experiments/ # 实验脚本:每个脚本产出论文/教学的一个完整记录包
|
||
├── cli.py # 命令行入口(M0–M4 的主用户界面)
|
||
├── gui.py # 简单图形界面 + 一键导出(M5,后置)
|
||
├── web/ # 展示网站(副产品,与里程碑同步增量,见附录 B)
|
||
│ ├── index.html # 静态页 + Pyodide 加载器(复用同一 core/)
|
||
│ ├── js/ # ECharts 图表渲染与参数交互
|
||
│ └── cases/ # 预计算记录包 JSON(重计算场景的展示数据)
|
||
├── export/ # 记录包导出(JSON + CSV + SVG/PNG)
|
||
└── 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.3 技术选型
|
||
|
||
| 项 | 选择 | 理由 |
|
||
|---|---|---|
|
||
| 语言/环境 | Python 3.10+ | 科研数据处理事实标准;与论文图表工具链一致 |
|
||
| 数值计算 | numpy | 信号生成、采样、重建 |
|
||
| 拟合 | scipy.optimize.least_squares / curve_fit | NLS 与稳健损失(huber / soft_l1)原生支持 |
|
||
| 统计 | numpy + scipy.stats | 蒙特卡洛、置信区间;bootstrap 按需 |
|
||
| 绘图 | matplotlib | 论文图表直接产出(SVG+PNG) |
|
||
| 随机数 | numpy.random.default_rng(seed) | 种子固定 → 逐位可复现 |
|
||
| 界面 | CLI 先行;M5 再做简单 GUI | 遵守"先算对,再好看",GUI 不阻塞算法开发 |
|
||
| 展示网站(副产品) | 静态站 + Pyodide 复用 core/ + ECharts,随里程碑同步增量(见附录 B) | 同步展示成果;core 保持浏览器可运行,网站零算法重写 |
|
||
|
||
---
|
||
|
||
## 6. 可调参数规格(六类)
|
||
|
||
> 表中"默认值"即原项目名义参数(来源见 `docs/项目说明.md` §5)。
|
||
|
||
| 参数类别 | 参数 | 默认值 | 建议范围 | 学生应观察 |
|
||
|---|---|---|---|---|
|
||
| **荧光信号** | 寿命 τ(单指数) | 52.8 ns | 1–200 ns | 曲线衰减速度 |
|
||
| | 双指数 (A₁,τ₁,A₂,τ₂) | 0.16, 0.60ns / 0.84, 52.80ns | — | 拟合难度、模型失配 |
|
||
| | 背景基线 B₀(+线性项 B₁) | 0 | 0–10% | 基线处理必要性 |
|
||
| | 激发重复性(幅度抖动) | 0 | 0–5% | 通道间/重复间波动 |
|
||
| **光纤通道** | 通道数量 | 4 | 1–8 | 相位数 = 通道数 |
|
||
| | 每路光纤长度 | 0 / 9.70 / 19.40 / 29.10 m | 0–50 m | 传播延时、等效相位 |
|
||
| | 群折射率 n_g | 1.468 | 1.44–1.50 | 延时换算 |
|
||
| | 通道损耗(相对增益) | 1.0 | 0.5–1.5 | 幅度差异 |
|
||
| | 长度制造误差 | 0 | ±0.1 m | 相位漂移 |
|
||
| **采集系统** | ADC 采样间隔 Δt | 10 ns | 2–20 ns | 有效采样点数 |
|
||
| | 量化位数 | 12 bit | 8–16 bit | 量化误差 |
|
||
| | 记录窗口 | 400 ns | 50–1000 ns | Fisher 结论:窗口越长精度越高 |
|
||
| | 触发位置 | 0 | — | 时间轴偏移 |
|
||
| | 时钟抖动 | 0 | 0–1 ns | 时基不确定度 |
|
||
| **模拟前端** | 带宽(高斯响应 σ) | 0(可设 1.373 ns) | 0–5 ns | 波形展宽 |
|
||
| | 增益 / 饱和上限 | 1.0 / 不饱和 | — | 截幅失真 |
|
||
| | 基线偏移 | 0 | ±5% | 预处理必要性 |
|
||
| | 噪声(σ 或 SNR) | SNR 50 dB | — | 信噪比与拟合稳定性 |
|
||
| **校准误差** | 增益校准残差 | 0 | ±10% | 重建曲线不连续 |
|
||
| | 延时校准残差 | 0 | ±0.1 ns | 时间归位偏差 |
|
||
| | 基线估计误差 | 0 | ±2% | 寿命估计偏差 |
|
||
| **统计设置** | 蒙特卡洛重复次数 | 200 | 1–1000 | 分布收敛性 |
|
||
| | 随机种子 | 固定(记录包保存) | — | 结果可复现 |
|
||
| | 参数扫描范围 | 按实验定义 | — | 趋势曲线与失效范围 |
|
||
|
||
---
|
||
|
||
## 7. 核心功能模块设计
|
||
|
||
### 7.1 光纤长度设计模块(独立教学环节,任务书重点)
|
||
|
||
**正向计算**:输入各路长度 L_k 与 n_g →
|
||
```
|
||
δk = Lk · ng / c (1m ≈ 4.90 ns)
|
||
φk = δk mod Δt (对采样周期取余相位)
|
||
```
|
||
按时间先后排序 → 等效采样网格(理想为等间距 Δt/N)。
|
||
|
||
**反向设计**:学生设定目标相位(如 0、2.5、5.0、7.5 ns)与片段定位间隔 S(默认 50ns)→ 解同余方程 `δk ≡ φk (mod Δt)`,取满足片段分离条件的最小解 →
|
||
```
|
||
Lk = δk · c / ng (多解 δk + m·Δt 全部列出,标注推荐值)
|
||
```
|
||
|
||
**输出**:光纤长度表、传播延时表、**相位圆图**(一个采样周期内的相位位置)、排序后的等效采样网格、**相位均匀性指标**(相邻相位间隔的最大偏差 / 标准差)。
|
||
|
||
**默认数据**:一键载入名义四组(0/9.70/19.40/29.10 m → 相位 0/2.5/5.0/7.5 ns);学生可任意修改,并可对比"名义长度 → 加制造误差后 → 校准后实际长度"三态。
|
||
|
||
### 7.2 信号生成与测量链仿真
|
||
|
||
```
|
||
I(t) = A₁·e^(−t/τ₁) + A₂·e^(−t/τ₂) + B₀ + B₁·t (τ₁→∞ 退化为单指数)
|
||
```
|
||
|
||
仿真链按物理顺序逐级作用(每级可开关、可调参):
|
||
|
||
1. **前端带宽**:与高斯冲激响应卷积(σ 可调,默认对应系统响应 1.373 ns 时模拟展宽);
|
||
2. **通道增益与损耗**:各路独立乘性系数;
|
||
3. **基线**:各路独立加性偏移(B₀ 或 B₀+B₁·t,模拟交流耦合下垂);
|
||
4. **饱和**:超出上限截幅;
|
||
5. **噪声**:各通道独立高斯白噪声(σ 由 SNR 定义);扩展项:1/f、散粒噪声;
|
||
6. **多通道采样**:t_sample = t_trigger + δk + jitter_k,各通道按 Δt 间隔采样;
|
||
7. **ADC 量化**:按位数均匀量化。
|
||
|
||
### 7.3 通道误差注入与校准
|
||
|
||
**误差注入**(对应可调参数"校准误差"):增益失配、延时残差、基线偏移——灵敏度参考原项目数据:通道失配 14% 在错误模型下→7.2% 偏差;延时残差 0.01ns→0.019%。
|
||
|
||
**校准三步**(学生可选方法与顺序):
|
||
1. 基线扣除:无信号尾段均值扣除,或尾段线性拟合扣除 B₀+B₁·t;
|
||
2. 增益归一化:各通道峰值(或全段比例)归一到参考通道;
|
||
3. 延时校准:上升沿互相关对齐 / 已知标定延时表查找。
|
||
|
||
### 7.4 时间重建
|
||
|
||
- 按**名义延时**直接交织 vs 按**校准延时**交织(核心对比②);
|
||
- 时间归位 u = t − δk → 四相位合并 → 排序成统一时间轴;
|
||
- 线性插值**仅用于显示**(教学讨论点:插值是否真正增加信息量?——不增加,信息来自真实采样相位);
|
||
- 定量指标:重建曲线**不连续度**(相邻点跳变统计),用于校准前后对比。
|
||
|
||
### 7.5 寿命拟合
|
||
|
||
| 算法 | 模型 | 特点 / 教学点 |
|
||
|---|---|---|
|
||
| 对数线性 | ln(I−B) = lnA − t/τ | 单指数适用;需先扣基线;**对数变换使噪声权重失真**(低信噪比尾部被放大),低 SNR 下产生系统性偏差 |
|
||
| 非线性最小二乘(NLS) | 全参数 (A₁,τ₁,A₂,τ₂,B₀,B₁) 直接拟合 | 基准算法;理想无噪数据应零偏差复现真值(对应原项目"标准拟合"验证) |
|
||
| 稳健拟合(扩展) | least_squares(loss='huber'/'soft_l1') | 异常点场景演示,不进论文主线 |
|
||
|
||
初值策略:τ₂ 由对数斜率粗估,A 由峰值估计——保证拟合收敛的可复现性。
|
||
|
||
### 7.6 统计分析(可信度评价)
|
||
|
||
1. **蒙特卡洛重复**:默认 200 次(不同种子)→ τ̂ 分布 → 均值、标准差、相对标准差;单通道 vs 四通道对比(复现 7.65% → 0.60% 的量级改善);
|
||
2. **参数扫描**:长度误差 / 噪声 / 带宽 / 增益校准误差 / 记录窗口 → τ̂ 偏差趋势曲线与误差热图,给出方法适用范围与失效条件;
|
||
3. **置信区间**:正态近似(±1.96σ)为主,bootstrap 为扩展;
|
||
4. **失败率**:定义 |τ̂−τ|/τ > 阈值(默认 5%)为失败,统计各扫描点的失败率。
|
||
|
||
---
|
||
|
||
## 8. 三组核心算法比较的实施方案
|
||
|
||
| # | 比较 | 固定条件 | 观测指标 | 预期现象(复现原项目量级) |
|
||
|---|---|---|---|---|
|
||
| ① | 单通道直接采样 vs 四相位等效采样 | 同一真值、同一噪声水平、同一窗口 | 有效采样点数、单次 τ̂ 偏差、蒙特卡洛 σ(τ̂)、失败率 | 点数×4;σ 从 ~7.65% 降至 ~0.60% 量级 |
|
||
| ② | 名义延时 vs 校准延时重建 | 注入增益失配与延时残差 | 重建曲线不连续度、τ̂ 偏差 | 校准前曲线断层、τ̂ 偏移;校准后消除 |
|
||
| ③ | 对数线性 vs NLS | 低/中/高三档 SNR,双指数+基线 | τ̂ 偏差与散布、残差结构 | 低 SNR 时对数法显著偏差,NLS 稳定 |
|
||
|
||
> 数值允许与原项目不完全相同(噪声模型细节不同),但**改善趋势与量级必须一致**,论文中说明仿真条件差异。
|
||
|
||
---
|
||
|
||
## 9. 界面与操作顺序(六页面,全部后置到 M5)
|
||
|
||
| 页面 | 主要操作 | 主要输出 |
|
||
|---|---|---|
|
||
| 参数与方案 | 设置荧光 / ADC / 光纤 / 前端参数 | 参数表、延时表、相位圆图 |
|
||
| 原始采样 | 生成理想波形,模拟单/多通道采样 | 连续曲线、原始采样点、各通道数据 |
|
||
| 校准与重建 | 选择校准方法与重建算法 | 校准前后曲线、统一时间轴重建结果 |
|
||
| 拟合与比较 | 选择拟合算法,比较不同采样方案 | 寿命估计、拟合残差、误差、置信区间 |
|
||
| 参数扫描 | 扫描长度/噪声/带宽/校准误差 | 趋势曲线、误差热图、算法失效范围 |
|
||
| 结果导出 | 保存参数/数据/图表/运行信息 | 可复现实验记录包 |
|
||
|
||
M0–M4 期间以 CLI + `experiments/` 脚本为操作界面(参数文件 → 命令行运行 → 记录包落盘),这本身就是任务书要求的开发顺序。
|
||
|
||
---
|
||
|
||
## 10. 实验记录包与可复现性设计
|
||
|
||
每次运行(CLI/GUI/批量脚本)导出一个记录包:
|
||
|
||
```
|
||
runs/YYYYMMDD-HHMMSS-<实验名>-<seed>/
|
||
├── meta.json # 运行日期时间、git commit、算法版本、全部参数、随机种子
|
||
├── data/ # 各通道原始采样点(CSV)、校准系数、重建网格点
|
||
├── results.json # τ̂ 及不确定度、残差统计、失败率、对比表
|
||
├── figures/ # SVG + PNG 图表
|
||
└── README.md # 一句话说明本次运行回答什么问题;数据来源标注:software-simulated
|
||
```
|
||
|
||
- `meta.json` 含 `data_origin: "software-simulated"` 字段——诚信红线自动落实;
|
||
- 论文中每张图/表在图注中标注对应记录包路径,保证"可重新生成和验证"。
|
||
|
||
---
|
||
|
||
## 11. 开发里程碑与验收标准
|
||
|
||
> 顺序与验收严格对应任务书"软件开发顺序"与"执行顺序和阶段验收"两节;**每个里程碑的产物 = 可运行代码 + 实验记录包 + 图表**。
|
||
|
||
| 里程碑 | 内容 | 验收标准 | 论文素材 |
|
||
|---|---|---|---|
|
||
| **M0 最小程序** | 单指数信号生成 + 10ns 直接采样 + 加噪声 + NLS 寿命拟合 | **理想无噪条件恢复设定寿命**(相对偏差 <10⁻⁶);加噪后多次运行分布合理 | 第一张拟合图;算法基准(对应原项目"偏差为零"验证) |
|
||
| **M1 光纤设计** | 可调光纤长度 + 延时/相位自动计算 + 四路采样点显示 | 名义四组得到 0/2.5/5.0/7.5ns 均匀相位;反向设计结果闭环正确(正向复算还原目标相位) | 长度/延时/相位表、相位圆图 |
|
||
| **M2 误差与校准** | 四通道基线/增益/延时误差注入 + 校准算法 + 时间重建 | 校准前后重建曲线与 τ̂ 偏差对比符合 §8-② 预期;误差注入-消除因果正确 | 校准前后对比图 |
|
||
| **M3 算法切换** | 对数线性 vs NLS 在相同数据上比较 | 三档 SNR 下两算法差异可稳定复现(§8-③) | 算法比较表与残差图 |
|
||
| **M4 统计分析** | 蒙特卡洛 + 参数扫描 + 置信区间 + 失败率 | 单通道 vs 四通道复现精度提升量级(§8-①);同种子逐位复现 | 蒙特卡洛分布图、扫描热图 |
|
||
| **M5 界面与导出** | 简单 GUI + 一键导出 | 论文全部图表可由程序重新生成;一次点击产出完整记录包 | 软件截图 |
|
||
|
||
**完成 M0 后立即执行任务书"开始工作时先做什么"的检查**:四项前置工作(理解说明/框图、实验流程、最小程序、光纤长度表)全部具备后,再继续 M2 以后工作。
|
||
|
||
### 11.1 网站同步增量计划(副产品,随里程碑上线)
|
||
|
||
> 网站与主线并行开发、每个里程碑后同步部署一次;工作量控制在"薄壳页面 + 部署",若与主线冲突,主线优先。
|
||
|
||
| 里程碑 | 网站同步增量 | 页面内容 |
|
||
|---|---|---|
|
||
| M0 | **网站骨架上线** | 项目简介(摘自 `项目说明.md`)+ 最小交互 demo:调节寿命/噪声,实时看 10ns 直接采样与拟合 |
|
||
| M1 | 光纤设计器页 | 长度→延时→相位计算器、反向设计、相位圆图(复现原项目名义四组) |
|
||
| M2 | 校准与重建页 | 误差注入开关;校准前后重建曲线对比 |
|
||
| M3 | 算法比较页 | 同一数据切换对数线性 / NLS,拟合与残差对比 |
|
||
| M4 | 统计结果页 | 蒙特卡洛分布与扫描热图:默认加载预计算记录包 JSON,提供小规模(如 20 次)交互重算体验 |
|
||
| M5 | 六页教学界面完整化 | 对应任务书六页面 + 一键导出 |
|
||
|
||
**内容纪律**:网站展示的每个案例必须对应一个实验记录包(`meta.json` 可追溯);页面显著标注"仿真演示,非实测数据";不出现任何整机性能表述。
|
||
|
||
---
|
||
|
||
## 12. 测试与验证策略
|
||
|
||
| 层级 | 内容 | 断言示例 |
|
||
|---|---|---|
|
||
| 单元测试 | fiber.py 相位计算 | 名义四组延时 0/47.5/95/142.5ns → 余数 0/7.5/5.0/2.5 → 排序 0/2.5/5.0/7.5;1m ≈ 4.90ns |
|
||
| 基准测试 | 无噪理想数据拟合 | NLS 恢复真值,相对偏差 ≈ 0(数值容差内) |
|
||
| 复现性测试 | 固定种子 | 两次运行输出哈希一致 |
|
||
| 灵敏度测试 | 误差注入响应 | 强制等幅 → τ̂ 偏差增大;自由 A_k → 偏差归零(对应原项目误差机制表量级) |
|
||
| 回归测试 | 论文图表脚本 | `experiments/` 全部重跑成功,图表与已发布版本一致 |
|
||
|
||
---
|
||
|
||
## 13. 硬件补充工作(模块级,不追求整机)
|
||
|
||
按任务书第五节,**至少完成一项**并保存仪器、参数、原始数据和照片:
|
||
|
||
| 可选项 | 产出 | 软件用途 |
|
||
|---|---|---|
|
||
| TIA 测试 | 增益、本底噪声、带宽 | 作为模拟前端默认参数 |
|
||
| 光纤 + 功率计 | 各通道插入损耗 | 作为通道增益系数 |
|
||
| FPGA 工程 | 用软件生成的 ADC 码流验证数据接收、阈值检测、缓存逻辑 | 逻辑仿真的真实激励 |
|
||
| 仅装置存档 | 实物照片 + 器件信息 | 论文"虚实结合"叙述(**不得宣称整机性能已验证**) |
|
||
|
||
未完成的功能在论文中明确写成后续工作。
|
||
|
||
---
|
||
|
||
## 14. 边界与不做的事
|
||
|
||
- **不做**:整机恢复运行;真实教学效果数据(未试用前不编写学生成绩/问卷);复杂滤波与稳健拟合挤占三组核心比较;
|
||
- **不宣称**:2.5ns 为整机时间分辨率;仿真曲线为实测曲线;仿真精度等同硬件验证结果;
|
||
- **不引用**:原报告中找不到原始记录的数据。
|
||
|
||
---
|
||
|
||
## 15. 与论文的映射(论文编写主线)
|
||
|
||
| 论文部分 | 主要内容 | 素材来源 |
|
||
|---|---|---|
|
||
| 教学问题 | 低采样率设备难以直观开展快速荧光衰减测量实验 | 原报告第 1 章 + 本文档 §2 |
|
||
| 实验原理 | 荧光衰减、光纤延时、ADC 采样、校准与寿命拟合 | 原报告 1、2 章 + `项目说明.md` §3 |
|
||
| 实验设计 | 统一任务、操作流程、可调参数、学生输出 | 本文档 §2–§3 |
|
||
| 软件实现 | 功能流程、参数设置、算法选择 | 本文档 §4–§9 + 实际代码 |
|
||
| 结果分析 | 相位、重建、算法比较、参数扫描、误差统计 | 记录包 + M0–M5 图表 |
|
||
| 虚实结合 | 现有装置说明 + 模块级真实参数 | §13 硬件记录 |
|
||
| 教学实施 | 实验学时、操作任务、评分、真实试用 | 学生实验指导材料(交付物 6) |
|
||
| 局限性 | 整机未跑通、仿真边界、进一步验证需求 | §14 + 实际情况 |
|
||
|
||
建议论文题目(任务书建议):**基于光纤延时等效采样的荧光寿命虚拟仿真实验设计**。
|
||
|
||
---
|
||
|
||
## 附录 B:展示网站(副产品,与主线同步开发)
|
||
|
||
### B.1 定位
|
||
|
||
- **副产品**:不进入任务书交付清单,不参与里程碑验收;
|
||
- **同步开发**:整个软件构建周期较长,网站与主线并行推进,每个里程碑完成后同步部署对应增量,作为阶段性成果的对外展示窗口;
|
||
- **优先级**:与主线时间冲突时主线优先;网站只做"薄壳",不反向拖慢算法开发。
|
||
|
||
### B.2 技术路线(M0 锁定,因为它决定 core 的约束)
|
||
|
||
- **静态站 + Pyodide**:同一 `core/` Python 算法核心经 Pyodide 在浏览器运行,前端用 ECharts 渲染——算法零重写,与论文/CLI 结果天然一致;
|
||
- 无后端、无数据库:nginx 纯静态托管,零运维成本;
|
||
- 重计算场景(如 200 次蒙特卡洛):默认加载预计算记录包 JSON,另提供小规模交互重算;
|
||
- core 的浏览器兼容约束已在 §5.1 定义,从 M0 第一行代码起生效。
|
||
|
||
### B.3 部署
|
||
|
||
| 项 | 说明 |
|
||
|---|---|
|
||
| 访问地址 | `https://chenxy.biboer.cn`(TLS 由 Cloudflare 隧道终止) |
|
||
| 公网链路 | `chenxy.biboer.cn`(Cloudflare DNS CNAME)→ mac-tunnel(`cloudflared`)→ `http://127.0.0.1:5050` |
|
||
| 服务器 | m4(Homebrew nginx,监听 5050 仅 HTTP;站点目录 `/Users/gavin/www/chenxy`) |
|
||
| 域名脚本 | m4 上 `./yuming.sh chenxy.biboer.cn 5050` 管理隧道与 nginx 占位配置 |
|
||
| 发布方式 | `./deploy.sh local`(同步 core 到 web/py)→ `rsync -az web/ m4:/Users/gavin/www/chenxy/` |
|
||
| 注意 | m4 nginx master 由 root/launchd 管理,改配置后需 `sudo /opt/homebrew/bin/nginx -s reload`;`py/json` 文件配置 `no-store`,发布新算法后浏览器强制刷新 |
|
||
|
||
### B.4 内容纪律(诚信红线在网站的落实)
|
||
|
||
- 页面显著标注"仿真演示,非实测数据";
|
||
- 展示的每个案例对应一个实验记录包(页面附 `meta.json` 摘要:参数/种子/运行日期);
|
||
- 不出现"整机 2.5ns 时间分辨率"等性能表述,措辞与软件一致("等效时间细分");
|
||
- 不展示未通过主线验收的功能。
|
||
|
||
---
|
||
|
||
*本文档基于《光纤延时等效采样教学实验后续工作说明.docx》与 `resources/` 两份原始材料整理(2026-10-12)。实施过程中如与任务书冲突,以任务书为准。*
|