# $Header: https://oberon.oapd.inaf.it/shins/trunk/shins/src/data_mgr/keywords.list 2590 2020-03-30 09:43:48Z depa $
KEYWORD; VALUE/FORMAT;  NOTE
SIMPLE  ; T;
BITPIX  ;              ; number of bits per data pixel
NAXIS    ; {:1d}; From 2 to 3, number of data axis. Three if the file contains a spectrum.
NAXIS1  ;              ; length of axis 1
NAXIS2  ;             ; length of axis 2
NAXIS3  ;             ; Only for FITS cubes
ENTEND   ; T; Extensions are allowed
NEXTEND  ; 0; No extensions are required
#
# Table 2: Basic keywords for LBT headers
#
BZERO    ; {:+f};real = fits-value*BSCALE+BZERO
BSCALE   ; {:+f};real = fits-value*BSCALE+BZERO
BUNIT    ; {:s};Physical Unit of array values, should be ADU
BLANK    ; {:+f};Value used for NULL pixels
#    
ORIGIN    ; MGIO-LBT; Observatory
LATITUDE  ; +32.701309; North latitude of LBT (deg +=North)
LONGITUD  ; -109.889064; Longitude of LBT (deg +=East)
ELEVATIO  ; 3221; Elevation of LBT above sea level (m)
TELESCOP  ; LBT-SX; Telescope used
MASTER    ; <logical>;Is telescope acting as master
INSTRUME  ; SHARK-NIR;Instrument used
OBJECT    ; {:s};Observation title given by observer
OBJNAME    ; {:s};Standard (IAU) object name
IMAGETYP  ;                ;See Table 17 in RD6
EXPTIME    ; {:+f};total integration time (seconds)
DIT        ; {:+f};
NDIT      ; {:+f};
#    
ORIGFILE ; <instrume>.<yyyymmdd>.<nnnnn>.[science | calib | monit].fits; original file name at the telescope (nnnnn is a 5 digit running number)
CREATOR   ; {:s};Software task that created this file
GRPNUM    ; {:d};Used to group related datafiles
PARTNER   ; {:s};Name of institute observing
DATE     ; YYYY-MM-DDThh:mm:ss.sss  ;UTC date and time the file was written
DATE-OBS ; YYYY-MM-DDThh:mm:ss.sss  ;UTC date and time of observation start
UTC-OBS   ; hh:mm:ss.sss  ;UTC of observation start
LST-OBS   ; hh:mm:ss.sss  ; Local sidereal time at start of observation
MJD-OBS   ; nnnnn.nnnnn    ;Modified Julian Date at the start of the observation. 5 decimals for 1 second accuracy
OBSERVER ; {:s}  ;Name of the observer
PI-COI   ; {:s}  ;Name of PI
PROPID   ; {:s}  ;Proposal identification
#    
RADECSYS  ;FK5          ;Reference system for the equatorial reference system
EQUINOX   ;2000         ;Standard FK5 epoch for RA and DEC
RA        ;hh:mm:ss.ss  ;Right ascension (same as TELRA)
DEC       ;dd:mm:ss.s   ;Declination (same as DECRA)
AIRMASS   ;{:+f}      ;Airmass at start of observation MJD-OBS
DATASUM   ;{:s}     ;Checksum of data section only
CHECKSUM  ;{:s}     ;ASCII 1s complement checksum
CHECKVER  ;COMPLEMENT   ;Checksum algorithm
COMMENT   ;;  Observer’s comments
LBT_LOG   ;;  Operations log entry 
#
# Table 3: Telescope and pointing keywords
# KEYWORD  VALUE/FORMAT  NOTE
PMODEL    ;{:s} ; pointing model in use
OBJRADEC  ;{:s} ; RADEC system for OBJRA, OBJDEC
OBJEQUIN  ;{:s} ; EQUINOX for OBJRA, OBJDEC
OBJRA     ;hh:mm:ss ; RA requested (from OB or catalog)
OBJDEC    ;dd:mm:ss ; DEC requested (from OB or catalog)
OBJPMRA   ;{:s} ; RA proper motion [mas]
OBJPMDEC  ;{:s} ; DEC proper motion [mas]
#    
TELRA     ;hh:mm:ss.ss  ;RA at detector center at MJD-OBS
TELDEC    ;dd:mm:ss.s   ;DEC at detector center at MJD-OBS
TELALT    ; {:+5.2f}    ; dd.dd LBT mount altitude at detector center at MJD-OBS
TELAZ     ; {:+6.2f}    ; ddd.dd LBT mount azimuth at detector center at MJD-OBS
TRAKSTAT  ;<logical>    ;Tracking status
TELTKRA   ;{:+3.1f}     ;Tracking rate from sidereal in RA [arcsec]
TELTKDEC  ;{:+3.1f}     ;Tracking rate in DEC [arcsec]
#    
HA        ;+hh:mm:ss  ;hour angle at start of observation MJD-OBS
ZD        ;{:+5.2f}      ;zenith distance of LBT mount at MJD-OBS [deg]. Complement of TELALT
MOONANGL  ;{:+7.3f}    ;Moon angle at start [deg]
SUNANGLE  ;{:+7.3f}    ;Sun angle at start [deg]
#    
PARANGLE  ;{:+5.1f}  ;Parallactic angle at start [deg]
POSANGLE  ;{:+5.1f}  ;Telescope position angle [deg]
ROTANGLE  ;{:+4.1f}  ;Telescope rotator angle [deg]
ROTASTAT  ;OFF  ;Rotator status. LBT rotator is always OFF when using SHARK-NIR
#
#
# Table 4: M1 specific keywords
# KEYWORD  VALUE/FORMAT  NOTE
M1-X   ;{:+f}  ;X position of primary mirror [mm]
M1-Y   ;{:+f}  ;Y position of primary mirror [mm]
M1-Z   ;{:+f}  ;Focus of primary mirror [mm]
M1-RX  ;{:+f}  ;Tilt of primary across X axis [arcsecs]
M1-RY  ;{:+f}  ;Tilt of primary across X axis [arcsecs]
M1-RZ  ;{:+f}  ;Rotation of primary about Z axis [arcsecs]
#
# Table 5: M2 specific keywords
# KEYWORD  VALUE/FORMAT  NOTE
M2-X   ;{:+f}  ;X position of secondary mirror [mm]
M2-Y   ;{:+f}  ;Y position of secondary mirror [mm]
M2-Z   ;{:+f}  ;Focus of secondary mirror [mm]
M2-RX  ;{:+f}  ;Tilt of secondary across X axis [arcsecs]
M2-RY  ;{:+f}  ;Tilt of secondary across X axis [arcsecs]
M2-RZ  ;{:+f}  ;Rotation of secondary about Z axis [arcsecs]
#
# Table 6: Instrument specific keywords
# KEYWORD  VALUE/FORMAT  NOTE
TELCONF  ; {:s} ; Telescope configuration
FOCSCALE ; {:s} ; Scale at focal plane [arcsec]
INSMODE  ; {:s} ; Mode of use of instrument 
#    
INSTHWV   ;{:s} ; Instrument hardware version
INSTSWV   ;{:s} ; Instrument software version
INSFOCUS  ;{:s} ; Instrument focus [mm]
#    
HIERARCH LBT INS MECH1 ID  ;;   General mechanical device unique ID
HIERARCH LBT INS MECH1 NAME  ;INBEAM_DEP   
HIERARCH LBT INS MECH1 ST  ;T;   
HIERARCH LBT INS MECH1  POS  ;;   Position axis [µm]
HIERARCH LBT INS MECH1  ENC  ;;   Position axis [enc]
HIERARCH LBT INS MIRR1  NAME ; INBEAM_TT   ;
HIERARCH LBT INS MIRR1  POS1 ;;    Position of axis 1 [µm]
HIERARCH LBT INS MIRR1  POS2 ;;    Position of axis 2 [µm]
HIERARCH LBT INS MIRR1  ENC1 ;;    Position of axis 1 [enc]
HIERARCH LBT INS MIRR1  ENC2 ;;    Position of axis 2 [enc]
HIERARCH LBT INS SHUT1 NAME ;  Instrument shutter;  Shutter name
HIERARCH LBT INS SHUT1 ST  ;T;  Shutter open
HIERARCH LBT INS SHUT1 POS  ;;   Position of axis [µm]
HIERARCH LBT INS SHUT1 ENC  ;;   Position of axis [enc]
HIERARCH LBT INS MIRR2  NAME  ;PUPIL_TT   ;
HIERARCH LBT INS MIRR2  POS1 ;;    Position of axis 1 [µm]
HIERARCH LBT INS MIRR2  POS2 ;;    Position of axis 2 [µm]
HIERARCH LBT INS MIRR2  ENC1 ;;    Position of axis 1 [enc]
HIERARCH LBT INS MIRR2  ENC2 ;;    Position of axis 2 [enc]
HIERARCH LBT INS OPTI1  NAME ; APODIZER_W;  Name of optical element
HIERARCH LBT INS OPTI1  TYPE ;; MASK or FREE  all elements in OPTI1 are masks
HIERARCH LBT INS OPTI1  NO   ;;  Position of wheel used
HIERARCH LBT INS OPTI1  ID   ;;  ID of the element
HIERARCH LBT INS OPTI1  NAME ;;    Name of the element
HIERARCH LBT INS OPTI1  POS  ;;   Position of axis [deg]
HIERARCH LBT INS OPTI1  ENC  ;;   Position of axis [enc]
HIERARCH LBT INS ADC NAME ; ADC   ;
HIERARCH LBT INS ADC ST  ;T ; a status binary flag, as true when the (sub)system is on, false when off
HIERARCH LBT INS ADC1   POS  ;   ;Position of axis 1 [deg]
HIERARCH LBT INS ADC2   POS  ;   ;Position of axis 2 [deg]
HIERARCH LBT INS ADC1   ENC  ;   ;Position of axis 1 [enc]
HIERARCH LBT INS ADC2   ENC  ;   ;Position of axis 2 [enc]
HIERARCH LBT INS FILT1  NAME ; ND_FILTER_W ; Name of optical element
HIERARCH LBT INS FILT1  NO   ;  ;Position of wheel used
HIERARCH LBT INS FILT1  ID   ;  ;ID of the element
HIERARCH LBT INS FILT1  NAME ;  ;  Name of the element
HIERARCH LBT INS FILT1  POS  ;  ; Position of axis [deg]
HIERARCH LBT INS FILT1  ENC  ;  ; Position of axis [enc]
HIERARCH LBT INS OPTI2  NAME ; CORO_SLIT_W ; Name of optical element
HIERARCH LBT INS OPTI2  TYPE ; ;MASK or SLIT OR FREE   
HIERARCH LBT INS OPTI2  NO   ; ; Position of wheel used
HIERARCH LBT INS OPTI2  ID   ; ; ID of the element
HIERARCH LBT INS OPTI2  NAME ; ;   Name of the element
HIERARCH LBT INS OPTI2  POS  ; ;  Position of axis [deg]
HIERARCH LBT INS OPTI2  ENC  ; ;  Position of axis [enc]
HIERARCH LBT INS OPTI3  NAME ; LYOT_GRISM_W ; Name of optical element
HIERARCH LBT INS OPTI3  TYPE ; ;MASK, SLIT, WOLLASTON, FREE   
HIERARCH LBT INS OPTI3  NO   ; ; Position of wheel used
HIERARCH LBT INS OPTI3  ID   ; ; ID of the element
HIERARCH LBT INS OPTI3  NAME ; ;   Name of the element
HIERARCH LBT INS OPTI3  POS  ; ;  Position of axis [deg]
HIERARCH LBT INS OPTI3  ENC  ; ;  Position of axis [enc]
HIERARCH LBT INS FILT2  NAME ; SCI_FILT_W1;  Name of optical element
HIERARCH LBT INS FILT2  NO   ;  ;Position of wheel used
HIERARCH LBT INS FILT2  ID   ;  ;ID of the element
HIERARCH LBT INS FILT2  NAME ;  ;  Name of the element
HIERARCH LBT INS FILT2  POS  ;  ; Position of axis [deg]
HIERARCH LBT INS FILT2  ENC  ;  ; Position of axis [enc]
HIERARCH LBT INS FILT3  NAME ; SCI_FILT_W2;  Name of optical element
HIERARCH LBT INS FILT3  NO   ;  ;Position of wheel used
HIERARCH LBT INS FILT3  ID   ;  ;ID of the element
HIERARCH LBT INS FILT3  NAME ;  ;  Name of the element
HIERARCH LBT INS FILT3  POS  ;  ; Position of axis [deg]
HIERARCH LBT INS FILT3  ENC  ;  ; Position of axis [enc]
HIERARCH LBT INS MECH2  ID   ;  ; General mechanical device unique ID
HIERARCH LBT INS MECH2  NAME ;   PUPIL_LENS_DEP  ;
HIERARCH LBT INS MECH2  ST   ;   ;
HIERARCH LBT INS MECH2  POS  ;   ;Position axis [µm]
HIERARCH LBT INS MECH2  ENC  ;   ;Position axis [enc]
HIERARCH LBT INS FILT3  NAME ;   DB_FILT_W;  Name of optical element
HIERARCH LBT INS FILT3  NO   ;   ;Position of wheel used
HIERARCH LBT INS FILT3  ID   ;   ;ID of the element
HIERARCH LBT INS FILT3  NAME ;   ;Name of the element
HIERARCH LBT INS FILT3  POS  ;   ;Position of axis [deg]
HIERARCH LBT INS FILT3  ENC  ;   ;Position of axis [enc]
HIERARCH LBT INS DROT   ID   ;   ;General mechanical device unique ID
HIERARCH LBT INS DROT   NAME ;   DROT;
HIERARCH LBT INS DROT   MODE ;   ON  ;Instrument derotator mode
HIERARCH LBT INS DROT   POS  ;   ;Position axis [deg]
HIERARCH LBT INS DROT   ENC  ;   ;Position axis [enc]
HIERARCH LBT INS DROT   BEGIN;   ;Physical position at start [deg]
HIERARCH LBT INS MIRR3  NAME ;   CAL_DEP;  Name of optical element
HIERARCH LBT INS MIRR3  ST   ;   ;Status of deployable mirror
HIERARCH LBT INS MIRR3  POS  ;   ;Position of axis [µm]
HIERARCH LBT INS MIRR3  ENC  ;   ;Position of axis [enc]
HIERARCH LBT INS OPTI5  NAME ;   FIBER_DEP;  Name of optical element
HIERARCH LBT INS OPTI5  TYPE ;   FIBER;  Name of optical element
HIERARCH LBT INS OPTI5  ID   ;   ;Lamp ID
HIERARCH LBT INS OPTI5  POS  ;   ;Position axis [µm]
HIERARCH LBT INS OPTI5  END  ;   ;Position axis [enc]
HIERARCH LBT INS SENS1  ID   ;   ;   Sensor ID for OPTI5
HIERARCH LBT INS SENS1  NAME ;   FF_LAMP;  Sensor common name for flat field lamp
HIERARCH LBT INS SENS1  VAL  ;   ;   T for ON, F for OFF
HIERARCH LBT INS SENS2  ID   ;   ;   Sensor ID for OPTI6
HIERARCH LBT INS SENS2  NAME ;   FIBER_LAMP;  Sensor common name for fiber lamp
HIERARCH LBT INS SENS2  VAL  ;   ;   T for ON, F for OFF
HIERARCH LBT INS TEMP1  VAL BEGIN ;; Cryo-vacuum T [K] at observation start
HIERARCH LBT INS TEMP1  VAL END   ;; Cryo-vacuum T [K] at end of observation
#
#
# Table 7: Detector specific keywords
# KEYWORD  VALUE/FORMAT  NOTE
DETECTOR  ;{:s}  ;Detector designation
DETNAME   ;{:s}  ;Same as DETECTOR 
DETSIZE   ;[1:2048,1:2048];  Unbinned size of detector full array
NCCDS     ;1      ;Number of CCDs in the detector 
NAMPS     ;{:s}   ;Number of amplifiers in the detector
PIXSCAL1  ;{:s}   ;Projected unbinned pixel scale along axis 1
PIXSCAL2  ;{:s}   ;Projected unbinned pixel scale along axis 2
PIXSIZE1  ;18     ;Unbinned det pix size [microns] along Axis 1
PIXSIZE2  ;18     ;Unbinned det pix size [microns] along Axis 2
DETHWV    ;{:s} ; Detector hardware version
DETSWV    ;{:s} ; Detector software version
DETSTAT   ;{:s} ; Detector status 
DEWAR     ;{:s} ; Dewar identification
DEWHWV    ;{:s} ; Dewar hardware version
DEWSWV    ;{:s} ; Dewar software version
DEWSTAT   ;{:s} ; Dewar status
DEWTEM1   ;{:s} ; Dewar temperature
CCDTEM    ;{:s} ; Detector temperature
UDEWTEM   ;{:s} ; Units for Dewar temperatures
UCCDTEM   ;{:s} ; Units for CCD temperature
#    
CCDNAME  ;{:s} ; Name of individual CCD (serial #)
CCDID    ;{:s} ; Detector serial number (=ccdname)
AMPNAME  ;{:s} ; Amplifier name
CCDHW    ;{:s} ; Same as DETHWV if NCCDS = 1
CCDSW    ;{:s} ; Same as DETSWV if NCCDS = 1
CCDGAIN  ;{:s} ; CCD gain state
#    
GAIN      ;{:s} ; Detector gain in e-/ADU
RDNOISE   ;{:s} ; Detector readout noise in e-
SATURATE  ;{:s} ; Saturation value in ADU
BPM       ;{:s} ; Name of bad pixel mask
#    
CCDSIZE  ;[x1:x2,y1:y2] ; Same as DETSIZE
CCDPSIZE ;[x1:x2,y1:y2] ; Same as CCDSIZE except for drift scanning CCDSUM    CCD on-chip summing (binning)
AMPSIZE  ;[x1:x2,y1:y2] ; Unbinned amplifier readout size
DATASEC  ;[x1:x2,y1:y2] ; Image data section
CCDSEC   ;[x1:x2,y1:y2] ; Region of the CCD read
DETSEC   ;[x1:x2,y1:y2] ; Detector section
BIASSEC  ;[x1:x2,y1:y2] ; Bias section
TRIMSEC  ;[x1:x2,y1:y2] ; Section of useful data
AMPSEC   ;[x1:x2,y1:y2] ;  Mapping of CCD section to amplifier coordinates
CCDNAMPS  ;{:s} ; Number of amplifiers to readout the CCD
PREFLASH  ;{:s} ; CCD preflash time [ms]
ITIME     ;{:s} ; Exposure time[s] per coadd
NCOADDS   ;{:s} ; Number of coadds (result is sum)
ACOAVGS   ;{:s} ; Number of co-avgs (if individual exps are averaged and not summed –sum& NCOADDS preferred)
DETTIME   ;{:s} ; Total exposure time in seconds: NCOADDS x ITIME
READMODES ; {:s};  Readout mode
NREADS    ;{:s} ; # reads at beg, end or during ITIME
#
# Table 8: WCS keywords 
# KEYWORD  VALUE/FORMAT  NOTE
WCSDIM  ;2 ; Dimensionality of WCS
CTYPE1  ;{:s} ; Pixel coordinate system
CTYPE2  ;{:s} ; Pixel coordinate system
CUNIT1  ;{:s} ; Unit of coordinate transformation
CUNIT2  ;{:s} ; Unit of coordinate transformation
CRPIX1  ;{:+f} ; Value of X Ref. pixel
CRPIX2  ;{:+f} ; Value of Y Ref. pixel
CRVAL1  ;{:+f} ; RA at CRPIX1 in units CUNIT1
CRVAL2  ;{:+f} ; DEC at CRPIX2 in units CUNIT2
CDELT1  ;{:+f} ; Increment along axis 1 as [CUNIT1]/pxl
CDELT2  ; {:+f};  Increment along axis 2 as [CUNIT2]/pxl
CD1_1   ;{:+f} ; Scale in [CUNIT1]/pixel
CD1_2   ;{:+f} ; Rotation and skew
CD2_1   ;{:+f} ; Rotation and skew
CD2_2   ;{:+f} ; Scale in [CUNIT2]/pixel
WAT0_001  ;;   Coordinate system
WAT1_001  ;;   Coordinate type
WAT2_001  ;;   Coordinate type
WCSSOL    ;; 
#
# Table 9: WCS keywords for spectra TBD
# KEYWORD  VALUE/FORMAT  NOTE
WCSDIM ; 3    ; Spec data inherently have 3 WCS axes
CTYPE1 ; WAVE ; Pixel coordinate system 
CTYPE2 ; {:s} ; 
CTYPE3 ; {:s} ; 
CUNIT1 ; {:s} ; Unit of coordinate transformation
CUNIT2 ; {:s} ; Unit of coordinate transformation
CUNIT3 ; {:s} ; Unit of coordinate transformation
CRVAL1 ; {:+f};  Wavelength at CRPIX1
CRVAL2 ; {:+f};  RA at CRPIX1 in units CUNIT1
CRVAL3 ; {:+f};  DEC at CRPIX2 in units CUNIT2
CD1_1  ;{:s} ; Increment for CTYPE1
CD2_2  ;{:s} ; Increment for CTYPE2
CD3_3  ;{:s} ; Increment for CTYPE3
DISPAXIS ;  {:d} ; Dispersion axis (1=rows, 2=columns)
DISPUNIT ;  {:s} ; Units for coordinate along DISPAXIS
DISPWC   ;{:s} ; Approximate central dispersion coordinate on detector [DISPAXIS]
DISPDW   ;{:s} ; Approximate central dispersion per pixel on the detector [DISPAXIS/pxl]
#
# Table 10: Enclosure, environment and weather specific keywords
# KEYWORD  VALUE/FORMAT  NOTE
DOMEPAN   ;{:+6.3f};  Dome position angle [degrees E of N]
DOMTEM    ;{:+6.3f};  Dome temperature [degrees C]
DOMHUM    ;{:+6.3f};  Dome relative humidity [%]
DOMDEWPT  ;{:+6.3f};   Dome dew point [degrees C]
#    
ENVTEM   ;{:+6.3f};  Outside temperature, C, at MJD-OBS
ENVPRE   ;{:+6.3f};  Atmospheric pressure [mbar]
ENVWIN   ;{:+6.3f};  Outside wind speed (m/s) at MJD-OBS
ENVDIR   ;{:+6.3f};  (degrees) Direction of wind: E from N
ENVHUM   ;{:+6.3f};  Outside relative humidity % at MJD-OBS
ENVDEWPT ;{:+6.3f};    Outside dew point (degrees C) at MJD-OBS
ENVTAU   ;{:+6.3f};  Opacity at 225 GHz, from SMT
WEATHER  ;;   Comment by telescope operator or observer
SEEING   ;;  Seeing estimate from S-H WFS
SEEWAV   ;;  Wavelength for seeing estimate
SEECAL   ;;  Seeing: S-H to seeing calibration curve
#    
END  ;;   <Mandatory FITS keyword
