.........
.........
The new kid on the block!! FITS files, which both NICMOS and STIS use exclusively. For more information on FITS files, check out FITS Support Office Home Page
There are three kinds of reference files: reference images (FITS and GEIS), and tables. These are Sun format binary files that can only be read inside the iraf/stsdas environment. Although these are Sun format files, there are tools in stsdas to convert reference files from Sun to Vax format.
Files are stored in directories according to the instrument they are associated with and file type. The first letter of the directory name is the instrument code. The remainder of the name is either REF for reference images or TAB for tables. For example, HRS calibration images are stored in ZREF and HRS calibration tables are stored in ZTAB. The extension of the file name indicates the type of reference file. See below.
Reference images are stored as two files. The header is stored as a file with an extension ending in the letter h. The data is stored as a file with an extension ending with the letterd. Otherwise, the filenames of the two parts of a reference image are identical. Both files must be retrieved if you want to use a reference image. Reference files are given unique names based on their creation date.
A file name will be unique over the telescope's
lifetime. The file name root has the format YMDHHMMSI where
Y denotes the year (where 1981 = 1)
M denotes the month of the year (where January = 1)
D denotes the day
HH denotes the hour (00-23)
MM denotes the minutes
S denotes seconds/2
I denotes the instrument ( where f=fgs, v=HSP, w=WFPC,
x=FOC, y=FOS, z=HRS, m=multiple)
The file name extension which is defined by file type is appended to the
unique root.
(see below a list of different types)
An example would be FAR1106TU.R3H:
WFPC2 (last character in the rootname is U=>wfpc2),
dark header file (R3H), named on October 27 1995 (FAR1106T).
Listed below is a table outlining directories all of the data types for each instrument, associated filename extensions, and database relation names.
WFPC2 Reference files
===============
Directory UREF:
===============
ASSOCIATED DATABASE
ROOT EXTENSION FILE_TYPE DATA QUALITY FILE RELATION
--------------------------------------------------------------------------
ROOTNAME.R0H (R0H)
ROOTNAME.R0D STATIC MASK
ROOTNAME.R1H (R1H)
ROOTNAME.R1D AtoD CONVERSION
ROOTNAME.R2H ROOTNAME.B2H (R2H)
ROOTNAME.R2D BIAS IMAGE + ROOTNAME.B2D
ROOTNAME.R3H ROOTNAME.B3H (R3H)
ROOTNAME.R3D DARK + ROOTNAME.B3D
ROOTNAME.R4H ROOTNAME.B4H (R4H)
ROOTNAME.R4D FLAT FIELD + ROOTNAME.B4D
ROOTNAME.R5H (R5H)
ROOTNAME.R5D SHUTTER
-------------------------------------------------------------------------
FOC reference files
===============
Directory XREF:
===============
ASSOCIATED DATABASE
ROOT EXTENSION FILE_TYPE DATA QUALITY FILE RELATION
--------------------------------------------------------------------------
ROOTNAME.R0H (R0H)
ROOTNAME.R0D BAC (BACKGROUND)
ROOTNAME.R1H (R1H)
ROOTNAME.R1D ITF (INTENSITY TRANSFER FUNCTION)
ROOTNAME.R2H (R2H)
ROOTNAME.R2D UNI (UNIFORM DE)
ROOTNAME.R3H (R3H)
ROOTNAME.R3D SDE (SPECTROGRAPHIC DE)
ROOTNAME.R5H (R5H)
ROOTNAME.R5D GEO (GEOMETRIC)
ROOTNAME.R7H (R7H)
ROOTNAME.R7D BLM (QUALITY)
---------------------------------------------------------------------------
FOC sdas tables
===============
Directory XTAB:
===============
ROOTNAME.CXU FOC DQE TABLE (UNITAB) (CXU)
---------------------------------------------------------------------------
FOS reference files
===============
Directory YREF:
===============
ASSOCIATED DATABASE
ROOT EXTENSION FILE_TYPE DATA QUALITY FILE RELATION
--------------------------------------------------------------------------
ROOTNAME.R0H (R0H)
ROOTNAME.R0D BAC (BACKGROUND)
ROOTNAME.R1H (R1H)
ROOTNAME.R1D FLT (FLAT FIELD)
ROOTNAME.R2H (R2H)
ROOTNAME.R2D IVS (INVERSE SENSITIVITY)
ROOTNAME.R3H (R3H)
ROOTNAME.R3D RET (WAVE RETARDATION)
ROOTNAME.R4H (R4H)
ROOTNAME.R4D DDT (DISABLED DIODE)
ROOTNAME.R5H (R5H)
ROOTNAME.R5D QIN (DQ INIT)
ROOTNAME.R6H (R6H)
ROOTNAME.R6D POINT SPREAD FUNCTION
ROOTNAME.R7H (R7H)
ROOTNAME.R7D LINE SPREAD FUNCTION
ROOTNAME.R8H (R8H)
ROOTNAME.R8D AVERAGE INVERSE SENSITIVITY
----------------------------------------------------------------------------
FOS sdas Tables
===============
Directory YTAB:
===============
ROOTNAME.CY0 FOS APERTURE PARAMETERS
ROOTNAME.CY1 FOS APERTURE POSITION PARAMETERS
ROOTNAME.CY2 FOS EMISSION LINES
ROOTNAME.CY3 FOS DETECTOR PARAMETERS
ROOTNAME.CY4 FOS POLARIMETRY REDUCTION PARAMETERS
ROOTNAME.CY5 FOS SKY SHIFT PARAMETERS
ROOTNAME.CY6 FOS WAVELENGTH PARAMETERS
ROOTNAME.CY7 FOS SCALE FACTORS FOR GIMP
ROOTNAME.CY8 FOS PREDICTED MEAN BACKGROUND COUNT RATES
AS A FUNCTION OF GEOMAGNETIC POSITION.
ROOTNAME.CY9 FOS SCATTERED LIGHT CORRECTION PARAMETERS
ROOTNAME.CYA OTA FOCUS HISTORY
ROOTNAME.CYB APERTURE THROUGHPUT COEFFICIENTS AT NOMINAL
FOCUS
ROOTNAME.CYC APERTURE THROUGHPUT COEFFICIENTS
VERSUS FOCUS
ROOTNAME.CYD CORRECTION FACTORS FOR CHANGES IN DETECTOR
SENSITIVITY
ROOTNAME.CMG PAIRED PULSE PARAMETERS
--------------------------------------------------------------------------
HRS reference files
===============
Directory ZREF:
===============
ASSOCIATED DATABASE
ROOT EXTENSION FILE_TYPE DATA QUALITY FILE RELATION
--------------------------------------------------------------------------
ROOTNAME.R0H (R0H)
ROOTNAME.R0D DIO (DIODE RESPONSE)
ROOTNAME.R1H (R1H)
ROOTNAME.R1D PHC (CATHODE RESPONSE)
ROOTNAME.R2H (R2H)
ROOTNAME.R2D VIG (VIGNETTING)
ROOTNAME.R3H (R3H)
ROOTNAME.R3D ABS (ABSOLUTE FLUX)
ROOTNAME.R4H (R4H)
ROOTNAME.R4D NET (WAVELENGTH NET)
ROOTNAME.R5H (R5H)
ROOTNAME.R5D QIN ( DQ INIT)
--------------------------------------------------------------------------
HRS sdas tables
===============
Directory ZTAB:
===============
ROOTNAME.CZ1 HRS LINE MAPPING PARAMETERS
ROOTNAME.CZ2 HRS SAMPLE MAPPING PARAMETERS
ROOTNAME.CZ3 HRS DETECTOR PARAMETERS
ROOTNAME.CZ4 HRS WAVELENGTH RANGES
ROOTNAME.CZ5 HRS SPECTRAL ORDER CONSTANTS
ROOTNAME.CZ6 HRS DISPERSION CONSTANTS
ROOTNAME.CZ7 HRS THERMAL CONSTANTS
ROOTNAME.CZ8 HRS INCIDENCE ANGLE CONSTANTS
ROOTNAME.CZ9 HRS ECHELLE RIPPLE INTERPOLATION CONSTAN
ROOTNAME.CZA HRS ECHELLE RIPPLE NON-INTERPOLATION CON
ROOTNAME.CZB HRS SCALE FACTORS FOR SCATTERED
LIGHT SUBTRACTION
ROOTNAME.CZC HRS GLOBAL WAVELENGTH COEFFICIENTS
ROOTNAME.CZD HRS PHOTOCATHODE BLEMISH LOCATION TABLE
ROOTNAME.CMG PAIRED PULSE PARAMETERS
ROOTNAME.CZY PT-NE LAMP LINE LIST, CORRECTED
TO VAC. WAVELENGTHS
ROOTNAME.CZZ COEFFIENTS TO A FIT OF OFFSETS BETWEEN
APERTURES (SSA) AND (SC1;SC2)
----------------------------------------------------------------------------
STIS reference files
===============
Directory OREF:
===============
ASSOCIATED DATABASE
ROOT EXTENSION FILE_TYPE DATA QUALITY FILE RELATION
--------------------------------------------------------------------------
ROOTNAME_BIA.FITS
ROOTNAME_DRK.FITS
ROOTNAME_MOC.FITS
ROOTNAME_PFL.FITS
ROOTNAME_DFL.FITS
ROOTNAME_LFL.FITS
ROOTNAME_SSC.FITS
------------------------------------------------------------------------------
STIS tables
===============
Directory OTAB:
===============
ROOTNAME_CCD.FITS
ROOTNAME_A2D.FITS
ROOTNAME_CRR.FITS
ROOTNAME_BPX.FITS
ROOTNAME_LIN.FITS
ROOTNAME_PHT.FITS
ROOTNAME_APT.FITS
ROOTNAME_APD.FITS
ROOTNAME_LMP.FITS
ROOTNAME_IDC.FITS
ROOTNAME_SDC.FITS
ROOTNAME_IAC.FITS
ROOTNAME_1DT.FITS
ROOTNAME_DSP.FITS
ROOTNAME_1DX.FITS
----------------------------------------------------------------------------
NICMOS reference files
===============
Directory NREF:
===============
ASSOCIATED DATABASE
ROOT EXTENSION FILE_TYPE DATA QUALITY FILE RELATION
--------------------------------------------------------------------------
ROOTNAME_DRK.FITS DARK
ROOTNAME_FLT.FITS FLAT
ROOTNAME_ILM.FITS ILLUMINATION
ROOTNAME_LIN.FITS LINEAR
ROOTNAME_MSK.FITS MASK
ROOTNAME_NOI.FITS NOISE
--------------------------------------------------------------------------
NICMOS tables
===============
Directory NTAB:
===============
ROOTNAME_PHT.FITS
----------------------------------------------------------------------------
Back to the CDBS Operations Page