54-Reproducibility Checklist Template v1.0 | Chapter 2 — Terms & Symbols (Reproduction Minimal Set)

Home ／ Docs-Technical WhitePaper ／ 54-Reproducibility Checklist Template v1.0

Chapter 2 — Terms & Symbols (Reproduction Minimal Set)

I. Purpose & Scope

• Provide the minimal term set and unified symbols/units/dimensions required for reproducible experiments across environment lock, data snapshot, training/inference, evaluation, and release.
• For path quantities (arrival time/phase), explicitly show gamma(ell) and the measure d ell in text; record delta_form ∈ {general, factored} on the data side; parenthesize all expressions; publication requires p_dim = 1.0 with check_dim_report.json.

II. Terms

• MRB (Minimal Reproducible Bundle): the minimal reproducible package.
• env lock: environment lock (HW/OS/driver/container/framework/clock source).
• data snapshot: data freeze (provenance, Schema, Splits, checksums, license).
• weights manifest: weights/params manifest (version/signature/freshness policy).
• coverage: interval convention, choose one: k / alpha / quantile.
• gate / stop: quality gates and stop conditions (G1–G8 / S1–S5).
• lineage DAG: lineage graph (nodes/edges carry version/checksum).
• idempotency key: key to ensure equivalence on repeated commands/API calls.

III. Symbols (minimal)

• Data & model: x (input), y (target), f_θ(x) (model), θ (parameters), L (loss).
• Evaluation & quality: ACC, AUC, MAE, RMSE, Q_res (robust residual), Latency_P95, Throughput.
• Uncertainty & covariance: u(x) (standard uncertainty), u_c (combined standard uncertainty), U = k·u_c (expanded uncertainty), Σ (covariance).
• Path-related: gamma(ell) (path), d ell (measure), n_eff(ell) (effective refractive index), c_ref (reference propagation limit), λ_ref (reference wavelength), T_arr (arrival time), Phi (phase).
• Dimensional closure: p_dim (probability of dimensional consistency, required = 1.0).

IV. Units & Dimensions

• SI/international symbols: m, s, rad, 1, m/s, 1/m, Pa, N, J, Hz.
• All fields must provide unit and/or declare dim in the contract.
• Run I70-dim_check before and after reproduction and emit check_dim_report.json; publication requires p_dim = 1.0.

V. Normative Path Forms

• Arrival (two equivalent):
  T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
  T_arr = ( ∫ ( n_eff / c_ref ) d ell )
• Phase accumulation:
  Phi = ( 2π / λ_ref ) * ( ∫ n_eff d ell )

Align in order time → path → phase before verification; arrays len(gamma_ell)=len(d_ell)=len(n_eff)≥2; record delta_form on the data side.

VI. Mandatory Conventions

• Wrap inline symbols/fields with backticks (e.g., f_θ(x), T_arr, Phi, n_eff, c_ref, coverage.mode).
• Parentheses required for any division/integral/composite expression; write logs/exp/convolution as ln(·), exp(·), conv(·).
• Conflict names: T_fil (tension) ≠ T_trans (transmittance); n (number density) ≠ n_eff (effective refractive index).
• Coverage consistency: across Data/Model/Error/Pipeline/this volume, use exactly one of k/alpha/quantile, and declare in manifests & captions.

VII. Field/Dimension Table (minimal template)

VIII. Machine-Readable Glossary (excerpt)

{

"version":"1.0.0",

"terms":[

{"name":"MRB","desc":"minimal reproducible bundle","see":["Repro Manifest"]},

{"name":"T_arr","unit":"s","dim":"T","norm":"(∫(n_eff/c_ref)d ell)","see":["EFT.WP.Core.Equations v1.1:S20-1"]},

{"name":"Phi","unit":"rad","dim":"1","norm":"((2π/λ_ref)∫n_eff d ell)","see":["EFT.WP.Core.Equations v1.1:S21-2"]},

{"name":"coverage","mode":["k","alpha","quantile"],"see":["Error Budget Card v1.0:Ch.8"]},

{"name":"p_dim","unit":"1","dim":"1","desc":"dimensional closure, require 1.0"}

]

}

IX. Anti-Patterns & Fixes

• Anti: T_arr = ∫ n_eff / c_ref d ell (missing parentheses) → Fix: T_arr = ( ∫ ( n_eff / c_ref ) d ell ).
• Anti: providing only gamma(ell) without d ell/delta_form → Fix: add and equalize with n_eff.
• Anti: inconsistent coverage mode across volumes → Fix: unify to a single mode and declare in manifests & captions.
• Anti: missing units/dimensions → Fix: complete unit/dim and pass I70-dim_check.

X. Cross-References

• Dataset Card: Ch. 4 (Schema/Units/Dimensions), Ch. 6 (Splits/Versioning).
• Model Card: Ch. 3 (Terms & Symbols), Ch. 4 (Control Equations), Ch. 6 (Training Protocol).
• Error Budget Card: Ch. 5/6/8 (Covariance & Coverage).
• Pipeline Card: Ch. 6 (Stage Control), Ch. 9 (Gates).
• Parameter Card: Ch. 4/6/8 (Units/Freshness/Cov groups).

XI. Checklist

• Inline symbols backticked; all division/integral/composite expressions parenthesized.
• For path quantities, explicit gamma(ell)/d ell recorded with delta_form; len(path) ≥ 2, Δell compliant.
• Field units/dimensions complete; p_dim = 1.0 passed with check_dim_report.json attached.
• coverage mode unified across Data/Model/Error/Pipeline/this volume; Σ PD.
• Citations use “volume + version + anchor (P/S/M/I)”, anchor coverage ≥ 90%, no external links/aliases.