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 alfosc.exit [-d] Exits the ALFOSC BIAS program. DET
alfosc alfosc.remote-slitoff [slit=<slitno>|xref=<x> yref=<y>] xstar=<x> ystar=<y> [xbin=<xbinning> ybin=<ybinning> xbeg=<x window begin> ybeg=<y window begin>] This script is meant to be used remotely when the network is too slow for graphical applications. Calculates the telescope offset required to bring a target onto a given slit and performs the required telescope offset. The slit number <slitno> refers to the position of the requested slit in the ALFOSC slit wheel. Alternatively, an (<x>,<y>) pixel position can be given as reference. The script does NOT use any kind of image display. The star to be positioned on the slit is identified by it's x and y coordinate, using the xstar and ystar parameters. The xbin, ybin and xbeg, ybeg parameters are used for indicating the binning in x and y and the window start pixel in x and y. If not given, these parameters will all default to "1" (i.e. full frame, no binning). TEL
alfosc alfoscfocus [-d] [ready] [step] <n> Moves ALFOSC internal focus to step position <n>. [ready] returns '0' if the element is moving, '1' if it is ready. [step] returns the step position [0-2700] of the ALFOSC internal focus. INST
alfosc autosave_off [-d] Turns off autosave. DATA
alfosc autosave_on [-d] Turns on autosave. DATA
alfosc edit-slitpos [ editor ]
-h
-test
If called without arguments, or passing your favourite editor as an argument, the program will launch an editor for the relevant file. After you've exited the editor, the file will be analyzed. If any error is detected it will be corrected where possible but, in any case, you'll be informed of the success (or not) for this operation.

The default editor is emacs

If called with the '-test' string, the program will just analyze the file, without launching the editor first.

If called with the '-h' option, the program will just print a usage message.
INST
alfosc focus-auto <step-size> [<image>] Computes the best focus value from a focus sequence image taken with the command focusexpose. If no image name <image> is given, the last obtained image will be used. The computed focus value is not automatically sent to the TCS. DATA
alfosc focusexpose [-d] <nnnn> <mm> <tt> Makes a focus exposure. <nnnnn> is the focus start value, <mm> is the step size and <tt> is the exposure time per sub-exposure. 7 sub-exposures will be made. DET
alfosc gainron [<file>] Computes detector gain and read-out-noise based on a sequence of two bias frames and two flat fields. The filename <file> must be the last in the sequence. If no filename is given, the last obtained image name will be used. Calculated values are being compared to previous values before being uploaded to database. If the deviations from previous results are found to be too large, the script can be terminated without uploading results. DATA
alfosc hgalign [-e] [exptime] Script for aligning ALFOSC optics. See ALFOSC staff pages for instructions. DET
alfosc hsalign [-e] [exptime] Script for aligning ALFOSC optics. See ALFOSC staff pages for instructions. DET
alfosc qc-script Takes a sequence of two bias frames and two flat fields with the betalight for each amplifier and gain setting and calls gainron to calculate gain and read-out-noise. DET
alfosc read_alfosc_setup The command instructs the ALFOSC instrument user interface (UIF) to re-read the setup information. The corresponds to pressing the "read setup" button in the UIF. INST
alfosc tiasgat Script for aligning ALFOSC optics. See ALFOSC staff pages for instructions. DATA
alfosc vgalign [-e] [exptime] Script for aligning ALFOSC optics. See ALFOSC staff pages for instructions. DET
alfosc vsalign [-e] [exptime] Script for aligning ALFOSC optics. See ALFOSC staff pages for instructions. DET

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