GUI提速:Pyodide自托管(m4 /pyodide/ immutable)+SW持久缓存(二次访问0.5s)+正反向设计+结果持久化(指纹校验) ; deploy.sh排除pyodide目录
27 KiB
实现方案:光纤延时等效采样综合教学实验与仿真软件
本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。 配套阅读:
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. 软件定位与设计原则
- 软件是教学实验的主要实施平台,不是数据生成器——学生主动修改物理参数、观察数据变化、选择处理算法、比较结果,看到"参数改变 → 测量过程改变 → 结果可信度改变"的完整因果链。
- 计算正确、结果可重复、参数含义清楚 > 界面美观(任务书原文)。前五个里程碑未完成前,不制作复杂界面。
- 一次运行 = 一个可复现实验记录包:参数、随机种子、原始数据、算法版本、运行日期全部落盘(诚信红线内建)。
- 所有输出默认标注数据来源为软件仿真;等效采样网格措辞固定为"等效时间细分"(不得表述为整机时间分辨率)。
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.373 ns 时模拟展宽);
- 通道增益与损耗:各路独立乘性系数;
- 基线:各路独立加性偏移(B₀ 或 B₀+B₁·t,模拟交流耦合下垂);
- 饱和:超出上限截幅;
- 噪声:各通道独立高斯白噪声(σ 由 SNR 定义);扩展项:1/f、散粒噪声;
- 多通道采样:t_sample = t_trigger + δk + jitter_k,各通道按 Δt 间隔采样;
- ADC 量化:按位数均匀量化。
7.3 通道误差注入与校准
误差注入(对应可调参数"校准误差"):增益失配、延时残差、基线偏移——灵敏度参考原项目数据:通道失配 14% 在错误模型下→7.2% 偏差;延时残差 0.01ns→0.019%。
校准三步(学生可选方法与顺序):
- 基线扣除:无信号尾段均值扣除,或尾段线性拟合扣除 B₀+B₁·t;
- 增益归一化:各通道峰值(或全段比例)归一到参考通道;
- 延时校准:上升沿互相关对齐 / 已知标定延时表查找。
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 统计分析(可信度评价)
- 蒙特卡洛重复:默认 200 次(不同种子)→ τ̂ 分布 → 均值、标准差、相对标准差;单通道 vs 四通道对比(复现 7.65% → 0.60% 的量级改善);
- 参数扫描:长度误差 / 噪声 / 带宽 / 增益校准误差 / 记录窗口 → τ̂ 偏差趋势曲线与误差热图,给出方法适用范围与失效条件;
- 置信区间:正态近似(±1.96σ)为主,bootstrap 为扩展;
- 失败率:定义 |τ̂−τ|/τ > 阈值(默认 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)。实施过程中如与任务书冲突,以任务书为准。