物理输入

English · 上一章：项目与晶格 · 下一章：连接 Engine

Physics Inputs 页面把“可编辑值”“派生只读值”“缺失项”和“它会阻塞什么”放在一起。它不是表单完整度检查器；最终是否能计算仍由 Engine 对精确项目修订的验证决定。

v0.1 与 v0.2 的关系

打开 v0.1 项目时，Studio 会生成确定性的 v0.2 authoring draft，列出无法从 v0.1 推导的字段。你可以导出这个草稿，但缺失项仍明确保持缺失，不会被填零或套用默认机器参数。

打开完整 v0.2 项目时，可以直接编辑经过审阅的 RF/平衡字段，并以一次原子修订应用。

可编辑字段

字段	规则	含义
Main harmonic h	正整数	主 RF 谐波数
Total RF voltage [V]	正有限值	权威总电压
RF reference phase [rad]	有限值	参考相位
Synchronism tolerance	0 < value ≤ 1e-3	RF 同步相对容差
Longitudinal range [σ]	≥ 3	平衡筛选纵向范围

fRF 由 h、参考粒子速度和环周长派生，只读且不能单独编辑。点击 Apply as new v0.2 revision 后，上述值和相联 cavity 值一起更新。

Readiness 表怎么读

每一行给出路径、状态和物理后果。常见状态包括 Present、Absent、Blocked、Preserved、Screening only 和 Available after negotiation。

重要依赖：

• 没有同步 RF，会阻塞纵向平衡；
• 没有 radiation model，会阻塞辐射积分和阻尼；
• 没有 equilibrium model，会阻塞平衡求解；
• bunch population 和 fill pattern 对单粒子平衡可能不是阻塞项，但会阻塞可信的强度、集体效应或寿命工作；
• 缺失垂直几何发射度不会自动由水平发射度猜出；匹配分布和 Touschek 会明确要求它；
• physical aperture 来源是几何证据，不等于动力学孔径或局部动量接受度；
• RF bucket height 永远不能代替 local momentum acceptance。

两条平衡输入路线

Studio 会根据项目自动选择：

1. Supplied-model v0.2 路线：项目已带完整且一致的辐射切片；直接验证并计算 equilibrium-result/0.1。
2. Lattice-derived v0.3 路线：项目没有合格切片；Engine 先从晶格生成 8/32/128 收敛的 radiation-slice evidence，再计算 equilibrium-result/0.2。

后一条路线是匹配分布和局部动量接受度的标准前置条件。修改非 RF 晶格后，Studio 会撤回旧 supplied slices，防止把旧光学继续用于新修订。

示例：更新 RF 而不手工改频率

打开：

protocol/v0_3/fixtures/fodo-ring.studio-project.json

1. 进入 Design → Physics Inputs。
2. 记下 Derived fRF。
3. 修改 Main harmonic 或 Total RF voltage；保持容差在允许范围内。
4. 点击 Apply as new v0.2 revision。
5. 回到 Project → Review，确认 RF 和 physics revision 变化。
6. 若更改了谐波数，确认 fRF 自动重算；不要再去编辑 cavity frequency。
7. 重新运行平衡，因为旧结果应显示为 stale。

示例只说明一致性更新。谐波、电压和相位应来自你的 RF 设计评审，而不是为了让按钮变绿而任意填写。

导出 v0.2 草稿

对可迁移的 v0.1 项目点击 Export deterministic v0.2 draft…。输出保留：

• 确定性的 content/physics identity；
• 已知 v0.1 值；
• 每一项 unresolved input 及原因；
• physical aperture 和 momentum acceptance 的原来源声明。

它是待补充的设计输入，不是平衡结果。