Specific WILDFIRE Commands

WILDFIRE mode image names (Sun based IR systems) follow the naming convention:

filenameXXX (e.g., n1.001 or raw023)

where ``filename'' is an observer controlled parameter, and the number ``XXX'' is sequentially numbered (it is automatically incremented for each exposure). If you set 'oldirafname = yes' when restoring the data from tape, the image names will be restored to their original names and match the log sheets.

pt A list of available commands within the WILDFIRE instrument control window is:

SYSTEM LEVEL
Command	Usage
! <commands>	execute the commands in csh or run csh
? <command>	give help on a command
ed <name>	call up an editor on a proc
help <name>	display help for one of these topics
man <name>	display a man page for a given topic
source <program>	temporarily include tcl program within recognized system; need to source again after powerup (full path name required)

DETECTOR
Command	Usage
activate	activate the detectors
deactivate	deactivate the detectors
setup irs	set up the default IRS voltages and prompt for activation

WILDFIRE
Command	Usage
startwf	initiate bootstrapping and downloading of the WILDFIRE system
exit	deactivate the array and exit the WILDFIRE controller
hung	attempts to complete link protocol; used as part of the restart procedure when WILDFIRE is hung (INSTRUMENT CONTROL window unresponsive and data collection stalled); must be entered in Console window
trouble	open troubleshooting session (do NOT enter in Instrument Control window)
restart IRS	fast restart of the IRS WILDFIRE system after an exit

HOUSEKEEPING
Command	Usage
status [$\mid$s$\mid$v$\mid$t$\mid$f]	display a status screen; (general status $\mid$s$\mid$ voltages $\mid$v$\mid$; temperatures $\mid$t$\mid$; filters $\mid$f$\mid$)
longheaders [on$\mid$off]	will disable/enable house keeping data in the header
tcp_[on$\mid$off]	enable/disable link to TCP for telescope status info and offsetting
progress NN	set how often ADC readouts are displayed. If you are doing lots of co-adds, a value like 10 may be convenient.
tcp_info	fetches telescope information from the TCS

PARAMETER FILES
Command	Usage
plist	list all the current parameters (also `ppar')
puse <filename>	load the named parameter file
eask	iterate through all the known parameters, allowing the user to specify which parameters are queried and which are displayed. After each question an ``l'' signifies display only; ``a'' signifies query; ``la'' will list the current value (which may be selected by <cr>) or accept a new entry
ask	prompt for the `eask' selected subset of parameters within the current parameter set
lpar	list the names of the available parameter files
ped	edit the current parameter file selected by `puse' asking all questions without regard to their query status
psave <filename>	save the current parameter set (values and ask/display flags) to the named parameter file. When no argument is given, the current parameter <filename> is used

Note: a parameter has two attributes, its value and flags indicating whether the parameter and its value should be displayed and/or queried when the ask or observe tasks are run

ACCESSING INDIVIDUAL PARAMETERS
Command	Usage
?coadds	returns the number of coadds for next image
coadds [n]	set the number of coadds for next image; if no argument given, will prompt with current value
filename <filename>	sets the IRAF image ``filename''. The path is is not included in ``filename''; if no argument given, will prompt with current value. For IRS, a ``%d'' or ``%03d'' should be inserted where the picture number should be placed. If no field is given, ``%03d'' will be appended. The format will be: ``filename''//``nextpic'' WARNING!! SAVED IMAGES WILL OVERWRITE EXISTING IMAGES IF THE FULL FILENAMES CONFLICT!!
title <string>	enters the title which will appear in the header
comment <string>	enters a comment line in the header
?lnrs	returns the number of low noise reads per coadd
lnrs [n]	sets the number of low noise reads per coadd. More than 8 does not seem to lower the read noise since dark current is generated with each read out
nextpic [n]	sets the picture index to [n]; when no argument given, prompts with current value
pics [n]	sets number of pictures to be taken at each observe/go/movie When no argument given, prompts with current value
?settime	returns current integration time/frame
set-time [f]	sets the integration time (to millisec level); when no argument given, prompts with current value. NOTE: minimum value is 0.315 * [lnr] seconds, where [lnr] is the number of low noise reads.
delay [f]	the same as set-time.
set fdly [f]	set the reset-read delay time to [f] seconds
?time	print out the current delay time and fdly of the array
setbias [f]	set the bias of the detector. Nominally 0.55 volts; maximum 0.8 volts.

Note ``fdly'' is a time interval between the detector reset and the first of the two series of readouts, designed to allow the detector to settle thermally after the dissipation due to the reset address cycle. The default value is 1 second; if the integration time is less than this, 'fdly' is set equal to to the integration time. Note that this means for short integration times, one is operating at a duty cycle of 0.5 and filling the detector potential wells to twice the value indicated by the observed signal. If one is observing only bright objects or at a high background, 'fdly' may be set to a smaller value (down to 0). The purpose of this delay is to give lower noise for long integrations at low background, so some compromises for high background/signal occur.

OBSERVING
Command	Usage
observe	perform one observation using current parameter set, prompting for key parameters
go	initiate an observation using the previously set parameters
abort	abort an observation (enter in Instrument Control window)
movie	begin observe/display loop. NOTE: parameters (integration time, coadds, etc.) will be those of previous observation or `ask' routine!!!!
zs [z1][z2]	set zscale values [z1] and [z2] for the image display
zs 0 0	enables autoscaling for the image display
offset [e] [n]	move telescope [e] arcsecs east and [n] arcsecs north: + for north/east; - for south/west
zrecenter [x(pix)] [y(pix)] [rot. angle]	initialize for recentering
recenter [x] [y]	offsets telescope to recenter start onn slit
slitscan [step] [#]	executes series of # observations along slit separated by step
abbaperp [step] [#]	executes series of # ABBA sequences perpendicular to the slit, offsetting by step
abbapar [step] [#]	executes series of # ABBA sequences along the the slit, symmetrically about the initial position separated by step arcsec

IMAGE STORAGE
Command	Usage
pixel_dir <dirname>	sets the directory for the saved image pixel files to `dirname'; defaults to current directory if no argument
header_dir <dirname>	sets the directory for the saved image header files to 'dirname'; defaults to current directory if no argument
newimdir <dirname>	sets the directory for the saved image header files to 'dirname' and the directory for the pixel files to 'dirname/pixels', creating these directories as needed and changes the current directory to 'dirname'.
checkdisk	determine space available for images with current imdir

SPECIFIC IRS COMMANDS
?filter	displays status of grating encoder (ecu), filter, slit, entrance mirror and selected grating
filt to [n]	moves the filter to filter [n], where [n] may be the names J,K2.... or the Durant counter position
ap to [n]	moves the slit to position [n], where [n] may be the names .35mm, 1mm, open_hole .... or the Durant counter position
ajog [n]	jog the aperture wheel [n] motor steps to align the slit image
sidea	moves the grating to zeroth order on side A
sideb	moves the grating to zeroth order on side B
mirror	moves the flat imaging mirror into the beam
lambda [m] [f]	moves the grating to wavelength [f] in order [m]. Using the input values for wavelength and order and the encoded grating number
gjog [n]	jog the grating drive [n] steps to set the grating zero point. 1 step=2 pixels
?lambda	returns [m] and [f] for the current grating position. NOTE: this command utilizes the order [m] from the last commanded lambda motion
chgrat	drives the grating from side A to side B or from side B to side A
initmtrs	Initializes the motor control microprocessor. This need only be done once per run