How qin-smart/beam-dynamics works
UED beam-dynamics simulator: users configure one beamline, run either the deterministic AG envelope model or OCELOT particle tracking, inspect beam diagnostics, and cross-check the two routes. The graph retains the documented drift, solenoid, RF, and space-charge stages and the validation framework. Source excerpts are partial; unsampled subsystem links are included only where the README or sampled code supports them.
Main entry points: ued_beamline_v2.py Beamline tracker · backend.py Backend drivers · params.py Parameter loader · run_shared.py AG adapter
Components 17
Shared configuration
- Beamline config
shared/beamline_config.yaml - Parameter loader
shared/params.py - Beam physics
shared/beam_physics.py - Output schema
shared/output_schema.py - Coordinate adapter
shared/ocelot_coords.py
AG envelope route
- AG adapter
AG/run_shared.py - 6D envelope solver
AG/beam_dynamics_6d.py - External forces
AG/external_forces.py - Covariance model
AG/beam_dynamics_6d_cov.py
OCELOT particle route
- Beamline tracker
GPT模拟/ued_beamline_v2.py
Validation and comparison
- Validation runner
validation/run_all.py - Backend drivers
validation/backend.py - Beam result
validation/beam_result.py - Route comparison
shared/compare.py - Analytic references
validation/reference.py
Other components
- Researcher
- OCELOT runtime
Connections 21
- Researcher → Beamline config: sets parameters
- Beamline config → Parameter loader: loads config
- Parameter loader → AG adapter: provides parameters
- Parameter loader → Beamline tracker: provides parameters
- Parameter loader → Backend drivers: provides parameters
- AG adapter → 6D envelope solver: runs propagation
- 6D envelope solver → External forces: applies forces
- AG adapter → Output schema: formats output
- Covariance model → 6D envelope solver: supports covariance tracking
- Beamline tracker → OCELOT runtime: tracks particles
- Beamline tracker → Coordinate adapter: uses coordinate access
- Beamline tracker → Output schema: formats output
- Backend drivers → 6D envelope solver: drives AG backend
- Backend drivers → OCELOT runtime: drives OCELOT backend
- Validation runner → Backend drivers: runs backends
- Backend drivers → Beam result: returns measurements
- Validation runner → Analytic references: checks against references
- Route comparison → Beam result: compares route results
- Researcher → Beamline tracker: runs beamline
- Researcher → AG adapter: runs envelope model
- Researcher → Validation runner: starts validation