Screening Study 与 Touschek

English · 上一章：平衡计算链 · 下一章：非线性动力学

Screening Study 是现有正式工作流的编排页面，不增加另一套物理算法或结果库。它把项目、target、依赖、警告和证据放在一个状态图中。

阶段和状态

主链为 Validate Project → Radiation Slice Model → Equilibrium，然后分叉到 Matched Distribution 和 Local Momentum Acceptance。

状态	含义
Not ready	项目或 target 快照不完整
Ready	所有前置和资格门槛通过
Running	一次性正式工作流正在运行
Completed	解析、哈希、身份和 Engine 证据全部通过
Completed with warnings	仅允许的明确警告被保留；不是无警告通过
Blocked	前置、收敛、警告或兼容性门槛失败
Stale	证据属于其他 target/content/physics revision，只读
Failed	工作流或证据验证失败
Client-aborted	本地客户端停止；不宣称远端持久取消

页面重启后从已验证结果库重建 Completed，不相信只存在于上一会话内存中的状态。

三个运行按钮

• Run next available stage：按依赖顺序运行第一个可运行阶段。
• Run to equilibrium：运行到平衡；可复用精确匹配且重新验证过的 radiation evidence。
• Run available downstream screening：并行启动已就绪的 Matched 和/或 LMA 分支。
• Abort client：停止活动的一次性客户端。它不是 durable cancel。

每次远程运行前都会显示 target、精确项目身份、实际路线、一次性中断语义和固定物理边界。

Corrected Touschek v0.7

这是当前允许新提交的 Touschek 路线。它是持久 CPU 筛选，支持提交、退出后继续运行、重连、取消和四产物获取。

提交门槛包括：

• 完整 v0.2 项目；
• 当前 target/项目/修订下的 valid equilibrium；
• LONGITUDINAL_LINEAR_APPROXIMATION=pass；
• 明确的正 bunch population；
• 明确的正 geometric εy；
• Engine v0.7 精确能力可用。

在 Touschek 面板点击 Submit corrected screening，阅读确认框后提交。运行中可以 Reconnect / fetch result 或 Cancel request。完成后页面显示 screening lifetime、正负接受度贡献、公式/交叉代码审计和四个产物身份。

固定解释边界是：

• SCREENING ONLY；
• 公式层面经过交叉代码验证；
• 稀疏物理孔径；
• 不是 machine prediction；
• 不是 total beam lifetime。

它不包含气体散射、量子寿命、IBS、阻抗、误差/校正和真实机器状态。

v0.6 为什么只能看历史任务

v0.6 的 touschek-lifetime/0.2 使用了错误的 Equation 42 归一化。该路线永久标记为：

KNOWN FORMULA BUG · SUPERSEDED · HISTORICAL FAILURE EVIDENCE

新 Submit 和 Submit replay 已禁用。若你以前已经提交过 v0.6 job，仍可执行 Get/Watch/Reconnect/Cancel/ListArtifacts/FetchArtifact，并打开四个原始 JSON；它们进入独立隔离库，physicsVerified=false，错误寿命标量绝不会进入正式结果卡。

修正的本地基准约为 783379.643 s，同输入 PyAT 约为 783380.428 s；旧 v0.6 值约为 5286.457 s。这些数字是固定基准的错误诊断证据，不是你的项目寿命。

示例：从平衡到 v0.7

1. 打开包含明确 beam intensity 与 vertical emittance 的受审阅 v0.2 项目。
2. 选择 v0.7 Engine target。
3. 运行 lattice-derived equilibrium，确认 validity 为 valid 且纵向线性检查通过。
4. 打开 Screening Study，检查 corrected Touschek 状态为 Ready。
5. 点击 Submit，记录 tsj7-* job ID。
6. 可点击 Detach/退出 Studio；稍后重开并 Reconnect。
7. 完成后检查公式审计、项目/修订、Engine source 和四产物，再读取 screening lifetime。

如果按钮仍是 Blocked，逐项读 gate detail；不要为了绕过门槛把 RF bucket height 填成 LMA。