|Space Telescope Science Institute|
|COS Data Handbook 2.00|
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:
• Instrument configuration information such as detector, grating, central wavelength setting, and aperture.
• 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: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.
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.
Right ascension of the target (deg) (J2000).
Declination of the target (deg) (J2000).
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). Is the target extended (Yes or No). Number of repeat exposures in dataset: Default = 1. External shutter position (OPEN or CLOSED). Corrected exposure time (seconds). For FUV exposures, the largest of EXPTIMEA and EXPTIMEB Wavecal shift determined for FUV segment A or NUV stripe A in dispersion direction (pixels). Wavecal shift determined for FUV segment B or NUV stripe B in dispersion direction (pixels). 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. Nominal location of the spectral extraction region for NUV stripe C 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. Fractional part of pixel coordinate for FUV segment A or NUV stripe A (pixels). Average binning error. Fractional part of pixel coordinate for FUV segment B or NUV stripe B (pixels). Average binning error. 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
Table 2.16: Spectroscopic Calibration Switch Keywords
TIME-TAG Omit1 Omit2
Table 2.17: Imaging Calibration Switch Keywords
Table 2.18: Reference File Keywords