约定接口

本页列出物理适配器消费的权威常量和自检入口。语义解释与推导见 基矢与相位约定。

qaiji.core.conventions.QASM3_INDEX_TO_PHYSICAL: Final

将 OpenQASM 计算基标签映射到物理态名称。

证伪状态:参照系定义。其余约定都以本表为参照,语义权威在本仓; 外部实现对 OpenQASM 比特另有物理解释时,以差异报告处理,不据此改写本表。 其变动由 self_check 与跨库判据 R3b 共同看守。

qaiji.core.conventions.OPTICS_INDEX_TO_PHYSICAL: Final

将光学适配器的存储下标映射到物理态名称。

证伪状态:已跨库证伪(判据 R0–R4,范围限于光学适配器的门、电路与原生后端层)。 快照事实 XR-SP、XR-SM、XR-Z、XR-ASSEMBLE、XR-SEMPARAM、XR-APPLY-MPS、XR-APPLY-SV、 XR-INIT、XR-INIT-PARSE,见源码仓库 tests/core/_optics_snapshot.py。

qaiji.core.conventions.QASM3_TO_OPTICS_BIT: Final

将 OpenQASM 基组标签翻译为光学适配器的存储下标。

证伪状态:推导成立。由 QASM3_INDEX_TO_PHYSICAL 与 OPTICS_INDEX_TO_PHYSICAL 经 self_check 推出。注意:光学适配器自带的 OpenQASM 加载路径不做这次翻转 (比特 b 直接作为下标 b),不在本契约覆盖范围内,二者不可混用。

qaiji.core.conventions.RZ_PHASE_CONVENTION: Final

Z 轴旋转的规范符号约定。

证伪状态:已跨库证伪(判据 R3a、R3b)。快照事实 XR-RZ、XR-Z, 见源码仓库 tests/core/_optics_snapshot.py。跨到光学适配器的存储下标时 Z 的物理含义反号, 因此同一角度的物理作用相反:RZ_optics(θ) ≡ RZ_qasm(−θ)。

qaiji.core.conventions.self_check(atol=1e-10)[源代码]

当声明的基组约定与 RZ 约定不自洽时抛出异常。

参数:

atol (float)

返回类型:

None