EALIGN: Define Misalignments

Alignment errors are defined by the EALIGN command. The misalignments refer to the local reference system for a perfectly aligned machine. Possible misalignments are displacements along the three coordinate axes, and rotations about the coordinate axes. Alignment errors can be assigned to all beam elements except drift spaces. The effect of misalignments is treated in a linear approximation. A Beam position monitor can be given read errors in both horizontal and vertical planes. Monitor errors (MREX, MREY, MSCALX and MSCALY) are ignored for all other elements. Each new EALIGN statement replaces the misalignment errors for all elements in its range, unless EOPTION,ADD=TRUE has been entered.

Alignment errors are defined by the statement

SELECT,FLAG=ERROR,RANGE=range,CLASS=name,PATTERN=string;
EALIGN, DX=real,DY=real,DS=real, 
        DPHI=real,DTHETA=real,DPSI=real, 
        MREX=real,MREY=real,
        MSCALX=real,MSCALY=real,
        AREX=real,AREY=real;
and elements are now selected by the SELECT command. The attributes are:

DX: The misalignment in the x-direction for the entry of the beam element (default: 0 m).
DX>0 displaces the element in the positive x-direction

DY: The misalignment in the y-direction for the entry of the beam element (default: 0 m).
DY>0 displaces the element in the positive y-direction

DS: The misalignment in the s-direction for the entry of the beam element (default: 0 m).
DS>0 displaces the element in the positive s-direction

DPHI: The rotation around the x-axis.
A positive angle gives a greater x-coordinate for the exit than for the entry (default: 0 rad).

DTHETA: The rotation around the y-axis according to the right hand rule (default: 0 rad).

DPSI: The rotation around the s-axis according to the right hand rule (default: 0 rad).

MREX: The horizontal read error for a monitor. This is ignored if the element is not a monitor
If MREX>0 the reading for x is too high (default: 0 m).

MREY: The vertical read error for a monitor. This is ignored if the element is not a monitor
If MREY>0, the reading for y is too high (default: 0 m).

AREX: The misalignment in the x-direction for the entry of an aperture limit (default: 0 m).
AREX>0 displaces the element in the positive x-direction

AREY: The misalignment in the y-direction for the entry of an aperture limit (default: 0 m).
AREY>0 displaces the element in the positive y-direction

MSCALX: The relative horizontal scaling error for a monitor. This is ignored if the element is not a monitor.
If MSCALX>0 the reading for x is too high (default: 0). A value of 0.5 implies the actual reading is multiplied by 1.5.

MSCALY: The relative vertical scaling error for a monitor. This is ignored if the element is not a monitor.
If MSCALY>0 the reading for y is too high (default: 0). A value of -0.3 implies the actual reading is multiplied by 0.7.


Example:

SELECT,FLAG=ERROR,CLASS=MQ;                  
EALIGN,DX=0.002,DY=0.0004*RANF(),DPHI=0.0002*GAUSS();
Assigns alignment errors to all elements of class MQ.
SELECT,FLAG=ERROR,PATTERN="QF.*";            
EALIGN,DX=0.001*TGAUSS(2.5),DY=0.0001*RANF();
Assigns alignment errors to all elements starting with "QF". TGAUSS(2.5) means a Gaussian distribution cut at 2.5 sigma.

Figure 1: Example of Misplacement in the (x, s)-plane.

Figure 2: Example of Misplacement in the (x, y)-plane.

Figure 3: Example of Misplacement in the (y, s)-plane.

Figure 4: Example of Read Errors in a monitor



Last updated: 02.9.2002
Werner Herr 18.6.2002