Files
chenproject/figma-design.md
2026-10-12 18:55:48 +08:00

10 KiB
Raw Permalink Blame History

FIGMA 设计指导:光纤延时等效采样 · 教学实验仿真软件

本文档是给 Figma make(AI 设计助手)的输入指导:只描述「功能、参数、动作、UI 元素类型」, 布局、分页、配色、视觉风格由 Figma 自行分析设计。

项目背景一句话:把「四路光纤延时等效采样」的光学原理做成教学实验仿真软件 —— 调节参数, 观察采样相位、重建曲线与荧光寿命估计的连续变化,理解「低采样率 ADC + 光学游标卡尺」的测量原理。


0. 全局设计约束(所有页面通用)

约束 说明
语言 界面文字一律简体中文;专业术语可中英并注(如 荧光寿命 τ₂ / ns)
诚信标注 页面显著位置常驻徽标「仿真演示 · 非实测数据」,不可遗漏
单位 时间一律 ns;长度 m;信噪比 dB;ADC 位数 bit
状态反馈 计算中需有加载态;失败需有错误提示条;成功需在结果区给出摘要文本
数字精度 寿命 τ 显示 3 位小数;百分比显示 2 位小数;相位显示 2 位小数
图 折线图/散点图需带图例、坐标轴标签(含单位);热图需色标说明

CG:

  1. 自适应布局,适合PC和手机。
  2. 图,xy坐标轴按实际显示内容适配。

1. 页面总览

# 页面名 一句话功能
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 输出元素

  • 文本:导出状态(成功/失败 + 路径)
  • 文本:导出内容清单(列出文件名)

8. 品牌与图标建议(Figma 可自行发挥,仅列需要表达的信息)

元素 建议
应用名 光纤延时等效采样 · 实验仿真
徽标 「仿真演示 · 非实测数据」(不可省略,放标题旁)