• Images
• Videos
• Documents
• Books
• Articles

Single particle dynamics codes

For many applications it is sufficient to track a single particle through the relevant electric and magnetic fields. Old codes no longer maintained by their original authors or home institutions include: BETA,³ AGS, ALIGN, COMFORT, DESIGN, DIMAD, HARMON, LEGO, LIAR, MAGIC, MARYLIE, PATRICIA, PETROS, RACETRACK, SYNCH,⁴ TRANSPORT, TURTLE, and UAL. Some legacy codes are maintained by commercial organizations for academic, industrial and medical accelerator facilities that continue to use those codes. TRACE 3-D and TURTLE are among the historic codes that are commercially maintained.⁵

Major maintained codes include:

	Single Particle Dynamics	Spin Tracking	Taylor Maps	Weak-Strong Beam-Beam Interaction	Electromagnetic Field Tracking	Higher Energy Collective Effects	Synchrotron Radiation Effects	Radiation Tracking	Wakefields	Extensible	Notes
Accelerator Toolbox (AT),6	Yes	Yes7	No	No	No	Yes	No	No	No	Yes
ASTRA8	Yes	No	No	No	Yes	Yes	No	No	Yes	No	For space-charge simulations
BDSIM9	Yes	No	No	No	Yes	No	No	No	No	Yes	For particle-matter simulations.
Bmad (contains PTC)10	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Reproduces PTC's unique beam line structures. Simulates X-rays.
COSY INFINITY11	Yes	Yes	Yes	No	Yes	No	No	No	No	Yes	Arbitrary-order differential-algebraic transfer maps
DYNAC12	Yes	No	No	No	No	No	No	No	No	No
Elegant13	Yes	No	No	No	Yes	Yes	Yes	No	Yes	No
MAD8 and MAD-X (includes PTC)14	Yes	No	Yes	Yes	No	No	Yes	No	No	No
MAD-NG15	Yes	No	Yes	Yes	No	No	Yes	No	No	Yes	Extensible, embeds LuaJIT
MERLIN++1617	Yes	Yes	No	No	No	No	No	No	Yes	Yes	Other: beam-matter interactions, sliced-macroparticle tracking
OCELOT18	Yes	No	No	No	No	Yes	Yes	Yes	Yes	Yes
OPA19	Yes	No	No	No	No	No	No	No	No	No
OPAL20	Yes	No	Yes	No	Yes	Yes	No	No	Yes	Yes	runs on laptops and on x 10k cores.
PLACET21	Yes	No	No	No	No	Yes	Yes	No	Yes	Yes	LINAC including wakefields simulations.
Propaga22	Yes	No	No	No	No	No	No	No	No	Yes
PTC23	Yes	Yes	Yes	Yes	Yes	No	No	No	No	Yes
SAD24	Yes	No	No	Yes	No	Yes	Yes	No	Yes	No
SAMM25	Yes	Yes	No	No	No	No	No	No	No	No
SixTrack26	Yes	No	Yes	Yes	No	No	No	No	No	No	Can run on BOINC
Xsuite27	Yes	No	Yes	Yes	Yes	Yes	Yes	No	Yes	Yes	Supports multi CPU and GPU tracking
Zgoubi2829	Yes	Yes	No	No	Yes	No	Yes	No	No	Yes

Columns

Spin Tracking Tracking of a particle's spin. Taylor Maps Construction of Taylor series maps to high order that can be used for simulating particle motion and also can be used for such things as extracting single particle resonance strengths. Weak-Strong Beam-Beam Interaction Can simulate the beam-beam interaction with the simplification that one beam is essentially fixed in size. See below for a list of strong-strong interaction codes. Electromagnetic Field Tracking Can track (ray trace) a particle through arbitrary electromagnetic fields. Higher Energy Collective effects The interactions between the particles in the beam can have important effects on the behavior, control and dynamics. Collective effects take different forms from Intrabeam Scattering (IBS) which is a direct particle-particle interaction to wakefields which are mediated by the vacuum chamber wall of the machine the particles are traveling in. In general, the effect of direct particle-particle interactions is less with higher energy particle beams. At very low energies, space charge has a large effect on a particle beam and thus becomes hard to calculate. See below for a list of programs that can handle low energy space charge forces. Synchrotron radiation effects

