update at 2026-10-12 14:18:03
忽略 .venv;剔除误提交的虚拟环境;更新 README 与实现方案
This commit is contained in:
3
.gitignore
vendored
3
.gitignore
vendored
@@ -1,5 +1,8 @@
|
|||||||
# 临时目录
|
# 临时目录
|
||||||
.temp/
|
.temp/
|
||||||
|
|
||||||
|
# Python 虚拟环境
|
||||||
|
.venv/
|
||||||
|
|
||||||
# macOS
|
# macOS
|
||||||
.DS_Store
|
.DS_Store
|
||||||
|
|||||||
87
README.md
87
README.md
@@ -0,0 +1,87 @@
|
|||||||
|
# 光纤延时等效采样教学实验
|
||||||
|
|
||||||
|
> 把原项目"光学游标卡尺"的核心原理,做成人人可以动手调节的综合教学实验。
|
||||||
|
|
||||||
|
用四路不同长度的光纤(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` |
|
||||||
|
|||||||
53
docs/实现方案.md
53
docs/实现方案.md
@@ -141,8 +141,8 @@ fiber_delay_sim/
|
|||||||
| 统计 | numpy + scipy.stats | 蒙特卡洛、置信区间;bootstrap 按需 |
|
| 统计 | numpy + scipy.stats | 蒙特卡洛、置信区间;bootstrap 按需 |
|
||||||
| 绘图 | matplotlib | 论文图表直接产出(SVG+PNG) |
|
| 绘图 | matplotlib | 论文图表直接产出(SVG+PNG) |
|
||||||
| 随机数 | numpy.random.default_rng(seed) | 种子固定 → 逐位可复现 |
|
| 随机数 | numpy.random.default_rng(seed) | 种子固定 → 逐位可复现 |
|
||||||
| 界面 | CLI 先行;M5 再做简单 GUI(如 Tkinter/Streamlit 单页) | 遵守"先算对,再好看" |
|
| 界面 | CLI 先行;M5 再做简单 GUI | 遵守"先算对,再好看",GUI 不阻塞算法开发 |
|
||||||
| 附加演示(可选) | 网页 demo,见附录 B | 交流用,不进入里程碑 |
|
| 展示网站(副产品) | 静态站 + Pyodide 复用 core/ + ECharts,随里程碑同步增量(见附录 B) | 同步展示成果;core 保持浏览器可运行,网站零算法重写 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -310,6 +310,21 @@ runs/YYYYMMDD-HHMMSS-<实验名>-<seed>/
|
|||||||
|
|
||||||
**完成 M0 后立即执行任务书"开始工作时先做什么"的检查**:四项前置工作(理解说明/框图、实验流程、最小程序、光纤长度表)全部具备后,再继续 M2 以后工作。
|
**完成 M0 后立即执行任务书"开始工作时先做什么"的检查**:四项前置工作(理解说明/框图、实验流程、最小程序、光纤长度表)全部具备后,再继续 M2 以后工作。
|
||||||
|
|
||||||
|
### 11.1 网站同步增量计划(副产品,随里程碑上线)
|
||||||
|
|
||||||
|
> 网站与主线并行开发、每个里程碑后同步部署一次;工作量控制在"薄壳页面 + 部署",若与主线冲突,主线优先。
|
||||||
|
|
||||||
|
| 里程碑 | 网站同步增量 | 页面内容 |
|
||||||
|
|---|---|---|
|
||||||
|
| M0 | **网站骨架上线** | 项目简介(摘自 `项目说明.md`)+ 最小交互 demo:调节寿命/噪声,实时看 10ns 直接采样与拟合 |
|
||||||
|
| M1 | 光纤设计器页 | 长度→延时→相位计算器、反向设计、相位圆图(复现原项目名义四组) |
|
||||||
|
| M2 | 校准与重建页 | 误差注入开关;校准前后重建曲线对比 |
|
||||||
|
| M3 | 算法比较页 | 同一数据切换对数线性 / NLS,拟合与残差对比 |
|
||||||
|
| M4 | 统计结果页 | 蒙特卡洛分布与扫描热图:默认加载预计算记录包 JSON,提供小规模(如 20 次)交互重算体验 |
|
||||||
|
| M5 | 六页教学界面完整化 | 对应任务书六页面 + 一键导出 |
|
||||||
|
|
||||||
|
**内容纪律**:网站展示的每个案例必须对应一个实验记录包(`meta.json` 可追溯);页面显著标注"仿真演示,非实测数据";不出现任何整机性能表述。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 12. 测试与验证策略
|
## 12. 测试与验证策略
|
||||||
@@ -364,14 +379,36 @@ runs/YYYYMMDD-HHMMSS-<实验名>-<seed>/
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 附录 B:附加演示网站(非交付主线,可选)
|
## 附录 B:展示网站(副产品,与主线同步开发)
|
||||||
|
|
||||||
> **定位**:仅为方便交流和演示的附加产物,不进入任何里程碑,M5 完成后视余力实施。内容仅限已被记录包验证过的仿真案例,页面显著标注"仿真演示,非实测数据"。
|
### B.1 定位
|
||||||
|
|
||||||
- 域名:`https://chenxy.biboer.cn`(HTTPS 已配置,证书有效期至 2027-01-10;服务器 24.233.3.126,nginx 当前为 302 占位配置,实施时替换为站点 root);
|
- **副产品**:不进入任务书交付清单,不参与里程碑验收;
|
||||||
- 推荐技术路线:**同一 `core/` 算法核心经 Pyodide 在浏览器运行**(Python 代码零重写,保算法一致性);备选:核心案例预计算为 JSON + 轻量 JS 页面;
|
- **同步开发**:整个软件构建周期较长,网站与主线并行推进,每个里程碑完成后同步部署对应增量,作为阶段性成果的对外展示窗口;
|
||||||
- 内容:教学实验六步流程的交互式复刻(参数滑块 → 曲线/拟合实时更新),重点展示三组核心比较;
|
- **优先级**:与主线时间冲突时主线优先;网站只做"薄壳",不反向拖慢算法开发。
|
||||||
- 约束:不影响主线进度;所有演示参数与记录包对应;不承载任何"实测"表述。
|
|
||||||
|
### B.2 技术路线(M0 锁定,因为它决定 core 的约束)
|
||||||
|
|
||||||
|
- **静态站 + Pyodide**:同一 `core/` Python 算法核心经 Pyodide 在浏览器运行,前端用 ECharts 渲染——算法零重写,与论文/CLI 结果天然一致;
|
||||||
|
- 无后端、无数据库:nginx 纯静态托管,零运维成本;
|
||||||
|
- 重计算场景(如 200 次蒙特卡洛):默认加载预计算记录包 JSON,另提供小规模交互重算;
|
||||||
|
- core 的浏览器兼容约束已在 §5.1 定义,从 M0 第一行代码起生效。
|
||||||
|
|
||||||
|
### B.3 部署
|
||||||
|
|
||||||
|
| 项 | 说明 |
|
||||||
|
|---|---|
|
||||||
|
| 域名 | `https://chenxy.biboer.cn`(HTTPS 已配置,证书有效期至 2027-01-10) |
|
||||||
|
| 服务器 | 24.233.3.126(`ssh web`),nginx 当前为 302 占位配置,首次部署时替换为静态站点 root |
|
||||||
|
| 发布方式 | `deploy.sh` 一键同步:rsync `web/` + `core/*.py` + 记录包 JSON 至站点目录,nginx reload |
|
||||||
|
| 目录 | 站点根仅放静态产物;不部署源码与无关文件 |
|
||||||
|
|
||||||
|
### B.4 内容纪律(诚信红线在网站的落实)
|
||||||
|
|
||||||
|
- 页面显著标注"仿真演示,非实测数据";
|
||||||
|
- 展示的每个案例对应一个实验记录包(页面附 `meta.json` 摘要:参数/种子/运行日期);
|
||||||
|
- 不出现"整机 2.5ns 时间分辨率"等性能表述,措辞与软件一致("等效时间细分");
|
||||||
|
- 不展示未通过主线验收的功能。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user