| Parameter Description | Argument Order | Argument Name | Units | Default Value |
|---|---|---|---|---|
| Length | 1 | L | cm | 0.0 |
| Bend Field | 2 | B[kG] | kG | 0.0 |
| Gradient | 3 | G[kG/cm] | kG/cm | 0.0 |
| Tilt | 4 | T[deg] | degree | 0.0 |
| Tilt Error | 5 | TiltError[deg] | degree | 0.0 |
The rotation is performed around the beam trajectory at the magnet upstream end. Dipole edge focusing is handled with a distinct element (see: G: magnet edge). Edge focusing elements must immediately precede or follow a dipole. If the tilt of a dipole is different from 0 or 90 deg., the input and output tilt angles will be different. This is a consequence of the local coordinate frame convention (see Coordinate system). While the tilt of an edge focusing element at the dipole entrance must coincide with the tilt of the corresponding dipole, the tilt of an edge focusing element at the magnet downstream end can be obtained from the View|Lattice menu or calculated independently from the local coordinate frame definition. Edit|Consistency Check verifies that all edge focusing elements are correctly specified.
Examples: B L[cm]=12.8 B[kG]=8.008 G[kG/cm]=0.033144 Tilt[deg]=45 b2 L[cm]=12.8 B[kG]=8.008 G[kG/cm]=0.033144 Tilt[deg]=0 b2 =12.8 =8.008
Note that in this example the third and fourth arguments are implicitly zero on the last line. A dipole can have a tilt (i.e. roll) error. The latter produces a beam kick proportional to the roll in a direction normal to the bending plane. In a similar fashion to correctors, dipole rolls affect the beam trajectory and are accounted for in all trajectory related calculations including optics calculations on a reference orbit.
Example: BB1 L[cm]=120 B[kG]=8.00 G[kG/cm]=0.0331 Tilt[deg]=0 TiltError[deg]=0.1