Can simulate the effect of synchrotron radiation emission on the particles being tracked.

Radiation Tracking Ability to track the synchrotron radiation (mainly X-rays) produced by the acceleration of charged particles.

This is not the same as simulating the effect of synchrotron radiation emission on the particles being tracked.

Wakefields The electro-magnetic interaction between the beam and the vacuum chamber wall enclosing the beam are known as wakefields. Wakefields produce forces that affect the trajectory of the particles of the beam and can potentially destabilize the trajectories. Extensible Open source and object oriented coding to make it relatively easy to extend the capabilities.

Space charge codes

The self interaction (e.g. space charge) of the charged particle beam can cause growth of the beam, such as with bunch lengthening, or intrabeam scattering. Additionally, space charge effects may cause instabilities and associated beam loss. Typically, at relatively low energies (roughly for energies where the relativistic gamma factor is less than 10 or so), the Poisson equation is solved at intervals during the tracking using particle-in-cell algorithms. Space charge effects lessen at higher energies so at higher energies the space charge effects may be modeled using simpler algorithms that are computationally much faster than the algorithms used at lower energies. Codes that handle low energy space charge effects include:

• ASTRA³⁰
• Bmad
• CST Studio Suite³¹
• GPT³²
• IMPACT³³
• ImpactX³⁴
• mbtrack³⁵
• ORBIT,³⁶ PyORBIT³⁷
• OPAL³⁸
• PyHEADTAIL³⁹
• Synergia⁴⁰
• TraceWin⁴¹
• Tranft⁴²
• VSim⁴³
• Warp⁴⁴
• Xsuite⁴⁵

At higher energies, space charge effects include Touschek scattering and coherent synchrotron radiation (CSR). Codes that handle higher energy space charge include:

• Bmad
• ELEGANT
• MaryLie
• SAD

"Strong-strong" beam-beam effects codes

When two beams collide, the electromagnetic field of one beam will then have strong effects on the other one, called beam-beam effects. So called "weak-strong" simulations model one beam (called the "strong" beam since it affects the other beam) as a fixed distribution (typically a Gaussian distribution) which interacts with the particles of the other "weak" beam. This greatly simplifies the simulation. A full "strong-strong" simulation is more complicated and takes more simulation time. Strong-strong codes include

• GUINEA-PIG⁴⁶
• BeamBeam3D⁴⁷
• Xsuite⁴⁸

Impedance computation codes

An important class of collective effects may be summarized in terms of the beams response to an "impedance". An important job is thus the computation of this impedance for the machine. Codes for this computation include

• ABCI⁴⁹
• ACE3P⁵⁰
• CST Studio Suite⁵¹
• GdfidL⁵²
• TBCI⁵³
• VSim⁵⁴

Magnet and other hardware-modeling codes

To control the charged particle beam, appropriate electric and magnetic fields must be created. There are software packages to help in the design and understanding of the magnets, RF cavities, and other elements that create these fields. Codes include

• ACE3P⁵⁵
• COMSOL Multiphysics⁵⁶
• CST Studio Suite⁵⁷
• OPERA⁵⁸
• VSim⁵⁹

Lattice description and data interchange issues

Given the variety of modeling tasks, there is not one common data format that has developed. For describing the layout of an accelerator and the corresponding elements, one uses a so-called "lattice file". There have been numerous attempts at unifying the lattice file formats used in different codes. One unification attempt is the Accelerator Markup Language, and the Universal Accelerator Parser.⁶⁰ Another attempt at a unified approach to accelerator codes is the UAL or Universal Accelerator Library.⁶¹ As of 2023 neither of these formats are maintained.

The file formats used in MAD may be the most common, with translation routines available to convert to an input form needed for a different code. Associated with the Elegant code is a data format called SDDS, with an associated suite of tools. If one uses a Matlab-based code, such as Accelerator Toolbox, one has available all the tools within Matlab.

For the interchange of particle positions and electromagnetic fields, the OpenPMD⁶² standard defines a format which can then be implemented with a file format like HDF5.

Codes in applications of particle accelerators

There are many applications of particle accelerators. For example, two important applications are elementary particle physics and synchrotron radiation production. When performing a modeling task for any accelerator operation, the results of charged particle beam dynamics simulations must feed into the associated application. Thus, for a full simulation, one must include the codes in associated applications. For particle physics, the simulation may be continued in a detector with a code such as Geant4.

For a synchrotron radiation facility, for example, the electron beam produces an x-ray beam that then travels down a beamline before reaching the experiment. Thus, the electron beam modeling software must interface with the x-ray optics modelling software such as SRW,⁶³ Shadow,⁶⁴ McXTrace,⁶⁵ or Spectra.⁶⁶ Bmad⁶⁷ can model both X-rays and charged particle beams. The x-rays are used in an experiment which may be modeled and analyzed with various software, such as the DAWN science platform.⁶⁸ OCELOT⁶⁹ also includes both synchrotron radiation calculation and x-ray propagation models.

Industrial and medical accelerators represent another area of important applications. A 2013 survey estimated that there were about 27,000 industrial accelerators and another 14,000 medical accelerators world wide,⁷⁰ and those numbers have continued to increase since that time.⁷¹ Codes used at those facilities vary considerably and often include a mix of traditional codes and custom codes developed for specific applications. The Advanced Orbit Code (AOC)⁷² developed at Ion Beam Applications is an example.

See also

• List of codes from UCLA Particle Beam Physics Laboratory Archived 2018-07-17 at the Wayback Machine
• Comparison of Accelerator Codes

References

1. Computer Codes for Particle Accelerator Design and Analysis: A Compendium, Second Edition, Helen Stokes Deaven and Kwok Chi Dominic Chen, Los Alamos National Laboratory report number LA-UR-90-1766, 290 pages (1990). ↩

2. the CERN CARE/HHH website Archived December 13, 2012, at the Wayback Machine https://oraweb.cern.ch/pls/hhh/code_website.disp_allcat ↩

3. "user's guide" (PDF). Archived from the original (PDF) on 2018-07-04. Retrieved 2013-11-16. https://web.archive.org/web/20180704202245/http://care-hhh.web.cern.ch/care-hhh/Simulation-Codes/Optics/Literature/BETA_MANUAL.pdf ↩

4. libtracy at sourceforge.net http://sourceforge.net/projects/libtracy/ ↩

5. AccelSoft Inc. website http://www.accelsoftinc.com/ ↩

6. ATcollab website https://github.com/atcollab/at ↩

7. See https://github.com/carmignani/festa https://github.com/carmignani/festa ↩

8. ASTRA Homepage http://www.desy.de/~mpyflo/ ↩

9. BDSIM Homepage http://www.pp.rhul.ac.uk/bdsim ↩

10. Bmad home page http://www.lepp.cornell.edu/bmad/ ↩

11. "COSY". http://www.cosyinfinity.org ↩

12. "DYNAC". https://dynac.web.cern.ch/dynac/dynac.html ↩

13. ELEGANT, a Flexible SDDS Compliant Code for Accelerator Simulation software https://www.aps.anl.gov/Accelerator-Operations-Physics/Software ↩

14. "MAD - Methodical Accelerator Design". [email protected]. Retrieved 2020-09-09. http://cern.ch/mad/ ↩

15. "MAD - Methodical Accelerator Design". [email protected]. Retrieved 2020-09-09. http://cern.ch/mad/ ↩

