42-EFT.WP.Heat.Decoherence v1.0 | Appendix B: Dataset Cards / Pipeline Cards / Error Budget Cards

Home ／ Docs-Technical WhitePaper ／ 42-EFT.WP.Heat.Decoherence v1.0

Appendix B: Dataset Cards / Pipeline Cards / Error Budget Cards

I. Scope & Anchors

• This appendix provides Dataset Card, Pipeline Card, and Error Budget Card publish-ready templates and minimal examples covering the full chain in this volume—from spectral estimation (Ch. 5) → open-system mapping (Ch. 4) → heat transport (Ch. 6) → platform channels (Ch. 7) → engineering (Ch. 8) → metrology & inversion (Ch. 9) → simulation stack (Ch. 11).
• Fields, formulas, and symbols are in English; cross-volume citations use the fixed style “Volume vX.Y: Anchor (P/S/M/I)”; interfaces align with Ch. 12 I12-*.

II. General Rules & Version Fields (Mandatory)

• Metadata: schema_version, contract_version, unit_system:"SI", references:[...].
• Frequency/PSD: declare one-sided/two-sided and ω|f in spectral_conventions.
• Arrival-time reuse (if applicable): must declare convention ∈ {pulled_const, integrand}, delta_form, gamma(ell), d_ell.
• All numerics must pass check_dim; do not mix the two T_arr conventions within the same dataset.

III. Dataset Card — Template

schema_version: "B.1.0"

contract_version: "1.0"

unit_system: "SI"

case_id: "<SC|NV|QD|Optomech|Acoustic|2D|custom>"

scene_tag: "<mK-cryostat|room-temp|UHV|...>"

device:

omega0: "<rad/s>"

bias: {lambda: "<Φ|Q|I_c|B|Vg|strain>", d_omega_d_lambda: "<rad/s/unit>"}

spectral_conventions:

fourier: {forward: "∫ f(t) e^{-iωt} dt", inverse: "(1/2π) ∫ F(ω) e^{iωt} dω"}

psd: {type: "one-sided|two-sided", freq: "ω|f"}

baths:

J_omega: {family: "ohmic|sub|super|piezo|custom", params: {eta:"<...>", s:"<...>", omega_c:"<rad/s>"}}

S_in: {family: "Johnson|one_over_f|TLS|white|custom", params:{...}, type:"one-sided|two-sided", freq:"ω|f"}

oQS_model:

type: "GKSL|Redfield|TCL2|IF|QBM"

H_S: "<Hamiltonian>"

coupling: {ops:["A1","A2"], map_to:"<charge|flux|x|p|spin>"}

thermal:

kappa_T: "<W/m/K>", alpha_T: "<m^2/s>", R_K: "<K m^2/W>"

sources: {Q:"<W/m^3>"}

T0: "<K>"

protocols:

type: ["Ramsey","Echo","CPMG","T1","NoiseTherm"]

timing: {t: "<s>", N: "<int>", phases: "<{φ_k}>"}

readout:

snr: "<->", enbw: "<Hz>", tau_int: "<s>", model: "Gaussian|Poisson|custom"

uncertainty:

Σ_y: "<block-diagonal or sparse>"

priors: {eta:"...", s:"...", omega_c:"...", tan_delta:"...", T:"<K>"}

interfaces:

spec: {psd: "I12-SPEC-estimate_psd", cpsd: "I12-SPEC-estimate_cpsd", fit: "I12-SPEC-fit_noise_models"}

oqs: {rates: "I12-OQS-lindblad_rates", simulate: "I12-OQS-simulate"}

heat: {fourier: "I12-HEAT-solve_fourier", bte: "I12-HEAT-solve_bte", landauer: "I12-HEAT-landauer"}

plat: {map_rates: "I12-PLAT-map_rates"}

eng: {thermal_balance: "I12-ENG-thermal_balance", synth_filter: "I12-ENG-synthesize_filter"}

met: {infer_spec: "I12-MET-infer_spectrum", design: "I12-MET-design_experiment"}

sim: {make_synth: "I12-SIM-make_synthetic", run_sbc: "I12-SIM-run_sbc"}

