37-EFT.WP.EDX.HighSpeed v1.0 | Appendix C. Dataset Cards & Pipeline Cards

Home ／ Docs-Technical WhitePaper ／ 37-EFT.WP.EDX.HighSpeed v1.0

Appendix C. Dataset Cards & Pipeline Cards

I. Purpose & Coverage (Mandatory)

1. Define the HighSpeed volume’s Dataset Card (v1.0) and Pipeline Card (v1.0) fields, templates, and checks, covering acquisition/simulation → alignment → S→Z mapping → phase/path correction → coherence-window KPI calculation → (optional) radiation evaluation → export/release.
2. Unified arrival dialect (two equivalent forms; path/measure explicit; record delta_form):
   • Constant-factored: T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
   • General: T_arr = ( ∫ ( n_eff / c_ref ) d ell )
3. SI units; hard release gates: check_dim = pass, Re{Z_eft} ≥ 0, KK_consistency = pass, two-dialect T_arr agreement, in-window KPIs meet gates; (if radiation enabled) Re{ΔZ_rad} ≥ 0.

II. Naming & Versioning

• dataset_id / pipeline_id: EDXHS-[topic]-[index] (e.g., EDXHS-001, EDXHS-PIPE-001).
• Versioning: semver (e.g., 1.0.0); each artifact & major input file carries a sha256.
• Time/tooling fingerprints: created_at (ISO 8601), toolchain, and env_lock.

III. Dataset Card (v1.0, HF field set)

Minimal template (copy-ready)

dataset_card:

dataset_id: "EDXHS-001"

version: "1.0.0"

source: "measurement"

instruments:

- {type:"VNA", model:"—", cal:"2025-08-01", range:"10 MHz–40 GHz"}

deemb: {method:"TRL", version:"1.2", artifact:"/artifacts/deemb.json", baseline_id:"BLSN-EDX-001"}

sync: {ref:"10MHz", scheme:"shared_ref+trigger", dt_sync_s: 2.0e-12}

binding_ref: "LAY2PATH-HF-0001"

arrival:

form: "n_over_c" # or "one_over_c_times_n"

gamma: "explicit"

measure: "d_ell"

c_ref: 299792458.0

Tarr_s: 1.234e-09

u_Tarr_s: 6.0e-12

delta_form: "n_over_c"

Znorm_ohm: [50.0, 50.0]

sparams: "/artifacts/S.s2p"

mixed_mode:

enabled: true

T_mm: "/cfg/T_mm.yaml"

Z0_mm_ohm: [100.0, 25.0]

Z_eft: {real:[...], imag:[...]}

argZ: [ ... ]

Zc_ohm: [ ... ]

HF_KPI:

T_group_s: [ ... ]

E_phase_rad: 0.043

GDR_s: 1.8e-10

ΔW: 0.17

dispersion:

alpha_per_m: [ ... ] # optional

beta_per_m: [ ... ] # optional

radiation:

enabled: true

deltaZ_rad: {Re_ohm:[...], Im_ohm:[...]} # Re ≥ 0

Re_Zrad_min: 0.0

qa_gates: {check_dim:"pass", passivity:"pass", KK:"pass"}

hashes:

files:

- {path:"/artifacts/S.s2p", sha256:"..."}

- {path:"/artifacts/deemb.json", sha256:"..."}

created_at: "2025-09-16T10:00:00Z"

toolchain: {simstack_hf:"1.0.0", kernels:"0.9.3"}

IV. Pipeline Card (v1.0) & Env Lock (v1.0)

• Standard stages: ingest → align(I30-HF) → deembed/renorm → s2z(I40-HF) → sync_corr → path_correct → kpi_eval(Ω) → radiation_eval → export(cards).
• Env-lock: record OS/interpreter/dependencies/container digest & hardware; consistent units across stages; provide RNG seeds.

pipeline_card:

pipeline_id: "EDXHS-PIPE-001"

version: "1.0.0"

steps:

- {id:"ingest", cmd:"load_sparams --input /artifacts/S.s2p"}

- {id:"align", cmd:"map_ports --binding LAY2PATH-HF-0001"}

- {id:"deembed", cmd:"deembed --fixture /artifacts/deemb.json --baseline BLSN-EDX-001"}

- {id:"renorm", cmd:"renorm --znorm Znorm.yaml"}

- {id:"s2z", cmd:"map_S_to_Z --mode mixed --Tmm /cfg/T_mm.yaml"}

- {id:"sync_corr", cmd:"phase_corr --dt_sync_s 2.0e-12"}

- {id:"path_correct", cmd:"pathfix --binding LAY2PATH-HF-0001"}

- {id:"kpi_eval", cmd:"kpi --omega ω1,ω2 --gates gates.yaml"}

- {id:"rad_eval", cmd:"rad --enable --zref Z_base.npy"}

- {id:"export", cmd:"export_cards --out /release"}

env_lock:

os: {name:"Ubuntu", version:"22.04"}

interpreter: {name:"Python", version:"3.11.6"}

packages:

