# 实现方案:光纤延时等效采样综合教学实验与仿真软件 > 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。 > 配套阅读:`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-<实验名>-/ ├── 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)。实施过程中如与任务书冲突,以任务书为准。*