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	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	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	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	piname	text	Sets the value of the FITS keyword PINAME to "text".	DATA
alfosc	propid	text	Sets the value of the FITS keyword PROPID to "text".	DATA
alfosc	proptitl	text	Sets the value of the FITS keyword PROPTITL to "text".	DATA
alfosc	qicpol	[<2ndfile>]	Circular polarimetry quick-look tool (FAPOL+ calcite) which calculates the circular polarization from a set of two images (retarder plate positions 0 and 90.0 degrees). The flux of each image is measured with fixed aperture using iraf/apphot from raw images. See more detailed description of the script from here	DATA
alfosc	qilpol	[<4thfile>]	Linear polarimetry quick-look tool (FAPOL+ calcite) which calculates the linear polarization from a set of four images (retarder plate positions 0, 22.5 45 and 67.5 degrees). The flux of each image is measured with fixed aperture using iraf/apphot from raw images. See more detailed description of the script from here.	DATA
alfosc	quickspec	[<file>]	Extracts spectra and applies an approximate wavelength calibration on an ALFOSC spectroscopic image using the iraf tasks apall and dispcor. If no file is specified, spectral extraction from the last image written to disk will be attempted. Extracted spectra are kept in the directory /data/reduced/alfosc/ on the instrument computer. Existing spectra will be overwritten if the task is re-run on the same file. The wavelength calibration is done using standard wavelength settings for the standard horizontally oriented central slits. The wavelength calibration is only approximate, and is most likely based on a slit that you are not currently using. Note that the slits have different Y-positions and hence different wavelength zeropoints, and that hence zeropoint offsets of for instance 200 Ångström are normal. The quickspec will leave the user in an IRAF splot session. To kill the session type q in the postprocessing graphics window. There are 2 ways of initiating quickspec. Automatic (see command quickspec-config auto=yes below), and from the sequencer command line. * When called from the sequencer command line, all input and output will go through that sequencer terminal. * When automatic, the input and output goes through the BIAS 'command' window.	DATA
alfosc	quickspec-config	[<options>]	Use this command to set the IRAF apall task parameters used in the quickspec script.    auto=[yes|no] : Automatically run quickspec on incoming images    kill=[yes|no] : Automatically remove previous quickspec windows    default : loads default values. Below parameters are specific for the apal iraf task:    background=[none|average|median|minimum|fit]    weights=[none|variance]    clean=[yes|no]    edit=[yes|no]    nfind=[1-10] (useful for Echelle spectra, MOS spectra, spectropolarimetry, and longslit spectra with more than one object on the slit) If the command is issued without any options, current parameter settings will be listed.	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	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	slitrot		Uses the currently loaded DS9 image to compute the TCS field rotation angle required to align two objects along a slit. The targets are identified interactively by the user through an imexam session.	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.