ESO Science Archive Facility

  Data Interface Control Document

Top Back


Mandatory header keywords

This appendix lists mandatory header keywords defined in the VLT generic dictionary ( ESO-VLT-DIC.GENERIC , version 1.0). These keywords are mandatory in the sense that they must be present in the header when applicable, that is when the parameter in question plays a role in the acquisition of the frame. Parameters not used for the exposure do not appear in the header even though present in the list below (e.g. no TEL keywords are included in BIAS frames).

For a description of the keywords please refer to http://archive.eso.org/DICB/ESO-VLT-DIC.GENERIC-1.0

Basic keywords

SIMPLE = T / Standard FITS format (NOST-100.0)
BITPIX = %d / # of bits storing pix values
NAXIS = %d / # of axes in frame
NAXIS1 = %d / # of pixels/row
NAXIS2 = %d / # of rows (also # of scan lines)
BZERO = %.1f / real=fits-value*BSCALE+BZERO
BSCALE = %.1f / real=fits-value*BSCALE+BZERO
BLANK =   %d / Value used for NULL pixels
INSTRUME= %10s / Instrument used
TELESCOP= %30s / ESO <TEL>
OBJECT = %30s / Target description
OBSERVER= %30s / Name of observer
ORIGIN = %30s / European Southern Observatory
PI-COI = %30s / Name(s) of proposer(s)
EXPTIME = %.3f / Total integration time (sec)
RA = %.6f / %HOURANG RA (J2000) pointing (deg)
DEC = %.5f / %DEGREE DEC (J2000) pointing (deg)
DATE =        %20s / Date this file was written
DATE-OBS=        %20s / Date the exposure was started
LST = %.3f / %TIME LST at start (sec)
UTC = %.3f / %TIME UTC at start (sec)
CTYPE1 = %s / pixel coordinate system
CTYPE2 = %s / pixel coordinate system
CRVAL1 = %.1f / Ref pixel in X of full chip
CRVAL2 = %.1f / Ref pixel in Y of full chip
CRPIX1 = %.1f / Ref pixel in X
CRPIX2 = %.1f / Ref pixel in Y
CDELT1 = %.8f / arcsec per pixel in RA (deg)
CDELT2 = %.8f / arcsec per pixel in DEC (deg)
EQUINOX = %.0f / Standard FK5 (years)
RADECSYS= %8s / FK5
MJD-OBS = %.8f / Obs start %DAYTIM (days)
ESO-LOG   free
COMMENT   free

Telescope

HIERARCH ESO TEL ID = %30s / Telescope Control SW ID
HIERARCH ESO TEL DID = %30s / Data dictionary for TEL
HIERARCH ESO TEL DATE = %10s / TCS installation date
HIERARCH ESO TEL ALT = %.3f / Tel ALT angle at start (deg)
HIERARCH ESO TEL AZ = %.3f / Tel Azimuth at start (deg)
HIERARCH ESO TEL GEOELEV = %.0f / Elevation above sea level (m)
HIERARCH ESO TEL GEOLAT = %.4f / Tel geographic lat (+=North) (deg)
HIERARCH ESO TEL GEOLON = %.4f / Tel geographic lon (+=East) (deg)
HIERARCH ESO TEL CHOP POSANG = %.3f / Posang of chopping (N=0 E=90) (deg)
HIERARCH ESO TEL CHOP ST     =   %c / TRUE when chopping active
HIERARCH ESO TEL CHOP THROW = %.3f / Chopping throw (arcsec)
HIERARCH ESO TEL CHOP FREQ = %.0f / Chopping frequency (Hz)
HIERARCH ESO TEL CHOP CYCL = %d / # chopping cycles
HIERARCH ESO TEL FOCU ID = %10s / Telescope focus station ID
HIERARCH ESO TEL FOCU LEN = %.3f / Focal length (m)
HIERARCH ESO TEL FOCU SCALE = %.3f / Focus scale (arcsec/mm)
HIERARCH ESO TEL FOCU VALUE = %.3f / M2 setting (mm)
HIERARCH ESO TEL PARANG END = %.3f / Parallactic angle at end (deg)
HIERARCH ESO TEL PARANG START= %.3f / Parallactic angle at start (deg)
HIERARCH ESO TEL TRAK RATEA = %.3f / Tracking rate in RA (mas/sec)
HIERARCH ESO TEL TRAK RATED = %.3f / Tracking rate in DEC (mas/sec)
HIERARCH ESO TEL TRAK STATUS = %10s / Tracking status
HIERARCH ESO TEL AIRM START  = %.3f / Airmass at start of exposure
HIERARCH ESO TEL AIRM END    = %.3f / Airmass at end of exposure

Instrument

