Search
Text Size:
Smaller Text Normal Text Larger Text

Facebook page

Twitter profile

YouTube channel

ALFOSC Sequencer Command Documentation

Go to the SEQUENCER Reference Manual Main Page.

Instrument : ALFOSC
Observing Mode: ANY IMA SPEC POL
Command Type: ANY DATA DET DISP INST TEL
Usage: BASIC GENERAL STAFF
Description: SHORT LONG

SystemCommandArgumentsDescriptionType
alfosc allopen [-e] Moves all ALFOSC/FASU optical wheels to the OPEN position. INST
alfosc aperture [-d] [id] [name] [pos] [ready] [step][orient] <n> Moves aperture wheel to slot number <n>. [id] returns the NOT ID of the element in the light path. [name] returns the name of the element in the light path. [pos] eturns the position [0-7] of the element in the light path. [ready] returns '0' if the element is moving, '1' if it is ready. [step] returns the step position [0-320000] of the element in the light path. [orient] returns the optical orientation of the element in the light path. INST
alfosc callamptimes [-s ] [-xbin N] [-ybin M] <lampID> <grism> Returns the exposure time needed for calibration exposures, based on lamp and grism choice. The lampID should be one of He/Ne/HeNe/ThAr/Halogen.
Slit width [-s] and binning [-xbin][-ybin] can be specified optionally.
INST
alfosc carriage [-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. INST
alfosc fasua [-d] [id] [name] [pos] [ready] <n> Moves FASU wheel A to position <n>. [id] returns the NOT ID of the element in the light path. [name] returns the name of the element in the light path. [pos] returns the position [0-6] of the element in the light path. [ready] returns '0' if the element is moving, '1' if it is ready. INST
alfosc fasub [-d] [id] [name] [pos] [ready] <n> Moves FASU wheel B to position <n>. [id] returns the NOT ID of the element in the light path. [name] returns the name of the element in the light path. [pos] returns the position [0-6] of the element in the light path. [ready] returns '0' if the element is moving, '1' if it is ready. INST
alfosc filter [-d] [id] [name] [pos] [ready] [step][orient] <n> Moves filter wheel to position <n>. [id] returns the NOT ID of the element in the light path. [name] returns the name of the element in the light path. [pos] returns the position [0-6] of the element in the light path. [ready] returns '0' if the element is moving, '1' if it is ready. [step] returns the step position [0-320000] of the element in the light path. [orient] returns the optical orientation of the element in the light path. INST
alfosc focuspyr-setup [-e] [-filter] Sets ALFOSC up for focusing. If optional argument -filter is used, the filter wheels will be left as they are. INST
alfosc grism [-d] [id] [name] [pos] [ready] [step][orient] <n> Moves the grism wheel to position <n>. [id] returns the NOT ID of the element in the light path. [name] returns the name of the element in the light path. [pos] returns the position [0-6] of the element in the light path. [ready] returns '0' if the element is moving, '1' if it is ready. [step] returns the step position [0-320000] of the element in the light path. [orient] returns the optical orientation of the element in the light path. INST
alfosc lamp [-d] [position] <n> <m> Turns on/off lamp number <n>, <m>=1 is turn on, <m>=0 is turn off. [position] returns a 4 bit pattern corresponding to the state of the 4 lamps. INST
alfosc mirror [-d] [pos] [ready] <n> Moves calibration mirror in or out, <n>=1 for in and <n>=0 for out. [pos] returns the position of the calibration mirror. '1' is in, '0' is out. [ready] returns '0' if the element is moving, '1' if it is ready. INST
alfosc optics [-e] [-s <slit>] [-g <grism>] [-f <filterID>] [-d <wheel>] [-m] [-a] [-p] [-o] [-h] Searches ALFOSC and FASU wheels for optical elements. See the ALFOSC Sequencer Command and Script Reference for a description of the output and a list of all possible <flags>. INST
alfosc polarizer [-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. INST
alfosc snapshot [store|restore] Takes a snapshot of the current instrument and detector setup. [store] stores the snapshot. [restore] restores the latest snapshot. INST
alfosc wait-camera-state [idle|integrating|readout|not-integrating] Routine to wait for a given ALFOSC CCD3 camera state. INST
alfosc wait_alfosc_ready [-d] Waits until all the following items are ready (not moving): FASU A and B, aperture, filter, grism, ALFOSC focus, FAPOL carriage and FAPOL polarizer. INST
alfosc wheels [-e] [-s <slit>] [-g <grism>] [-c <crossdisp>] [-f <filterID>] [-d <diffuserID>][-nowait] [-forceFASU] Sets all 5 ALFOSC wheels to the given setup. Default is OPEN. If optional flag -nowait is used, the script exits while wheels are moving. INST

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.

Type definitions:
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.

Back to top Last modified: January 26 2023