[Top] [Prev] [Next] [Bottom]

25.2 Header Keywords

In Table 25.2 we list those header keywords found in a calibrated WFPC2 image (suffix .c0h) that many observers are likely to find useful. A complete list of header keywords, with brief explanations, can be found in the Keyword Dictionary, available on the STScI Web pages:

http://archive.stsci.edu/keyword 

The STSDAS tasks hedit or imhead can be used to view any or all of the header and group keywords. WFPC2 keywords include items such as observing mode, integration time, filters and reference files used, calibration steps performed, and the properties of the data itself (e.g., number of groups, dimensions in pixels of each group, reference pixels, coordinates, scale, flux units, image statistics). Some additional calibration information is given at the end of the header file in HISTORY keywords.

Some keywords can occasionally be confusing. Users should pay special attention to DATE, which refers to the date the file was written, as opposed to DATE-OBS, the date of the observation; FILTER1 and FILTER2, which are the numerical designations of the filter(s) used, while the filter names are FILTNAM1 and FILTNAM2; and PHOTZPT, which is not the photometric zeropoint (in the ST magnitude system) as normally understood, but rather the zeropoint in the ST magnitude system to be used after conversion to FLAM units (see "Photometric Zero Point" on page 28-1).

Astrometry keywords can also be confusing. The orientation of the image is specified by a global keyword, PA_V3, and a group keyword, ORIENTAT. The keyword PA_V3 gives the position angle (in degrees) of the telescope's V3 axis on the sky, measured from North through East. The V3 axis is roughly 225 degrees from the x axis of the PC. This axis differs by exactly 180 degrees from the ORIENT value specified in the Phase II submission, which refers to the U3 axis. The group keyword ORIENTAT gives, for each detector, the position angle of the y axis in the plane of the sky, measured from North through East. This angle differs from PA_V3 by roughly -135, -45, +45, and +135 degrees, for PC1, WF2, WF3, and WF4, respectively. See Figure 24.2 for a graphic representation of the geometric relationship between the four detectors. Accurate values of the positions and rotations between chips can be obtained from the Science Instrument Aperture File (SIAF). The SIAF is available via the WWW at:

http://www.stsci.edu/ftp/instrument_news/
Observatory/siaf.html
In addition, each group has eight keywords (listed under coordinate-related keywords below) that specify the transformation from pixels to world coordinates (right ascension and declination) in the tangent plane approximation at the center of the chip.


WFPC2 Header Keywords

Keyword

Description

Information about the groups

GROUPS

Multi-group image? Indicates whether data has groups.

GCOUNT

Number of groups per observation (1 to 4)

Coordinate-related keywords

CRVAL1

RA of reference pixel (deg)

CRVAL2

Dec of reference pixel (deg)

CRPIX1

X coordinate of reference pixel

CRPIX2

Y coordinate of reference pixel

CD1_1

Partial derivative of RA with respect to x

CD1_2

Partial derivative of RA with respect to y

CD2_1

Partial derivative of Dec with respect to x

CD2_2

Partial derivative of Dec with respect to y

Orientation

MIR_REVR

Is image mirror reversed?

ORIENTAT

Orientation of y axis (deg)-different for each group

Bias level information (columns 3-14 of the .x0h/.x0d file)

DEZERO

Bias level from engineering data

BIASEVEN

Bias level based on average of odd columns in .x0h/.x0d file (even columns in science image)

BIASODD

Bias level based on average of even columns in .x0h/.x0d file (odd columns in science image)

Pixel statistics

GOODMIN

Minimum value of "good" pixels (not flagged in DQF)

GOODMAX

Maximum value of "good" pixels

DATAMEAN

Mean value of "good" pixels

Photometry keywords

PHOTMODE

Photometry mode

PHOTFLAM

Inverse sensitivity (units of erg/sec/cm2/Å for 1 DN/sec)

PHOTZPT

Zeropoint (currently -21.10, if DOPHOTOM = yes)

PHOTPLAM

Pivot wavelength (in angstroms)

PHOTBW

rms bandwidth of filter (in angstroms)

Image statistics keywords

MEDIAN

Middle data value when good quality pixels sorted

HISTWIDE

Width of the histogram

SKEWNESS

Skewness of the histogram

MEANC10

Mean of a 10 x 10 region at the center of the chip

MEANC100

Mean of a 100 x 100 region at the center of the chip

MEANC300

Mean of a 300 x 300 region at the center of the chip

BACKGRND

Estimated background level

Image keywords

INSTRUME

Instrument used; always WFPC2

ROOTNAME