arrival_time: # if propagation chain reused, mandatory

convention: "pulled_const|integrand"

delta_form: "c_ref^-1 * ∫ n_eff dℓ" # or "∫ (n_eff/c_ref) dℓ"

gamma: "piecewise: free|fixture|substrate|device|environment"

d_ell: "m"

reproducibility:

scripts: "<path>"

env: "<container|conda spec>"

anchors: ["S40-*","S50-*","S60-*","S70-*","S80-*","S90-*","S110-*","I12-*"]

IV. Specialized Dataset Sub-Templates (Per Platform)
A. SC (Superconducting circuits)

case_id: "SC"

baths: {J_omega: {family:"ohmic", params:{eta:"...", s:1, omega_c:"..."}}}

channels:

dielectric: {p:[{region:"JJ_stack", value:"<->"}], tan_delta:[{mat:"SiN", value:"<->"}]}

quasiparticle: {x_qp:"<->"}

radiation: {J_gamma:"<model|fit>"}

B. NV

case_id: "NV"

spin: {gamma_e:"<rad/s/T>", S_BzBz:"<model|table>"}

thermal: {T0:"<K>", kappa_T:"<W/m/K>"}

C. Optomech

case_id: "Optomech"

mechanics: {omega_m:"<rad/s>", Gamma_m0:"<s^-1>"}

optics: {kappa:"<s^-1>", g0:"<rad/s>"}

V. Pipeline Card — Template

schema_version: "B.1.0"

unit_system: "SI"

pipeline:

dag:

- id: "ingest"

api: "I13-1" # load_case_card

in: ["dataset_card.yaml"]

out: ["raw"]

- id: "clean_std"

api: "I13-2" # clean_and_standardize

in: ["raw","contracts"]

out: ["clean","Σ_y","notes"]

- id: "psd"

api: "I12-SPEC-estimate_psd"

in: ["clean.signal","fs","method","params"]

out: ["S_xx(ω)","edof","ci"]

- id: "fit_spec"

api: "I12-SPEC-fit_noise_models"

in: ["S_xx(ω)","family"]

out: ["A","gamma","omega_c","ci"]

- id: "oqs_rates"

api: "I12-OQS-lindblad_rates"

in: ["H_S","L_ops","J(ω)","T"]

out: ["Gamma1","Gamma_phi"]

- id: "heat"

api: "I12-HEAT-solve_fourier"

in: ["geom","kappa_T","Q","bc"]

out: ["T(r,t)","q(r,t)","kappa_eff"]

- id: "platform_map"

api: "I12-PLAT-map_rates"

in: ["omega0","d_omega_d_lambda","S_ll(ω)","J(ω)","T"]

out: ["T1","T2","Gamma1","Gamma_phi","Q"]

- id: "design"

api: "I12-MET-design_experiment"

in: ["Fisher","budget","objective"]

out: ["times*","N*","repeats*","expected_ci"]

runtime:

seeds: {global: 2025}

resources: {cpu_time: "hh:mm", gpu_mem: "GB", max_walltime: "hh:mm"}

logging:

level: "INFO"

artifacts: ["repro_bundle.tgz"]

contracts:

unit_system: "SI"

references: ["Ch.4","Ch.5","Ch.6","Ch.7","Ch.8","Ch.9","Ch.11","Ch.12"]

VI. Error Budget Card — Template

schema_version: "B.1.0"

unit_system: "SI"

error_budget:

channels:

- name: "PSDs"

unit: "<unit^2/Hz>"

contributors:

- {name: "window_norm", type: "systematic", u: "<rel>"}

- {name: "leakage", type: "systematic", u: "<rel>"}

- {name: "edof_var", type: "random", u: "<rel>"}

combine_rule: "quadrature"

- name: "T1"

unit: "s"

contributors:

- {name: "fit_bias", type: "systematic", u: "<s>"}

- {name: "readout_SNR", type: "random", u: "<s>"}

- name: "T2"

unit: "s"

contributors:

- {name: "sequence_timing", type: "systematic", u: "<s>"}

