38-EFT.WP.EDX.EMI v1.0 | Chapter 15 — Data & Reproducibility (DataSpec / Methods.Repro)

Home ／ Docs-Technical WhitePaper ／ 38-EFT.WP.EDX.EMI v1.0

Chapter 15 — Data & Reproducibility (DataSpec / Methods.Repro)

I. Chapter Objectives & Structure

1. Objective: Define the EDX.EMI data contract, data/pipeline cards, and audit-trail exports; lock environments and equivalence tests so that Z_eft(omega), ΔZ_rad(omega), P_rad(omega), E_rad/H_rad, and I_CM(omega) are reproducible, auditable, and releasable under a unified data dialect.
2. Structure: Data contract → Fields & templates → Pipeline card & env-lock → Repro workflow → Audit trail & release → Falsifiability → Compliance templates → Cross-chapter closure.
3. Shared time-of-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 )

II. Data Contract (EMI increments)

• Artifacts: raw/cleaned/aligned S-parameters, Z_eft/argZ, Znorm(omega), (optional) T_mm/Z0_mm, arrival, binding_ref, deemb/sync, ΔZ_rad(omega), I_port(omega), P_rad(omega), E_rad/H_rad (with AF/PF and distance R), I_CM(omega), HF_KPI{E_phase/GDR/ΔW}, qa_gates, audit_manifest.
• Minimal consistency: SI units; check_dim = pass; Re{Z_eft} ≥ 0, KK_consistency = pass; Re{ΔZ_rad} ≥ 0; two-dialect T_arr agreement; corr(P_rad,E/H) ≥ ρ_gate (suggest ρ_gate ≥ 0.8).
• Versioning & checksums: semver + per-file sha256; record created_at, toolchain, and env_lock fingerprints.

III. Dataset Card (v1.0, EMI fields)

Minimal template (copy-ready)

dataset_card:

dataset_id: "EDXEMI-001"

version: "1.0.0"

source: "field-site"

instruments:

- {type:"VNA", model:"—", cal:"2025-08-01"}

- {type:"EMI_receiver", detector:"qpk", if_bw_kHz:120, time_const_ms:1.0}

- {type:"antenna", AF_file:"/cal/AF_3m.yaml", version:"2025.1"}

- {type:"LISN", spec:"5µH CM", version:"v2.0"}

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

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

binding_ref: "LAY2PATH-EMI-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]

impedance:

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

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

I_port_A: [ ... ]

P_rad_W: [ ... ]

fields:

site: {distance_m: 3.0, coords:"...", AF_file:"/cal/AF_3m.yaml", PF_file:"/cal/PF.yaml"}

E_rad_peak_dBuV_m: [ ... ]

H_rad_peak_dBA_m: [ ... ]

currents:

I_CM_A: [ ... ]

HF_KPI:

E_phase_rad: 0.043

GDR_s: 1.8e-10

ΔW: 0.17

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_emi:"1.0.0", kernels:"0.9.3"}

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

• Standard stages: ingest → align(I30-EMI) → deembed/renorm → s2z(I40-EMI) → sync_corr → path_correct → rad_equiv(P_rad) → field_convert(E/H) → kpi_eval(Ω) → export(cards).
• Env-lock: record OS/interpreter/dependencies/container digest & hardware; unified unit system; provide RNG seeds.

pipeline_card:

pipeline_id: "EDXEMI-PIPE-001"

version: "1.0.0"

steps:

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

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

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

- {id:"renorm", cmd:"renorm --znorm Znorm.yaml --tmm /cfg/T_mm.yaml --z0mm Z0_mm.yaml"}

- {id:"s2z", cmd:"map_S_to_Z --mode mixed"}

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

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

- {id:"rad_equiv", cmd:"z2prad --zbase Z_base.npy"}

- {id:"field_conv", cmd:"prad2field --af /cal/AF_3m.yaml --pf /cal/PF.yaml --dist 3.0"}

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

