42-EFT.WP.Heat.Decoherence v1.0 | 附录 B 数据卡 / 管线卡 / 误差预算卡

目录 ／ 文档-技术白皮书 ／ 42-EFT.WP.Heat.Decoherence v1.0

附录 B 数据卡 / 管线卡 / 误差预算卡

I. 适用范围与锚点

• 本附录提供数据卡（Dataset Card）、**管线卡（Pipeline Card）与误差预算卡（Error Budget Card）**的发布版模板与最小示例，覆盖本卷从谱估计（第5章）→开放量子系统映射（第4章）→传热（第6章）→平台通道（第7章）→工程设计（第8章）→计量与反演（第9章）→仿真栈（第11章）的全链路。
• 字段、公式与符号统一英文；跨卷引用采用“卷名 vX.Y: 锚点（P/S/M/I）”固定写法；接口对齐第12章 I12-*。

II. 总则与版本字段（强制）

• 元数据：schema_version、contract_version、unit_system:"SI"、references:[...]。
• 频率/PSD 口径：在 spectral_conventions 明确单边/双边与 ω|f。
• 到达时复用（如有）：必须声明 convention ∈ {pulled_const, integrand}、delta_form、gamma(ell)、d_ell。
• 所有数值须通过 check_dim；禁止在同一数据集混用两种 T_arr 口径。

III. 数据卡（Dataset Card）模板

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: # 如复用传播链路，必填

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. 专用数据卡子模板（按平台选用）
A. SC（超导电路）

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）模板

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）模板

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>" # 与再加权/合并后的版本一致

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. 字段校验与质量门

• 结构校验：schema_version/contract_version/unit_system/references 必填；YAML/JSON 可解析、键不重复。
• 口径一致：PSD 单/双边与 ω/f 选择一致；到达时四项（如适用）完备。
• 量纲校核：S_xx(ω)、J(ω)、χ(ω)、T(r,t)、q(r,t)、Γ 等通过 check_dim；dBm↔W 换算明确。
• 协方差一致性：Σ_y 的通道块与再加权/膨胀后版本一致，并反映到图/滤波结构。
• 一致性与覆盖度：NEES/NIS 与 pass@coverage 达标；跨协议（Ramsey/Echo/CPMG/T1）一致。
• 复现门：生成 repro_bundle = {scripts, params, env, anchors, hash}，保留口径/滤波/热链/反演的决策轨迹。

VIII. 最小示例（发布可用）
A. SC + Ramsey/Echo（节选）

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（节选）

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. 接口绑定清单（本附录引用）

• 谱估计：I12-SPEC-estimate_psd，I12-SPEC-estimate_cpsd，I12-SPEC-fit_noise_models。
• 开放系统：I12-OQS-lindblad_rates，I12-OQS-simulate。
• 传热：I12-HEAT-solve_fourier，I12-HEAT-solve_bte，I12-HEAT-landauer。
• 平台通道：I12-PLAT-map_rates。
• 工程设计：I12-ENG-thermal_balance，I12-ENG-synthesize_filter。
• 计量与反演：I12-MET-infer_spectrum，I12-MET-design_experiment。
• 仿真与基准：I12-SIM-make_synthetic，I12-SIM-run_sbc。

X. 交付物与存档

• 交付物：dataset_card.yaml、pipeline_card.yaml、error_budget.yaml、repro_bundle.tgz、报告表与图（CSV/PNG）。
• 存档策略：记录 request_id、时间戳、环境指纹与引用锚点清单；支持审计模式下的确定性重放。