}

DIS Keywords

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.