49-Error Budget Card Template v1.0 | Chapter 11 — Reporting Format & Visualization Standards

Home ／ Docs-Technical WhitePaper ／ 49-Error Budget Card Template v1.0

Chapter 11 — Reporting Format & Visualization Standards

I. Purpose & Scope

• Standardize the document structure, table fields, figure styles, and export formats for error budget and uncertainty results to ensure reproducibility, review, and release compliance across teams.
• When path quantities (arrival time/phase) are involved, explicitly show gamma(ell) and the measure d ell in text, and record delta_form ∈ {general, factored} in data/metadata; publication requires p_dim = 1.0.

II. Document Structure (publication version)

• Cover & metadata: title, version (SemVer), date, authors/reviewers, data time window, see[]/references[].
• Abstract & conclusion: one-line takeaway + key uncertainties/intervals; pass/fail/Restricted decision.
• Methods & conventions: propagation method (Delta/MC/Bootstrap), interval type and k/α/quantiles, correlation structure and parameters.
• Results & compliance: core metric tables, mapping to gate thresholds, check_dim_report summary, clock_state/τ_calib.
• Figures & appendices: dashboard, metric plots, sensitivity & power plots, machine-readable file list with hashes/signature.

III. Table Standards

• Error budget table (publication)
  Fields: source, symbol, unit, type(A/B), estimate, distribution, correlation, gate, see[].
• Uncertainty & interval table
  Fields: target, point, lower, upper, unit, method(delta/mc/bootstrap), coverage(k/α/quantile), notes.
• Compliance table
  Fields: metric, point, interval_or_band, gate, threshold, decision(pass/fail/restricted), notes.
• Typesetting: snake_case headers; separate columns for units/dimensions; scientific notation with 3–4 significant digits; decimal point ..

IV. Figure Standards (minimum set)

1. Dashboard:
   • ΔT_arr distribution (hist/KDE)
   • r_phi bar with confidence/quantile intervals
   • ε_flux boxplot with conservation guard line
   • Q_res trend (over time/records)
   • p_dim gauge (=1 required)
2. Agreement & residuals: residual-vs-fitted and Bland–Altman; phase scatter Phi_obs vs Phi_ref (with y=x and interval band).
3. Path & geometry: n_eff(ell) vs ell profile; caption must state Δell and delta_form; occlusions/boundaries shown via mask layer.
4. Sensitivity & power: Sobol bar/stacked plots, Morris μ–σ plane, incremental power curves (vs N_eff).
5. Export formats: export both PDF/SVG (vector) and PNG (bitmap) for each figure; DPI ≥ 300; axes show explicit units (s, rad, 1); captions include see[]/version.

V. Typesetting & Symbols

• Section headings in bold Roman numerals; bullets with “- space”; ordered lists with “1. space”.
• Wrap inline symbols in backticks (e.g., T_arr, Phi, n_eff, c_ref); any division/integral/composite operator must use parentheses.
• Forbid bare c, T, n; use c_ref, T_arr (or specific quantity), n_eff (or n with explicit unit); T_fil ≠ T_trans, n ≠ n_eff.
• Formulas, symbols, and definitions must use international notation (no Chinese); units/dimensions use SI symbols.

VI. Compliance & Audit

• Dimensions & citations: attach check_dim_report.json; see[]/references[] use “volume + version + anchor (P/S/M/I)”, anchor coverage ≥ 90%, no external links/aliases.
• Gate mapping: Results page shows decisions vs τ_T / r_phi_min / ε_flux guard / Q_res band; unmet items tagged [Restricted].
• Audit trail: audit.jsonl records random seed, B, kernel parameters, estimator & version, generation time, and file hashes.

VII. Results Page (Markdown skeleton)

# 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 Templates

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 (publication)

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-References

• Propagation & intervals: Ch. 6 and Ch. 8.
• Correlation & power: Ch. 5 and Ch. 7.
• Threshold mapping & decisions: Ch. 9.
• Appendix templates: Ch. 12.

XI. Checklist

• Document complete: methods, results, compliance, figures, and export list.
• For path quantities, explicit gamma(ell)/d ell; delta_form recorded; p_dim = 1.0.
• Core table trio generated: error_budget.csv, uncertainty_intervals.csv, compliance_table.csv.
• Dual figure exports (PDF/SVG and PNG), with units and coverage levels labeled.
• check_dim_report.json and audit.jsonl updated; see[]/references[]/version compliant with anchor coverage ≥ 90%.
• If [Restricted], all figures tagged and triggers listed; publish qualitative results & diagnostics only.