49-误差预算卡 Template v1.0 | 第11章 报告格式与可视化规范

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

第11章 报告格式与可视化规范

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

• 统一误差预算与不确定度结果的文档结构、表格字段、图表样式与导出形态，确保跨团队复现、审校与发布合规。
• 涉及路径量（到达时/相位）时，正文显式 gamma(ell) 与测度 d ell，并在数据/元数据记录 delta_form ∈ {general, factored}；发布要求 p_dim = 1.0。

II. 文档结构（Document Structure，发布版）

• 封面与元信息：标题、版本（SemVer）、时间、作者/审校、数据时间窗、see[]/references[]。
• 摘要与结论：一句话结论 + 关键不确定度/区间；阳性/阴性/限制模式判定。
• 方法与口径：传播方法（Δ/MC/自举）、区间类型与 k/α/分位、相关结构与参数。
• 结果与合规：核心指标表、与质量门阈值对照、check_dim_report 摘要、clock_state/τ_calib。
• 图表与附录：总览板、指标图、敏感度与功效图、机读文件清单与哈希/签名。

III. 表格规范（Tables）

• 误差预算表（发布版）
  字段：source, symbol, unit, type(A/B), estimate, distribution, correlation, gate, see[]。
• 不确定度与区间表
  字段：target, point, lower, upper, unit, method(delta/mc/bootstrap), coverage(k/α/quantile), notes。
• 合规对照表
  字段：metric, point, interval_or_band, gate, threshold, decision(pass/fail/restricted), notes。
• 排版约定：字段名用蛇形；单位/量纲单列；数值采用科学计数法，默认 3–4 有效数字；小数点统一“.”。

IV. 图形规范（Figures，最小集合）

1. 总览板（Dashboard）：
   • ΔT_arr 分布（直方/核密度）
   • r_phi 柱状 + 置信/分位区间
   • ε_flux 箱线 + 守恒阈值线
   • Q_res 趋势图（随时间/记录）
   • p_dim 仪表（=1 要求）
2. 一致性/残差：残差–拟合图、Bland–Altman 图；相位散点 Phi_obs vs Phi_ref（含 y=x 与区间带）。
3. 路径与几何：n_eff(ell)–ell 剖面；图注注明 Δell 与 delta_form；遮挡/边界用掩膜层。
4. 灵敏度与功效：Sobol 条形/堆叠图、Morris μ–σ 平面、增量功效曲线（随 N_eff）。
5. 导出格式：每张图同时导出 PDF/SVG（矢量）与 PNG（位图）；DPI≥300；坐标轴显式单位（s, rad, 1），图注含 see[]/version。

V. 文字与符号（Typesetting）

• 小节标题用罗马数字并加粗；项目符号用“- 空格”；编号列表用“1. 空格”。
• 内联符号一律用反引号（如 T_arr、Phi、n_eff、c_ref）；含除号/积分/复合算符强制加括号。
• 禁止裸用 c、T、n；分别使用 c_ref、T_arr（或具体量名）、n_eff（或 n 且明示单位）；T_fil ≠ T_trans、n ≠ n_eff。
• 公式、符号、定义禁用中文，单位/量纲采用国际符号。

VI. 合规与审计（Compliance & Audit）

• 维度与引用：check_dim_report.json 必附；see[]/references[] 采用“卷名 + 版本 + 锚点（P/S/M/I）”，锚点直指率 ≥ 90%，无外链/别名。
• 质量门映射：结果页同步展示与 τ_T / r_phi_min / ε_flux guard / Q_res band 的判定；未满足项按 [Restricted] 标注。
• 审计轨迹：audit.jsonl 记录随机种子 seed、B、核参数、估计器与版本、生成时间与文件哈希。

VII. 示例页（Results Page，Markdown 骨架）

# Error Budget — v1.0.0

## I. Summary

- One-liner; key intervals (T_arr, r_phi, ε_flux, Q_res, p_dim) and decisions.

## II. Methods & Coverage

- Delta/MC/Bootstrap; interval type & k/α/quantile; correlation: exp(L_c=25 m); delta_form=general.

## III. Results & Gates

- Table: targets with point ±U(k) / quantile bands.

- Compliance block: check_dim OK; anchor_coverage=0.93; clock_state=locked; tau_calib OK.

## IV. Figures

- Dashboard; residual & BA plots; path profile with Δell; sensitivity & power curves.

## V. Exports

- Files: error_budget.csv, uncertainty.md, check_dim_report.json, figs/*.pdf|png, audit.jsonl

VIII. 机读模板（Machine-Readable）

A. report_manifest.yaml

version: "1.0.0"

bundle:

tables:

- "tables/error_budget.csv"

- "tables/uncertainty_intervals.csv"

- "tables/compliance_table.csv"

figures:

- "figs/dashboard.pdf"

- "figs/residual_ba.pdf"

- "figs/path_profile.svg"

- "figs/sobol_bar.pdf"

reports:

- "reports/check_dim_report.json"

- "reports/audit.jsonl"

metadata:

dataset_id: "ptn-demo"

method_version: "2.0.0"

anchor_coverage_min: 0.90

see:

- "EFT.WP.Core.Equations v1.1:S20-1"

- "EFT.WP.Core.Metrology v1.0:check_dim"

B. uncertainty_intervals.csv（发布表）

target,point,lower,upper,unit,method,coverage,notes

T_arr,1.23e-8,9.9e-9,1.47e-8,s,delta,"k=2 (95%)","Σ from exp kernel; delta_form=general"

Phi,0.035,0.028,0.043,rad,mc,"quantile [2.5,97.5]%","B=10000; aligned window"

r_phi,0.72,0.61,0.80,1,bootstrap,"Fisher-z 95%","stratified by device"

IX. 发布与目录结构（Release & Layout）

PTN_EXPORT/

manifest.yaml

tables/

error_budget.csv

uncertainty_intervals.csv

compliance_table.csv

figs/

dashboard.pdf

residual_ba.pdf

path_profile.svg

sobol_bar.pdf

reports/

check_dim_report.json

audit.jsonl

results.md

SIGNATURE.asc

X. 与其它章节衔接（Cross-Refs）

• 传播与区间：见第6章、第8章；
• 相关结构与功效：见第5章、第7章；
• 阈值映射与判定：见第9章；
• 附录模板：见第12章。

XI. 执行勾选清单（Checklist）

• 文档结构完整：方法、结果、合规、图表与导出清单齐备。
• 路径量显式 gamma(ell)、d ell；delta_form 已记录；p_dim = 1.0。
• 核心表格三件套：error_budget.csv、uncertainty_intervals.csv、compliance_table.csv 已生成。
• 图表双份导出（PDF/SVG 与 PNG），轴单位与覆盖水平标注清晰。
• check_dim_report.json 与 audit.jsonl 已更新；see[]/references[]/version 合规且锚点直指率 ≥ 90%。
• 若处于 [Restricted]，所有图表标题已追加标签并列出触发项，仅发布定性结果与诊断图。