# 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 查看网页版本的功能对照(布局仅供参考)。