11 KiB
11 KiB
FIGMA 设计指导:光纤延时等效采样 · 教学实验仿真软件
本文档是给 Figma make(AI 设计助手)的输入指导:只描述「功能、参数、动作、UI 元素类型」, 布局、分页、配色、视觉风格由 Figma 自行分析设计。
项目背景一句话:把「四路光纤延时等效采样」的光学原理做成教学实验仿真软件 —— 学生调节参数, 观察采样相位、重建曲线与荧光寿命估计的连续变化,理解「低采样率 ADC + 光学游标卡尺」的测量原理。
参考运行中界面(当前实现,仅作功能参考,布局可完全重新设计):
- 桌面 GUI:
python -m fiber_delay_sim.gui(tkinter 六页签)- 网页版:https://chenxy.biboer.cn
0. 全局设计约束(所有页面通用)
| 约束 | 说明 |
|---|---|
| 语言 | 界面文字一律简体中文;专业术语可中英并注(如 荧光寿命 τ₂ / ns) |
| 诚信标注 | 页面显著位置常驻徽标「仿真演示 · 非实测数据」,不可遗漏 |
| 单位 | 时间一律 ns;长度 m;信噪比 dB;ADC 位数 bit |
| 一致性 | 同一含义控件全站统一命名与图标(如「运行」按钮、「重新采样 ↻」) |
| 状态反馈 | 计算中需有加载态;失败需有错误提示条;成功需在结果区给出摘要文本 |
| 数字精度 | 寿命 τ 显示 3 位小数;百分比显示 2 位小数;相位显示 2 位小数 |
| 图 | 折线图/散点图需带图例、坐标轴标签(含单位);热图需色标说明 |
1. 页面总览(共 6 个页面,导航可任意形式:页签/侧栏/顶栏)
| # | 页面名 | 一句话功能 |
|---|---|---|
| 1 | 参数与方案 | 设置荧光/ADC/光纤参数,查看采样网格设计结果 |
| 2 | 原始采样 | 生成理想波形,模拟单通道/四通道采样 |
| 3 | 校准与重建 | 注入通道误差,比较校准前后重建曲线 |
| 4 | 拟合与比较 | 切换拟合算法,比较算法在相同数据上的表现 |
| 5 | 参数扫描 | 扫描噪声/窗口等参数,查看稳定性趋势 |
| 6 | 结果导出 | 一键导出当前会话为可复现记录包 |
2. 页面 1:参数与方案
2.1 功能
设置荧光衰减、ADC 采样、光纤参数;软件自动计算光纤传播延时、等效采样相位与均匀性, 帮助学生理解「光纤长度 → 延时 → 相位 → 等效采样网格」的链路。
2.2 输入参数(控件类型 → 元素类型)
| 参数 | 含义 | 类型 | 默认 | 范围 |
|---|---|---|---|---|
| 荧光寿命 τ₂ | 慢成分荧光寿命 | 滑块 + 数字输入框 | 52.8 ns | 10–100 ns,步长 0.5 |
| 采样间隔 Δt | ADC 采样间隔 | 数字输入框 | 10.0 ns | 2–50 ns |
| 群折射率 n_g | 光纤群折射率 | 滑块 + 数字输入框 | 1.468 | 1.44–1.50,步长 0.001 |
| 光纤长度 L0–L3 | 四路光纤长度(可增减路数 2/3/4) | 数字输入框 × 4 | 0 / 9.7 / 19.4 / 29.1 m | 0–200 m,步长 0.1 |
2.3 动作(按钮 + 触发行为)
| 按钮 | 行为 |
|---|---|
| 运行 | 根据当前参数重算延时/相位/网格,刷新图表与表格 |
| 正向计算 | 由光纤长度 → 输出延时/相位(默认) |
| 反向设计 | 由目标相位(0 / 2.5 / 5 / 7.5 ns)→ 输出候选光纤长度 |
| 复制参数 | 一键复制当前参数为 JSON(可粘贴到结果导出页) |
2.4 输出(元素类型)
- 文本区:等效采样网格摘要,如「0 / 2.5 / 5.0 / 7.5 ns(理想步长 2.5 ns,最大间隔偏差 5.4e-3)」
- 表格:四通道参数表 —— 通道号 / 光纤长度 (m) / 传播延时 (ns) / 采样相位 (ns)
- 表格:反向设计候选表 —— 目标相位 (ns) / 通道序 k / 延时 (ns) / 光纤长度 (m)
- 图:延时–相位散点图(每个通道一个点,标注通道号与相位值)
2.5 提示信息
- 当输入相位非均匀网格时给出警告建议「建议使用均匀网格 j·Δt/N」
- 每次计算后给出结果摘要文本
3. 页面 2:原始采样
3.1 功能
生成理想荧光衰减波形,模拟单通道直接采样与四通道等效采样,让学生直观看到 「10 ns 采样点数不足」与「四相位补点」的差异。
3.2 输入参数
| 参数 | 含义 | 类型 | 默认 | 范围 |
|---|---|---|---|---|
| 信噪比 SNR | 加性高斯噪声 | 滑块 + 数值 | 50 dB | 20–80 dB,步长 1 |
| ADC 位数 | 量化位深 | 下拉选择 | 12 bit | 8 / 10 / 12 / 14 |
| 记录窗口 | 采样时长 | 下拉选择 | 400 ns | 40(≈0.76τ)/ 100 / 200 / 400 ns |
| 理想无噪 | 是否加噪声/量化 | 复选框 | 关 | — |
| 随机种子 | 噪声复现性 | 数字显示 + 「重新采样」触发变化 | 42 | 正整数 |
3.3 动作
- 重新采样 ↻:以当前参数(新种子)重新生成采样点并刷新图表
3.4 输出元素
- 图:时间–强度折线图(双坐标系可选)
- 序列 1:理想连续信号(真值)——折线
- 序列 2:10 ns 直接采样点——散点
- 序列 3:四通道采样点(按等效时间拼合)——异色散点
- 文本指标卡 × 3:单通道采样点数(默认 40)/ 四通道总点数(默认 160)/ 当前随机种子
- 文本提示:如「窗口 40 ns 时信号仅衰减到初值 47% —— 采样点数不足」
3.5 失败/提示
- 无
4. 页面 3:校准与重建
4.1 功能
向四通道注入「增益失配 / 延时误差 / 基线偏置」三类硬件误差,让学生对比 「不校准 / 基线+增益校准 / 完整校准」三种处理的曲线连续度与寿命拟合,理解校准的价值。
4.2 输入项
| 参数 | 含义 | 类型 | 默认 | 范围 |
|---|---|---|---|---|
| 通道增益失配 | 四路增益偏离比例 | 滑块 + 数字 | 1.0 | 0–1.5,步长 0.05 |
| 延时误差 | 四路传播延时误差幅度 | 滑块 + 数字 | 1.0 ns | 0–2 ns,步长 0.1 |
| 基线偏置 | 四路基线偏离幅度 | 滑块 + 数字 | 1.0 | 0–2,步长 0.1 |
| SNR | 采集噪声 | 滑块 + 数字 | 50 dB | 20–70 dB,步长 1 |
(上述三个「幅度」参数缩放预设的 4 通道误差向量:CH1 为参考无误差,CH2–4 有差异)
4.3 动作
- 运行校准对比:注入误差 → 计算三种方案结果 → 刷新图与表格
4.4 输出元素
- 图:时间–强度对比图(叠加 4 条曲线,同一时间轴)
- 理论真值 I(t):深色细折线(参考线)
- 不校准重建:散点(暖色)
- 基线+增益校准重建:散点(暗色)
- 完整校准重建:散点(蓝色)
- 表格:方案对比表 —— 方案 / τ̂ (ns) / 相对偏差 / 有效点数 / 连续度 mean_jump
- 提示文本(教学点):如「校准显著降低通道断层;延时常数错位不改变单指数 τ(被幅度自由度吸收)——教学点」
5. 页面 4:拟合与比较
5.1 功能
在完全相同的采样数据上切换拟合算法(非线性最小二乘 NLS、对数线性、稳健拟合), 比较偏差与曲线,让学生观察到对数变换对低幅值尾部噪声的放大。
5.2 输入项
| 参数 | 含义 | 类型 | 默认 | 范围 |
|---|---|---|---|---|
| SNR | 信噪比 | 滑块 + 数字 | 50 dB | 20–70 dB,步长 1 |
| 随机种子 | 数据复现 | 数字 + 「重新采样」按钮 | 42 | 正整数 |
5.3 动作
- 重新采样 ↻:同数据不同噪声重生成
- 算法选择:多选开关(checkbox chips)—— 可选:NLS / 对数线性 / 稳健拟合(默认全开)
5.4 输出元素
- 图:时间–强度(对数纵轴可选)对比图
- 采样数据:散点
- 真值曲线:细线
- 各算法拟合曲线:不同颜色折线/虚线
- 表格:算法对比 —— 算法名 / τ̂ (ns) / 相对偏差 / 估计基线 B / 剔点数
- 文本提示:说明性结论(如「对数线性在估基线下的系统偏差;低幅值尾部经对数变换后噪声权重被放大」)
6. 页面 5:参数扫描
6.1 功能
批量扫描(记录窗口 × SNR)蒙特卡洛,绘制稳定性趋势,让学生看到 「采样点数不足时等效采样的收益最大」,对应原项目 7.65% → 0.60% 量级。
6.2 输入项
| 参数 | 含义 | 类型 | 默认 | 范围 |
|---|---|---|---|---|
| SNR | 扫描的固定信噪比 | 滑块 + 数字 | 50 dB | 25–80 dB |
| 重复次数 | 蒙特卡洛次数 | 数字输入框 | 40 | 10–200 |
| 随机种子 | 复现性 | 数字 | 42 | 正整数 |
| 窗口扫描范围 | 预置几组窗口 | 多选 chips | 200/300/400 ns | 100/150/200/300/400 |
6.3 动作
- 运行扫描:启动蒙特卡洛,给出加载进度;完成后刷新图与表格
6.4 输出元素
- 图 1(主图):折线图 —— 横轴窗口 (ns),纵轴 τ₂ 相对标准差 (%)(对数坐标可选)
- 序列:单通道 vs 四相位等效
- 图 2(辅助,可选):SNR×窗口 提升比热力图(色标:提升比,对数刻度)
- 表格:扫描结果 —— 窗口 / 单通道 σ/τ / 四相位 σ/τ / 提升比 / 失败率
- 文本结论卡:如「SNR 30 dB、窗口 300 ns:单通道 92.8% → 四相位 3.1%(提升 27 倍,失败率 67.5%→15%)」
6.5 状态
- 运行时显示加载进度条或百分比
- 大扫描完成后给出「浏览器计算完成,与本地 CLI 结果一致」提示
7. 页面 6:结果导出
7.1 功能
一键将当前会话全部内容(参数、数据、图表、运行信息)导出为可复现记录包, 供论文图表重新生成与实验复现。
7.2 输入项
| 页 | 含义 | 类型 | 默认 |
|---|---|---|---|
| 记录名(备注) | 可选给本次导出加备注 | 文本框 | 空 |
| 导出位置 | 记录包存储目录 | 路径选择器/默认 runs/ | runs/ |
7.3 动作
- 一键导出记录包:生成目录
<时间戳>-m5_gui_session/,包含:session.json(全部参数 + 各页结果)meta.json(数据来源标注 software-simulated、时间、种子)page5_scan.csv(若执行过扫描)figures/(各页 PNG + SVG)README.md(导出说明)
- 复制路径:将导出目录完整路径复制到剪贴板
7.4 输出元素
- 文本:导出状态(成功/失败 + 路径)
- 文本:导出内容清单(列出文件名)
7.5 诚信
- 导出文件中必须包含
data_origin: "software-simulated"字段,界面展示不可变。
8. 品牌与图标建议(Figma 可自行发挥,仅列需要表达的信息)
| 元素 | 建议 |
|---|---|
| 应用名 | 光纤延时等效采样 · 教学实验 |
| 徽标 | 「仿真演示 · 非实测数据」(不可省略,放标题旁) |
| 图标 | 运行(播放/箭头)、重新采样(环形箭头 ↻)、复制(两张叠纸)、导出(向下保存)、信息(i)、警示(!) |
| 数值单位 | ns / dB / bit / m 常规小号标注 |
9. 免责与一致性
- 本文档描述的「功能 / 参数 / 动作 / 元素类型」为最终需求;布局、分页、配色、圆角、 动效等视觉实现由 Figma 自由发挥,但不得移除专业标注(仿真徽标、单位、图例)。
- 如需运行参考实现(当前 tkinter GUI 或网页),可在项目目录执行
python -m fiber_delay_sim.gui或访问 https://chenxy.biboer.cn 查看网页版本的功能对照(布局仅供参考)。