Filter Wheel and Stage Commands

The filter wheel and guider stage commands using the BAIT protocol customized for the RCT implemented by the rstage program.

In the following optional arguments are indicated in [] brackets. Either/or choices are shown with vertical line |. All commands have the help option that lists the available keywords.

STAGE

stage [x=] [y=] [z=] | [stow]

Positions the guide stage to the x, y, z coordinates specified. The three axes are the following:

x - increases North   range: -100 - 0 mm
y - increases West    range: 0 - 200 mm
z - increases in ?    range: 0 - 50 mm

If any axis has not been homed, an error message will be issued. Use the home option to correct.

Example:
tx stage x=-23.2 y=12.0
done stage x=-23.20 y=12.00 z=45.90

stow - checks whether the guider is not blocking the chip. It will move it to 0,0 if it is blocking.

See the Vignetting map.

FILTER

filter [num=0,16]| [fw1=1,9] [fw2=1,9]

Positions the filter wheels. FW1 is the upper wheel, and FW2 is the lower. Watch out the definition of upper and lower is ambiguous. The slot numbers of the individual wheels range from 1 - 9 inclusive and correspond to the stamped numbers on the wheels. The #9 position of each wheel contains no filter.

In addition there is a numbering system from 0 - 16 inclusive that assumes that one of the filter wheels is in the empty position. See Devices/FilterWheel and the pfilter command for more details.

If either wheel has not been homed an error message will be issued. Homing will not leave the filter wheel in a usable position.

If the wheels are in a position so that two non-empty (position 9 is empty) filters are aligned an error message will be issued similar to:

Examples:
done filter num=5 fw1=5 fw2=9
done filter num=14 fw1=9 fw2=6
ERROR filter crossed filters fw1=1 fw2=1

HOME2

home2 [x[=]] [y[=]] [z[=]] [fw1[=]] [fw2[=]] | [status]

Homes the various axes. This is a redundant method to test individual axes. For testing, you can fool the homing ritual using the equals sign. option.

status determines whether the axes have been homed. It returns a string simlar to:

done home x=homed y=homed z=homed fw1=not_homed fw2=not_homed

Program index