13.1 Highlights of What’s New in Version 2024.1

Here is a summary of what’s changed since release 2023.4.

13.1.1 Bug Fixes for Elements

• None.

13.1.2 Bug Fixes for Commands

• Fixed several units errors in the response and correction matrix output files from correct_tunes and chromaticities commands. The quantities don’t change, just the reported units.
• The amplification_factors command now checks that the correct command is given, instead of crashing. This bug was reported by forum user NuanYa_Huang.
• The link_elements command now performs multiple iterations until nothing changes. This deals with cases where is complex linkage between elements, some of which are varied in optimization, for example.
• A bug was fixed in the elastic_scattering command that would result in the program crashing on some systems.
• Bugs were fixed in ramp_elements and modulate_elements that resulted in ramp/modulation getting reset by closed orbit calculations. This was reported by forum user dondreka.

13.1.3 New and Modified Elements

• The ROTATE element now accepts the ON_PASS option.
• The BEDGE element, which implements a dipole fringe kick, was added.

13.1.4 New and Modified Commands

• The particle_tunes command was added, which allows computing the tunes of individual particles from tracking.
• The semaphores command now allows creation of a semaphore on demand by setting immediate=1. This can be used to synchronize other activities with an elegant run.
• The run_control command now supports use of semaphores to synchronize execution of steps in a run with an external process.
• The profile output from run_setup now includes integrated strengths, steering kicks, and strength errors.
• The find_aperture supports a new “grid” search mode for both serial and parallel dynamic acceptance computation. This mode allows the user more control over the resolution in the two planes. In addition, one can search in (δ,x) and (δ,y) space in addition to (x,y). This was in response to a forum request from user Skamarokha.
• The correct_tunes command supports the ability to select which parameter of the element will be used for correction.
• The chromaticity command supports the ability to select which parameter of the element will be used for correction.
• The elastic_scattering command supports quadratic spacing of θ points, to emphasize the central region.
• The ion_effects command has an added parameter use_local_pressure, which allows using the pressure at the interaction point, rather than averaging over a region.
• The ion_effects command has an added parameter ion_poisson_span: if nonzero, Poisson calculation is done over this range (rather than the full ion_span).
• Orbit response matrix computation now uses parallel resources.

13.1.5 Changes to Examples

• Added an example of restarting a simulation that includes an RFMODE element as part of a beam-abort simulation. See PAR/RfmodeRestart.
• Added an example of slip-stacking with collective effects. See slipStacking/RCS

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

• offMidplaneExpansion now allows specification of the names of the data columns. The output option, which has not been implemented, is not longer required.
• generateBunchTrain was revised so that particles within each bunch are distributed over multiple cores in Pelegant, to improve performance.
• The program quantumLifetime was added. It provides computations of quantum lifetime vs aperture using one- and two-dimensional methods.
• The emittance computation used by touschekLifetime is now correct when the coupling option was used if J_x≠J_y.