49-误差预算卡 Template v1.0 | 第0章 前言与使用说明

目录 ／ 文档-技术白皮书 ／ 49-误差预算卡 Template v1.0

第0章 前言与使用说明

I. 目的与范围（Purpose & Scope）

• 定义本卡用于协议级误差源识别、传播与不确定度报告的统一规范，支撑运行态审校、结果发布与对比评分。
• 适用：timing / imaging / spectral / mixed；相干窗内近轴小角、缓变介质；与 PTN Template v1.0、实验协议卡 Template v1.0 对齐。
• 非适用：超出相干窗的强非线性/强色散/全波耦合场景（进入 [Restricted] 仅发布定性结论）。

II. 读者与适用域（Audience & Applicability）

• 对象：实验/观测负责人、计量与数据治理、审校与发布负责人。
• 适用域：到达时 T_arr、相位 Phi、守恒误差 ε_flux、质量守恒偏差 ΔM、稳健残差 Q_res 等指标的误差预算与区间报告。
• 前置：clock_state=locked、|ts_start − calib.timestamp| ≤ τ_calib、p_dim=1.0、len(path)≥2。

III. 引用与版本策略（Citations & Versioning）

• 固定写法：见《<卷名> vX.Y》<章节> <锚点>；优先直指 P/S/M/I。
• 稳定线：对外仅引用 v1.*；如引用 v0.*，在正文显著标注“草案/非承诺”。
• 文内与数据侧 see[]/references[] 保持一致，锚点直指率 ≥ 90%，禁止外链与别名。

IV. 统一口径示例（Normative Forms，可直接复用）

• 到达时（两种等价口径）：
  T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
  T_arr = ( ∫ ( n_eff / c_ref ) d ell )
• 相位累计：
  Phi = ( 2π / λ_ref ) * ( ∫ n_eff d ell )
• 要求：正文显式路径 gamma(ell) 与测度 d ell，并在数据/元数据记录 delta_form ∈ {general, factored}；n_eff 无量纲，c_ref 单位 m/s，T_arr 单位 s，Phi 单位 rad。
• 量纲闭合：导出随附 check_dim_report.json。

V. 文档结构与产出（Structure & Deliverables）

• 章节骨架：目的与范围 → 输入与前置 → 方法与口径（Δ法/MC/自举）→ 结果与核对 → 合规与停止 → 产出与导出 → 引用。
• 必交付机读件：error_budget.csv、uncertainty.md、check_dim_report.json、（如适用）uncertainty.yaml。
• 表格口径：误差源以 source, symbol, unit, type(A/B), estimate, distribution, correlation, note, see[] 报告。

VI. 依赖与交叉引用（Dependencies & Cross-Refs）

• 计量与控制式：见《EFT.WP.Core.Metrology v1.0》check_dim；见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1/S21-2。
• 协议衔接：见《PTN Template v1.0》Ch.7/Ch.9/Ch.11；见《实验协议卡 Template v1.0》Ch.5/Ch.7/Ch.9/Ch.11。
• 数据契约：见《EFT.WP.Core.DataSpec v1.0》TARR（字段、单位与导出）。

VII. 执行勾选清单（Pre-Flight Checklist）

• 文内与数据侧 see[]/references[] 采用“卷名 + 版本 + 锚点”，锚点直指率 ≥ 90%。
• 路径型表达显式 gamma(ell) 与 d ell，并记录 delta_form；len(path) ≥ 2。
• p_dim = 1.0，clock_state=locked，|ts_start − calib.timestamp| ≤ τ_calib。
• 到达时/相位按统一口径；error_budget.csv / uncertainty.md / check_dim_report.json 准备完毕。
• 禁止裸用 c、T、n；使用 c_ref、T_arr（或具体量名）、n_eff（或 n 且明示单位）；不混用 T_fil/T_trans 与 n/n_eff。
• 若处于 [Restricted]，仅发布定性区间与诊断图，并在全部图表标题追加标签 [Restricted]。