DIS Keywords

• For all keywords that contain a red and a blue value, the blue value comes first.
• Several keywords are historical, and will eventually be modified or removed. These are noted with an [M]
• The ICC generates a handful of other keywords which are not documented, mostly because they are for debugging.
• Case is a sore subject. I would like all the keywords to start with a lowercase letter and have other words be capitalized (e.g.: semiStudlyCaps=123), but some existing software would be confused.
• If the value is listed as a word, it is text with no enclosing quotes. string values do have enclosing quotes.

basename=string

The full pathname, but without the trailing "b.fit" and "r.fit", that would be given to the next exposure if the basename argument is not given to the expose command.

ccdHeaters=float,float

Heater currents, percent of full-scale. 0.0 to 100.0. As of 2003-03, the CCD temperatures are currently not regulated.
These are put in the CCDHEAT FITS header cards.

ccdTemps=float,float

Blue and red CCD temperatures, degC. As of 2003-03, the temperatures are currently not regulated.
These are put in the CCDTEMP FITS header cards.

bluelambda1=float [M]

bluelambda2=float [M]

The center wavelength for the given grating: the 1 or 2 indicates the grating bay. The bluelambda and redlambda keywords match one set of these, depending on the position of the turret. Set to 0 if the value is not known.
The appropriate value is put in the DISPWC FITS header card.

blueReadout=float

How much of the CCD has been read out. 0.0 to 1.0. This is currently output every five seconds during readout.

bluestep1=int [M]

bluestep2=int [M]

The grating tilt, in motor steps. The 1 or 2 indicates the grating bay.

blueURL=string

A URL pointing to the just-finished exposure. This is only generated if the image path is under /export/images. Because of APO username and password requirements for reading the data, the URL is not quite useable as-is. ftp://tycho.apo.nmsu.edu/export/images/test/bias.0001b.fit would need to be changed to ftp://USER:PASS@tycho.apo.nmsu.edu/export/images/test/bias.0001b.fit, with USER and PASS set to the proper values. This should be fairly straightforward for a program to insert. Note that the ftp directory on tycho is not writeable.

bluezerostep1=int [M]

bluezerostep2=int [M]

The grating tilt that was used to define the center wavelength, in motor steps. The 1 or 2 indicates the grating bay.

camtxt=string

The output lines from the camera controller, in response to camcmd commands.

ccdBin=X,Y

The CCD binning. Dispersion is along the X-axis.
This is put in the CCDBIN1 and CCDBIN2 FITS header cards.

ccdOverscan=cols,rows

The CCD overscan columns and rows. The overscan columns should provide a good bias region.
The overscan columns, inset by two columns and one row from each side, are indicated in the BIASSEC FITS header card. That inset can be changed by editting the config/configdata.py file, as can the default overscan size.

ccdState=string

The state of the CCD controller. "unknown" or "undefined" indicate that the controller needs to be initialized, "ok" that is is idle. The other two states are "integrating" and "reading".

ccdWindow=xlo,ylo,xhi,yhi

The CCD readout window, in binned pixels. The bottom-left corner of the bottom-left pixel is at (1, 1).
The origin is put in the CNPIX1 and CNPIX2 FITS header cards, and the size in the NAXIS1 and NAXIS2 cards.

detent=steps

The commanded position of the grating turret detent. This is occasionally useful for diagnosing turret rotation problems: the detent gets hung up on the rim of the turret, and the following turret move shows a huge decrease in the detent position.

diserrtxt=string

Error messages from the instrument. Yes, and? CPL

disfilter=word [M]

Either Empty or Gunn-Thuan.
Use filterName instead.

dismaskstat=string[M]

See (and use) maskNames.

distxt=string

Human- and Remark-friendly descriptive text about what the instrument is doing. These get dribbled out while motors are moving and exposures progress.

exposureState=string

The state of any running exposure. Runs through the following:

• flushing - the CCDs are being flushed.
• integrating - an object or dark exposure is integrating (resuming a paused exposure generates integrating)
• reading - the CCDs are being read out.
• paused - an object exposure has been paused. Resuming will generate integrating
• done - the exposure has been successfully finished.
• aborted - the exposure has been aborted, and the image discarded.

filterID=int

1 if the filter set is not in the light path, 2 if it is.

filterName=string

The name of the currently installed filter pair. "Empty" or "Gunn-Thuan"

filterNames=string, string

The names of the installed filters. The filters are inside the instrument, and cannot be changed.

gratingset1=word [M]

gratingset2=word [M]

The names of the grating sets installed in the two turret positions. For example: "high", "Rlo+Bmed", etc.
Really should be strings.

mask=int [M]

The index of the installed slit mask. 1..5
Use maskID instead.

maskID=int

The index of the installed slit mask. 1..5

maskName=string

The name of the installed slit mask. Basically maskNames[maskID].

maskNames=string,string,string,string,string

The names of the five slit masks. If the mask names have not been defined, they will each be set to "unknown".

name=string

The filename of the next auto-generated filename, without the directory, the sequence number, or the file extension.

number=int

The sequence number of the next auto-generated filename.

path=string

The directory of the next auto-generated filename.

places=int

The number of places to pad the sequence number of the next auto-generated filename.

readoutOrder=string [M]

Always "parallel". This is only required to keep Remark 2.80 through 2.82 happy.

redXXX

See blueXXX

shutter=word

open or closed.

TDStxt=string

The output lines from the TDS motor controller, in response to tdscmd commands.

turret=string [M]

A too-clever string describing the active grating set. If the turret is at a grating position, the name of the grating bay followed by the grating name in parentheses. e.g. turret="gratingset1(high)"

turretPos=int

The position of the turret. Matches the argument to the motors command. If 1 or 2, also matches the number at the end of the keywords.