next up previous
Next: FRFMODE Up: Element Dictionary Previous: FLOOR

FMULT

Multipole kick element with coefficient input from an SDDS file.
Parallel capable? : yes
Parameter Name Units Type Default Description
L $M$ double 0.0 length
TILT $RAD$ double 0.0 rotation about longitudinal axis
DX $M$ double 0.0 misalignment
DY $M$ double 0.0 misalignment
DZ $M$ double 0.0 misalignment
FSE   double 0.0 fractional strength error
N_KICKS   long 1 number of kicks
SYNCH_RAD   long 0 include classical synchrotron radiation?
FILENAME   STRING NULL name of file containing multipole data
SQRT_ORDER   long 0 Order of expansion of square-root in Hamiltonian. 0 means no expansion.
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 simulates a multipole element using a 4th-order sympletic integration. Specification of the multipole strength is through an SDDS file. The file is expected to contain a single page of data with the following elements:
  1. An integer column named order giving the order of the multipole. The order is defined as $(N_{poles}-2)/2$, so a quadrupole has order 1, a sextupole has order 2, and so on.
  2. A floating point column named KnL giving the integrated strength of the multipole, $K_n L$, where $n$ is the order. The units are $1/m^n$.
  3. A floating point column named JnL giving the integrated strength of the skew multipole, $J_n L$, where $n$ is the order. The units are $1/m^n$.

The MULT element is also available, which allows the same functionality without an external file.


next up previous
Next: FRFMODE Up: Element Dictionary Previous: FLOOR
Robert Soliday 2014-03-21