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

94 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 光纤延时等效采样教学实验
> 把原项目"光学游标卡尺"的核心原理,做成人人可以动手调节的综合教学实验。
用四路不同长度的光纤(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/)
- **[docs/项目说明.md](docs/项目说明.md)** —— 任务书阶段一成果。原项目是什么、为什么做:问题背景、"光学游标卡尺"核心原理(1 m 光纤 ≈ 4.90 ns 延时)、原系统全貌与简化框图、关键参数速查表(软件默认值来源)、原材料内部不一致辨析与科研诚信红线。面向第一次接触本项目的同学,读完可不依赖原文讲清实验链路。
- **[docs/实现方案.md](docs/实现方案.md)** —— 任务书阶段二/三成果。新项目怎么做:交付物清单、统一教学命题与实验六步流程、三组核心对比设计、软件总体架构与六类可调参数、实验记录包与可复现性规范、M0–M5 里程碑验收标准、硬件补充与论文映射。
### 原始材料(resources/ 与任务书)
- **[光纤延时等效采样教学实验后续工作说明.docx](光纤延时等效采样教学实验后续工作说明.docx)** —— 任务书,需求权威来源(七项交付物与最终判断标准)。
- **[resources/研究报告.pdf](resources/研究报告.pdf)** —— 原项目正式研究报告(50 页),全部技术细节的权威出处。
- **[resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf](resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf)** —— 原项目答辩 PPT(30 页),可视化素材与部分补充数据。
快速指路:想了解**原理与背景**读项目说明;想了解**实验设计与软件实现**读实现方案;两份文档按"先说明、后方"顺序配套阅读。