10.130 WIGGLER—A wiggler or undulator for damping or excitation of the beam.

A wiggler or undulator for damping or excitation of the beam.
Parallel capable? : yes
GPU capable? : no
Back-tracking capable? : no






Parameter NameUnitsType Default

Description






L M double 0.0

length






RADIUS M double 0.0

Peak bending radius. Ignored if K or B is non-negative.






K double 0.0

Dimensionless strength parameter.






B T double 0.0

Peak vertical magnetic field. Ignored if K is non-negative






DX double 0.0

Misaligment.






DY double 0.0

Misaligment.






DZ double 0.0

Misaligment.






TILT double 0.0

Rotation about beam axis.






POLES long 0

Number of wiggler poles






FOCUSING short 1

If 0, turn off vertical focusing (this is unphysical!)






MODEL STRINGNULL

Model for determining B from GAP. Used if GAP is non-zero, K=0, and B=0.






GAP M double 0.0

Magnetic gap. Ignored if K or B is non-negative.






JFRACTION double 0.0

For SCU models, fraction of maximum current at which to operate.






C1 double 0.0

For custom model, the C1 parameter of the Halbach-type expression.






C2 double 0.0

For custom model, the C2 parameter of the Halbach-type expression.






C3 double 0.0

For custom model, the C3 parameter of the Halbach-type expression.






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 wiggler or undulator. There are two aspects to the simulation: the effect on radiation integrals and the vertical focusing.

If the number of poles should be an odd integer, we include half-strength end poles to match the dispersion, but only for the radiation integral calculation. For the focusing, we assume all the poles are full strength (i.e., a pure sinusoidal variation). If the number of poles is an even integer, no special end poles are required, but we make the unphysical assumption that the field at the entrance (exit) of the device jumps instantaneously from 0 (full field) to full field (0).

The radiation integrals were computed analytically using Mathematica, including the variation of the horizontal beta function and dispersion. For an odd number of poles, half-strength end-poles are assumed in order to match the dispersion of the wiggler. For an even number of poles, half-length end poles are assumed (i.e., we start and end in the middle of a pole), for the same reason.

The vertical focusing is implemented as a distributed quadrupole-like term (affecting ony the vertical, unlike a true quadrupole). The strength of the quadrupole is (see Wiedemann, Particle Accelerator Physics II, section 2.3.2)

K  = -1--,
  1  2 ρ2
(169)

where ρ is the bending radius at the center of a pole. The undulator is focusing in the vertical plane.

The wiggler field strength may be specified either as a peak bending radius ρ (RADIUS parameter) or using the dimensionless strength parameter K (K parameter). These are related by

     γλ
K =  --u-,
     2πρ
(170)

where γ is the relativistic factor for the beam and λu is the period length.

There are several ways to specify the strenght of the magnetic field:

  1. Using the B parameter directly
  2. Using the K parameter in combination with the L and POLES parameters, in which case B[T] = K∕(93.37287λu[m]).
  3. Using a predefined undulator model. Several hybrid-permanent-magnet undulator (HPMU) models are supported. To use these, the GAP parameter must be used to provide the full magnetic gap.

    Two superconducting undulator (SCU) models are supported. In addition to providing the magnetic gap, the user must provide a value for the parameter JFRACTION, which is the fraction of the quench current at which to operate; 0.8 is considered conservative. These are based on the model of S. H. Kim [67].

ZLONGIT