- {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/edxemi:1.0.0", digest:"sha256:..."}

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

seeds: {global: 20250916}

V. Reproducibility Workflow (Methods.Repro, execution dialect)

• Fetch & verify: pull dataset_card/pipeline_card/env_lock; verify sha256.
• Rebuild environment: launch container/venv as per env_lock.
• Alignment & corrections: run align → deembed/renorm → s2z → sync_corr → path_correct; ensure passivity/KK and complete arrival.
• Radiation equivalence: compute ΔZ_rad = Z_eft − Z_base, enforce Re{ΔZ_rad} ≥ 0; compute P_rad = ½·Re{ΔZ_rad}|I_port|^2.
• Field conversion & consistency: convert E/H using AF/PF and distance R; verify corr(P_rad,E/H) ≥ ρ_gate.
• Recompute KPIs: on window Ω, recompute E_phase/GDR/ΔW; apply timebase correction and unwrap before fitting.
• Arrival consistency: two-dialect T_arr difference ≤ u(T_arr).
• Equivalence test: compare reproduced vs published with thresholds ε_Z/ε_φ/ε_PRad_E/ε_PRad_H/ε_ICM/(ε_ΔW); emit qa_gates.

VI. Audit Trail & Release

audit_manifest:

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

toolchain: {simstack_emi:"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", "/release/qa_report.json"]

hashes:

dataset_card: "sha256:..."

pipeline_card: "sha256:..."

env_lock: "sha256:..."

audit: "sha256:..."

VII. Falsifiability (Repro-specific)

1. R-EMI-1 (Two-dialect agreement): |T_arr(n_over_c) − T_arr(one_over_c_times_n)| > u(T_arr).
2. R-EMI-2 (Positive-real/causality failure): reproduced Re{Z_eft} < 0 or KK_consistency fails.
3. R-EMI-3 (Power–field consistency failure): corr(P_rad,E/H) < ρ_gate.
4. R-EMI-4 (Equivalence failure):
   • ε_Z = max_ω |Z_eft^{rep} − Z_eft^{pub}| / |Z_eft^{pub}| > ε_Z_gate
   • ε_φ = max_ω |arg Z^{rep} − arg Z^{pub}| > ε_φ_gate
   • ε_PRad_E = 1 − corr(P_rad^{rep}, E^{pub}) > ε_PRad_E_gate
   • ε_PRad_H = 1 − corr(P_rad^{rep}, H^{pub}) > ε_PRad_H_gate
   • ε_ICM = 1 − corr(I_CM^{rep}, Re{ΔZ_rad}^{pub}) > ε_ICM_gate
   • ε_ΔW = max_ω |ΔW^{rep} − ΔW^{pub}| > ε_ΔW_gate
5. R-EMI-5 (Env not reproducible / audit missing): env_lock cannot be rebuilt or missing critical hashes/logs.

VIII. Compliance Templates (copy-ready)

# 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) S→Z / ΔZ_rad / P_rad / E/H

Z = map_S_to_Z(S_ren, Znorm(ω))

ΔZ_rad = Z - Z_base

assert min(Re(ΔZ_rad)) >= 0.0 and KK_consistency(Z)

P_rad = 0.5 * Re(ΔZ_rad) * abs(I_port)**2

ρE, ρH = corr(P_rad, E_env), corr(P_rad, H_env)

assert ρE >= ρ_gate and ρH >= ρ_gate

# 3) KPIs

phi = unwrap(arg(Z) - ω*Δt_sync)

E_phase = max_abs(phi - (ω*Tarr + φ0_opt))

# ΔW comparison

eps_dW = max_over_ω(abs(ΔW_rep - ΔW_pub))

# 4) Equivalence set

eps_Z = max_abs(Z_rep - Z_pub) / max_abs(Z_pub)

eps_phi = max_abs(phi_rep - phi_pub)

eps_PrE = 1 - corr(P_rad_rep, E_env_pub)

eps_PrH = 1 - corr(P_rad_rep, H_env_pub)

eps_Icm = 1 - corr(I_CM_rep, Re(ΔZ_rad)_pub)

assert eps_Z<=ε_Z_gate and eps_phi<=ε_φ_gate and eps_PrE<=ε_PRad_E_gate and \

eps_PrH<=ε_PRad_H_gate and eps_Icm<=ε_ICM_gate and eps_dW<=ε_ΔW_gate

Suggested thresholds (specialize per dataset card)

equivalence_gates:

eps_Z_gate: 0.05 # 5% relative error

eps_phi_gate: 0.05 # rad

eps_PRad_E_gate: 0.20 # 1 − correlation (smaller is stricter)

eps_PRad_H_gate: 0.20

eps_ICM_gate: 0.20

eps_ΔW_gate: 0.10

rho_gate: 0.80

IX. Cross-Chapter Links & Closure

• Dependencies: Chapters 8–9 (mapping / metrology chain), Chapter 10 (falsification), Chapter 13 (multi-domain coordination), EDX.HighSpeed Chapter 15 (Data & Repro).
• Downstream: Chapter 16 (Design Protocol & Checklist — incorporate equivalence/audit gates into sign-off) and the unified specifications EFT.WP.Core.DataSpec / Methods.Repro.