Specialized Tools for Use with elegant

A number of specialized programs are available that work with elegant. Most are SDDS-compliant, so they will also work with any program that reads or writes appropriate SDDS data. These programs will be made available in Version 14.3Beta. The following is a brief description of each program. Full descriptions are available on subsequent pages.

• elegant2genesis -- This program performs slice analysis of particle output files, which are suitable for use with the SDDS-compliant APS version of GENESIS[14]. This program is part of the SDDS toolkit. See the SDDS toolkit manual for documentation.
• haissinski -- Computes the steady-state longitudinal distribution in an electron storage ring. Requires as input a file containing the Twiss parameters around the ring, such as that provided by the twiss_output command. (Program by L. Emery)
• ibsEmittance -- Computes the transverse and longitudinal emittances of a beam in an electron storage ring, resulting from the combination of quantum excitation, damping, and intra-beam scattering. Requires as input a file containing the Twiss parameters, such as that provided by the twiss_output command. (Program by L. Emery)
• madto -- Translates an elegant-style lattice file (or a MAD file, with some restrictions) into formats accepted by other programs, such as COSY, PARMELA, PATPET, PATRICIA, TRANSPORT, and XORBIT. Will also generate an SDDS file containing lattice data.
• sddsanalyzebeam -- Analyzes a beam of macro-particles and produces an SDDS file containing beam moments, emittances, equivalent beta functions, etc. The beam file is of the type written by elegant using the output field of the run_setup command, or the WATCH element.
• sddsemitmeas -- Analyzes quadrupole scan emittance measurement data. Accepts a file containing the transport matrix for each point and measured beam sizes. The file may, for example, be the file produced by the final field of the run_setup command. The quadrupole scan can be executed inside of elegant using vary_elements.
• sddsmatchtwiss -- Transforms a beam of macro-particles to match to given beta functions and dispersion. The beam file is of the type written by elegant using the output field of the run_setup command, or the WATCH element.
• sddsrandmult -- Simulates the effect of random mechanical errors in a quadrupole or sextupole, generating multipole error data that can be used with elegant's KQUAD and KSEXT elements.
• sddssampledist -- This program allows creating particle distributions from user-designed distribution functions. It is thus a more flexible alternative to bunched_beam. This program is part of the SDDS toolkit. See the SDDS toolkit manual for documentation.