40-EFT.WP.Materials.Superconductivity v1.0 | 附录 B 数据卡 / 管线卡 / 误差预算卡

目录 ／ 文档-技术白皮书 ／ 40-EFT.WP.Materials.Superconductivity v1.0

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

I. 适用范围与锚点

• 本附录提供数据卡（Dataset Card）、**管线卡（Pipeline Card）与误差预算卡（Error Budget Card）**的发布版模板与最小示例，覆盖本卷各观测通道（腔/谐振、波导/薄膜透射、磁输运等）。
• 全部字段、公式与符号统一英文书写；跨卷引用采用“卷名 + 版本号 + 锚点（P/S/M/I）”。
• 强制与本卷第6–12章联动：W_c/W_coh、T_arr 两口径、y = M(θ)、J = ∂y/∂θ、F = J^T Σ_y^{-1} J、接口 I12-*。

II. 总则与版本字段

• 统一元数据：schema_version、contract_version、unit_system:"SI"、references:[...]。
• 到达时强制字段：convention ∈ {pulled_const, integrand}、delta_form、gamma(ell)、d_ell。
• 全部数值需通过 check_dim；不可混用 T_temp/T_fil 与 n/n_eff。

III. 数据卡（Dataset Card）模板

schema_version: "B.1.0"

contract_version: "1.0"

unit_system: "SI"

case_id: "<cuprates|fe-based|heavy-fermion|2d>"

specimen:

batch: "<id>"

growth: "<MBE|PLD|bulk|...>"

geometry: "<slab|bridge|vdW-stack>"

thickness_d: "<m>"

texture_Lc: "<m>"

measurement:

bands: ["microwave","THz","optical"]

convention: "pulled_const" # or "integrand"

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

gamma: "piecewise: free|fixture|substrate|film|sample"

d_ell: "m"

deembed: {scheme: "OSLT|TRL", refs: ["blank","substrate-only"]}

unwrap: {method: "phase_unwrap_v2", params: {...}}

environment: {T_range: "[Kmin,Kmax]", H_range: "[A·m^-1] or [T]", strain: "ε_ij map"}

observables:

- name: "T_arr(ω)" # s

- name: "Δf/f" # cavity/resonator

- name: "1/Q"

- name: "|S21|"

- name: "arg S21"

- name: "M(H)"

- name: "R(H,T,θ,φ)"

units:

T_arr: "s"

S21_mag: "1"

S21_phase: "rad"

M: "A·m^2"

R: "Ω"

constants:

c_ref: 299792458.0

Phi0_ref: "h/(2e)"

cal_bundle:

timebase: "<spec>"

freq_ref: "<spec>"

field_ref: "<spec>"

geom_ref: "<CAD/hash>"

drift_model: "<name|hash>"

coherence:

W_coh: {model: "<name>", params: {...}}

weights: {rule: "L_coh|Fisher", table: "<optional>"}

interfaces:

arrival_time:

compute: "I12-AT-compute_arrival_time"

fit_thinfilm: "I12-AT-fit_thinfilm_transmission"

measurement_matrix:

build: "I12-MM-build_measurement_matrix"

fisher: "I12-MM-compute_fisher"

inference:

hmc: "I12-INF-run_hmc"

vi: "I12-INF-run_vi"

targets_and_priors:

theta: ["lambda_L","xi","kappa_i","kappa_tensor","sigma1(ω)","sigma2(ω)","d","H_c1","H_c2"]

priors:

lambda_L: "HalfNormal(μ,σ)"

xi: "HalfNormal(μ,σ)"

kappa_floor: "1/sqrt(2)"

d: "N(μ_d,σ_d)"

K_T: "LogNormal(μ,σ)" # if nonlocal

references:

- "EFT.WP.Materials.Superconductivity v1.0:Ch.6"

- "EFT.WP.Materials.Superconductivity v1.0:Ch.7"

- "EFT.WP.Materials.Superconductivity v1.0:Ch.8"

- "EFT.WP.Materials.Superconductivity v1.0:Ch.10"

reproducibility:

scripts: "<path>"

env: "<container|conda spec>"

anchors: ["S70-*","M7-*","I12-*"]

IV. 专用数据卡子模板
A. 腔/谐振法（Cavity/Resonator）

measurement:

bands: ["microwave"]

cavity:

mode_map: "<eigenfields-id>"

calibration: "<coupling,Qe>"

observables: ["Δf/f","1/Q","φ(ω)"]

B. 波导/薄膜透射（TDTS / Waveguide）

measurement:

bands: ["THz"]

waveguide:

type: "<TE|TM>"

cutoff: "<Hz>"

substrate: {n_sub: "<model|table>"}

observables: ["T_arr(ω)","|S21|","arg S21"]

V. 管线卡（Pipeline Card）模板

schema_version: "B.1.0"

pipeline:

dag:

- id: "ingest"

fn: "load_case_card"

api: "I12-CASE-load_card"

in: ["dataset_card.yaml"]

out: ["raw"]

- id: "deembed"

fn: "clean_and_deembed"

api: "I12-CASE-clean_and_deembed"

in: ["raw","standards"]

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

- id: "unwrap"

fn: "phase_unwrap"

api: "I12-AT-compute_arrival_time"

in: ["clean"]

