The quickest way to learn how each observation was performed is to use the
iminfo task in the
STSDAS toolbox.headers package to look at the headers of the science data. The output from
iminfo summarizes on one screen the relevant information about an observation (
Table 2.9) and the instrument configuration during the observations (
Table 2.10), by reading and reporting the values of various keywords.
The entire suite of keywords from any header can be listed with the IRAF task
imheader. Given that NICMOS data files contain multiple extensions, the number of the desired extension must always be specified. For example, to list the primary header content of a calibrated image, you type
where [0] identifies the primary header. To list the header of the
second science image in a MULTIACCUM sequence (the sixth extension):
Chapter 2 of the "HST Data Handbook" describes in detail how to work with FITS file extensions. Here we will recap the essentials. In order to simplify access to NICMOS FITS image extensions, each extension header contains the two keywords extname
(extension name) and extver (extension version number). The extname keyword identifies the nature of the extension (SCI, ERR, DQ, SAMP, TIME, see
Table 2.9). The extver keyword contains an integer value which is used to uniquely identify a particular imset (quintuple of image extensions). For example, the five image extensions (single imset) contained in the science data file for an ACCUM or BRIGHTOBJ observation will all usually be assigned an extver value of 1 because there will only be one set of extensions in the file. In a MULTIACCUM science data file, each set of extensions associated with a given readout will have a unique extver value, running from 1 up to the total number of readouts in that particular file.
To list the header of the second science image in a MULTIACCUM sequence, in place of the command line above, one could instead type:
In general, to access a particular image extension, append the name and version number of the desired extension in square brackets to the end of the file name. The extname value is specified first, then the extver value, separated by a comma. Indeed, the use of the keywords extname and extver is not limited to the task
imheader, but can be used in all
IRAF tasks.
If a calibration keyword needs to be changed, the IRAF/STSDAS chcalpar task can be used. For instance, to modify the flat-field calibration switch from perform to omit in a given data file, the following command can be given:
The parameter set (or "pset") list appropriate for the image will appear, and the calibration keyword can be modified. The operation performed with
chcalpar can be equivalently performed (although in a more cumbersome way) with the general
IRAF task
hedit; in this case, the extension [0] of the primary header
must be explicitly specified:
Image sections can be specified in the case of NICMOS data with the same syntax as all
IRAF images. For example, to specify a pixel range from 101 to 200 in the
x direction and all pixels (denoted by an asterisk) in the
y direction from the second error image in a file, the complete file name specification would be: