13.1 Highlights of What’s New in Version 2025.2

Here is a summary of what’s changed since release 2025.2 Historical change logs are collected in Section 13.

13.1.1 Bug Fixes for Elements

• The CSBEND and SBEN elements did not behave well when very small angles were used together with non-zero gradient or sextupole terms. This was reported by forum user Skamarokha.
• Fixed issues with computation of radiation integrals when dipoles have zero bending angle. This was reported by forum user Skamarokha.

13.1.2 Bug Fixes for Commands

• The semaphores command issued errors if an immediate semaphore was requested even if the other semaphores were blank.
• The insert_sceffects element, which inserts special elements for computation of transverse space charge in rings, had a bug that resulted in use of linear space charge calculations even when nonlinear calculations were requested, plus other bugs once that once fixed. P. Baxevanis (BNL) assisted in finding and resolving these issues.

13.1.3 New and Modified Elements

• Added the FLIP parameter to BRAT to allow turning the magnet upside down.
• Added the FIELD_OUTPUT_FILE, NX_OUTPUT, NY_OUTPUT, and NZ_OUTPUT parameters to BRAT to allow output of interpolated field values to an SDDS file.
• The WATCH, HISTOGRAM, and SLICE elements now support automatic bunch-by-bunch modes using the new BUNCH_SERIES flag. If this flag is set, successive instances of the same element will be assigned to successive bunches.
• The WIGGLER and CWIGGLER elements now internally implement several optional models for hybrid permanent magnet and superconducting undulators.

13.1.4 New and Modified Commands

• When reporting results for elements for which the matrix is determined by tracking, the matrix_output command now provides the maximum error for each coordinate between the tracking results and the matrix.
• Added the macro_output command, which allows writing the values of the commandline macros to a file.
• The insert_sceffects command, which inserts elements that model transverse space charge kicks, now automatically supports multiple bunches. It also supports a slice-based simulation of space charge kicks. These changes were requested by A. Blednykh, P. Baxevanis, and others (BNL).
• The load_parameters command now allows specifying a parameter file that will be loaded each time a specific SCRIPT element is encountered. This allows the script to create a parameter file that alters properties of the lattice elements for subsequent tracking.

13.1.5 Changes to Examples

• None.

13.1.6 Changes to Related Programs and Files

The elegant distribution includes many programs and scripts that perform computations with elegant output data, provide interfaces with other programs, or prepare data for use with elegant. These are listed in Section 8.

Changes to these tools in this release include

• sddsbrightness has a new method for computing the brightness that is about 20 times faster than the default method. R. Lindberg (APS) developed the method and code.