Photometric Calibration information in postage stamp headers

This note describes the what information about single exposure photometric calibration will be available in the headers of postage stamp images.

PS1 exposures are calibrated photometrically in multiple stages of the pipeline.

• During the camera stage psastro compares the point sources detected at the chip stage with a reference catalogue and computes the astrometric solution and measures the photometric zero point.
• The ubercal process [XXX: insert reference] refines the zero points. These values are then inserted into the DVO catalog.
• During DVO calibration, exposures that were not ubercaled are calibrated by relphot [XXX: insert reference or text describing the process]. New zero points are measured for the non-ubercal exposures, ubercal exposures keep the zero points measured there.

It has been requested that the IPP postage stamp server include calibration information in the headers of the postage stamps. This project is in the process of being implemented. After DVO calibration the resulting information will be extracted and saved in the table relExp in the IPP meta data database (the mysql database named gpc1). The postage stamp server will include the data in the postage stamp FITS headers.

The following table describes the associated keywords that provide the information.

keyword     type    Description 

ZPCALIB     F32     calibrated zero point extracted from DVO.
ZPCALERR    F32     error in calibrated zero point. Zero for ubercal exposures. 
                    
DVOFLAGS    U32     photometry calibration flags extracted from dvo image flags. Includes flag indicating if the exposure is an ubercal
                    exposure.
UCALDIST    U32     Distance to ubercaled image XXX: 0 for ubercaled exposures. XXX: Describe more completely.
UCALFILE    STR     base name of ubercal file (serves as ubercal version)
DVODB       STR     base name of DVO database used for calibration (Source of calibration information)

CALDATE     STR     timestamp relExp was last updated (presumably when it's state was changed to calibrated)
PSREL       STR     ippRelease name for processing/calibration (for example 3PI.PV1) 

All keywords are absent if exposure's relExp for given release is not "calibrated"

Related keywords

ZPT_OBS     zero point and error measured by psastro
ZPT_ERR
PSREFCAT    base name of reference catalog used by psastro.