Space Telescope Science Institute
COS Data Handbook 2.00
help@stsci.edu
Table of Contents Previous Next Print


COS Data Handbook > Chapter 2: COS Data Files > 2.6 Headers, Keywords, and Relationship to Phase II

2.6
As with previous HST instruments, the FITS header keywords in COS data files store important information characterizing the observations and telemetry received during the observations, and describe the post-observation processing of your dataset. Each keyword follows FITS conventions and is no longer than eight characters. Values of keywords can be integer, real (floating-point), boolean, and character strings. Several keywords are HST and COS specific. Knowledge of the keywords and where to find them is an important first step in understanding your data. By examining your file headers, using either catfits, imhead, hselect, thselect or hedit, in STSDAS you will find detailed information about your data including:
Exposure-specific information such as more detailed timing, world coordinate system information, and Fine Guidance Sensor identification.
Calibration information such as the calibration switches and reference files used by the pipeline and parameters derived from the calibration, such as image statistics and wavelength shifts.
The keywords relevant for one COS data type will not necessarily be relevant to another. Accordingly, you will find that the header on a particular file type contains a unique combination of keywords appropriate for that type of observation. Long definitions for the keywords can also be accessed from the following Web page, which provides detailed explanations of the contents and algorithm for populating the keywords. This site also provides sample headers for different COS file types:
http://stdatu.stsci.edu/keyword/.
Keywords that deal with a particular topic, such as the instrument configuration, are grouped together logically throughout the headers. Table 2.15 lists a useful subset of these groups of keywords, indicates the name of the grouping, and where applicable, shows their relationship to the corresponding information from the Phase II proposal.
Table 2.16 summarizes the possible calibration switch keywords, and indicates whether they are present for a particular observation; it also indicates the reference file keyword corresponding to the particular calibration step. A calibration switch keyword is initially populated with values of OMIT, PERFORM or N/A in the raw uncalibrated science data. After each calibration step is executed in the COS calibration pipeline, calcos will set the keyword switch to COMPLETE.
Header
Keyword
PR_INV_L
PR_INV_F
PI Last Name
PI First Name
Last name of principal investigator
First name of principal investigator
Visit_Number, Exposure_Number
Indicates the visit and exposure number from the Phase II
proposal: Visit_Number, Exposure_Number.
RA_TARG
DEC_TARG
RA
DEC
Right ascension of the target (deg) (J2000).
Declination of the target (deg) (J2000).
POSTARG1
POSTARG2
POSTARG
POSTARG
Postarg in axis 1 direction.
Postarg in axis 2 direction.
Observation type (IMAGING or SPECTROSCOPIC).
Operating mode (ACCUM, TIME-TAG).
Exposure type (EXTERNAL/SCI, WAVECAL, PHA, DARK, FLAT, ACQ/IMAGE, ACQ/SEARCH, ACQ/PEAKD, ACQ/PEAKXD, ENG DIAG, or MEM DUMP).
Detector in use (NUV or FUV).
FUV detector segment in use (FUVA, FUVB, BOTH, or N/A).
FUV detector high voltage state (NomAB, NomA, NomB, Off, Low).
Data from a subarray (T) or full frame (F).
Lamp status, NONE or name of lamp which is on (P1, D1, P2, or D2)
Type of flashed exposures in TIME-TAG (NONE, AUTO, or uniformly-spaced).
Cross-dispersion location at which calcos extracted the FUV segment A or NUV stripe A spectrum.
Cross-dispersion location at which calcos extracted the FUV segment B or NUV stripe B spectrum.
Cross-dispersion location at which calcos extracted the NUV stripe C spectrum.
Nominal location of the spectral extraction region for FUV segment A or NUV stripe A based on the wavecal aperture location.
Nominal location of the spectral extraction region for FUV segment B or NUV stripe B based on the wavecal aperture location.
Offset from SP_NOM_A at which the spectrum was found.
Offset from SP_NOM_B at which the spectrum was found.
Offset from SP_NOM_C at which the spectrum was found.
nsubarry1
NUV Deadtime correction method (DATA, DEVENTS, or MEVENTS)
FUVA Deadtime correction method (DATA, DEVENTS, or MEVENTS)
FUVB Deadtime correction method (DATA, DEVENTS, or MEVENTS)
TIME-TAG Events Orientation Keywords (in Extension header 1 or greater)2

1
For FUV data subarrays 1-3 refer to segment A, and subarrays 4-7 refer to segment B.

2
The values for these keywords are currently deleted from the output files except for NUV Imaging.

Table 2.16: Spectroscopic Calibration Switch Keywords
Omit1
Omit2

1
BRSTCORR is set to Omit until further information about FUV bursts has been determined on-orbit.

2
FLA.

Table 2.17: Imaging Calibration Switch Keywords
Table 2.18: Reference File Keywords

Table of Contents Previous Next Print