- {name: "S_dw_model", type: "model", u: "<s>"}

- name: "ThermalChain"

unit: "K"

contributors:

- {name: "kappa_T", type: "param", u: "<K>"}

- {name: "R_K", type: "param", u: "<K>"}

- {name: "rad_load",type: "random", u: "<K>"}

covariance:

Σ_y: "<block-diagonal or sparse>" # consistent with reweighted/merged versions

derived_params:

- name: "Gamma1"

unit: "s^-1"

relation: "from OQS or platform map"

u_formula: "cov(θ) ≈ (J^T Σ_y^-1 J)^-1"

- name: "Gamma_phi"

unit: "s^-1"

relation: "from S_dw and filter"

u_formula: "propagate via |F(ω)|^2"

coverage:

k: 2.0

metrics: ["NEES","NIS","pass@coverage"]

reports:

tables: ["channel_budget.csv","param_ci.csv"]

plots: ["sankey_budget.png","psd_fit.png","ci_forest.png"]

VII. Field Validation & Quality Gates

• Structure: schema_version/contract_version/unit_system/references required; YAML/JSON parseable; keys unique.
• Convention consistency: PSD one-/two-sided and ω|f consistent; arrival-time four fields (if applicable) complete.
• Dimensions: S_xx(ω), J(ω), χ(ω), T(r,t), q(r,t), Γ pass check_dim; explicit dBm↔W conversion.
• Covariance: Σ_y channel blocks align with reweight/deflation and reflected in graph/filter structures.
• Consistency & coverage: NEES/NIS and pass@coverage meet targets; cross-protocol (Ramsey/Echo/CPMG/T1) agreement.
• Reproducibility: emit repro_bundle = {scripts, params, env, anchors, hash}; retain decision trails for conventions/filtering/thermal chain/inversion.

VIII. Minimal Examples (Publish-Ready)
A. SC + Ramsey/Echo (excerpt)

schema_version: "B.1.0"

unit_system: "SI"

case_id: "SC"

device: {omega0: 2.0e10, bias: {lambda: "Φ", d_omega_d_lambda: 1.0e9}}

spectral_conventions: {psd: {type: "one-sided", freq: "ω"}}

baths: {J_omega: {family:"ohmic", params:{eta:1.2e-3, s:1, omega_c:3.0e11}}}

protocols: {type:["Ramsey","Echo"], timing:{t:[1e-6,3e-6,1e-5], N:1}}

interfaces:

spec: {psd: "I12-SPEC-estimate_psd", fit: "I12-SPEC-fit_noise_models"}

oqs: {rates: "I12-OQS-lindblad_rates"}

met: {infer_spec: "I12-MET-infer_spectrum"}

B. Optomech + Thermal balance (excerpt)

schema_version: "B.1.0"

unit_system: "SI"

case_id: "Optomech"

thermal:

kappa_T: 250

R_K: 2.0e-4

sources: {Q: 5.0e3}

interfaces:

eng: {thermal_balance: "I12-ENG-thermal_balance"}

outputs: {targets:{Q_min:1.0e6}}

IX. Interface Binding List (Referenced Here)

• Spectra: I12-SPEC-estimate_psd, I12-SPEC-estimate_cpsd, I12-SPEC-fit_noise_models.
• Open systems: I12-OQS-lindblad_rates, I12-OQS-simulate.
• Heat: I12-HEAT-solve_fourier, I12-HEAT-solve_bte, I12-HEAT-landauer.
• Platform: I12-PLAT-map_rates.
• Engineering: I12-ENG-thermal_balance, I12-ENG-synthesize_filter.
• Metrology & inversion: I12-MET-infer_spectrum, I12-MET-design_experiment.
• Simulation & benchmarks: I12-SIM-make_synthetic, I12-SIM-run_sbc.

X. Deliverables & Archival

• Deliverables: dataset_card.yaml, pipeline_card.yaml, error_budget.yaml, repro_bundle.tgz, and report tables/figures (CSV/PNG).
• Archival: record request_id, timestamps, environment fingerprints, and citation anchors; support deterministic replay in audit mode.