SOL †
A solenoid. Unlike other elements, SOL elements inserted at boundaries or
of a solenoid or at where the field changes. Between SOL elements DRIFT,
BEND(straight bend only), QUAD, and MULT elements can be inserted. The
longitudinal field of the solenoid overlaps on those elements.
In a SOL region, the coordinate is shifted on the axis of the solenoid,
no matter how the design orbit bends there. The x-direction of the
coordinate in a solenoid is so chosen as to CHI3 = 0. At the exit of a
solenoid, the coordinate is shifetd back to the design orbit, but the value
of CHI3 is so determined as to set CHI3 zero at the nearest MARK element
which has GEO = 1 after the exit. The offset and orientation of the design
orbit can be given by keywords DX, DY, DPX, DPY at a SOL element with
GEO = 1.
SOL can be used to shift the coordinate to the actual orbit even without BZ.
It is useful to define the coordinate with magnets with DX and DY.
- BOUND
- BOUND = 1 must be given at both sides of the boudaries of a solenoid,
otherwise SOL only specifies the change of BZ
- BZ
- The longitudinal field of a solenoid. If a SOL is used with BOUND = 0
(default), only BZ is used to change the field, and no coordinate
transformation is applied.
- DISRAD
- If nonzero, the synchrotron radiation due to the fringe field of solenoid is inhibited.
- DISFRIN
- If DISFRIN=1 for each SOL element, the nonlinear fringe effect of solenoid is suppressed. The default is DISFRIN=0.
The transformation for the nonlinear fringe is expressed by


where


whose canonical partners are


respectively.
- DPX
- An offset of the design ORBIT angle CHI1 relative to the solenoid axis at
SOL with GEO = 1.
- DPY
- An offset of the design ORBIT angle CHI2 relative to the solenoid axis at
SOL with GEO = 1.
- DX
- An x-offset of the design ORBIT relative to the solenoid center at SOL
with GEO = 1.
- DY
- A y-offset of the design ORBIT relative to the solenoid center at SOL
with GEO = 1.
- F1
- If F1 =0 (default), no radiation araises. F1 only affects the emittance calculation to determine the magnitude of the transverse field at the fringe.
- GEO
- One of boundaries (with GEO = 1) of a solenoid must have GEO = 1 to specify
the alignment of the design orbit. At a SOL element with GEO = 1, the
design orbit is determined by DX, DY, DPX, DPY parameters.