- {name:"numpy", version:"1.26.4", hash:"sha256:..."}

- {name:"scipy", version:"1.13.1", hash:"sha256:..."}

- {name:"pandas", version:"2.2.2", hash:"sha256:..."}

container: {image:"registry/edxhs:1.0.0", digest:"sha256:..."}

hardware: {cpu:"x86_64", gpu:"none", ram_GB:32}

seeds: {global: 20250916}

V. QA Gates & Consistency Checks (unified record)

qa_gates:

check_dim: "pass"

passivity: "pass" # min(Re{Z_eft}) ≥ 0

KK: "pass"

Tarr_dual:

diff_s: 3.0e-12 # |T_arr (two dialects) difference|

u_Tarr_s:6.0e-12

pass: true

VI. Audit Trail & Release Manifest (templates)

audit_manifest:

run_id: "RUN-2025-09-16-001"

toolchain: {simstack_hf:"1.0.0", kernels:"0.9.3"}

diffs: {params_changed:["Ks_tau"], reason:"tuning within prior"}

seeds: {global: 20250916}

qa:

check_dim: "pass"

passivity: "pass"

KK: "pass"

logs: "/logs/run_001.txt"

release_manifest:

normative_refs: ["EFT.WP.Core.DataSpec v1.0","Methods.Repro v1.0"]

artifacts:

- "/release/dataset_card.yaml"

- "/release/pipeline_card.yaml"

- "/release/env_lock.yaml"

- "/release/audit_manifest.yaml"

hashes:

dataset_card: "sha256:..."

pipeline_card: "sha256:..."

env_lock: "sha256:..."

audit: "sha256:..."

VII. Equivalence & Repro Metrics (thresholds & pseudocode)

equivalence_gates:

eps_Z_gate: 0.03

eps_phi_gate: 0.05 # rad

eps_Tg_gate: 0.10e-9 # s

eps_W_gate: 0.10

eps_Zc_gate: 2.0 # Ω

# 1) Two-dialect T_arr

T1 = (1/c_ref) * sum(n_eff[i]*Δell[i]) # n_over_c

T2 = sum((n_eff[i]/c_ref) * Δell[i]) # one_over_c_times_n

assert abs(T1 - T2) <= u_Tarr

# 2) KPIs & propagation consistency

phi = unwrap(argZ - ω*Δt_sync)

T_group = grad(phi, ω)

assert max_abs(T_group - L*grad(beta, ω)) <= u_Tg # if beta available

# 3) Hard quick gates

assert min(Re(Z_eft)) >= 0.0 and KK_consistency(Z_eft)

# 4) Equivalence

eps_Z = max_abs(Z_eft_rep - Z_eft_pub) / max_abs(Z_eft_pub)

eps_phi= max_abs(phi_rep - phi_pub)

eps_Tg = max_abs(Tg_rep - Tg_pub)

eps_W = max_over_ω(sum_abs(w_rep - w_pub))

eps_Zc = max_abs(Zc_rep - Zc_pub)

assert all([eps_Z<=ε_Z_gate, eps_phi<=ε_φ_gate, eps_Tg<=ε_Tg_gate, eps_W<=ε_W_gate, eps_Zc<=ε_Zc_gate])

VIII. Suggested Release Directory Layout

/release/

dataset_card.yaml

pipeline_card.yaml

env_lock.yaml

audit_manifest.yaml

qa_report.json

artifacts/

deemb.json

S.s2p

Z_eft.npy

aligned.parquet

IX. Error Codes (Unified Returns)

errors:

E_BAD_UNITS: "Unit or dimensional mismatch"

E_KK_FAIL: "K–K consistency failed"

E_PASSIVITY: "Passivity failed (Re{Z}<0)"

E_BINDING_MISSING: "Missing binding_ref or path segments"

E_DELTA_FORM_MISSING: "Arrival delta_form not recorded"

E_TARR_MISMATCH: "Two-dialect T_arr mismatch"

E_EQUIV_FAIL: "Equivalence thresholds not met"

E_ENVLOCK_FAIL: "Env-lock reconstruction failed or fingerprint mismatch"

E_QA_FAIL: "QA gate failed"

X. Compliance Bundle (one-shot, copy-ready)

dataset_card: { ... per §III template ... }

pipeline_card: { ... per §IV template ... }

env_lock: { ... per §IV template ... }

qa_gates: { ... per §V template ... }

audit_manifest: { ... per §VI template ... }

release_manifest:

normative_refs: ["EFT.WP.Core.DataSpec v1.0","Methods.Repro v1.0"]

artifacts: ["/release/dataset_card.yaml","/release/pipeline_card.yaml","/release/env_lock.yaml","/release/audit_manifest.yaml"]

hashes: {dataset_card:"sha256:...", pipeline_card:"sha256:...", env_lock:"sha256:...", audit:"sha256:..."}

equivalence_gates: {eps_Z_gate:0.03, eps_phi_gate:0.05, eps_Tg_gate:0.10e-9, eps_W_gate:0.10, eps_Zc_gate:2.0}

XI. Release Hard Gates (Summary)