误差与轨道修正¶

English · 上一章：非线性动力学 · 下一章：结果与证据

Errors & Orbit Correction 是 v0.9 的持久 CPU 筛选工作区。它把一个受审阅、不可随意调整的 portable FODO profile 应用于当前 v0.2 项目，生成误差、BPM 响应/SVD 修正和有限 seed 容差证据。

当前固定 Profile¶

项目	固定配置
Seed ensemble	master `20260821`，显式 seed 0…7
Error scales	0、1、8
Error components	dx/dy alignment、roll、normal-field relative
BPM	8 个受审阅稳定实例，含 offset/gain/resolution
Correctors	8 H + 8 V，硬限制 ±400 µrad
Response	中心差分 `h=1 µrad` 与 `h/2`
SVD	cutoff `1e-6`、所需 rank 8/8、condition ≤ `1e8`
Yield	目标 0.90，Wilson 95% 区间，passing/failing bracket
计算规模	24 ensemble trials + 1 个单 seed PyAT 对照，CPU only

这些是只读的已审阅选择，不是通用 orbit-correction knob editor。

配置 v0.9 目标¶

执行目标必须一起填写：

v0.9 dedicated state directory: /absolute/dedicated/path
v0.9 exact source revision:     3b14dbcc5e525235a44db32ad96e20be5c33e3ef
v0.9 build ID:                  source:3b14dbcc5e52

state directory 应由 Engine 管理员预先创建并专用于正式 v0.9 状态。Engine executable 也必须指向这个精确构建。不要与 v0.8/5253 target 混用。

运行步骤¶

打开一个适配该 reviewed profile 的 v0.2 项目。仓库参考项目是：

protocol/orbit_error_model_v0_1/fixtures/portable-fodo-reference-ring.studio-project.json

选择 v0.9 target，进入 Calculate → Errors & Orbit Correction。
等待 runtime gate 完成精确能力协商。
可勾选 Show advanced read-only configuration and raw evidence，但不会改变计算。
点击 Run durable orbit correction v0.9 并确认筛选边界。
需要时使用 Detach、Reconnect 或 Cancel remote job。
完成后从 Retained formal results 重开结果。

结果页怎么读¶

Horizontal / Vertical Orbit：BPM 位置上的修正前后闭轨，横坐标是规范晶格 s。
Correctors：H/V command（µrad）及 ±400 µrad 硬限制；饱和会使筛选失败。
Response & SVD：rank、condition、singular values 和 h/h/2 收敛。
Yield & Tolerance：每个 scale/seed 的成功、残差、最大轨道、饱和，及 Wilson 95% yield/bracket。
Evidence：四产物身份、Engine 来源、checks、assumptions、applicability、provenance；可复制 reviewed configuration。

求解器返回并不等于成功。Response 收敛、SVD rank/condition、BPM/轨道残差和 Corrector hard limit 必须全部过门槛。非收敛、rank 不足、病态或饱和结果保留诊断，但不会发布 qualification evidence。

解释边界¶

结果始终是 planar、reference-δ 4D、ideal/reference-model SCREENING，MACHINE PREDICTION: FALSE。八 seed 的 Wilson 区间不是机器渐近容差；PyAT 对照不是测量验证。

当前不支持 strong coupling/skew、dispersion/chromaticity correction、LOCO、survey/measured response、hysteresis、power-supply dynamics、time drift、误差下 DA/FMA/lifetime、GPU 或 SLURM。轨道修正成功不能推导 DA、LMA、Touschek lifetime、commissioning readiness 或机器可运行性。