HIERARCH ESO INS ID = %30s / Instrument Control SW ID
HIERARCH ESO INS DID = %30s / Data dictionary for INS
HIERARCH ESO INS DATE = %10s / ICS installation date
HIERARCH ESO INS ADC STATUS = %10s / ADC status
HIERARCH ESO INS ADC POS = %10s / ADC position
HIERARCH ESO INS OPER = %30s / Instrument Operator
HIERARCH ESO INS FILTi ID = %10s / Filter i unique id
HIERARCH ESO INS FILTi NAME = %10s / Filter i name
HIERARCH ESO INS GRATi POSANG= %.3f / Grating posang (N=0 E=90) (deg)
HIERARCH ESO INS GRATi ID = %10s / Grating unique ID
HIERARCH ESO INS GRATi NAME = %30s / Grating common name
HIERARCH ESO INS GRATi DISP = %.1f / Grating dispersion (nm/mm)
HIERARCH ESO INS GRATi WLEN = %.1f / Grating central wavelength (nm)
HIERARCH ESO INS GRISi POSANG= %.3f / Grism posang (N=0 E=90) (deg)
HIERARCH ESO INS GRISi ID = %10s / Grism unique ID
HIERARCH ESO INS GRISi NAME = %30s / Grism common name
HIERARCH ESO INS GRISi DISP = %.1f / Grism dispersion (nm/mm)
HIERARCH ESO INS GRISi WLEN = %.1f / Grism central wavelength (nm)
HIERARCH ESO INS LAMPi NAME = %10s / Lamp name
HIERARCH ESO INS LAMPi EXPTIME=  %.3f / Lamp exp time (sec)
HIERARCH ESO INS MODE = %10s / Instrument mode used
HIERARCH ESO INS TEMP = %.1f / Instrument temperature (C)
HIERARCH ESO INS PATH = %10s / Optical path used
HIERARCH ESO INS OPTIi POSANG= %.3f / Position angle (N=0 E=90) (deg)
HIERARCH ESO INS OPTIi ID = %10s / OPTIi unique ID
HIERARCH ESO INS OPTIi NAME = %10s / OPTIi name
HIERARCH ESO INS OPTIi NO =     %d / OPTIi slot number
HIERARCH ESO INS OPTIi TYPE = %10s / OPTIi element
HIERARCH ESO INS MOS SETUP = %30s / MOS setup
HIERARCH ESO INS MOSi POSANG = %.5f / MOSi posang (N=0 E=90) (deg)
HIERARCH ESO INS MOSi WID = %.2f / MOSi slit width (arcsec)
HIERARCH ESO INS MOSi LEN = %.2f / MOSi slit length (arcsec)
HIERARCH ESO INS MOSi RA = %.8f / RA of slit (deg)
HIERARCH ESO INS MOSi DEC = %.8f / DEC of slit (deg)
HIERARCH ESO INS SLIT WID = %.2f / SLIT width (arcsec)
HIERARCH ESO INS SLIT LEN = %.2f / SLIT length (arcsec)
HIERARCH ESO INS SLIT POSANG = %.3f / SLIT posang (N=0 E=90) (deg)
HIERARCH ESO INS SLIT RA = %.8f / RA of slit (deg)
HIERARCH ESO INS SLIT DEC = %.8f / DEC of slit (deg)
HIERARCH ESO INS PIXSCALE    =        %.3f / Pixel scale (arcsec)

Detector

