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

237 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# FIGMA 设计指导:光纤延时等效采样 · 教学实验仿真软件
> 本文档是给 Figma make(AI 设计助手)的**输入指导**:只描述「功能、参数、动作、UI 元素类型」,
> **布局、分页、配色、视觉风格由 Figma 自行分析设计**。
>
> 项目背景一句话:把「四路光纤延时等效采样」的光学原理做成教学实验仿真软件 —— 调节参数,
> 观察采样相位、重建曲线与荧光寿命估计的连续变化,理解「低采样率 ADC + 光学游标卡尺」的测量原理。
---
## 0. 全局设计约束(所有页面通用)
| 约束 | 说明 |
|---|---|
| 语言 | 界面文字一律简体中文;专业术语可中英并注(如 荧光寿命 τ₂ / ns) |
| 诚信标注 | 页面显著位置常驻徽标「仿真演示 · 非实测数据」,不可遗漏 |
| 单位 | 时间一律 ns;长度 m;信噪比 dB;ADC 位数 bit |
| 状态反馈 | 计算中需有加载态;失败需有错误提示条;成功需在结果区给出摘要文本 |
| 数字精度 | 寿命 τ 显示 3 位小数;百分比显示 2 位小数;相位显示 2 位小数 |
| 图 | 折线图/散点图需带图例、坐标轴标签(含单位);热图需色标说明 |
CG:
1. 自适应布局,适合PC和手机。
1. 图,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 可自行发挥,仅列需要表达的信息)
| 元素 | 建议 |
|---|---|
| 应用名 | 光纤延时等效采样 · 实验仿真|
| 徽标 | 「仿真演示 · 非实测数据」(不可省略,放标题旁) |