next up previous
Next: KICKER Up: Element Dictionary Previous: IBSCATTER

ILMATRIX

An Individualized Linear Matrix for each particle for fast symplectic tracking with chromatic and amplitude-dependent effects
Parallel capable? : yes
Parameter Name Units Type Default Description
L $M$ double 0.0 Length (used for position and time-of-flight computation)
NUX   double 0.0 Horizontal tune
NUY   double 0.0 Vertical tune
NUX1M   double 0.0 First chromatic derivative of the horizontal tune
NUY1M   double 0.0 First chromatic derivative of the vertical tune
NUX2M   double 0.0 Second chromatic derivative of the horizontal tune
NUY2M   double 0.0 Second chromatic derivative of the vertical tune
NUX3M   double 0.0 Third chromatic derivative of the horizontal tune
NUY3M   double 0.0 Third chromatic derivative of the vertical tune
NUX1AX   double 0.0 First amplitude derivative of the horizontal tune wrt Ax
NUY1AX   double 0.0 First amplitude derivative of the vertical tune wrt Ax
NUX1AY   double 0.0 First amplitude derivative of the horizontal tune wrt Ay
NUY1AY   double 0.0 First amplitude derivative of the vertical tune wrt Ay
BETAX $M$ double 0.0 On-momentum horizontal beta function
BETAY $M$ double 0.0 On-momentum vertical beta function
BETAX1M $M$ double 0.0 First chromatic derivative of horizontal beta function
BETAY1M $M$ double 0.0 First chromatic derivative of vertical beta function
ALPHAX   double 0.0 On-momentum horizontal alpha function

An Individualized Linear Matrix for each particle for fast symplectic tracking with chromatic and amplitude-dependent effects
Parameter Name Units Type Default Description
ALPHAY   double 0.0 On-momentum vertical alpha function
ALPHAX1M   double 0.0 First chromatic derivative of horizontal alpha function
ALPHAY1M   double 0.0 First chromatic derivative of vertical alpha function
ETAX $M$ double 0.0 On-momentum horizontal eta function
ETAPX $M$ double 0.0 On-momentum horizontal eta' function
ETAY $M$ double 0.0 On-momentum vertical eta function
ETAPY $M$ double 0.0 On-momentum vertical eta' function
ETAX1 $M$ double 0.0 First chromatic derivative of horizontal eta function
ETAPX1 $M$ double 0.0 First chromatic derivative of horizontal eta' function
ETAY1 $M$ double 0.0 First chromatic derivative of vertical eta function
ETAPY1 $M$ double 0.0 First chromatic derivative of vertical eta' function
ALPHAC   double 0.0 First-order momentum compaction factor
ALPHAC2   double 0.0 Second-order momentum compaction factor
TILT $RAD$ double 0.0 Rotation angle about the longitudinal axis.
CROSS_RESONANCE   long 0 If zero, then particles that cross an integer or half-integer resonance are considered lost.
GROUP   string NULL Optionally used to assign an element to a group, with a user-defined name. Group names will appear in the parameter output file in the column ElementGroup





This element allows fast, symplectic tracking of transport through a periodic cell with chromatic and amplitude-dependent tunes, beta functions, and dispersion. This is done by computing a linear matrix for every particle. The linear matrix is composed from Twiss parameters, tunes, dispersion, etc., supplied by the user. The user can also supply selected chromatic and amplitude derivatives of these quantities, which are used to compute the individual particle's beta functions, tune, dispersion, etc., which in turn allows computing the individual particle's linear matrix.

Using this element is very similar to using linear chromatic matrix tracking via the setup_linear_chromatic_tracking command. The advantage is that using LMATRIX, one can split a ring into segments and place, for example, impedance elements between the segments.

This element was inspired by requests from Y. Chae (APS).

N.B.: There is a bug related to using ILMATRIX that will result in a crash if one does not request computation of the twiss parameters. If you encounter this problem, just add the following statement after the run_setup command:

&twiss_output
        matched = 1
&end

next up previous
Next: KICKER Up: Element Dictionary Previous: IBSCATTER
Robert Soliday 2014-03-21