56-报告级方法附录 Template v1.0 | 附录A 数据字典与符号表

目录 ／ 文档-技术白皮书 ／ 56-报告级方法附录 Template v1.0

附录A 数据字典与符号表

I. 目的与范围（强制）

• 固定数据字典—字段规范—符号表—单位与量纲—引用锚点的统一口径，支撑可检索、可对齐、可复用。
• 适用对象：本附录所涵盖的全部方法条目之输入/输出数据、评测结果与计量量。

II. 数据字典结构（强制）

• 组织方式：按域（domain）→集合（collection）→字段（field）分层；每字段记录名称、类型、单位、量纲、取值域/编码、缺失策略、来源与锚点。
• 版本策略：dataset@version + sha256；字段级变更记录 field_rev 与 breaking 标记。

III. 字段规范与约束（强制）

IV. 符号表（最小统一集，强制）

V. 单位与量纲（强制）

• 基础：T:s，L:m，M:kg，Q:C，Θ:K，One:1。
• 常用派生：速度 m·s^-1，密度 m^-3，能量 J，功率 W。
• 校核：方程处 check_dim=true；字段级 unit/dim 必填且与方法条目一致。

VI. 到达时一致性（强制）

1. 统一口径：
   • 常量外提：T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
   • 一般口径：T_arr = ( ∫ ( n_eff / c_ref ) d ell )
2. 同段显式路径 gamma(ell) 与测度 d ell；在机读元数据登记 delta_form ∈ {general, factored}、Δell/ε_int/τ_c；禁用裸写 n/c 与未加括号表达。

VII. 引用与锚点（强制）

VIII. 人读 × 机读映射（强制）

IX. 机读 Schema（YAML；JSON 等价，强制）

assets:

datasets:

- { name: "cmb_set_v3", version: "v3", sha256: "sha256:…", license: "CC-BY-4.0" }

- { name: "lens_v1", version: "v1", sha256: "sha256:…", license: "CC-BY-4.0" }

dict:

collections:

- name: "measurement.arrival"

fields:

- { name: "T_arr", type: "float", unit: "s", dim: "T", required: true, missing: "forbid",

anchor: "EFT.WP.Core.Equations v1.1:S20-1" }

- name: "measurement.medium"

fields:

- { name: "n_eff", type: "float", unit: "1", dim: "1", required: true, missing: "impute" }

- { name: "c_ref", type: "float", unit: "m·s^-1", dim: "L T^-1", required: true, missing: "forbid" }

- name: "path.curve"

fields:

- { name: "gamma(ell)", type: "path", unit: "-", dim: "L", required: true }

- { name: "d ell", type: "measure", unit: "m", dim: "L", required: true }

symbols:

T_arr: { unit: "s", dim: "T", desc: "arrival time" }

n_eff: { unit: "1", dim: "1", desc: "effective refractive index" }

c_ref: { unit: "m·s^-1", dim: "L T^-1", desc: "reference propagation limit" }

T_fil: { unit: "N", dim: "M L T^-2" }

T_trans: { unit: "1", dim: "1" }

compat_rate: { unit: "1", dim: "1" }

eval:

metrics:

- { name: "gate_accuracy", direction: "↑" }

- { name: "gate_latency", direction: "↓" }

- { name: "compat_rate", direction: "↑" }

arrival_time:

delta_form: "general|factored"

path: "gamma(ell)"

measure: "d ell"

numeric: { Δell: 1e-3, ε_int: 1e-6, τ_c: 0.01 }

check_dim: true

references:

see:

- "EFT.WP.Core.Terms v1.0:P10-3"

- "EFT.WP.Core.Equations v1.1:S20-1"

- "EFT.WP.Core.Metrology v1.0:check_dim"

X. 校验规则（正则/一致性，强制）

• 数据集：^[A-Za-z0-9_\-]+@v?\d+(\.\d+)*$；哈希：^sha256:[0-9a-f]{64}$。
• 字段：name 唯一；type ∈ {int,float,string,bool,path,measure,duration}。
• 单位/量纲：字段若参与方程，unit 与 dim 不得为空，且 math.check_dim=true。
• 到达时：出现 T_arr 必含 arrival_time.path/measure 与 delta_form。
• 指标：direction ∈ {↑,↓,≈}；gate_* 命名与第8章一致。
• 引用：^EFT\.WP\.[\w\.]+ v\d+\.\d+(?:\.\d+)?:[PSMI]\d+(?:-\d+)?$ 必通过。

XI. 示例（人读摘要 × 机读片段，强制）

• 人读摘要：本数据字典定义 measurement.arrival.T_arr (s, T)、measurement.medium.{n_eff (1,1), c_ref (m·s^-1, L T^-1)} 与路径 gamma(ell)/d ell；评测指标包含 gate_accuracy/latency/compat_rate；引用锚点见清单。
• 机读片段：

dict.collections[0].fields[0]: { name:"T_arr", unit:"s", dim:"T", required:true }

arrival_time: { delta_form:"general", path:"gamma(ell)", measure:"d ell", check_dim:true }

eval.metrics: [{ name:"gate_accuracy", direction:"↑" }]