FITS keywords for CIRPASS data

Keywords that should be in raw FITS files output from PixCel.

Assuming:
- PixCel mosaics the quadrants
- PixCel can read an external FITS header file
- we can choose a subset of FITS header keywords that we want PixCel to write out

Most but not all of these keywords will have values in the raw FITS files.

Keyword values are either intrinsic to PixCel or are read by PixCel from an external file. The values of the keywords in the external file are written by the ICS. The ICS gets these values from three sources: the observation set up parameters, by monitoring the status of the instrument and from the telescope via the VII. For keywords that are read from an external file the table notes which of these sources the keyword value comes from (set up, inst. status or Telescope). For values that come from the telescope the table gives the name of the VII status item that contains this value.

Keyword Type Default Description Keyword read from Initial Value acquired from Value changed by
SIMPLEboolTThis is a FITS filePixCel
BITPIXint1616bit signed dataPixCel
NAXISint22d images supportedPixCel
NAXIS1int1024Number of pixels in rowPixCel
NAXIS2int1024Number of pixels in colPixCel
EXTENDboolTFile may contain standard extensionswritten by stack
NEXTENDint0Number of standard extensionswritten by stack
IRAF-TLMstring???Time of last modificationwritten by IRAFIRAF tasks?
IRAFNAMEstring.fitsFilenamewritten by IRAF
Target information
TARGNAMEstring
Name of target objectexternalTelescope targetName
TARG_RArealdd.ddddddddddright ascension of the target (deg) J2000externalTelescope targetRA
TARG_DECrealdd.dddddddddddeclination of the target (deg) J2000externalTelescope targetDec
Observation information
NRUNint735Run NumberPixCel
OBSTYPEstringDARK / ARC / DOMFLAT / SKYFLAT / OBJECT / SUPLAMP / FLUXSTDObservation typeexternal (NB not PixCel keyword of the same name)set up
OBJECTstring
Object NamePixCel
FILEPATHstring
Disk to save dataPixCel
OFF_RAreal
RA offset from base positionexternalTelescope offsetRA
OFF_DECreal
Dec offset from base positionexternalTelescope offsetDec
DATE_OBSstring1999-0403T05:32:49Sequence started, this time is same for all images in a loop: This is Y2K format YYYYMMDDTHH:MM:SSPixCel
EXP_TIMEint25Requested integration in secondsPixCel
INT_TIMEfloat25.077Actual integration time in secondsPixCel
NLOOPS int1 Total number of loopsPixCel
TOTALNDR int1 - Total number of reads of each chipPixCel
NREADS int1 - Total number of NDR reads in each loopPixCel
PRE_READboolT / FTrue if dummy first read was madePixCel
FLUSHES int32Number of flushes before sequence startedPixCel
LOC_TIMstring
Local TimeexternalTelescope localTime
MJDstringbrModified Julian DateexternalTelescope MJD
UTCstringbrUniversal Coordinated TimeexternalTelescope UTC
UTC_DATEstring
UTC dateexternalTelescope utcdate
OBS_Lstring
last name of observerexternalset up
OBS_Fstring
first name of observerexternalset up
May want to add in nodding and/or chopping information here
Software information
PIXVERstring
PixCel versionexternalset up
Read information
LOOP int2Current loopPixCel
READ in RRR mode int1 -Current number out of abovePixCel
CURR_NDRint1 -Current number of read out of total_ndrPixCel
TIME_OBSreal51094ms since sequence startedPixCel
SAMPTIMEreal51094effective integration time of this readexternalzerosub
FRAMEint1-Current frame in sequencePixCel
SUBTRACTboolT / F True if reset level has been subtractedPixCel
ROTATE boolTTrue if image is rotatedPixCel
ROTANGLEint0,90,180,270 Rotation anglePixCel
FLIP_H boolT / FTrue if image is mirrored E-W PixCel
FLIP_V boolT / FTrue if image is mirrored N-SPixCel
CHIP int1-4Chip numberPixCel
QUAD string1,2,3,4Active quads in this imagePixCel
FPA string
Array Serial NumberPixCel
Telescope Information
TEL_RAreal
right ascension of the telescope (deg) J2000externaltelescope telRA
TEL_DECreal
declination of the telescope (deg) J2000externaltelescope telDec
TEL_FOCreal
telescope focusexternaltelescope focus
USERFOCreal
offset from nominal focusexternaltelescope userFocus
ROT_PAreal
instrument rotator position angle (deg)externaltelescope rotator
AIRMASSreal
object airmassexternaltelescope Airmass
HUMIDITYreal
humidityexternaltelescope Humidity
TEL_HLTHstringGOOD / WARNING / BADTelescope healthexternalTelescope Health
Proposal Information
PROPOSIDstring
Proposal identifierexternalset up
PR_INV_Lstring
last name of principal investigatorexternalset up
PR_INV_Fstring
first name of principal investigatorexternalset up
PR_INV_Mstring
middle initial of principal investigatorexternalset up
Instrument configuration
CAMERAstringcirsi Name of camera - just any old stringPixCel
LENS_SCLreal0.05 / 0.12 / 0.25 / 0.36lens scale (arcsec)externalinst. status
RA_OFFreal
RA offset of IFU reference lensexternalset up
DEC_OFFreal
Dec offset of IFU reference lensexternalset up
TEMP_DETreal
detector tempexternalinst. status
TEMP_FRIreal
temperature at some position(s) in the fridgeexternalinst. status
FILTER1string
filter wheel 1 element in beam during observationexternalinst. status
FILTER2string
filter wheel 2 element in beam during observationexternalinst. status
GRATINGstringR3000,R10000Grating usedexternalinst. status
MASKstringSUPP / BLANKMask usedexternalinst. status
DET_FOCreal
detector focusexternalinst. status
DET_TILTreal
detector tiltexternalinst. status
MASK_FOCreal
mask focusexternalinst. status
TILTMIRXreal
tilt mirror xexternalinst. status
TILTMIRYreal
tilt mirror yexternalinst. status
GRAT_Xreal
grating xexternalinst. status
GRAT_Yreal
grating yexternalinst. status
IFU_Zreal
IFU position on optical axisexternalinst. status
MAG_Xreal
magnifier xexternalinst. status
MAG_Yreal
magnifier yexternalinst. status
Detector configuration
DETECTORstringhawaii/picnic Name of detector - generally hawaii or picnic string PixCel
READRATEint432Pixel rate (KHz)PixCel
READMODEstringRRR / NDR Readout mode, either read-reset-read or non-destructive readPixCel
SAMVER float4.49SAM version numberPixCel
PIXVER float5.0Pixcel version number and build datePixCel
PIX_OSstringWIN98PixCel operating systemexternalsetup
SAMTYPE int5SAM typePixCel
GAINfloat3.083 Camera gain in e/dnPixCel
READNOISfloat22.0Read noise (e)externalsetup
CHIPGAINfloat0.340Relative chip gainPixCel
HWGAINfloat12Hardware gain settingPixCel
PIXRATEfloat17Hardware Rate settingPixCel
BLKLEVELfloat500Blacklevel settingPixCel
Calibration Reference Files
DBFILEstring
database to write/read parameters to/fromexternalset up
MASKFILEstring
static data quality fileexternalset up
NOISFILEstring
detector read noise fileexternalset up
LINFILEstring
detector nonlinearities fileexternalset up
BKGFILEstring
background fileexternalset up
EXTRFILEstring
image to use to find extraction parametersexternalset up
WVFILEstring
wavelength calibration fileexternalset up
FLATFILEstring
flat field fileexternalset up
CALFILEstring
flux calibration fileexternalset up
Calibration Reference File Pedigree
DQPDGRstring
static data quality file pedigreeexternalset up
NOISPDGRstring
detector read noise file pedigreeexternalset up
NLINPDGRstring
detector nonlinearities file pedigreeset up
FLATPDGRstring
flat field file pedigreeexternalset up
Calibration Switches: perform,omit
ZOFFCORRstringperform / omitsubtract MULTI-ACCUM zero readexternalset up
MASKCORR stringperform / omitdata quality initializationexternalset up
NOISCALC stringperform / omitcalculate statistic errorsexternalset up
TIMECALCstringperform / omitpopulate time extensionsexternalset up
LINCORR stringperform / omitcorrect for detector nonlinearitiesexternalset up
UNITCORR stringperform / omitconvert to count ratesexternalset up
CRIDCALC stringperform / omitidentify cosmic ray hitsexternalset up
BKGCORRstringperform / omitsubtract background observationexternalset up
DOWVCAL stringperform / omitdo wavelength calibrationexternalset up
DOWVALGNstringperform / omitremove distortions in spatial direction (ie make mask lines look straight). easy to do this using mask features, but need to consider no mask ?externalset up
FLATCORR stringperform / omitflat field correctionexternalset up
DOFLCAL stringperform / omitdo flux calibrationexternalset up
DOEXTR stringperform / omitdo spectral extractionexternalset up
Calibration Indicators
ZOFFDONE stringperformed / skipped / omittedsubtract zeroth readexternalDR pipelineDR pipeline
MASKDONE stringperformed / skipped / omitteddata quality initializationexternalDR pipelineDR pipeline
NOISDONE stringperformed / skipped / omittedcalculate statistic errorsexternalDR pipelineDR pipeline
TIMEDONEstringperformed / skipped / omittedpopulated time extensionsexternalDR pipelineDR pipeline
LINDONE stringperformed / skipped / omittedcorrect for detector nonlinearitiesexternalDR pipelineDR pipeline
UNITDONE stringperformed / skipped / omittedconvert to count ratesexternalDR pipelineDR pipeline
CRIDDONE stringperformed / skipped / omittedidentify cosmic ray hitsexternalDR pipelineDR pipeline
BKGDONEstringperformed / skipped / omittedsubtracted background observationexternalDR pipelineDR pipeline
EXTRDONEstringperformed / skipped / omittedspectra extractedexternalDR pipelineDR pipeline
WVCLDONE stringperformed / skipped / omittedwavelength calibrationexternalDR pipelineDR pipeline
WVALDONE stringperformed / skipped / omittedwavelength alignmentexternalDR pipelineDR pipeline
FLATDONE stringperformed / skipped / omittedflat field correctionexternalDR pipelineDR pipeline
FLUXDONE stringperformed / skipped / omittedflux calibrationexternalDR pipelineDR pipeline
CALSTAGE stringnone / some / QuickLook / Finalstate of calibrationexternalDR pipelineDR pipeline
CAL_VERstring
Calibration code versionexternalset up


Rachel Johnson <raj@ast.cam.ac.uk>
Last modified: Thu Apr 17 11:45:22 2003