Sequencer Command Documentation
Go to the SEQUENCER Reference Manual Main Page.
||Will move all ALFOSC/FASU optical wheels to the OPEN position. Only wheels that according to the ALFOSC status are not already OPEN will be commanded to move. FASU wheels will always be commanded to move.
||[-d] [pos] [ready] [action]
||Moves FAPOL carriage in or out with the [action] keyword. [action] can be 'in', 'IN', 'out' or 'OUT'. [pos] returns '1' if the carriage is in the lightpath, '0' if it is out. [ready] returns '0' if the element is moving, '1' if it is ready.
||[-d] [position] <n> <m>
||Turn on/off lamp no. <n>, where <n> is [1-4] and <m>='1' to turn on and <m>='0' to turn off. Current (29/10-2007) lamp setup: Lamp 1 is "He" Lamp 2 is "Ne" Lamp 3 is "Halogen" Lamp 4 is "ThAr Hollow Cathode". A timer will turn off any lamp after 1200 sec. Subsequent commands to turn on a lamp will result in the timer being reset to 1200 seconds. [position] returns a 4 bit pattern corresponding to the state of the 4 lamps: If bit no. 1 is set, lamp no. 1 is on, else off If bit no. 2 is set, lamp no. 2 is on, else off If bit no. 3 is set, lamp no. 3 is on, else off If bit no. 4 is set, lamp no. 4 is on, else off
||[-d] [pos] [ready] <n>
||Moves the polarizer to angle <n>, where <n> is any multiple of 22.5 between '0' and '337.5'. [pos] returns the current polarizer position. [ready] returns '0' if the element is moving, '1' if it is ready.
||[-e] [-s <slit>] [-g <grism>] [-c <crossdisp>] [-f <filter>] [-nowait] [-forceFASU]
||Script to setup all 5 ALFOSC wheels, in quickest possible way. Possible arguments are:
Each wheel defaults to the OPEN position, unless it needs to be put to a different position as requested through the command-line arguments. Consequently, without any arguments alfosc.wheels puts all wheels to open. The script uses alfosc.optics to check the feasibility of the requested setup. If feasible, the wheels will be moved to put the requested items in the beam. If wheels are already in the correct position they will not be exercised, except for the FASU wheels when flag -forceFASU is given. If a requested setup is not possible, an error will result, and no wheels will be moved. Note: grism/slit strings should be unique. A list of optical items can be found here. Note: filter ID numbers can be found here. Note: the Focus_Pyr is considered a grism!! Note: for spectroscopy the horizontal/vertical requirements for the optical elements are tested.
- -s <slit> aperture-wheel item string
- -g <grism> grism string
- -c <crossdisperser> crossdisp grism string
- -f <filterID> filter number
- -nowait exit while wheels are moving
- -forceFASU force the FASU wheels to move even when at required position
- alfosc.wheels -f 74 sets up for imaging with filter #74
- alfosc.wheels -g Focus_Pyr sets up for focusing without filters
- alfosc.wheels -s Slit_1.0 -g "#4" sets up for spectroscopy with slit 1.0" and Gr#4
- alfosc.wheels -s Slit_1.0 -g "#4" -f 93 sets up for spectroscopy with slit 1.0" and Gr#4 and blocking filter #93
- alfosc.wheels -s Ech_0.8 -g "#9" -c "#10" sets up for Echelle spectroscopy with slit 0.8" and Echelle Gr#9 and cross disperser Gr#10
In scripts, the syntax alfosc.<command> should be used.
If a part of a command is written in <angle brackets>, this is an argument that should be replaced with a value.
If a part of a command is written in [square brackets], this is an optional argument or flag.
When available, the optional flag -d will write extended debugging information to the log.
When available, the optional flag -e will show the script on standard output instead of executing the commands.
When available, the optional flag -t will only make a simulated exposure. Useful for testing scripts.
DATA: All commands related to handling/modifying data (editing fits-headers, post-processing etc.).
DET: Commands related to operations with the detector.
DISP: Commands related to displaying images on the instrument computer.
INST: Commands related to operations with the instrument.
TEL: Commands related to operations with the telescope.