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-calibs [-e] [-skip] <date-string> Script to do biases and spectral calibs for all setups and windows used in a particular night.
Of course, this script should not be used for previous nights in case optical elements have been changed since.
The wheel setups are checked for inconsistencies in current vs stored wheel position content.
Any such inconsistent setup will be skipped, with a warning on the talker.

Command-line arguments:
[-e]                 echo mode: only show what will have be done in case started without the -e flag
<datestr>   for expample 'ALwb13'

Spectroscopic and window setups are collected from the FITSheader database.
For all different window setups bias frames will be taken.
For all different setups with a grism in the beam, spectroscopic flats and arc-lamp spectra will be taken.

For flat/arc exposure times, alfosc.callampstimes is used.
Setups that are yet non-supported by alfosc.callampstimes will automatically be skipped, with a warning on the talker

When the flag -skip is given, the user is asked to specify interactively from which GRISM or WINDOW setup to (re-)start alfosc-calibs.

Is supposed to work also for spectropolarimetry.

DATA
alfosc clearobject [-d] Clears the value of the FITS keyword OBJECT. DATA
alfosc clearobserver [-d] Clears the value of the FITS keyword OBSERVER. DATA
alfosc comment [-d] <text> Sets the FITS keyword COMMENT to <text>. Will be cleared after each image. FEB 13, 2013: This command is currently unavailable. DATA
alfosc filename [-d] <nn> Sets the default file name to <nn> (four characters). DATA
alfosc filenamestd [-d] Sets the filename back to the default file name. DATA
alfosc focuspyr Interactively examine a focus pyramid image to determine the focus offset required to bring the telescope in focus. The estimated best focus offset determined by the focuspyr-auto script will be presented on screen for comparison. DATA
alfosc focuspyr-auto [<file>] Computes the required telescope focus offset from a Focus Pyramid image <file>. If no input file is given (full path), the last image in the data directory will be used. DATA
alfosc imexam Initiates an IRAF imexam session on the image currently loaded into the ALFOSC DS9. While active in the imexam session, no further commands can be issued from the sequencer window. To kill the imexam session type q on the image in the postprocessing display.

CURSOR KEY COMMANDS:

?       Print help
a       Aperture radial photometry measurement (see above for output)
c       Column plot
e       Contour plot
f       Redraw the last graph
j       Fit 1D gaussian to image lines
k       Fit 1D gaussian to image columns
l       Line plot
m       Statistics
            image[section] npixels mean median stddev min max
q       Quit
r       Radial profile plot (see above for output)
s       Surface plot
x       Print coordinates
            col line pixval [xorign yorigin dx dy r theta]
DATA
alfosc impath [-d] <text> Sets the path of the image saving to <text>. DATA
alfosc imtype [-d] <text> Sets the FITS keyword IMTYPE to <text>. DATA
alfosc log-comment "Comment in quotes" [file1 file2 ...] When invoked with just the comment, it will be applied to the latest available image with a prefix for the current night (which starts at noon) and the sequencer's instrument.

If image names are provided, the program will test the existence of ALL them before applying the change.

Eg.

        $ alfosc.log-comment "This is a comment"
        $ alfosc.log-comment "Comment for two" ALug170154 ALug170155
Notice that there's no need to add the ".fits" after each image's name

If no arguments are provided, a usage message is displayed

DATA
alfosc object [-d] <text> Sets the FITS keyword OBJECT to <text>. DATA
alfosc observer [-d] <text> Sets the FITS keyword OBSERVER to <text>. DATA
alfosc photstd [-e] [-a mode] [-f filterIDs] Automatic exposure of standard stars. Goes to nearest standard field and does exposures in filters UBVRi as default - or filters specified by the user.
Currently supports UBVRi and in the future sdss ugriz. Other filters can be done, but will have the same exposure times, set by the variable default_time.
Instead of going to the nearest field, aquisition mode can be set to a specific target. The TCS name must be used, see http://www.not.iac.es/instruments/alfosc/photstd/.

Usage example: alfosc.photstd -a A_PG1633+099 -f "74 75 120 110"

DATA
alfosc rempath [-d] <nn> Sets the remote saving path to <nn>. DATA
alfosc remsave_off [-d] Turns off remote saving. DATA
alfosc remsave_on [-d] Turns on remote saving. DATA
alfosc remsystem [-d] <nn> Sets the remote host computer to <nn>. DATA
alfosc reset-log The script will use infosys.kill to reset the monitoring system, then it will wait for a set number of seconds, and at last it will instruct the obslog to show the listing for alfosc, all the while informing the user about what is happening

If there's any error, the script will notify the user and suggest further actions.
DATA
alfosc restore-uparm Populates the iraf uparm directory, used by the pyraf based sequencer scripts, with some known working parameter files. DATA
alfosc runselector <date> A command line frontend to set the PROPID,PROPTITL & PINAME fits keywords for the current observations. Choose the program being observed from a drop-down menu. The optional date argument displays programs for that date. DATA
alfosc runselectorUIF [alfosc|fies] <date> A GUI frontend to set the PROPID,PROPTITL & PINAME fits keywords for the current observations. Choose the program being observed from a drop-down menu. The optional date argument displays programs for that date. This GUI is started automatically when starting the observing system DATA
alfosc save [-d] Saves a read-out image to disk. DATA

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