16. Appleby, Robert; Barlow, Roger J.; Bungau, Adriana; Fallon, James; Kruecker, Dirk; Molson, James; Rafique, Haroon; Rowan, Scott; Serluca, Maurizio; Sjøbæk, Kyrre Ness; Toader, Adina; Tygier, Sam; Walker, Nick; Wolski, Andy (2019-03-03). "Github Merlin-Collaboration/Merlin". doi:10.5281/zenodo.2598428. {{cite journal}}: Cite journal requires |journal= (help) https://github.com/Merlin-Collaboration/Merlin ↩

17. Appleby, Robert; Barlow, Roger J.; Bungau, Adriana; Fallon, James; Kruecker, Dirk; Molson, James; Rafique, Haroon; Rowan, Scott; Serluca, Maurizio; Sjøbæk, Kyrre Ness; Toader, Adina; Tygier, Sam; Walker, Nick; Wolski, Andy (2019). "Merlin++". doi:10.5281/zenodo.2598428. {{cite journal}}: Cite journal requires |journal= (help) /wiki/Doi_(identifier) ↩

18. OCELOT collaboration on GitHub https://github.com/ocelot-collab/ocelot/ ↩

19. OPA website https://ados.web.psi.ch/opa/ ↩

20. "Home · Wiki · OPAL / SRC". https://gitlab.psi.ch/OPAL/src/-/wikis/home ↩

21. PLACET manual https://cds.cern.ch/record/2145365?ln=en ↩

22. Propaga GitHub repository https://github.com/ALaDyn/Propaga ↩

23. "GitHub - jceepf/fpp_book". GitHub. 2019-02-06. https://github.com/jceepf/fpp_book ↩

24. SAD home page at kek.jp http://acc-physics.kek.jp/SAD/ ↩

25. SAMM, another Matlab based tracking code, at liv.ac.uk http://pcwww.liv.ac.uk/~awolski/main_links_computercodes.htm ↩

26. SixTrack home page at cern.ch http://sixtrack.web.cern.ch/SixTrack/ ↩

27. Xsuite home page at cern.ch https://xsuite.web.cern.ch/ ↩

28. Zgoubi home page at sourceforge.net https://sourceforge.net/projects/zgoubi/files/ ↩

29. Zgoubi Users' Guide https://sourceforge.net/p/zgoubi/code/HEAD/tree/trunk/guide/Zgoubi.pdf ↩

30. ASTRA Homepage http://www.desy.de/~mpyflo/ ↩

31. PIC solver at cst.com https://www.cst.com/solutions#SolverIds-Param%5B%5D=afcdc15d9d8a463c86193b62acc4b805 ↩

32. General Particle Tracer (GPT) from Pulsar Physics http://www.pulsar.nl/gpt/ ↩

33. "IMPACT homepage at Berkeley Lab". Archived from the original on 2015-04-16. Retrieved 2015-04-09. https://web.archive.org/web/20150416205107/http://amac.lbl.gov/~jiqiang/impact/ ↩

34. ImpactX: an s-based beam dynamics code including space charge effects from Berkeley Lab https://github.com/ECP-WarpX/impactx ↩

35. THE MULTIPARTICLE TRACKING CODES SBTRACK AND MBTRACK. R. Nagaoka, PAC '09 paper here http://accelconf.web.cern.ch/accelconf/PAC2009/papers/fr5rfp046.pdf ↩

36. ORBIT home page at ornl.gov http://web.ornl.gov/~jzh/JHolmes/ORBIT.html ↩

37. PyORBIT Collaboration https://github.com/PyORBIT-Collaboration ↩

38. OPAL homepage https://gitlab.psi.ch/OPAL/src/wikis/home ↩

39. PyHEADTAIL wiki https://github.com/PyCOMPLETE/PyHEADTAIL/wiki ↩

40. Synergia home page at fnal.gov https://web.fnal.gov/sites/Synergia/SitePages/Synergia%20Home.aspx ↩

41. TraceWin at CEA Saclay http://irfu.cea.fr/Sacm/logiciels/index3.php ↩

