Files
chenproject/docs/实现方案.md
douboer 63323c9e15 update at 2026-10-13 08:40:33
GUI提速:Pyodide自托管(m4 /pyodide/ immutable)+SW持久缓存(二次访问0.5s)+正反向设计+结果持久化(指纹校验) ; deploy.sh排除pyodide目录
2026-10-13 08:40:33 +08:00

421 lines
27 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 实现方案:光纤延时等效采样综合教学实验与仿真软件
> 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。
> 配套阅读:`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`(构建 figma GUI → rsync 到 m4 → HTTP 验证);`./deploy.sh legacy` 部署旧版 web/;`./deploy.sh local` 仅同步 core |
| 已上线 | React 版六页面 GUI(Figma 重构):P1 正/反向设计、P2–P4、P5 扫描+蒙特卡洛(参数各自可调)、P6 导出;参数与计算结果 localStorage 持久化(刷新保持) |
| Pyodide 自托管 | `/pyodide/` 目录(v0.26.4 + numpy/scipy/openblas wheel ≈ 70MB,一次性下载至 m4,**rsync --delete 排除保护**);nginx `Cache-Control: immutable` 一年缓存 |
| 加载提速 | Service Worker 缓存 Pyodide 运行时与构建产物——二次访问引擎 ~0.5s 就绪(首次仍需网络下载);Pyodide `packageCacheDir:"idb"` 双保险;sw.js 响应 no-store 防钉死,注册 URL 带版本参数 |
| 注意 | m4 nginx master 由 root/launchd 管理,改配置需 `sudo /opt/homebrew/bin/nginx -s reload`;构建产物文件名带内容 hash 无需手动版本号;index.html 为 no-store |
### B.4 内容纪律(诚信红线在网站的落实)
- 页面显著标注"仿真演示,非实测数据";
- 展示的每个案例对应一个实验记录包(页面附 `meta.json` 摘要:参数/种子/运行日期);
- 不出现"整机 2.5ns 时间分辨率"等性能表述,措辞与软件一致("等效时间细分");
- 不展示未通过主线验收的功能。
---
*本文档基于《光纤延时等效采样教学实验后续工作说明.docx》与 `resources/` 两份原始材料整理(2026-10-12)。实施过程中如与任务书冲突,以任务书为准。*