ALFOSC Sequencer Command Documentation

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

System	Command	Arguments	Description	Type
alfosc	alfosc-calibs	[-e] <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 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.	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	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	restore-uparm		Populates the iraf uparm directory, used by the pyraf based sequencer scripts, with some known working parameter files.	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.