params: {convention: "pulled_const", path: "gamma(...)"}

out: ["T_arr(ω)","meta"]

- id: "build_J"

fn: "build_measurement_matrix"

api: "I12-MM-build_measurement_matrix"

in: ["clean","T_arr(ω)","cal_bundle"]

out: ["J","B","Σ_y"]

- id: "fuse"

fn: "fuse_multi_band"

api: "I12-AT-fuse_multi_band"

in: ["band_results[]","weights"]

out: ["merged_params","consistency"]

- id: "invert"

fn: "run_hmc"

api: "I12-INF-run_hmc"

in: ["J","Σ_y","priors"]

out: ["posterior","rhat","ess","traces"]

- id: "ppc"

fn: "posterior_predictive"

api: "I12-INF-posterior_predictive"

in: ["traces","sim_adapter"]

out: ["y_rep","metrics"]

- id: "design"

fn: "recommend_design"

api: "I12-CASE-recommend_design"

in: ["posterior","objectives"]

out: ["Δθ_design","recipe"]

runtime:

cache: true

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.6","Ch.7","Ch.8","Ch.10","Ch.12"]

VI. 误差预算卡（Error Budget Card）模板

schema_version: "B.1.0"

error_budget:

channels:

- name: "T_arr(ω)"

unit: "s"

contributors:

- {name: "phase_unwrap", type: "systematic|random", u: "<s>", note: "piecewise jumps"}

- {name: "deembed", type: "systematic", u: "<s>", cov_with: ["|S21|","arg S21"]}

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

combine_rule: "quadrature"

- name: "Δf/f"

unit: "1"

contributors:

- {name: "mode_map", type: "systematic", u: "<1>"}

- {name: "coupling", type: "random", u: "<1>"}

covariance:

Σ_y: "<block-diagonal|sparse file>"

derived_params:

- name: "lambda_L"

unit: "m"

relation: "from J and y via inversion"

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

- name: "xi"

unit: "m"

relation: "same as above"

coverage:

k: 2.0 # expanded uncertainty factor

U_policy: "U = k * u_c"

reports:

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

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

VII. 字段校验与质量门

• 结构校验：schema_version/contract_version/unit_system/references 必填；JSON/YAML 可解析且键不重复。
• 到达时强制：convention/delta_form/gamma(ell)/d_ell 四项缺一判拒。
• 量纲校核：对 observables 与派生量执行 check_dim；单位列缺失判拒。
• 可辨识性门：计算 F = J^T Σ_y^{-1} J，若 cond(F) > κ_th，输出 E/IDENTIFIABILITY 与几何/频段建议。
• 一致性门：W_coh 权重与 Σ_y 的块结构一致；超出 W_coh 的数据仅作低权或系统项。
• 复现门：生成 repro_bundle = {scripts, params, env, anchors}，含随机种子与 cal_bundle 哈希。

VIII. 最小示例（发布可用）
A. TDTS / Fe-based 薄膜（节选）

schema_version: "B.1.0"

unit_system: "SI"

case_id: "fe-based"

measurement:

bands: ["THz"]

convention: "integrand"

delta_form: "∫ (n_eff/c_ref) dℓ"

gamma: "piecewise: free|fixture|substrate|film|sample"

d_ell: "m"

deembed: {scheme: "TRL", refs: ["blank","substrate-only"]}

observables: ["T_arr(ω)","|S21|","arg S21"]

interfaces:

arrival_time: {compute: "I12-AT-compute_arrival_time", fit_thinfilm: "I12-AT-fit_thinfilm_transmission"}

measurement_matrix: {build: "I12-MM-build_measurement_matrix"}

targets_and_priors:

theta: ["lambda_L","xi","sigma1(ω)","sigma2(ω)","d"]

priors: {lambda_L: "HalfNormal(0,200e-9)", d: "N(50e-9,5e-9)"}

B. 腔/谐振 / Heavy-Fermion（节选）

schema_version: "B.1.0"

unit_system: "SI"

case_id: "heavy-fermion"

measurement:

bands: ["microwave"]

convention: "pulled_const"

delta_form: "c_ref^-1 * ∫ n_eff dℓ"

gamma: "piecewise: free|fixture|cavity|sample"

d_ell: "m"

observables: ["Δf/f","1/Q","φ(ω)"]

interfaces:

arrival_time: {compute: "I12-AT-compute_arrival_time"}

inference: {hmc: "I12-INF-run_hmc"}

targets_and_priors:

theta: ["lambda_L","xi","kappa_i"]

priors: {kappa_floor: "1/sqrt(2)"}

IX. 接口绑定清单（本附录引用）

• 到达时/传播：I12-AT-compute_arrival_time，I12-AT-fit_thinfilm_transmission，I12-AT-deembed_path，I12-AT-fuse_multi_band。
• 测量矩阵/计量：I12-MM-build_measurement_matrix，I12-MM-compute_fisher，I12-MM-propagate_uncertainty，I12-MM-assess_identifiability。
• 推断：I12-INF-run_hmc，I12-INF-run_vi，I12-INF-posterior_predictive。
• 案例库：I12-CASE-load_card，I12-CASE-clean_and_deembed，I12-CASE-build_J，I12-CASE-recommend_design。

X. 交付物与存档

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