This qualifier specifies a text file in the directory defined by the logical name IR_DO containing instructions for taking data frames automatically. On startup, IR_DO points to the default directory DATADISK:[INFRARED]. The file can also contain comment lines (lines beginning with the ``!'' character), which may appear anywhere in the file.
The file type, if not specified, is assumed to be ``.DO''.
The format of each instruction line is as follows:
COMMAND Object_Name RA_Offset Dec_Offset Method Cycles Time Fndr - Repeats Aperture Ufilter Utility Lfilter Lens Filter Period Tiptilt - Stage_Offset Track_Coord Guide_Coord GRA_Offset GDec_Offset TTX TTY - TTDX TTDY AcqX AcqY AcqDX AcqDY TT_Mode TT_ATime TT_GTime TT_CTime - TT_Find TT_Error
The syntax of the instruction lines is flexible. The COMMAND item must appear, and it must be one of ``RUN'', ``BIAS'' or ``DARK''. All other items are optional. Items may be separated by spaces and/or commas; if items are omitted, commas are required to identify the missing item (but note that COMMAND ,,,,, will interpret the commas as the object name). A ``-'' character at the end of a line indicates that the instruction is continued on the next line.
Items may also be specified non-positionally, using a ITEM_NAME=value syntax. This is the most convenient way of formatting an instruction when only a few items need be specified. For example:
RUN Object_1, TIME = 15 CYCLES = 2 FILT=K
If the command is BIAS or DARK, then the Aperture, Ufilter, Utility, Lfilter, Lens and Filter items must not be specified. If the command is BIAS, the Time item must not be specified. If the command is RUN, the Filter item cannot be specified if either the Ufilter or Lfilter items is present.
The items in detail:
COMMAND "RUN", "BIAS" or "DARK".
Object_Name= Character string.
RA_Offset= Offset in Right Ascension to move telescope to, before
taking data (arcseconds).
Dec_Offset= Offset in Declination (arcseconds).
Method= Integration (readout) method (integer, range 1-7).
Cycles= Number of transputer co-add cycles.
Time= Exposure time (seconds).
Fndr= Number of Fowler non-destructive reads.
Repeats= Number of repeats of integration sequence.
Aperture= Aperture wheel position.
Ufilter= Upper Filter wheel position.
Utility= Utility wheel position.
Lfilter= Lower Filter wheel position.
Lens= Lens wheel position.
Filter= Combined Upper and Lower Filter wheel position.
Period= Non-destructive read period (seconds) [not used].
Tiptilt Enable Tip-Tilt operation.
NoTipTilt Disable Tip-Tilt operation.
Stage_Offset Enables IMB X-Y stage motion.
NoStage_Offset Disables IMB X-Y stage motion.
Track_Coord= Track on a new object coordinate specified as a text string
delimited by double quotes. The string format is as for
the telescope TRACK/COORD command. No object name can be
present; use the ``Object_Name'' DO file command instead.
The telescope returns to the original tracking coordinate
at the end of the DO file.
Guide_Coord= Defines a new guide star coordinate specified as a text
string delimited by double quotes. The string format is
as for the telescope TRACK/COORD command. No object name
can be present. The guide coordinates return to their
original values at the end of the DO file.
GRA_Offset= Defines guide star offset in arcsec in RA as a floating point
number. The guide coordinate returns to its original
value at the end of the DO file.
GDec_Offset= Defines guide star offset in arcsec in Dec. as a floating
point number. The guide coordinate returns to its original
value at the end of the DO file.
TTX= X coordinate of Tip-Tilt correct subframe center in integer
units of CCD pixels.
TTY= Y coordinate of Tip-Tilt correct subframe center in integer
units of CCD pixels.
TTDX= X size of Tip-Tilt correct subframe in integer units of CCD
pixels. Permitted values are 8, 10, 12, 16.
TTDY= Y size of Tip-Tilt correct subframe in integer units of CCD
pixels. Permitted values are 8, 10, 12, 16.
AcqX= X coordinate of Tip-Tilt acquire subframe center in integer
units of CCD pixels.
AcqY= Y coordinate of Tip-Tilt acquire subframe center in integer
units of CCD pixels.
AcqDX= X size of Tip-Tilt acquire subframe in integer units of CCD
pixels. Permitted values are 8, 10, 12, 16.
AcqDY= Y size of Tip-Tilt acquire subframe in integer units of CCD
pixels. Permitted values are 8, 10, 12, 16.
TT_Mode= Tip-Tilt operation mode specified as one of ``correct'',
``guide'', ``acquire'', or ``recalibrate''. Tip-Tilt is
left in acquire mode at the end of the DO file.
TT_ATime= Specifies acquire mode integration time in ms as a floating
point number. Remains in effect when DO file completes.
TT_GTime= Specifies guide mode integration time in ms as a floating
point number. Remains in effect when DO file completes.
TT_CTime= Specifies correct mode integration time in ms as a floating
point number. Remains in effect when DO file completes.
TT_Find Enables Auto-Acquire mode.
NOTT_Find Disables Auto-Acquire mode.
TT_Error Do not abort on Tip-Tilt errors.
NOTT_Error Abort DO file if Tip-Tilt errors encountered.