Orbit Threader

When the closed orbit search in a MICADO or TWISS command fails due to machine imperfections, it may be possible to thread the orbit through the machine using the command

THREADBPM,LINE=name,BEAM=name,RANGE=range,TOL=real,LISTC=logical,LISTM=logical;

This command has the attributes:

LINE

The label of a previously defined beam line (no default).

BEAM

The label of a previously defined beam (default UNNAMED_BEAM). This is used to define the type and reference momentum for the particles to be sent through the line.

RANGE

If this attribute is given, the table is restricted to the range given.

TOL

The orbit is observed at all beam position monitors (BPM). When the orbit deviation exceeds TOL, a correction is attempted. MAD backtracks to find another monitor and two correctors and tunes the latter so as to adjust the readings of the two monitors to zero.

LISTC

If true, list the corrector settings after correction.

LISTM

If true, list the monitor readings after correction.