HIERARCH ESO DET DID = %30s / Data dictionary for DET
HIERARCH ESO DET ID = %30s / Detector Contro SW ID
HIERARCH ESO DET DATE = %10s / DCS installation date
HIERARCH ESO DET NAME = %10s / Name of detector system
HIERARCH ESO DET CCDS = %d / # of CCDs in detector array
HIERARCH ESO DET CHIPi ID    = %30s / Detector CCD identification
HIERARCH ESO DET CHIPi DATE  = %30s / Date of installation
HIERARCH ESO DET CHIPi NAME  = %16s / Detector CCD name
HIERARCH ESO DET CHIPi NX    = %d / # of pixels along X
HIERARCH ESO DET CHIPi NY    = %d / # of pixels along Y
HIERARCH ESO DET CHIPi PSZX  = %.1f / Size of pixel in X (mu)
HIERARCH ESO DET CHIPi PSZY  = %.1f / Size of pixel in Y (mu)
HIERARCH ESO DET EXP TYPE = %s / Type of exp as known to the CCD sw
HIERARCH ESO DET EXP ID = %d / Unique exposure ID number
HIERARCH ESO DET EXP DUMDIT = %d / # of dummy readouts
HIERARCH ESO DET READ NO     = %d / # of times the same pixel is read
HIERARCH ESO DET READ MODE = %10s / Readout method
HIERARCH ESO DET READ SPEED = %10s / Readout speed
HIERARCH ESO DET READ SHIFT =   %d / # of lines shifted between exp
HIERARCH ESO DET READ CLOCK = %10s / Readout clock pattern used
HIERARCH ESO DET OUTPUTS = %d / # of outputs
HIERARCH ESO DET OUTREF = %d / reference output
HIERARCH ESO DET OUTi X = %d / X location of output
HIERARCH ESO DET OUTi Y = %d / Y location of output
HIERARCH ESO DET OUTi PRSCX = %d / Prescan region in X
HIERARCH ESO DET OUTi PRSCY = %d / Prescan region in Y
HIERARCH ESO DET OUTi OVSCX = %d / Overscan region in X
HIERARCH ESO DET OUTi OVSCY = %d / Overscan region in Y
HIERARCH ESO DET OUTi CF = %.2f / Conversion from e- to ADUs (e-/ADU)
HIERARCH ESO DET OUTi GAIN = %.2f / Gain for output
HIERARCH ESO DET CHIPi OUTPUTS=         %d / # of outputs
HIERARCH ESO DET CHIPi OUTREF =         %d / reference output
HIERARCH ESO DET CHIPi OUTi Y =         %d / Y location of output
HIERARCH ESO DET CHIPi OUTi PRSCX=      %d / Prescan region in X
HIERARCH ESO DET CHIPi OUTi PRSCY=      %d / Prescan region in Y
HIERARCH ESO DET CHIPi OUTi OVSCX=      %d / Overscan region in X
HIERARCH ESO DET CHIPi OUTi OVSCY=      %d / Overscan region in Y
HIERARCH ESO DET CHIPi OUTi CF=       %.2f / Conversion from e- to ADUs (e-/ADU)
HIERARCH ESO DET CHIPi OUTi GAIN=     %.2f / Gain for output
HIERARCH ESO DET CHIPi OUTi GAIN=     %.2f / Gain for output
HIERARCH ESO DET FRAM ID = %d / Image sequential number
HIERARCH ESO DET FRAM TYPE = %16s / Type of frame
HIERARCH ESO DET FRAM NAVER = %d / Number of images averaged
HIERARCH ESO DET FRAM BIAS = T / bias frame subtraction performed
HIERARCH ESO DET FRAM FLATF = T / flat field division performed
HIERARCH ESO DET WINDOWS = %d / # of windows readout
HIERARCH ESO DET WINi STRX = %d / Lower left pixel in X
HIERARCH ESO DET WINi STRY = %d / Lower left pixel in Y
HIERARCH ESO DET WINi NX = %d / # of pixels along X
HIERARCH ESO DET WINi NY = %d / # of pixels along Y
HIERARCH ESO DET WINi BINX = %d / Binning factor in X
HIERARCH ESO DET WINi BINY = %d / Binning factor along Y
HIERARCH ESO DET DKTM        = %.3f / Dark current time (sec)
HIERARCH ESO DET REQTIM = %.3f / Requested exposure time (sec)
HIERARCH ESO DET WINi NDIT   = %d / # of subintegrations
HIERARCH ESO DET WINi UITi   = %.3f / requested subintegration time (sec)
HIERARCH ESO DET WINi DITi   = %.3f / actual subintegration time (sec)
HIERARCH ESO DET SHUT TYPE = %16s / type of shutter

Adapter

HIERARCH ESO ADA POSANG = %.5f / Position angle at start (deg)
HIERARCH ESO ADA ABSROT START=        %.5f / Abs rot angle at exp start (deg)
HIERARCH ESO ADA ABSROT END = %.5f / Abs rot angle at exposure end (deg)
HIERARCH ESO ADA GUID STATUS = %10s / Status of autoguider
HIERARCH ESO ADA GUID RA = %.5f / %HOURANG Guide star RA J2000 (deg)
HIERARCH ESO ADA GUID DEC = %.5f / %DEGREE Guide star DEC J2000 (deg)
HIERARCH ESO ADA GUID ROT = %.5f / Rot of guide probe arm (deg)

ObsBlock

HIERARCH ESO OBS DID = %30s / Data dictionary for OBS
HIERARCH ESO OBS ID          =   %d / Observation block id
HIERARCH ESO OBS NAME = %30s / Observation block name
HIERARCH ESO OBS GRP = %30s / linked blocks
HIERARCH ESO OBS PROG ID = %20s / ESO program identification
HIERARCH ESO OBS TPLNO       = %d / Template seq # in OB

Template

HIERARCH ESO TPL DID = %30s / Data dictionary for TPL
HIERARCH ESO TPL ID          = %30s / Template ID
HIERARCH ESO TPL NAME        = %30s / Template name
HIERARCH ESO TPL SEQNO = %d / Template seq # within OBS
HIERARCH ESO TPL NEXP        =          %d / Number of exposures within template
HIERARCH ESO TPL EXPNO       = %d / Exposure number within template

Data Product

HIERARCH ESO DPR DID = %30s / Data dictionary for DPR
HIERARCH ESO DPR CATG = %15s / Observation category
HIERARCH ESO DPR TYPE = %15s / Observation type
HIERARCH ESO DPR TECH = %15s / Observation technique


Top  Back


Last updated: November 28, 1997