42. TRANFT user's manual, BNL--77074-2006-IR http://www.osti.gov/scitech/biblio/896444 https://www.osti.gov/scitech/biblio/896444 ↩

43. VSim at Tech-X https://www.txcorp.com/vsim ↩

44. Warp wiki http://warp.lbl.gov ↩

45. Xsuite home page at cern.ch https://xsuite.web.cern.ch/ ↩

46. "GUINEA-PIG Twiki". twiki.cern.ch. Archived from the original on 2022-01-20. Retrieved 2020-07-03. https://twiki.cern.ch/twiki/bin/view/ABPComputing/Guinea-Pig ↩

47. "BeamBeam3D GitHub Repo"."J. Qiang, M. Furman, and R. Ryne, "A parallel particle-in-cell model for beam–beam interaction in high energy ring colliders"". J. Comp. Phys. 2004. doi:10.1016/j.jcp.2004.01.008. https://github.com/beam-beam/BeamBeam3D ↩

48. Xsuite home page at cern.ch https://xsuite.web.cern.ch/ ↩

49. ABCI home page at kek.jp http://abci.kek.jp/abci.htm ↩

50. ACE3P at slac.stanford.gov https://portal.slac.stanford.edu/sites/ard_public/acd/Pages/Default.aspx ↩

51. CST Archived 2018-07-29 at the Wayback Machine, Computer Simulation Technology at cst.com https://www.cst.com/ ↩

52. GdfidL, Gitter drueber, fertig ist die Laube at gdfidl.de http://www.gdfidl.de/ ↩

53. T. Weiland, DESY ↩

54. VSim at Tech-X https://www.txcorp.com/vsim ↩

55. ACE3P at slac.stanford.gov https://portal.slac.stanford.edu/sites/ard_public/acd/Pages/Default.aspx ↩

56. COMSOL home page at comsol.com http://www.comsol.com/ ↩

57. CST Electromagnetic Studio at cst.com https://archive.today/20131115111937/https://www.cst.com/Applications/Category/Magnetostatics ↩

58. "OPERA at magnet-design-software.com". Archived from the original on 2013-12-24. Retrieved 2013-11-15. https://web.archive.org/web/20131224023436/http://magnet-design-software.com/webinar-introduction-magnet-design-opera/ ↩

59. VSim at Tech-X https://www.txcorp.com/vsim ↩

60. Description of AML and UAP at cornell.edu http://www.lepp.cornell.edu/~dcs/aml/ ↩

61. See references by N. Malitsky and Talman such as this manual from 2002. http://www.bnl.gov/isd/documents/24937.pdf ↩

62. OpenPMD GitHub repository. https://github.com/openPMD/openPMD-standard ↩

63. SRW home page at esrf.eu http://www.esrf.eu/Accelerators/Groups/InsertionDevices/Software/SRW ↩

64. Shadow home page at esrf.eu http://www.esrf.eu/computing/scientific/raytracing/ ↩

65. McXTrace home page at mcxtrace.org http://www.mcxtrace.org/ ↩

66. "Spectra home page at riken.go.jp". Archived from the original on 2013-08-27. Retrieved 2013-11-15. https://web.archive.org/web/20130827221328/http://radiant.harima.riken.go.jp/spectra/ ↩

67. Bmad home page http://www.lepp.cornell.edu/bmad/ ↩

68. DAWN science platform website http://www.dawnsci.org ↩

69. "An Introduction to Ocelot". GitHub. 16 December 2021. https://github.com/ocelot-collab/ocelot ↩

70. R. W. Hamm and M. E. Hamm, Industrial Accelerators https://accelconf.web.cern.ch/IPAC2013/papers/weib201.pdf ↩

71. session on accelerator business opportunities at IPAC-17 https://accelconf.web.cern.ch/ipac2017/talks/tuia2_talk.pdf ↩

72. AOC, A Beam Dynamics Code for Medical and Industrial Accelerators https://accelconf.web.cern.ch/ipac2016/papers/tupoy002.pdf ↩