Tracks through a magnetic field which is expressed by a SDDS table.
Parallel capable? : yes
GPU capable? : no
Back-tracking capable? : no
The effective field length measured along a straight line.
The designed bending angle
The left fringe field length.
The right fringe field length. L1+L+L2=Total z span in the input field table.
The designed entrance edge angle
The designed exit edge angle
rotation about incoming longitudinal axis
Factor by which to multiply field data.
Fields smaller than this are considered 0.
Name of SDDS file which contains field data.
Number of kicks into which to split the element.
Used for debugging code. Not applicable to Pelegant
If non-zero, use simple input format.
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 is used for tracking through an arbitrary magnetic field when its values are known at regularly spaced grid points and it is hard to find a suitable model to describe it. The input magnet parameter and coordinate system definition are illustrated in Fig:1.
The THRESHOLD parameter sets the magnitude of magnetic field below which the field is considered zero. If this is too small, there may be numerical problems.
The field data is provided in an SDDS file, with two formats available. The recommended format can be used if the SIMPLE_INPUT parameter is non-zero.
Simple input format — This format is shared with the BMXYZ and BRAT elements and is more convenient than the original, default format. The field map file is an SDDS file with the following columns:
The field map file must contain a rectangular grid of points, equispaced (separately) in x, y, and z. There should be no missing values in the grid (this is not checked by elegant). In addition, the x values must vary fastest as the values are accessed in row order, then the y values. To ensure that this is the case, use the following command on the field file:
sddssort fieldFile -column=z,incr -column=y,incr -column=x,incr
N.B.: Particles are injected into the field region with z=0. Hence, one would normally want the minimum value of z to be 0.
Original input format — This format is difficult to understand and set up. Although it is not recommended, it is the default at present for historical reasons.
The field data is saved in a 3 pages (Bx, By, Bz) 3D histogram SDDS table (see MHISTOGRAM for detail). An example is shown in Fig:2. This SDDS file must have one column Frequency to store the field data in Tesla, and following parameters:
N.B.: Particles are injected into the field region with z=0. Hence, one would normally want Variable02Min=0. If Variable02Min<0, data ahead of the injection point.