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 | |
SIMPLE | bool | T | This is a FITS file | PixCel | |||
BITPIX | int | 16 | 16bit signed data | PixCel | |||
NAXIS | int | 2 | 2d images supported | PixCel | |||
NAXIS1 | int | 1024 | Number of pixels in row | PixCel | |||
NAXIS2 | int | 1024 | Number of pixels in col | PixCel | |||
EXTEND | bool | T | File may contain standard extensions | written by stack | |||
NEXTEND | int | 0 | Number of standard extensions | written by stack | |||
IRAF-TLM | string? | ?? | Time of last modification | written by IRAF | IRAF tasks? | ||
IRAFNAME | string | .fits | Filename | written by IRAF | |||
Target information | |||||||
TARGNAME | string | Name of target object | external | Telescope targetName | |||
TARG_RA | real | dd.dddddddddd | right ascension of the target (deg) J2000 | external | Telescope targetRA | ||
TARG_DEC | real | dd.dddddddddd | declination of the target (deg) J2000 | external | Telescope targetDec | ||
Observation information | |||||||
NRUN | int | 735 | Run Number | PixCel | |||
OBSTYPE | string | DARK / ARC / DOMFLAT / SKYFLAT / OBJECT / SUPLAMP / FLUXSTD | Observation type | external (NB not PixCel keyword of the same name) | set up | ||
OBJECT | string | Object Name | PixCel | ||||
FILEPATH | string | Disk to save data | PixCel | ||||
OFF_RA | real | RA offset from base position | external | Telescope offsetRA | |||
OFF_DEC | real | Dec offset from base position | external | Telescope offsetDec | |||
DATE_OBS | string | 1999-0403T05:32:49 | Sequence started, this time is same for all images in a loop: This is Y2K format YYYYMMDDTHH:MM:SS | PixCel | |||
EXP_TIME | int | 25 | Requested integration in seconds | PixCel | |||
INT_TIME | float | 25.077 | Actual integration time in seconds | PixCel | |||
NLOOPS | int | 1 | Total number of loops | PixCel | |||
TOTALNDR | int | 1 - | Total number of reads of each chip | PixCel | |||
NREADS | int | 1 - | Total number of NDR reads in each loop | PixCel | |||
PRE_READ | bool | T / F | True if dummy first read was made | PixCel | |||
FLUSHES | int | 32 | Number of flushes before sequence started | PixCel | |||
LOC_TIM | string | Local Time | external | Telescope localTime | |||
MJD | string | br | Modified Julian Date | external | Telescope MJD | ||
UTC | string | br | Universal Coordinated Time | external | Telescope UTC | ||
UTC_DATE | string | UTC date | external | Telescope utcdate | |||
OBS_L | string | last name of observer | external | set up | |||
OBS_F | string | first name of observer | external | set up | |||
May want to add in nodding and/or chopping information here | Software information | ||||||
PIXVER | string | PixCel version | external | set up | |||
Read information | |||||||
LOOP | int | 2 | Current loop | PixCel | |||
READ in RRR mode | int | 1 - | Current number out of above | PixCel | |||
CURR_NDR | int | 1 - | Current number of read out of total_ndr | PixCel | |||
TIME_OBS | real | 51094 | ms since sequence started | PixCel | |||
SAMPTIME | real | 51094 | effective integration time of this read | external | zerosub | ||
FRAME | int | 1- | Current frame in sequence | PixCel | |||
SUBTRACT | bool | T / F | True if reset level has been subtracted | PixCel | |||
ROTATE | bool | T | True if image is rotated | PixCel | |||
ROTANGLE | int | 0,90,180,270 | Rotation angle | PixCel | |||
FLIP_H | bool | T / F | True if image is mirrored E-W | PixCel | |||
FLIP_V | bool | T / F | True if image is mirrored N-S | PixCel | |||
CHIP | int | 1-4 | Chip number | PixCel | QUAD | string | 1,2,3,4 | Active quads in this image | PixCel |
FPA | string | Array Serial Number | PixCel | ||||
Telescope Information | |||||||
TEL_RA | real | right ascension of the telescope (deg) J2000 | external | telescope telRA | |||
TEL_DEC | real | declination of the telescope (deg) J2000 | external | telescope telDec | |||
TEL_FOC | real | telescope focus | external | telescope focus | |||
USERFOC | real | offset from nominal focus | external | telescope userFocus | |||
ROT_PA | real | instrument rotator position angle (deg) | external | telescope rotator | |||
AIRMASS | real | object airmass | external | telescope Airmass | |||
HUMIDITY | real | humidity | external | telescope Humidity | |||
TEL_HLTH | string | GOOD / WARNING / BAD | Telescope health | external | Telescope Health | ||
Proposal Information | |||||||
PROPOSID | string | Proposal identifier | external | set up | |||
PR_INV_L | string | last name of principal investigator | external | set up | |||
PR_INV_F | string | first name of principal investigator | external | set up | |||
PR_INV_M | string | middle initial of principal investigator | external | set up | |||
Instrument configuration | |||||||
CAMERA | string | cirsi | Name of camera - just any old string | PixCel | |||
LENS_SCL | real | 0.05 / 0.12 / 0.25 / 0.36 | lens scale (arcsec) | external | inst. status | ||
RA_OFF | real | RA offset of IFU reference lens | external | set up | |||
DEC_OFF | real | Dec offset of IFU reference lens | external | set up | |||
TEMP_DET | real | detector temp | external | inst. status | |||
TEMP_FRI | real | temperature at some position(s) in the fridge | external | inst. status | |||
FILTER1 | string | filter wheel 1 element in beam during observation | external | inst. status | |||
FILTER2 | string | filter wheel 2 element in beam during observation | external | inst. status | |||
GRATING | string | R3000,R10000 | Grating used | external | inst. status | ||
MASK | string | SUPP / BLANK | Mask used | external | inst. status | ||
DET_FOC | real | detector focus | external | inst. status | |||
DET_TILT | real | detector tilt | external | inst. status | |||
MASK_FOC | real | mask focus | external | inst. status | |||
TILTMIRX | real | tilt mirror x | external | inst. status | |||
TILTMIRY | real | tilt mirror y | external | inst. status | |||
GRAT_X | real | grating x | external | inst. status | |||
GRAT_Y | real | grating y | external | inst. status | |||
IFU_Z | real | IFU position on optical axis | external | inst. status | |||
MAG_X | real | magnifier x | external | inst. status | |||
MAG_Y | real | magnifier y | external | inst. status | Detector configuration | ||
DETECTOR | string | hawaii/picnic | Name of detector - generally hawaii or picnic string | PixCel | |||
READRATE | int | 432 | Pixel rate (KHz) | PixCel | |||
READMODE | string | RRR / NDR | Readout mode, either read-reset-read or non-destructive read | PixCel | |||
SAMVER | float | 4.49 | SAM version number | PixCel | |||
PIXVER | float | 5.0 | Pixcel version number and build date | PixCel | PIX_OS | string | WIN98 | PixCel operating system | external | setup |
SAMTYPE | int | 5 | SAM type | PixCel | |||
GAIN | float | 3.083 | Camera gain in e/dn | PixCel | |||
READNOIS | float | 22.0 | Read noise (e) | external | setup | ||
CHIPGAIN | float | 0.340 | Relative chip gain | PixCel | |||
HWGAIN | float | 12 | Hardware gain setting | PixCel | |||
PIXRATE | float | 17 | Hardware Rate setting | PixCel | |||
BLKLEVEL | float | 500 | Blacklevel setting | PixCel | |||
Calibration Reference Files | |||||||
DBFILE | string | database to write/read parameters to/from | external | set up | |||
MASKFILE | string | static data quality file | external | set up | |||
NOISFILE | string | detector read noise file | external | set up | |||
LINFILE | string | detector nonlinearities file | external | set up | |||
BKGFILE | string | background file | external | set up | |||
EXTRFILE | string | image to use to find extraction parameters | external | set up | |||
WVFILE | string | wavelength calibration file | external | set up | |||
FLATFILE | string | flat field file | external | set up | |||
CALFILE | string | flux calibration file | external | set up | |||
Calibration Reference File Pedigree | |||||||
DQPDGR | string | static data quality file pedigree | external | set up | |||
NOISPDGR | string | detector read noise file pedigree | external | set up | |||
NLINPDGR | string | detector nonlinearities file pedigree | set up | ||||
FLATPDGR | string | flat field file pedigree | external | set up | |||
Calibration Switches: perform,omit | |||||||
ZOFFCORR | string | perform / omit | subtract MULTI-ACCUM zero read | external | set up | ||
MASKCORR | string | perform / omit | data quality initialization | external | set up | ||
NOISCALC | string | perform / omit | calculate statistic errors | external | set up | ||
TIMECALC | string | perform / omit | populate time extensions | external | set up | ||
LINCORR | string | perform / omit | correct for detector nonlinearities | external | set up | ||
UNITCORR | string | perform / omit | convert to count rates | external | set up | ||
CRIDCALC | string | perform / omit | identify cosmic ray hits | external | set up | ||
BKGCORR | string | perform / omit | subtract background observation | external | set up | ||
DOWVCAL | string | perform / omit | do wavelength calibration | external | set up | ||
DOWVALGN | string | perform / omit | remove distortions in spatial direction (ie make mask lines look straight). easy to do this using mask features, but need to consider no mask ? | external | set up | ||
FLATCORR | string | perform / omit | flat field correction | external | set up | ||
DOFLCAL | string | perform / omit | do flux calibration | external | set up | ||
DOEXTR | string | perform / omit | do spectral extraction | external | set up | ||
Calibration Indicators | |||||||
ZOFFDONE | string | performed / skipped / omitted | subtract zeroth read | external | DR pipeline | DR pipeline | |
MASKDONE | string | performed / skipped / omitted | data quality initialization | external | DR pipeline | DR pipeline | |
NOISDONE | string | performed / skipped / omitted | calculate statistic errors | external | DR pipeline | DR pipeline | |
TIMEDONE | string | performed / skipped / omitted | populated time extensions | external | DR pipeline | DR pipeline | |
LINDONE | string | performed / skipped / omitted | correct for detector nonlinearities | external | DR pipeline | DR pipeline | |
UNITDONE | string | performed / skipped / omitted | convert to count rates | external | DR pipeline | DR pipeline | |
CRIDDONE | string | performed / skipped / omitted | identify cosmic ray hits | external | DR pipeline | DR pipeline | |
BKGDONE | string | performed / skipped / omitted | subtracted background observation | external | DR pipeline | DR pipeline | |
EXTRDONE | string | performed / skipped / omitted | spectra extracted | external | DR pipeline | DR pipeline | |
WVCLDONE | string | performed / skipped / omitted | wavelength calibration | external | DR pipeline | DR pipeline | |
WVALDONE | string | performed / skipped / omitted | wavelength alignment | external | DR pipeline | DR pipeline | |
FLATDONE | string | performed / skipped / omitted | flat field correction | external | DR pipeline | DR pipeline | |
FLUXDONE | string | performed / skipped / omitted | flux calibration | external | DR pipeline | DR pipeline | |
CALSTAGE | string | none / some / QuickLook / Final | state of calibration | external | DR pipeline | DR pipeline | |
CAL_VER | string | Calibration code version | external | set up |