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
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 Jx≠Jy.