# 光纤延时等效采样教学实验 > 把原项目"光学游标卡尺"的核心原理,做成人人可以动手调节的综合教学实验。 用四路不同长度的光纤(0 / 9.70 / 19.40 / 29.10 m)产生错开的采样相位,把 10 ns 的 ADC 采样间隔**等效细分**为 2.5 ns,从而在低速采样条件下稳定测量 ~50 ns 量级的荧光衰减。本仓库将这条技术链提炼为**可调参数的教学仿真软件**、**综合实验方案**与**教学论文**。 **核心命题**:在 ADC 采样率有限的条件下,能否通过改变光纤长度产生不同的采样相位,重建更密集的荧光衰减曲线,并提高荧光寿命估计的稳定性? (原项目蒙特卡洛结果:单路拟合标准差 7.65% → 四相位等效采样 0.60%,精度提升超过十倍) --- ## 仓库结构 ``` chenchen/ ├── docs/ # 项目文档 │ ├── 项目说明.md # 阶段一:项目理解 + 简化框图 + 关键参数速查 │ └── 实现方案.md # 阶段二三:实验设计 + 软件实现蓝图 ├── resources/ # 原始材料(研究报告 PDF、答辩 PPT) ├── 光纤延时等效采样教学实验后续工作说明.docx # 任务书(需求权威来源) ├── fiber_delay_sim/ # 仿真软件(主线交付) │ ├── core/ # 算法核心层(纯 numpy/scipy,浏览器可复用) │ ├── pipeline.py # 实验流程编排 │ ├── cli.py # 命令行入口 │ ├── experiments/ # 实验脚本(每个实验产出一个记录包) │ └── tests/ # 单元 / 基准 / 复现性测试 ├── runs/ # 实验记录包(参数+种子+数据+图表,可复现) └── web/ # 展示网站(副产品,同步增量开发) ``` ## 快速开始 ```bash # 1. 环境准备(macOS/Linux) python3 -m venv .venv && source .venv/bin/activate pip install numpy scipy matplotlib pytest # 2. 运行测试(M0/M1 验收断言) pytest fiber_delay_sim/tests/ -v # 3. 运行 M0 最小实验:单指数信号 + 10ns 直接采样 + 噪声 + 寿命拟合 python -m fiber_delay_sim.cli m0 --tau 52.8 --snr-db 50 --repeats 20 --seed 42 # 4. 光纤长度设计:名义四组 → 延时/相位表 python -m fiber_delay_sim.cli design --nominal # 5. 反向设计:目标相位 0/2.5/5.0/7.5 ns → 候选光纤长度 python -m fiber_delay_sim.cli design --targets 0,2.5,5,7.5 ``` 每次运行自动在 `runs/` 落盘一个**实验记录包**:`meta.json`(参数/种子/日期/来源标注)+ 数据 CSV + 结果 JSON + 图表,保证论文每一项结果可重新生成和验证。 ## 开发里程碑 | 里程碑 | 内容 | 状态 | |---|---|---| | M0 最小程序 | 信号生成 + 10ns 采样 + 噪声 + NLS 寿命拟合(验收:理想无噪恢复设定寿命) | 🔄 进行中 | | M1 光纤设计 | 长度→延时→相位 + 反向设计 + 相位图 | 🔄 进行中 | | M2 误差与校准 | 四通道误差注入 + 校准 + 时间重建 | ⬜ | | M3 算法切换 | 对数线性 vs 非线性最小二乘 | ⬜ | | M4 统计分析 | 蒙特卡洛 + 参数扫描 + 置信区间 + 失败率 | ⬜ | | M5 界面与导出 | 简单 GUI + 一键导出记录包 | ⬜ | 网站(副产品)随每个里程碑同步增量上线,见 `docs/实现方案.md` §11.1 与附录 B。 ## 展示网站 - 地址:**https://chenxy.biboer.cn** (静态站:Pyodide 在浏览器运行同一 `core/` 算法核心 + ECharts 渲染,算法与本地/论文零重写) - 本地预览:`python3 -m http.server -d web 8765` → 访问 http://localhost:8765 - 首次加载需下载 Pyodide 运行时(约数十 MB),请耐心等待 ## 数据与诚信声明 - 本软件输出均为**软件仿真数据**(记录包 `meta.json` 中 `data_origin: "software-simulated"`),不得表述为装置实测曲线; - 2.5 ns 是**等效时间细分网格**,不是整机时间分辨率,也不代表探测器、TIA 或 ADC 模拟带宽的提高; - 原项目实测数据、器件参数的来源与差异(如 τ₁=0.6ns 仿真设定值 vs 5.0ns 实测拟合值)见 `docs/项目说明.md` §6; - 未进行真实教学试用前,不编写任何教学效果数据。 ## 文档导航 | 想了解 | 读 | |---|---| | 原项目是什么、原理、关键数字 | `docs/项目说明.md` | | 新实验怎么设计、软件怎么做、里程碑验收 | `docs/实现方案.md` | | 任务范围与交付物(权威) | `光纤延时等效采样教学实验后续工作说明.docx` | | 原项目完整技术细节 | `resources/研究报告.pdf` |