douboer ae1c774606 update at 2026-10-12 14:18:03
忽略 .venv;剔除误提交的虚拟环境;更新 README 与实现方案
2026-10-12 14:18:03 +08:00
2026-10-12 14:18:03 +08:00
2026-10-12 13:58:31 +08:00
2026-10-12 14:18:03 +08:00
2026-10-12 14:18:03 +08:00
2026-10-12 13:54:10 +08:00
2026-10-12 13:54:10 +08:00

光纤延时等效采样教学实验

把原项目"光学游标卡尺"的核心原理,做成人人可以动手调节的综合教学实验。

用四路不同长度的光纤(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/                     # 展示网站(副产品,同步增量开发)

快速开始

# 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
Description
No description provided
Readme 66 MiB
Languages
Python 57.7%
TypeScript 20.2%
CSS 11.4%
JavaScript 7%
HTML 3%
Other 0.7%