Rootname of the observation set

FILETYPE

SHP - standard header packet

EXT - extracted engineering file

EDQ - EED data quality file

SDQ - science data quality file

SCI - science data file

MODE

Mode: FULL (full resol.) or AREA (2 x 2 pixel summation)

SERIALS

Serial clocks: ON, OFF

Data type keywords

IMAGETYP

DARK/BIAS/IFLAT/UFLAT/VFLAT/KSPOT/EXT/ECAL

CDBSFILE

GENERIC/BIAS/DARK/FLAT/MASK/NO Is the image a reference file and if so, type is specified

Reference file selection keywords

DATE

File creation date (dd/mm/yy)

FILTNAM1

First filter name

FILTNAM2

Second filter name; blank if none

FILTER1

First filter number (0-48) (Historical, but used in SOGS)

FILTER2

Second filter number (0-48)

FILTROT

Partial filter rotation angle (degrees)

More reference file selection keywords

ATODGAIN

Analog to digital gain (electrons/DN)

Calibration switches

MASKCORR

Do mask correction: PERFORM, OMIT, COMPLETE

ATODCORR

Do A-to-D correction: PERFORM, OMIT, COMPLETE

BLEVCORR

Do bias level correction: PERFORM, OMIT, COMPLETE

BIASCORR

Do bias correction: PERFORM, OMIT, COMPLETE

DARKCORR

Do dark correction: PERFORM, OMIT, COMPLETE

FLATCORR

Do flatfield correction: PERFORM, OMIT, COMPLETE

SHADCORR

Do shaded shutter correction: PERFORM, OMIT, COMPLETE

DOSATMAP

Output saturated pixel map: PERFORM, OMIT, COMPLETE

DOPHOTOM

Fill photometry keywords: PERFORM, OMIT, COMPLETE

DOHISTOS

Make histograms: PERFORM, OMIT, COMPLETE

OUTDTYPE

Output image datatype: REAL, LONG, SHOR-always set to REAL by PODPS pipeline

Calibration reference files used1

MASKFILE

Name of the input static mask containing known bad pixels and charge traps

ATODFILE

Name of the A-to-D conversion file

BLEVFILE

Name of engineering file with extended register data

BLEVDFIL

Name of data quality file (DQF) for the engineering file

BIASFILE

Name of the bias frame reference file

BIASDFIL

Name of the bias frame reference DQF

DARKFILE

Name of the dark reference file

DARKDFIL

Name of the dark reference DQF

FLATFILE

Name of the flatfield reference file

FLATDFIL

Name of the flatfield reference DQF

SHADFILE

Name of the reference file for shutter shading

PHOTTAB

Name of the photometry calibration table

SATURATE

Data value at which saturation occurs

(always 4095 for WFPC2, which includes the bias)

Ephemeris data

PA_V3

Position angle of V3 axis of HST

RA_SUN

Right ascension of the sun (deg)

DEC_SUN

Declination of the sun (deg)

EQNX_SUN

Equinox of the sun

Fill values

PODPSFF

0 (no fill), 1 (fill present)

RSDPFILL

Bad data fill value set in pipeline for calibrated image

Exposure Information

DARKTIME

Estimate of darktime (in sec)

EQUINOX

Equinox of the celestial coordinate system

SUNANGLE

Angle between sun and V1 axis (deg)

MOONANGL

Angle between moon and V1 axis (deg)

SUN_ALT

Altitude of the sun above Earth's limb (deg)

FGSLOCK

Commanded FGS lock (FINE, COARSE, GYROS, UNKNOWN)

Timing information

DATE-OBS

UT date of start of observation (dd/mm/yy)

TIME-OBS

UT time of start of observation (hh:mm:ss)

EXPSTART

Exposure start time (Modified Julian Date)

EXPEND

Exposure end time (Modified Julian Date)

EXPTIME

Exposure duration (seconds)

EXPFLAG

How exposure time was calculated. (NORMAL, INTERRUPTED, INCOMPLETE, EXTENDED, UNCERTAIN, INDETERMINATE, or P REDICTED)

Proposal information

TARGNAME

Proposer's target name

RA_TARG

Right ascension of the target (deg) (J2000)

DEC_TARG

Declination of the target (deg) (J2000)

PROPOSID

RPS2 proposal identifier

1 Calibration reference file keywords are populated even if unused.



[Top] [Prev] [Next] [Bottom]

stevens@stsci.edu
Copyright © 1997, Association of Universities for Research in Astronomy. All rights reserved. Last updated: 11/13/97 17:49:45