From 7d6b02c2348d83dca74ce7bdc6682097663bccce Mon Sep 17 00:00:00 2001 From: douboer Date: Mon, 12 Oct 2026 13:54:10 +0800 Subject: [PATCH] update at 2026-10-12 13:54:10 --- .gitignore | 5 + docs/实现方案.md | 362 ++++++++++++++++++ docs/项目说明.md | 318 +++++++++++++++ 研究报告.pdf => resources/研究报告.pdf | Bin .../闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf | Bin runit.sh | 1 + todo.md | 44 +++ 7 files changed, 730 insertions(+) create mode 100644 .gitignore create mode 100644 docs/实现方案.md create mode 100644 docs/项目说明.md rename 研究报告.pdf => resources/研究报告.pdf (100%) rename 闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf => resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf (100%) create mode 120000 runit.sh diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..592dab3 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +# 临时目录 +.temp/ + +# macOS +.DS_Store diff --git a/docs/实现方案.md b/docs/实现方案.md new file mode 100644 index 0000000..c9a1240 --- /dev/null +++ b/docs/实现方案.md @@ -0,0 +1,362 @@ +# 实现方案:光纤延时等效采样综合教学实验与仿真软件 + +> 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段二(实验设计)+ 阶段三(软件实现)**的设计成果。 +> 配套阅读:`docs/项目说明.md`(阶段一:项目理解 + 简化框图 + 关键参数速查)。 +> **交付物以任务书(原说明文档)要求为准;任何演示性产物(如网页)仅为交流方便的附加项,不作为主线交付。** + +--- + +## 1. 交付物清单(以任务书为准) + +| # | 交付物 | 对应本文档章节 | 状态 | +|---|---|---|---| +| 1 | 原项目理解说明 + 简化系统框图 | `docs/项目说明.md` | ✅ 已完成 | +| 2 | 完整综合教学实验方案 | §2–§3 | 本文档 | +| 3 | 可调光纤长度与算法选择功能的仿真软件 | §4–§11 | 本文档 + 后续代码 | +| 4 | 可重复生成的原始数据、结果图、统计表 | §10 实验记录包 | 软件 M0 起产出 | +| 5 | 至少一项可追溯的真实硬件模块记录 | §13 | 待实施 | +| 6 | 学生实验指导内容 | 基于 §2 扩写 | 待实施 | +| 7 | 面向《实验科学与技术》的论文初稿 | §15 映射 | 待实施 | + +**最终判断标准**(任务书原文):能否清楚回答——①为什么需要光纤延时等效采样;②学生通过调节参数和比较算法能学到什么;③论文中每一项结果是否能够被重新生成和验证。 + +--- + +## 2. 教学命题与统一实验任务 + +### 2.1 教学命题(新核心问题) + +> **在 ADC 采样率有限的条件下,能否通过改变光纤长度产生不同的采样相位,重建更密集的荧光衰减曲线,并提高荧光寿命估计的稳定性?** + +### 2.2 统一实验任务 + +在采样周期 **10 ns** 的条件下,对约 **50 ns 量级**的荧光衰减(YAG:Ce,基准真值 τ=52.8 ns)进行测量。学生先评价直接采样的局限,再通过调整四路光纤长度设计不同采样相位,完成校准、重建、寿命拟合和误差分析。 + +### 2.3 实验六步流程(学生操作主线) + +| 步骤 | 学生完成的任务 | 教学价值 | 软件支撑 | +|---|---|---|---| +| 1 直接测量 | 单通道 10ns 采样数据拟合荧光寿命 | 认识采样点数量、噪声与拟合稳定性的关系 | 单通道仿真 + 拟合 | +| 2 延时设计 | 改变各通道光纤长度,计算传播延时与等效相位 | 把光纤传播与 ADC 采样相位联系起来 | 光纤设计模块 | +| 3 通道校准 | 处理基线偏移、通道增益差异、延时误差 | 理解真实多通道测量为什么必须校准 | 误差注入 + 校准算法 | +| 4 波形重建 | 不同相位的采样点归位并合并到统一时间轴 | 理解等效时间采样的条件和实现过程 | 时间重建模块 | +| 5 算法比较 | 比较不同预处理、重建和寿命拟合算法 | 认识算法选择会改变结果偏差和稳定性 | 算法切换框架 | +| 6 可信度评价 | 重复仿真、参数扫描、不确定度分析 | 从"得到一个数值"提升到"判断数值是否可信" | 统计分析模块 | + +### 2.4 实验完成后的学习成果(验收依据) + +- 解释**采样间隔、等效采样间隔、模拟带宽、时间分辨能力**四个概念的区别; +- 根据光纤长度和群折射率计算传播延时,并换算为采样相位(δ = L·n_g/c,n_g=1.468,1m≈4.90ns); +- 根据目标等效采样网格**反向设计**光纤长度; +- 完成多通道基线、增益、延时校准; +- 使用不同算法重建衰减曲线并拟合荧光寿命; +- 通过误差统计判断方案的有效范围和失效条件。 + +--- + +## 3. 实验设计要点 + +### 3.1 三组核心对比(论文与软件的主线,必须做透) + +| 对比 | 复现的原项目结果 | 教学结论 | +|---|---|---| +| **单通道直接采样 vs 四相位等效采样** | 5 点/窗口 0.76τ → 拟合 56.66ns;41 点 → 53.18ns(真值 52.8);蒙特卡洛 σ:7.65% → 0.60% | 采样点密度决定信息量,等效采样用光学手段换电子学带宽 | +| **名义延时重建 vs 校准延时重建** | 延时标定残差 0.01ns 在错误模型下→0.019% 偏差;自由 t_k 下→0 | 真实多通道系统必须校准;校准前后重建曲线连续性差异 | +| **对数线性拟合 vs 非线性最小二乘** | 标准数据反演基准:NLS 偏差为零(PPT p22) | 对数变换放大低信噪比尾部噪声权重;NLS 在双指数+基线下更稳 | + +稳健拟合(Huber/Soft-L1)与复杂滤波作为**扩展功能**,不挤占主线。 + +### 3.2 基准真值预设(软件内置,论文需区分表述) + +| 预设 | 模型 | 用途 | +|---|---|---| +| A 仿真基准 | I(t) = 0.16·e^(−t/0.60) + 0.84·e^(−t/52.80) | 复现报告 5.4.4 蒙特卡洛(τ₁=0.60ns 为**仿真设定值**) | +| B 实测参考 | τ₁=5.0 ns,τ₂=52.5 ns | 对应附图 A1 实测截图标注,用于虚实结合叙述 | +| C 单指数教学 | I(t) = e^(−t/52.8) | 最小程序与入门教学(对数线性适用) | + +> 注意(见项目说明 §6):原项目材料中 τ₁(0.6 vs 5.0)、τ₂(52.5 vs 52.8)存在不一致。软件以预设 A 为默认仿真基准,论文中明确区分"仿真设定值"与"实测拟合值"。 + +--- + +## 4. 软件定位与设计原则 + +1. **软件是教学实验的主要实施平台**,不是数据生成器——学生主动修改物理参数、观察数据变化、选择处理算法、比较结果,看到"参数改变 → 测量过程改变 → 结果可信度改变"的完整因果链。 +2. **计算正确、结果可重复、参数含义清楚 > 界面美观**(任务书原文)。前五个里程碑未完成前,不制作复杂界面。 +3. **一次运行 = 一个可复现实验记录包**:参数、随机种子、原始数据、算法版本、运行日期全部落盘(诚信红线内建)。 +4. 所有输出默认标注数据来源为**软件仿真**;等效采样网格措辞固定为"等效时间细分"(不得表述为整机时间分辨率)。 + +--- + +## 5. 软件总体架构 + +### 5.1 分层设计(核心与界面解耦) + +``` +fiber_delay_sim/ +├── core/ # 算法核心层:纯 Python,无界面依赖,可独立测试与复用 +│ ├── signal.py # 荧光信号生成(单/双指数 + 基线 B0+B1·t) +│ ├── fiber.py # 光纤延时与相位(正向计算 / 反向设计 / 均匀性指标) +│ ├── acquisition.py # 测量链仿真:前端展宽/增益/基线/噪声/饱和/ADC量化/时钟抖动/多通道采样 +│ ├── calibration.py # 通道校准:基线扣除 / 增益归一化 / 延时校准 +│ ├── reconstruction.py # 时间重建:名义/校准延时交织、线性插值显示 +│ ├── fitting.py # 寿命拟合:对数线性 / 非线性最小二乘 / 稳健(扩展) +│ └── statistics.py # 蒙特卡洛 / 参数扫描 / 置信区间 / 失败率 +├── pipeline.py # 流程编排:参数→生成→采样→校准→重建→拟合→统计 +├── experiments/ # 实验脚本:每个脚本产出论文/教学的一个完整记录包 +├── cli.py # 命令行入口(M0–M4 的主用户界面) +├── gui.py # 简单图形界面 + 一键导出(M5,后置) +├── export/ # 记录包导出(JSON + CSV + SVG/PNG) +└── tests/ # 单元测试 + 基准测试 + 复现性测试 +``` + +### 5.2 数据流(任务书"软件总体流程") + +``` +参数设计 → 信号生成 → 测量链仿真 → 多通道采样 → 校准与重建 → 寿命拟合 → 误差统计 → 结果导出 +``` + +### 5.3 技术选型 + +| 项 | 选择 | 理由 | +|---|---|---| +| 语言/环境 | Python 3.10+ | 科研数据处理事实标准;与论文图表工具链一致 | +| 数值计算 | numpy | 信号生成、采样、重建 | +| 拟合 | scipy.optimize.least_squares / curve_fit | NLS 与稳健损失(huber / soft_l1)原生支持 | +| 统计 | numpy + scipy.stats | 蒙特卡洛、置信区间;bootstrap 按需 | +| 绘图 | matplotlib | 论文图表直接产出(SVG+PNG) | +| 随机数 | numpy.random.default_rng(seed) | 种子固定 → 逐位可复现 | +| 界面 | CLI 先行;M5 再做简单 GUI(如 Tkinter/Streamlit 单页) | 遵守"先算对,再好看" | +| 附加演示(可选) | 网页 demo,见附录 B | 交流用,不进入里程碑 | + +--- + +## 6. 可调参数规格(六类) + +> 表中"默认值"即原项目名义参数(来源见 `docs/项目说明.md` §5)。 + +| 参数类别 | 参数 | 默认值 | 建议范围 | 学生应观察 | +|---|---|---|---|---| +| **荧光信号** | 寿命 τ(单指数) | 52.8 ns | 1–200 ns | 曲线衰减速度 | +| | 双指数 (A₁,τ₁,A₂,τ₂) | 0.16, 0.60ns / 0.84, 52.80ns | — | 拟合难度、模型失配 | +| | 背景基线 B₀(+线性项 B₁) | 0 | 0–10% | 基线处理必要性 | +| | 激发重复性(幅度抖动) | 0 | 0–5% | 通道间/重复间波动 | +| **光纤通道** | 通道数量 | 4 | 1–8 | 相位数 = 通道数 | +| | 每路光纤长度 | 0 / 9.70 / 19.40 / 29.10 m | 0–50 m | 传播延时、等效相位 | +| | 群折射率 n_g | 1.468 | 1.44–1.50 | 延时换算 | +| | 通道损耗(相对增益) | 1.0 | 0.5–1.5 | 幅度差异 | +| | 长度制造误差 | 0 | ±0.1 m | 相位漂移 | +| **采集系统** | ADC 采样间隔 Δt | 10 ns | 2–20 ns | 有效采样点数 | +| | 量化位数 | 12 bit | 8–16 bit | 量化误差 | +| | 记录窗口 | 400 ns | 50–1000 ns | Fisher 结论:窗口越长精度越高 | +| | 触发位置 | 0 | — | 时间轴偏移 | +| | 时钟抖动 | 0 | 0–1 ns | 时基不确定度 | +| **模拟前端** | 带宽(高斯响应 σ) | 0(可设 1.373 ns) | 0–5 ns | 波形展宽 | +| | 增益 / 饱和上限 | 1.0 / 不饱和 | — | 截幅失真 | +| | 基线偏移 | 0 | ±5% | 预处理必要性 | +| | 噪声(σ 或 SNR) | SNR 50 dB | — | 信噪比与拟合稳定性 | +| **校准误差** | 增益校准残差 | 0 | ±10% | 重建曲线不连续 | +| | 延时校准残差 | 0 | ±0.1 ns | 时间归位偏差 | +| | 基线估计误差 | 0 | ±2% | 寿命估计偏差 | +| **统计设置** | 蒙特卡洛重复次数 | 200 | 1–1000 | 分布收敛性 | +| | 随机种子 | 固定(记录包保存) | — | 结果可复现 | +| | 参数扫描范围 | 按实验定义 | — | 趋势曲线与失效范围 | + +--- + +## 7. 核心功能模块设计 + +### 7.1 光纤长度设计模块(独立教学环节,任务书重点) + +**正向计算**:输入各路长度 L_k 与 n_g → +``` +δk = Lk · ng / c (1m ≈ 4.90 ns) +φk = δk mod Δt (对采样周期取余相位) +``` +按时间先后排序 → 等效采样网格(理想为等间距 Δt/N)。 + +**反向设计**:学生设定目标相位(如 0、2.5、5.0、7.5 ns)与片段定位间隔 S(默认 50ns)→ 解同余方程 `δk ≡ φk (mod Δt)`,取满足片段分离条件的最小解 → +``` +Lk = δk · c / ng (多解 δk + m·Δt 全部列出,标注推荐值) +``` + +**输出**:光纤长度表、传播延时表、**相位圆图**(一个采样周期内的相位位置)、排序后的等效采样网格、**相位均匀性指标**(相邻相位间隔的最大偏差 / 标准差)。 + +**默认数据**:一键载入名义四组(0/9.70/19.40/29.10 m → 相位 0/2.5/5.0/7.5 ns);学生可任意修改,并可对比"名义长度 → 加制造误差后 → 校准后实际长度"三态。 + +### 7.2 信号生成与测量链仿真 + +``` +I(t) = A₁·e^(−t/τ₁) + A₂·e^(−t/τ₂) + B₀ + B₁·t (τ₁→∞ 退化为单指数) +``` + +仿真链按物理顺序逐级作用(每级可开关、可调参): + +1. **前端带宽**:与高斯冲激响应卷积(σ 可调,默认对应系统响应 1.373 ns 时模拟展宽); +2. **通道增益与损耗**:各路独立乘性系数; +3. **基线**:各路独立加性偏移(B₀ 或 B₀+B₁·t,模拟交流耦合下垂); +4. **饱和**:超出上限截幅; +5. **噪声**:各通道独立高斯白噪声(σ 由 SNR 定义);扩展项:1/f、散粒噪声; +6. **多通道采样**:t_sample = t_trigger + δk + jitter_k,各通道按 Δt 间隔采样; +7. **ADC 量化**:按位数均匀量化。 + +### 7.3 通道误差注入与校准 + +**误差注入**(对应可调参数"校准误差"):增益失配、延时残差、基线偏移——灵敏度参考原项目数据:通道失配 14% 在错误模型下→7.2% 偏差;延时残差 0.01ns→0.019%。 + +**校准三步**(学生可选方法与顺序): +1. 基线扣除:无信号尾段均值扣除,或尾段线性拟合扣除 B₀+B₁·t; +2. 增益归一化:各通道峰值(或全段比例)归一到参考通道; +3. 延时校准:上升沿互相关对齐 / 已知标定延时表查找。 + +### 7.4 时间重建 + +- 按**名义延时**直接交织 vs 按**校准延时**交织(核心对比②); +- 时间归位 u = t − δk → 四相位合并 → 排序成统一时间轴; +- 线性插值**仅用于显示**(教学讨论点:插值是否真正增加信息量?——不增加,信息来自真实采样相位); +- 定量指标:重建曲线**不连续度**(相邻点跳变统计),用于校准前后对比。 + +### 7.5 寿命拟合 + +| 算法 | 模型 | 特点 / 教学点 | +|---|---|---| +| 对数线性 | ln(I−B) = lnA − t/τ | 单指数适用;需先扣基线;**对数变换使噪声权重失真**(低信噪比尾部被放大),低 SNR 下产生系统性偏差 | +| 非线性最小二乘(NLS) | 全参数 (A₁,τ₁,A₂,τ₂,B₀,B₁) 直接拟合 | 基准算法;理想无噪数据应零偏差复现真值(对应原项目"标准拟合"验证) | +| 稳健拟合(扩展) | least_squares(loss='huber'/'soft_l1') | 异常点场景演示,不进论文主线 | + +初值策略:τ₂ 由对数斜率粗估,A 由峰值估计——保证拟合收敛的可复现性。 + +### 7.6 统计分析(可信度评价) + +1. **蒙特卡洛重复**:默认 200 次(不同种子)→ τ̂ 分布 → 均值、标准差、相对标准差;单通道 vs 四通道对比(复现 7.65% → 0.60% 的量级改善); +2. **参数扫描**:长度误差 / 噪声 / 带宽 / 增益校准误差 / 记录窗口 → τ̂ 偏差趋势曲线与误差热图,给出方法适用范围与失效条件; +3. **置信区间**:正态近似(±1.96σ)为主,bootstrap 为扩展; +4. **失败率**:定义 |τ̂−τ|/τ > 阈值(默认 5%)为失败,统计各扫描点的失败率。 + +--- + +## 8. 三组核心算法比较的实施方案 + +| # | 比较 | 固定条件 | 观测指标 | 预期现象(复现原项目量级) | +|---|---|---|---|---| +| ① | 单通道直接采样 vs 四相位等效采样 | 同一真值、同一噪声水平、同一窗口 | 有效采样点数、单次 τ̂ 偏差、蒙特卡洛 σ(τ̂)、失败率 | 点数×4;σ 从 ~7.65% 降至 ~0.60% 量级 | +| ② | 名义延时 vs 校准延时重建 | 注入增益失配与延时残差 | 重建曲线不连续度、τ̂ 偏差 | 校准前曲线断层、τ̂ 偏移;校准后消除 | +| ③ | 对数线性 vs NLS | 低/中/高三档 SNR,双指数+基线 | τ̂ 偏差与散布、残差结构 | 低 SNR 时对数法显著偏差,NLS 稳定 | + +> 数值允许与原项目不完全相同(噪声模型细节不同),但**改善趋势与量级必须一致**,论文中说明仿真条件差异。 + +--- + +## 9. 界面与操作顺序(六页面,全部后置到 M5) + +| 页面 | 主要操作 | 主要输出 | +|---|---|---| +| 参数与方案 | 设置荧光 / ADC / 光纤 / 前端参数 | 参数表、延时表、相位圆图 | +| 原始采样 | 生成理想波形,模拟单/多通道采样 | 连续曲线、原始采样点、各通道数据 | +| 校准与重建 | 选择校准方法与重建算法 | 校准前后曲线、统一时间轴重建结果 | +| 拟合与比较 | 选择拟合算法,比较不同采样方案 | 寿命估计、拟合残差、误差、置信区间 | +| 参数扫描 | 扫描长度/噪声/带宽/校准误差 | 趋势曲线、误差热图、算法失效范围 | +| 结果导出 | 保存参数/数据/图表/运行信息 | 可复现实验记录包 | + +M0–M4 期间以 CLI + `experiments/` 脚本为操作界面(参数文件 → 命令行运行 → 记录包落盘),这本身就是任务书要求的开发顺序。 + +--- + +## 10. 实验记录包与可复现性设计 + +每次运行(CLI/GUI/批量脚本)导出一个记录包: + +``` +runs/YYYYMMDD-HHMMSS-<实验名>-/ +├── meta.json # 运行日期时间、git commit、算法版本、全部参数、随机种子 +├── data/ # 各通道原始采样点(CSV)、校准系数、重建网格点 +├── results.json # τ̂ 及不确定度、残差统计、失败率、对比表 +├── figures/ # SVG + PNG 图表 +└── README.md # 一句话说明本次运行回答什么问题;数据来源标注:software-simulated +``` + +- `meta.json` 含 `data_origin: "software-simulated"` 字段——诚信红线自动落实; +- 论文中每张图/表在图注中标注对应记录包路径,保证"可重新生成和验证"。 + +--- + +## 11. 开发里程碑与验收标准 + +> 顺序与验收严格对应任务书"软件开发顺序"与"执行顺序和阶段验收"两节;**每个里程碑的产物 = 可运行代码 + 实验记录包 + 图表**。 + +| 里程碑 | 内容 | 验收标准 | 论文素材 | +|---|---|---|---| +| **M0 最小程序** | 单指数信号生成 + 10ns 直接采样 + 加噪声 + NLS 寿命拟合 | **理想无噪条件恢复设定寿命**(相对偏差 <10⁻⁶);加噪后多次运行分布合理 | 第一张拟合图;算法基准(对应原项目"偏差为零"验证) | +| **M1 光纤设计** | 可调光纤长度 + 延时/相位自动计算 + 四路采样点显示 | 名义四组得到 0/2.5/5.0/7.5ns 均匀相位;反向设计结果闭环正确(正向复算还原目标相位) | 长度/延时/相位表、相位圆图 | +| **M2 误差与校准** | 四通道基线/增益/延时误差注入 + 校准算法 + 时间重建 | 校准前后重建曲线与 τ̂ 偏差对比符合 §8-② 预期;误差注入-消除因果正确 | 校准前后对比图 | +| **M3 算法切换** | 对数线性 vs NLS 在相同数据上比较 | 三档 SNR 下两算法差异可稳定复现(§8-③) | 算法比较表与残差图 | +| **M4 统计分析** | 蒙特卡洛 + 参数扫描 + 置信区间 + 失败率 | 单通道 vs 四通道复现精度提升量级(§8-①);同种子逐位复现 | 蒙特卡洛分布图、扫描热图 | +| **M5 界面与导出** | 简单 GUI + 一键导出 | 论文全部图表可由程序重新生成;一次点击产出完整记录包 | 软件截图 | + +**完成 M0 后立即执行任务书"开始工作时先做什么"的检查**:四项前置工作(理解说明/框图、实验流程、最小程序、光纤长度表)全部具备后,再继续 M2 以后工作。 + +--- + +## 12. 测试与验证策略 + +| 层级 | 内容 | 断言示例 | +|---|---|---| +| 单元测试 | fiber.py 相位计算 | 名义四组延时 0/47.5/95/142.5ns → 余数 0/7.5/5.0/2.5 → 排序 0/2.5/5.0/7.5;1m ≈ 4.90ns | +| 基准测试 | 无噪理想数据拟合 | NLS 恢复真值,相对偏差 ≈ 0(数值容差内) | +| 复现性测试 | 固定种子 | 两次运行输出哈希一致 | +| 灵敏度测试 | 误差注入响应 | 强制等幅 → τ̂ 偏差增大;自由 A_k → 偏差归零(对应原项目误差机制表量级) | +| 回归测试 | 论文图表脚本 | `experiments/` 全部重跑成功,图表与已发布版本一致 | + +--- + +## 13. 硬件补充工作(模块级,不追求整机) + +按任务书第五节,**至少完成一项**并保存仪器、参数、原始数据和照片: + +| 可选项 | 产出 | 软件用途 | +|---|---|---| +| TIA 测试 | 增益、本底噪声、带宽 | 作为模拟前端默认参数 | +| 光纤 + 功率计 | 各通道插入损耗 | 作为通道增益系数 | +| FPGA 工程 | 用软件生成的 ADC 码流验证数据接收、阈值检测、缓存逻辑 | 逻辑仿真的真实激励 | +| 仅装置存档 | 实物照片 + 器件信息 | 论文"虚实结合"叙述(**不得宣称整机性能已验证**) | + +未完成的功能在论文中明确写成后续工作。 + +--- + +## 14. 边界与不做的事 + +- **不做**:整机恢复运行;真实教学效果数据(未试用前不编写学生成绩/问卷);复杂滤波与稳健拟合挤占三组核心比较; +- **不宣称**:2.5ns 为整机时间分辨率;仿真曲线为实测曲线;仿真精度等同硬件验证结果; +- **不引用**:原报告中找不到原始记录的数据。 + +--- + +## 15. 与论文的映射(论文编写主线) + +| 论文部分 | 主要内容 | 素材来源 | +|---|---|---| +| 教学问题 | 低采样率设备难以直观开展快速荧光衰减测量实验 | 原报告第 1 章 + 本文档 §2 | +| 实验原理 | 荧光衰减、光纤延时、ADC 采样、校准与寿命拟合 | 原报告 1、2 章 + `项目说明.md` §3 | +| 实验设计 | 统一任务、操作流程、可调参数、学生输出 | 本文档 §2–§3 | +| 软件实现 | 功能流程、参数设置、算法选择 | 本文档 §4–§9 + 实际代码 | +| 结果分析 | 相位、重建、算法比较、参数扫描、误差统计 | 记录包 + M0–M5 图表 | +| 虚实结合 | 现有装置说明 + 模块级真实参数 | §13 硬件记录 | +| 教学实施 | 实验学时、操作任务、评分、真实试用 | 学生实验指导材料(交付物 6) | +| 局限性 | 整机未跑通、仿真边界、进一步验证需求 | §14 + 实际情况 | + +建议论文题目(任务书建议):**基于光纤延时等效采样的荧光寿命虚拟仿真实验设计**。 + +--- + +## 附录 B:附加演示网站(非交付主线,可选) + +> **定位**:仅为方便交流和演示的附加产物,不进入任何里程碑,M5 完成后视余力实施。内容仅限已被记录包验证过的仿真案例,页面显著标注"仿真演示,非实测数据"。 + +- 域名:`https://chenxy.biboer.cn`(HTTPS 已配置,证书有效期至 2027-01-10;服务器 24.233.3.126,nginx 当前为 302 占位配置,实施时替换为站点 root); +- 推荐技术路线:**同一 `core/` 算法核心经 Pyodide 在浏览器运行**(Python 代码零重写,保算法一致性);备选:核心案例预计算为 JSON + 轻量 JS 页面; +- 内容:教学实验六步流程的交互式复刻(参数滑块 → 曲线/拟合实时更新),重点展示三组核心比较; +- 约束:不影响主线进度;所有演示参数与记录包对应;不承载任何"实测"表述。 + +--- + +*本文档基于《光纤延时等效采样教学实验后续工作说明.docx》与 `resources/` 两份原始材料整理(2026-10-12)。实施过程中如与任务书冲突,以任务书为准。* diff --git a/docs/项目说明.md b/docs/项目说明.md new file mode 100644 index 0000000..f020b71 --- /dev/null +++ b/docs/项目说明.md @@ -0,0 +1,318 @@ +# 项目说明:光纤延时等效采样教学实验 + +> 本文档是《光纤延时等效采样教学实验后续工作说明》**阶段一成果**(项目理解说明 + 简化系统框图)。 +> 面向第一次接触本项目的同学,阅读后应能不依赖原文讲清楚实验链路。 +> +> 原始材料(位于 `resources/`): +> - `研究报告.pdf` —— 2026 全国大学生物理实验竞赛(创新)自选题 1 正式研究报告(50 页,技术权威来源) +> - `闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf` —— 同项目答辩 PPT(30 页,可视化素材与部分补充数据) +> - `光纤延时等效采样教学实验后续工作说明.docx` —— 后续任务书(新项目的需求文档) + +--- + +## 1. 一句话概括 + +**原项目**已经用"四路不同长度光纤 + 单探测器 10ns 采样"实现了**光学时间交错采样**,把 10ns 采样间隔等效细分到 2.5ns,使荧光寿命估计的蒙特卡洛仿真精度从 7.65% 提升到 0.60%。 + +**新项目**不再复现整机,而是把这条最有教学价值的技术链提炼成**综合教学实验 + 可调参数仿真软件 + 教学论文**,核心目标是"让更多人能理解光学游标卡尺的原理"。 + +--- + +## 2. 背景与要解决的问题 + +### 2.1 为什么"测时间"而不只是"测功率" + +商用激光功率测量仪器多为"黑匣子":学生只能读到一个功率数值,看不到信号的时间演化。对纳秒级快速光信号(如荧光衰减 ~50ns 量级),传统教学仪器受限于: + +1. **ADC 采样率**:本项目高速支路采样间隔 10ns,一个 50ns 衰减过程只落约 5 个采样点,直接拟合极不稳定; +2. **探测器/前端带宽**:换更快的探测器,带宽越高噪声越大、电路设计难度陡增; +3. **成本**:高速 ADC、条纹相机等专业设备价格昂贵、功能封闭、体积大,不适合学生实验平台。 + +(来源:研究报告第 1 章、PPT 第 5–6、11 页"三条老路都走不通") + +### 2.2 荧光为什么是理想的"教学信号" + +YAG:Ce(钇铝石榴石掺铈)荧光粉由 450–470 nm 蓝光激发,发射 530–560 nm 荧光,**标称衰减时间约 52.8 ns**,与系统时间尺度匹配。它在项目中承担双重角色: + +- **时域标定源**:衰减曲线可重复、可拟合,寿命真值已知; +- **快速信号转换媒介**:把抽象的"纳秒级时间响应"转化为学生能直接观察的光强-时间曲线。 + +原项目在缺少脉冲激光器的条件下,用商用白光 LED + YAG:Ce 荧光粉构造等效瞬态光源(激发稳定后快速关断,记录衰减过程)。 + +(来源:研究报告 3.7 节、第 1.2 节图 1 荧光能级与衰减示意) + +--- + +## 3. 核心原理:光学游标卡尺 + +### 3.1 物理基础:光纤延时 + +光在折射率为 n_g 的石英光纤中传播,长度 L 对应延时: + +``` +δ = L · n_g / c L = δ · c / n_g +``` + +取 n_g = 1.468,得 c/n_g ≈ 20.42 cm/ns,即 **1 m 光纤产生约 4.90 ns 延时**。 + +### 3.2 游标细分设计 + +普通尺子最小刻度有限,引入已知偏移量的辅助刻度即可细分读数——同理,让同一光信号的四路副本经不同长度光纤后错时到达,即可细分采样间隔。 + +设单通道采样间隔 Δt = 10 ns,划分 N = 4 个相位位置,相邻相位错位: + +``` +Δt / N = 10 ns / 4 = 2.5 ns +``` + +三路非零延时通道采用逐级递推设计(S = 50 ns 为片段定位间隔,保证四段波形在时间轴上可分辨): + +``` +δk = k · (S − Δt/N) = 47.5k ns , k = 1, 2, 3 +``` + +| 通道 | 光纤长度 | 名义延时 | 对 10 ns 取余相位 | 按时间排序等效相位 | +|---|---|---|---|---| +| CH1(直通参考) | 0 m | 0 ns | 0 ns | **0 ns** | +| CH2 | 9.70 m | 47.5 ns | 7.5 ns | **2.5 ns** | +| CH3 | 19.40 m | 95.0 ns | 5.0 ns | **5.0 ns** | +| CH4 | 29.10 m | 142.5 ns | 2.5 ns | **7.5 ns** | + +四路合束后由同一探测链路以 10ns 间隔采样:**延时的整数部分(10ns 倍数)用于区分片段,小数相位(2.5ns 错位)补充主采样点之间的时间信息**。数据流程:通道分段 → 幅度归一化 → 时间归位(u = t − δk)→ 按四相位交错重排,形成 **2.5 ns 等效时间网格**。 + +(来源:研究报告 2.4 节、图 5;PPT 第 12、14 页示意图) + +### 3.3 数学模型 + +时间编码系统用线性观测模型描述: + +``` +y = H·x + n (或卷积形式 y(t) = x(t) * h(t)) +x:真实快速光信号 H:时间编码系统 y:观测数据 n:噪声 + +反演:x̂ = argmin ‖H x − y‖² + λ·R(x) (λ 为正则化参数) +``` + +**拟合模型必须保留每个峰的自由幅度 A_k 与自由位置 t_k**。这是原项目误差分析的命门(见 4.4 节)。 + +### 3.4 措辞红线(贯穿软件与论文) + +该方法提高的是**离散采样点的密度**(10ns → 2.5ns 等效时间网格),**不等同于**探测器、TIA 或 ADC 模拟带宽的提高。任何时候都**不能**把 2.5ns 表述为"整机时间分辨率"。 + +--- + +## 4. 原系统全貌 + +### 4.1 简化系统框图 + +原系统技术链四个衔接环节(闭环激发 → 荧光 → 光纤时间编码 → 反演拟合): + +```mermaid +flowchart TB + subgraph A["环节1:闭环激发(背景,不进入新实验主线)"] + A1[STM32 + PID 闭环] -->|"稳定可控的激发条件
响应12-15s,稳态误差<2%,超调<5%"| A2[半导体激光器 + PWM 驱动 10kHz] + A2 -->|"450-470nm 蓝光"| A3[YAG:Ce 荧光粉] + end + A3 -->|"关断激发后 530-560nm 荧光衰减
(≈50ns 量级,真值已知的瞬态信号)"| B + + subgraph B["环节2+3:光纤时间编码(新实验核心)"] + B1[1×4 分光] --> B2["四路光纤
0 / 9.70 / 19.40 / 29.10 m
延时 0 / 47.5 / 95.0 / 142.5 ns"] + B2 --> B3[合束] + B3 -->|"四个错开 2.5ns 相位的信号副本"| B4["Hamamatsu S5973 光电探测器
+ TIA 跨阻放大(AD825)"] + end + B4 --> C + + subgraph C["环节4:采集与反演(新实验核心)"] + C1["高速 ADC(10ns 采样间隔)"] --> C2["FPGA(ALINX Zynq XCZU9EG)
触发同步/数据缓存/通道分段"] + C2 --> C3["软件反演:延时标定 → 幅度归一化
→ 时间归位 → 交错重排 → 寿命拟合"] + end +``` + +新实验聚焦的简化链路(教学主线,学生应能独立画出): + +``` +荧光衰减信号 → 不同长度光纤产生延时 → 光电探测 + TIA → ADC 采样 +→ 通道校准 → 时间归位 → 波形重建 → 寿命拟合 → 误差分析 +``` + +### 4.2 主要硬件与器件 + +| 器件 | 型号/规格 | 职责 | +|---|---|---| +| 光电探测器 | Hamamatsu S5973(320–1000nm,1 GHz 截止频率@830nm/50Ω/3.3V 反偏) | 连续与瞬态光电转换 | +| 运放 | AD825 + 反馈电阻(约 0.2 V/μA) | TIA 跨阻放大 | +| 主控(慢支路) | STM32F103 + TFT 屏 | 功率计算、PID 闭环、显示 | +| 光谱仪 | 博源 BIM-6002A | 峰值波长读取 → 响应度 R(λ) 补偿 | +| 分束镜 | 1:1 透反比 | 探测支路 / 光谱支路功率分配 | +| 光纤组件 | 1×4 分光;0、9.70、19.40、29.10 m | 四路时间错位副本 | +| 采集(快支路) | 高速 ADC + ALINX Zynq XCZU9EG FPGA | 触发、缓存、通道切分、时间重构 | +| 等效瞬态光源 | YAG:Ce 荧光粉,标称衰减 ≈52.8 ns | 替代脉冲激光验证动态链路 | + +(来源:研究报告第 3 章、附录 A.1 表 9;实物照片见 PPT 第 16–19 页:机架式实验台、亚克力光纤绕线盘配 FC 连接器、XCZU9EG 芯片特写) + +### 4.3 PID 闭环(背景知识) + +增量式 PID(Kp=0.5, Ki=0.1, Kd=0.05)调节 10 kHz PWM 占空比实现恒功率输出。实测:开环功率波动 1.00 mW → 闭环 0.09 mW(**降低 91%**);阶跃响应 12–15 s、稳态误差 <2%、超调 <5%。闭环的作用是为时域测量提供稳定激发——激发不稳则荧光曲线抖动、标定失效。**新实验中仅作为背景了解,不进入主线。** + +(来源:研究报告 2.3.3、5.4.1–5.4.2 节、图 13) + +### 4.4 已完成的关键结果 + +**① 等效采样重构(报告 5.4.3、图 14)**:直通测量采样点稀疏,四通道归一化合并后点密度提高 4 倍,各段呈稳定下降趋势。 + +**② 蒙特卡洛重复测量(报告 5.4.4、图 15 + PPT 第 21 页)——项目招牌结果**: + +仿真真值:**τ₁ = 0.60 ns(权重 0.16)、τ₂ = 52.80 ns(权重 0.84)**,重复 200 次: + +| 方案 | τ₁ 拟合表现 | τ₂ 拟合标准差 | +|---|---|---| +| 单路 10ns 直接采样 | 散布 0.45–0.75 ns,明显偏离真值 | **7.65%** | +| 四路 2.5ns 等效采样 | 集中在 0.58–0.62 ns | **0.60%** | + +精度提升超过 10 倍。 + +**③ 采样点数与拟合偏差对比(PPT 第 23 页,报告正文无)——最佳教学案例**: + +| 方案 | 采样点数 | 记录窗口 | 拟合 τ₂ | 问题 | +|---|---|---|---|---| +| 直接采样 | 5 点 | 0–40 ns(仅 0.76τ,信号只衰减到初值 47%) | **56.66 ns** | 信息严重不足 | +| 光纤尺等效采样 | 41 点 | 0–400 ns | **53.18 ns** | 接近真值 | + +**④ 误差机制三表(PPT 第 24 页)——校准环节的理论依据**: + +| 误差机制 | 错误模型下的偏差 | 正确模型处理 | 偏差 | +|---|---|---|---| +| 通道权重失配 | 强制各峰等幅:失配 14% → 偏差 7.2% | 保留自由 A_k | → 0 | +| 延时标定误差 | 固定 t_k 为标称值:0.01ns → 0.019% | 保留自由 t_k | → 0 | +| 温度漂移 | 固定 A_k、t_k:可达 10⁻³ 量级 | 二者自由拟合 | → 0 | + +**⑤ 误差预算与 Fisher 信息矩阵修正(报告 5.4.5、图 16/17)**: + +原预算合成 `√(0.30²+0.30²+0.10²+0.08²+0.05²+0.034²+0.008²) ≈ 0.45%`——基线与线性度各 0.30% 主导;系统脉冲响应仅 0.034%,探头本身 0.0002%,**均非瓶颈**。 + +Fisher 分析条件:Δt=4ns、窗口 400ns(N=100)、SNR=50dB、系统响应 σ=1.373ns、四峰相邻幅度比 0.407、**11 个自由参数**(4 幅度 + 4 位置 + τ₂ + B₀ + B₁)。结论:基线项不是独立系统误差,而是**参数相关导致的统计方差放大**(下限 0.225% → 含基线参数 0.30%,仅增 0.07 个百分点);修正后总合成不确定度 **0.44%**。 + +**⑥ 实测重复性(PPT 第 26 页)**:0–190ns 每隔 10ns 测 4 组共 80 组:RMSE=0.00775、MAE=0.00737、最大相对误差 2.82%;4 次平均后 RMSE=0.00192(平均绝对相对误差 ≈0.21%)。 + +**⑦ FPGA 脉冲事件检测逻辑(报告 5.4.6、图 18)**:250MHz 逻辑时钟下 RTL 行为仿真验证阈值上穿检测(hit 单周期)、时间戳锁存(4 / 14)、峰值跟踪(160 / 130)。 + +**⑧ 其他实测**:TIA 标定 0–19μA 线性良好(个别点 ±8–10%,接近满量程时线性度下降);三波长功率测量 430/517/641nm 平均 9.848/10.329/9.631 mW(参考 9.87/10.36/9.63),合成不确定度 0.0262/0.0326/0.0255 mW。 + +--- + +## 5. 关键参数速查表(软件开发默认值来源) + +| 类别 | 参数 | 数值 | 来源 | +|---|---|---|---| +| 荧光 | 激发/发射波段 | 450–470 nm / 530–560 nm | 报告 3.7 | +| 荧光 | 标称衰减时间 | 52.8 ns | 器件标称 | +| 荧光 | **仿真基准预设** | I(t) = 0.16·e^(−t/0.60) + 0.84·e^(−t/52.80) | 报告 5.4.4 蒙特卡洛真值 | +| 荧光 | **实测参考预设** | τ₁ = 5.0 ns,τ₂ = 52.5 ns | 报告附图 A1 截图标注 | +| 荧光 | **单指数教学预设** | τ = 52.8 ns | 按器件标称 | +| 光纤 | 群折射率 n_g | 1.468(1m ≈ 4.90ns) | 报告 2.4.1 | +| 光纤 | 四路名义长度 | 0 / 9.70 / 19.40 / 29.10 m | 报告 2.4.2 | +| 光纤 | 名义延时 | 0 / 47.5 / 95.0 / 142.5 ns | 报告 2.4.2 | +| 光纤 | 等效相位 | 0 / 2.5 / 5.0 / 7.5 ns | 报告 2.4.2 | +| 采集 | 原始采样间隔 | 10 ns(高速 ADC) | 全文 | +| 采集 | 等效时间网格 | 2.5 ns | 全文 | +| 采集 | 记录窗口 | 正文 ≈0–200ns;图表/Fisher 为 400ns(N=100) | 见 §6 注意事项 | +| 前端 | 系统响应 σ | 1.373 ns(Fisher 条件) | 报告 5.4.5 | +| 前端 | TIA 增益 | ≈0.2 V/μA(AD825) | 报告 5.1 标定 | +| 统计 | 蒙特卡洛次数 | 200 | PPT 第 21 页 | +| 统计 | 信噪比条件 | SNR = 50 dB | 报告 5.4.5 | +| 误差 | 触发抖动与时基 | 0.10%;ADC 量化 0.008% | 报告表 8 | +| 数字逻辑 | FPGA 仿真时钟 | 250 MHz(4ns 周期) | 报告 3.6.1 | + +--- + +## 6. 原材料内部不一致与注意事项 + +软件与论文中必须**主动统一**以下参数矛盾,否则会被质疑: + +| # | 不一致点 | 事实 | 处理建议 | +|---|---|---|---| +| 1 | 快成分 τ₁ | PPT 第 22 页图顶标注 τ₁=5.0 ns,但同页公式为 `0.16·e^(−t/0.6)`(0.6 ns);报告附图 A1 实测截图也标 τ₁=5.0 ns | 0.6ns 是**仿真设定值**(算法基准验证),5.0ns 是**实测 YAG:Ce 拟合值**。软件做两套预设;论文明确区分 | +| 2 | 慢成分 τ₂ | 52.5(PPT 多数处、附图 A1)vs 52.8(器件标称、报告 5.4.4 真值、PPT 图下公式) | 仿真基准统一用 **52.8ns**;实测参考用 52.5ns | +| 3 | 记录窗口 | 报告正文"约 0–200ns" vs 图 14 / PPT 第 23 页 / Fisher 均为 **400ns** | 软件中做成可调参数;论文统计与 Fisher 部分按 400ns 表述 | +| 4 | Fisher 的 Δt=4ns | 与主链路 10ns/2.5ns 不同 | Fisher 分析的独立计算条件,引用时注明,勿混入等效采样叙述 | + +--- + +## 7. 配图索引(论文/软件素材清单) + +### 研究报告(18 图) + +| 图 | 内容要点 | 页 | +|---|---|---| +| 图 1 | 荧光能级跃迁(S0/S1、吸收/弛豫/发射)+ 单指数衰减曲线(I₀、τ、1/e 参考线) | 10 | +| 图 2 | S5973 参数图(1GHz 截止频率;S5973-02: 410nm 0.3A/W、QE 91%) | 13 | +| 图 3 | TIA 电路(光电二极管等效 Iph/Cd/Rsh + 运放 + Rf/Cf/Ccm/Cdiff) | 14 | +| 图 4 | 光栅光谱仪结构(狭缝→准直镜→光栅→聚焦镜→CCD) | 15 | +| 图 5 | **四通道延时与等效细分示意**(四路蓝脉冲错开 + 紫/绿/橙/蓝四色 2.5ns 网格) | 18 | +| 图 6 | 系统架构实物(机架式:左电路区/右光路区) | 20 | +| 图 7 | 光谱仪上位机界面(波长-强度曲线 + 数据列表) | 23 | +| 图 8 | STM32 实物(洞洞板 + 最小系统板) | 24 | +| 图 9 | Vivado 工程(综合/实现/bitstream 完成) | 25 | +| 图 10 | TIA 标定装置(黑 PCB、SMA×4、电位器×2) | 27 | +| 图 11 | TIA 标定曲线(线性子图 + 偏差柱状子图) | 30 | +| 图 12 | 三波长 10 次重复测量 | 33 | +| 图 13 | 闭环响应(开环橙/闭环蓝/目标 10mW 灰虚线;开环 8.5–11 震荡) | 37 | +| 图 14 | **直通 vs 四通道归一化对比**(左全局 + 右放大;蓝稀疏/橙密集/灰理论参考) | 38 | +| 图 15 | **蒙特卡洛 τ₁/τ₂ 散点**(真值 0.60/52.80ns 参考线) | 39 | +| 图 16/17 | Fisher 三维图(窗口×SNR→精度下限;B₀/B₁→精度增量) | 41 | +| 图 18 | RTL 仿真波形(sample_in 双脉冲/hit/timestamp 4→14/peak 160→130) | 42 | +| 附图 A1 | **实测归一化衰减 + 双指数拟合**(对数轴 10⁻³–10⁰;标注 τ₁=5.0、τ₂=52.5) | 49 | + +### PPT 补充素材 + +| 页 | 内容要点 | +|---|---| +| 7 | **设计思路流程图**(快速光信号→光学时间编码→较慢探测系统→离散采样→数字反演→恢复波形)——教学软件骨架 | +| 12 | 光纤尺示意(1×4 分光 + L0–L3 + 探测器 + ADC;四通道时序 2.5ns 错开) | +| 13 | 数学模型四卡片(y=Hx+n、卷积、正则化反演) | +| 14 | 单路 vs 四路采样脉冲示意(黑底四色) | +| 15 | 光路渲染图(激光→荧光样品→收集透镜→探测器)+ 荧光光谱/寿命曲线/材料试管 | +| 17–19 | 硬件照片:光纤绕线盘特写、ALINX 板 + XCZU9EG 芯片、装置全家福 | +| 21–26 | 数据分析全套:蒙特卡洛直方图(45–65ns)、标准拟合、5点/41点对比、误差机制表、误差预算条形图、80 组实测数据表 | + +--- + +## 8. 科研诚信红线(软件与论文必须内建) + +1. 所有数据必须标明来源类型:**理论计算 / 软件仿真 / 逻辑仿真 / 硬件实测**; +2. 软件生成的曲线**不能**写成装置实测曲线; +3. 原报告中找不到原始记录的数据不直接用于新论文; +4. 每次仿真保存**参数、随机种子、原始数据、算法版本、运行日期**; +5. **不能**把 2.5ns 等效采样网格表述为整机 2.5ns 时间分辨率; +6. 未进行真实教学试用时,不编写学生成绩、问卷或教学效果数据。 + +--- + +## 9. 新项目定位与交付物 + +**唯一主线**:理解原项目和物理问题 → 设计综合教学实验 → 用软件实现和验证实验思想 → 整理成论文。 + +**新核心问题**: + +> 在 ADC 采样率有限的条件下,能否通过改变光纤长度产生不同的采样相位,重建更密集的荧光衰减曲线,并提高荧光寿命估计的稳定性? + +**统一实验任务**:在采样周期 10ns 的条件下,对约 50ns 量级荧光衰减进行测量——先评价直接采样的局限,再通过调整四路光纤长度设计不同采样相位,完成校准、重建、寿命拟合和误差分析。 + +**最终交付**(对应任务书第十节): + +1. 本项目理解说明 + 简化系统框图(**本文档**); +2. 完整综合教学实验方案 + 软件实现方案(见 `docs/实现方案.md`); +3. 一套可调光纤长度和算法选择功能的仿真软件; +4. 可重复生成的原始数据、结果图和统计表; +5. 至少一项可追溯的真实硬件模块记录; +6. 学生实验指导内容; +7. 面向《实验科学与技术》的论文初稿。 + +**最终判断标准**(三个问题): +- 为什么需要光纤延时等效采样? +- 学生通过调节参数和比较算法能够学到什么? +- 论文中的每一项结果是否能够被重新生成和验证? + +--- + +*文档基于三份原始材料全文精读与全部 80 页配图的视觉分析整理(2026-10-12)。参数如有出入,以 `resources/研究报告.pdf` 原文为准。* diff --git a/研究报告.pdf b/resources/研究报告.pdf similarity index 100% rename from 研究报告.pdf rename to resources/研究报告.pdf diff --git a/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf b/resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf similarity index 100% rename from 闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf rename to resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf diff --git a/runit.sh b/runit.sh new file mode 120000 index 0000000..fa5b862 --- /dev/null +++ b/runit.sh @@ -0,0 +1 @@ +/Users/gavin/tools/runit.sh \ No newline at end of file diff --git a/todo.md b/todo.md index 244a7f3..be7b37b 100644 --- a/todo.md +++ b/todo.md @@ -14,3 +14,47 @@ 后续任务:将硬件核心原理提炼为教学实验,开发可调参数的仿真软件(支持调光纤长度、噪声、采样率等),并撰写教学论文。不追求恢复整机硬件,重点在"让更多人能理解这个光学游标卡尺的原理"。 +1. 做一个网站来展示。域名https://chenxy.biboer.cn。部署到web(ssh web)。域名已创建,如下: + +``` +gavin tools % ./dns.sh chenxy.biboer.cn + +[INFO] 模式: apply, 域名: chenxy.biboer.cn +[INFO] Zone: biboer.cn (10555bc8cf587e1572eb54d7533efda8) +[INFO] DNS 不存在,执行创建 +[INFO] DNS 已就绪: chenxy.biboer.cn -> 24.233.3.126 +[2026-10-12 13:38:49] [INFO] dns-https-302 开始: domain=chenxy.biboer.cn dry_run=false certbot_email= +[2026-10-12 13:38:49] [INFO] 已写入基础 nginx 配置: /etc/nginx/conf.d/chenxy.biboer.cn.conf +[2026-10-12 13:38:49] [INFO] nginx 基础配置已生效 +nginx: the configuration file /etc/nginx/nginx.conf syntax is ok +nginx: configuration file /etc/nginx/nginx.conf test is successful +Saving debug log to /var/log/letsencrypt/letsencrypt.log +Python 3.9 support will be dropped in the next planned release of Certbot - please upgrade your Python version. +Requesting a certificate for chenxy.biboer.cn + +Successfully received certificate. +Certificate is saved at: /etc/letsencrypt/live/chenxy.biboer.cn/fullchain.pem +Key is saved at: /etc/letsencrypt/live/chenxy.biboer.cn/privkey.pem +This certificate expires on 2027-01-10. +These files will be updated when the certificate renews. + +Deploying certificate +Successfully deployed certificate for chenxy.biboer.cn to /etc/nginx/conf.d/chenxy.biboer.cn.conf +Congratulations! You have successfully enabled HTTPS on https://chenxy.biboer.cn +NEXT STEPS: +- The certificate will need to be renewed before it expires. Certbot can automatically renew the certificate in the background, but you may need to take steps to enable that functionality. See https://certbot.org/renewal-setup for instructions. + +- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +If you like Certbot, please consider supporting our work by: + * Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate + * Donating to EFF: https://eff.org/donate-le +- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +[2026-10-12 13:39:07] [INFO] certbot 已执行完成: chenxy.biboer.cn +[2026-10-12 13:39:07] [INFO] 已写入最终 302 配置: /etc/nginx/conf.d/chenxy.biboer.cn.conf +nginx: the configuration file /etc/nginx/nginx.conf syntax is ok +nginx: configuration file /etc/nginx/nginx.conf test is successful +[2026-10-12 13:39:07] [INFO] nginx reload 完成 +[INFO] 云主机证书与 302 配置已完成 +[INFO] 完成。 +``` +