The Zgoubidoo Python Framework for Ray-Tracing Simulations with Zgoubi: Applications to Fixed-Field Accelerators

The study of beam dynamics in accelerators featuring main magnets with complex geometries such as Fixed Field Accelerators (FFAs) requires simulation codes allowing step-by-step particle tracking in complex magnetic fields, such as the Zgoubi ray-tracing code. To facilitate the use of Zgoubi and to allow readily processing the resulting tracking data, we developed a modern Python 3 interface, Zgoubidoo, using Zgoubi in the backend. In this work, the key features of Zgoubidoo are illustrated by detailing the main steps to obtain a non-scaling FFA accelerator from a scaling design. The results obtained are in excellent agreement with prior results, including the tune computation and orbit shifts. These results are enhanced by Zgoubidoo beam dynamics analysis and visualization tools, including the placement of lattice elements in a global coordinate system and the computation of linear step-by-step optics. The validation of Zgoubidoo on conventional scaling and non-scaling FFA designs paves the way for future uses in innovative FFA design studies.