Files
chenproject/README.md
2026-10-12 14:26:51 +08:00

5.9 KiB
Raw Blame History

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

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

用四路不同长度的光纤(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/)

  • docs/项目说明.md —— 任务书阶段一成果。原项目是什么、为什么做:问题背景、"光学游标卡尺"核心原理(1 m 光纤 ≈ 4.90 ns 延时)、原系统全貌与简化框图、关键参数速查表(软件默认值来源)、原材料内部不一致辨析与科研诚信红线。面向第一次接触本项目的同学,读完可不依赖原文讲清实验链路。
  • docs/实现方案.md —— 任务书阶段二/三成果。新项目怎么做:交付物清单、统一教学命题与实验六步流程、三组核心对比设计、软件总体架构与六类可调参数、实验记录包与可复现性规范、M0–M5 里程碑验收标准、硬件补充与论文映射。

原始材料(resources/ 与任务书)

快速指路:想了解原理与背景读项目说明;想了解实验设计与软件实现读实现方案;两份文档按"先说明、后方"顺序配套阅读。