非线性动力学¶
English · 上一章：Screening Study · 下一章：轨道修正
Nonlinear Dynamics 工作区用于 v0.2 项目的持久 exact-lattice、有限 turn、固定 δ 4D DA/FMA 筛选。Engine v0.8 是物理权威；Studio 保存修订绑定的研究草稿、管理任务并可视化严格证据。
第一次打开工作区时，Studio 还会加载内置的冻结 acceptance fixture，便于离线检查 DA/FMA、loss 和 convergence 视图。Evidence origin 会明确标为 acceptance/validation；这些数据不能提升为当前项目的正式结果。当前项目的 durable result 到达后才会进入独立 formal store。
设置研究¶
打开 Calculate → Nonlinear Dynamics → Setup：
| 输入 | 可选值/默认 |
|---|---|
| Observation occurrence | 当前晶格中的稳定实例 |
| Location | Entrance、Center 或 Exit |
| Explicit δ list | 默认 -0.01, 0, 0.01，最多由 Engine 限制为 7 个 |
| Convergence profile | 固定 v0.8：512/1024/2048 turns |
| Aperture source | 只读，显示完整性与物理 loss 是否允许 |
Radiation、quantum excitation、collective effects、RF kick、magnet errors 和 orbit correction 都固定为 OFF，不能在界面中打开。这不是遗漏，而是 v0.8 已接受物理边界。
保存 .vmaproj 会保存这个研究草稿。若项目内容或 physics revision 改变，草稿显示 STALE REVISION，必须重新审阅绑定。
运行和恢复¶
选择精确兼容的 v0.8 target。页面会自动协商能力；只有 protocol、source revision、CPU durable/reconnect、限制和固定 profile 全部一致时，Run durable nonlinear v0.8 才启用。
提交后：
- Detach 停止观察但远端继续；
- Reconnect 从保存的 job/token 继续；
- Cancel remote job 请求合作式取消；
- Retained formal results → Reopen 离线重开已验证结果。
当前要求精确 Engine source 5253d6758042381bab15ed9c385aef78bd0331f6。用更新或不同构建并不会自动放宽门槛。
六个结果页¶
- Dynamic Aperture：按 δ 查看第一象限稳定边界；可叠加全部 δ、缩放并导出 PNG/SVG。
- Tune Footprint / FMA：按 δ、幅度、角度和 resonance order 过滤
Qx–Qy点；空心点是不合格证据。 - Losses：按 loss cause 过滤，查看 lattice
s、turn 直方图和具体 occurrence。 - Convergence：分别查看 turn、径向、角度和切片相邻层级误差门槛。
- Evidence：查看项目/修订、坐标、Engine、projection、资格与哈希，可导出 CSV 和规范 JSON。
- Setup：任务状态、当前草稿和保留结果。
如果数值收敛或独立证据失败，页面仍可展示 diagnostic points，但显示：
不会绘制或导出“合格边界”。
上手例子¶
打开：
- 选择
Entrance和-0.01, 0, 0.01。 - 选择 v0.8/5253 target，等待 runtime gate 显示可用。
- 点击 Run 并记录
ndj8-*job ID。 - 运行一段时间后点 Detach，确认状态说明远端未取消。
- 点 Reconnect，等待三类产物取回。
- 先看 Convergence，再看 DA 和 FMA；最后导出 PNG 和 CSV。
解释边界¶
这是 ideal-lattice CPU finite-turn screening。有限 turn 存活不等于无限时间稳定；DA 不是 LMA，也不能作为 Touschek 输入；不完整孔径不能支持完整 physical-loss 声明；PyAT 一致只代表交叉代码数值证据。该路线没有 RF/辐射跟踪、量子激发、集体效应、误差、修正、强耦合、GPU 或 SLURM。