Engine Capabilities and Version Boundaries¶
简体中文 · Previous: Import and migration · Next: CLI and build
This chapter is for Engine operators and advanced users checking exact capability boundaries. Studio does not calculate these quantities itself; it negotiates explicit Engine capability and strictly validates returned artifacts.
Current route matrix¶
| Route | User capability | Project | Execution | Current status/boundary |
|---|---|---|---|---|
| v0.1 | 4D Twiss optics | v0.1 | Interactive one-shot | Available, SCREENING |
| v0.1 | Generic CPU tracking | v0.1 | Durable | Available, at most 50M particle-turns |
| v0.2 | Supplied-slice radiation–RF equilibrium | v0.2 | One-shot | Available, result/0.1 |
| v0.3 | Lattice-derived slices + equilibrium | v0.2 | One-shot | Available, 8/32/128 convergence, result/0.2 |
| v0.4 | Matched distribution | v0.2 + qualified equilibrium/0.2 | One-shot | 128–8192 particles; linear/planar/uncoupled |
| v0.5 | Local momentum acceptance | v0.2 + qualified equilibrium/0.2 | One-shot, ≤1800 s | Sparse aperture, not lifetime |
| v0.6 | Touschek | v0.2 | Historical durable | Formula bug; no new submit, recovery only |
| v0.7 | Corrected Touschek | v0.2 + beam/equilibrium gates | Durable | Screening lifetime, not total lifetime |
| v0.8 | Exact-lattice DA/FMA | v0.2 | Durable | CPU fixed-δ 4D finite-turn |
| v0.9 | Orbit error/correction | v0.2 + reviewed profile | Durable | Planar reference-δ ideal model |
One-shot means no durable reconnect/cancel contract after client interruption. Durable work has a stable remote identity, state, and reconnect path.
Accepted Engine sources¶
These identities are deployment evidence, not project inputs:
| Route | Accepted/required Engine source |
|---|---|
| v0.1 | e50a6e6952cbb85fd1e3a831e4b5b2010b9b6bd9 |
| v0.2 | dc9860b43cc9a2d929e0568df814f28d733270bc |
| v0.3 | fdab5539893d66bf37bf05fb4ab246ecab1476b7 |
| v0.4 / v0.5 | f4189eba95469be1e286d6169e2781376c4e58c8 |
| v0.6 historical | 5063daaa2ac6501645742c6997fc72d46679aabb |
| v0.7 | 79fad5d1bb3d2f3b3b9be417d6eb23a6bb1332a9 |
| v0.8 current gate | 5253d6758042381bab15ed9c385aef78bd0331f6 |
| v0.9 current gate | 3b14dbcc5e525235a44db32ad96e20be5c33e3ef |
Do not assume a newer commit satisfies an older exact identity. Deploy accepted releases and use separate Studio targets for incompatible gates.
v0.8 fixed limits and exclusions¶
- CPU-only turns 512/1024/2048;
- up to 7 deltas, 2,048 turns, 8,192 final launches, and 65,536 convergence trials;
- radial/angle intervals 8/16/32 and magnet slices 2/4/8;
- three artifacts: lattice projection, nonlinear screening, job summary;
- no RF kick, radiation, quantum excitation, collective effects, errors/correction, strong coupling, GPU, or SLURM.
v0.9 fixed limits and exclusions¶
- one reviewed portable-FODO profile;
- maximum 512 element definitions, 128 occurrences/BPMs/correctors, 512 seeds, 32 scales;
- formal profile uses 8 BPMs, 16 correctors, 8 seeds, 3 scales;
- four artifacts: error model, correction screening, tolerance summary, job summary;
- no coupling/skew, dispersion/chromaticity, LOCO, survey/measured response, hysteresis, power-supply dynamics, GPU, or SLURM.
Explicitly unavailable system capabilities¶
There is no generic GPU/SLURM RPC execution, arbitrary workflow daemon/dashboard, normal-mode coupling, strong-coupling correction, complete collective/IBS/wake/space-charge model, DA/FMA/ lifetime under realistic errors, measured-machine loop, or AI-agent automatic execution interface. Read-only OFF switches cannot be bypassed by editing JSON.
Compatibility checklist¶
- Confirm SSH principal and runtime user.
- Point the executable to the accepted build.
- Check expected protocol/namespace/build/source in Hello/Capabilities.
- Check CPU, permissions, durability/reconnect/fetch semantics.
- Check request/project/artifact limits.
- Keep v0.8/v0.9 state roots, namespaces, credentials, and job prefixes isolated.
- In Studio run Test SSH, Test Engine, then the specialized runtime gate.
- Label fixtures as reference/acceptance; never promote them into a user's formal result.
Frozen protocol and acceptance records remain under protocol/ and docs/round_*; ordinary users
do not need to read protobuf definitions.