File and Table Structures

.........

The new kid on the block!! FITS files, which both NICMOS and STIS use exclusively. FITS files have been around for a while in one form or another, but for data handled by CDBS, this is a new format. For more information on FITS files, check out FITS Support Office Home Page

When FITS files are processed in CDBS, they run through a verification process. For more information on this, look at fitsverify.

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/IRAF to convert reference files from Sun to Vax format or to read STSDAS tables.

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. 

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              QUALITY FILE         RELATION
--------------------------------------------------------------------------

ROOTNAME.R0H                                                      
ROOTNAME.R0D        STATIC MASK                            WFPC2 FILE and ROW

ROOTNAME.R1H                                                      
ROOTNAME.R1D        AtoD CONVERSION                             

ROOTNAME.R2H                               ROOTNAME.B2H           
ROOTNAME.R2D        BIAS IMAGE         +   ROOTNAME.B2D     

ROOTNAME.R3H                               ROOTNAME.B3H           
ROOTNAME.R3D        DARK               +   ROOTNAME.B3D     

ROOTNAME.R4H                               ROOTNAME.B4H           
ROOTNAME.R4D        FLAT FIELD         +   ROOTNAME.B4D     

ROOTNAME.R5H                                                      
ROOTNAME.R5D        SHUTTER           


-------------------------------------------------------------------------
FOC reference files
===============
Directory XREF:  
===============
                                                        DATABASE
ROOT     EXTENSION  FILE_TYPE                           RELATION
--------------------------------------------------------------------------


ROOTNAME.R0H                                                     
ROOTNAME.R0D        BAC (BACKGROUND)                  FOC FILE and ROW

ROOTNAME.R1H                                                     
ROOTNAME.R1D        ITF (INTENSITY TRANSFER FUNCTION)

ROOTNAME.R2H                                                     
ROOTNAME.R2D        UNI (UNIFORM DE)

ROOTNAME.R3H                                                     
ROOTNAME.R3D        SDE (SPECTROGRAPHIC DE)

ROOTNAME.R5H                                                     
ROOTNAME.R5D        GEO (GEOMETRIC)

ROOTNAME.R7H                                                     
ROOTNAME.R7D        BLM (QUALITY)
---------------------------------------------------------------------------

FOC sdas tables
===============
Directory XTAB: 
===============

ROOTNAME.CXU        FOC DQE TABLE (UNITAB)                     


---------------------------------------------------------------------------   

FOS reference files
===============
Directory YREF:
===============

                                                       DATABASE
ROOT     EXTENSION  FILE_TYPE                          RELATION
--------------------------------------------------------------------------
ROOTNAME.R0H                                     FOS FILE and FOS ROW 
ROOTNAME.R0D        BAC (BACKGROUND)

ROOTNAME.R1H                                                      
ROOTNAME.R1D        FLT (FLAT FIELD)

ROOTNAME.R2H                                                      
ROOTNAME.R2D        IVS (INVERSE SENSITIVITY)

ROOTNAME.R3H                                                      
ROOTNAME.R3D        RET (WAVE RETARDATION)

ROOTNAME.R4H                                                      
ROOTNAME.R4D        DDT (DISABLED DIODE)

ROOTNAME.R5H                                                      
ROOTNAME.R5D        QIN (DQ INIT)

ROOTNAME.R6H                                                      
ROOTNAME.R6D        POINT SPREAD FUNCTION

ROOTNAME.R7H                                                      
ROOTNAME.R7D        LINE SPREAD FUNCTION

ROOTNAME.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: 
===============

                                                        DATABASE
ROOT     EXTENSION  FILE_TYPE                           RELATION
--------------------------------------------------------------------------

ROOTNAME.R0H                                                    
ROOTNAME.R0D        DIO (DIODE RESPONSE)           HRS FILE and HRS ROW

ROOTNAME.R1H                                                   
ROOTNAME.R1D        PHC (CATHODE RESPONSE)

ROOTNAME.R2H                                                    
ROOTNAME.R2D        VIG (VIGNETTING)

ROOTNAME.R3H                                                   
ROOTNAME.R3D        ABS (ABSOLUTE FLUX)

ROOTNAME.R4H                                                   
ROOTNAME.R4D        NET (WAVELENGTH NET)

ROOTNAME.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: 
===============
                                         DATABASE
ROOT     EXTENSION  FILE_TYPE            RELATION
-------------------------------------------------------
ROOTNAME_BIA.FITS      BIA        STIS_FILE and STIS_ROW
ROOTNAME_DRK.FITS      DRK                                             
ROOTNAME_MOC.FITS      MOC                                             
ROOTNAME_PFL.FITS      PFL                                             
ROOTNAME_DFL.FITS      DFL                                             
ROOTNAME_LFL.FITS      LFL                                             
ROOTNAME_SSC.FITS      SSC                                             

------------------------------------------------------------------------------

STIS tables
===============
Directory OTAB:  
===============

ROOTNAME_CCD.FITS      CCD         STIS_FILE and STIS_ROW                  
ROOTNAME_A2D.FITS      A2D                                             
ROOTNAME_CRR.FITS      CRR                                             
ROOTNAME_BPX.FITS      BPX                                             
ROOTNAME_LIN.FITS      LIN                                             
ROOTNAME_PHT.FITS      PHT                                             
ROOTNAME_APT.FITS      APT                                             
ROOTNAME_APD.FITS      APD                                             
ROOTNAME_LMP.FITS      LMP                                             
ROOTNAME_IDC.FITS      IDC                                             
ROOTNAME_SDC.FITS      SDC                                            
ROOTNAME_IAC.FITS      IAC                                             
ROOTNAME_1DT.FITS      1DT                                             
ROOTNAME_DSP.FITS      DSP                                             
ROOTNAME_1DX.FITS      1DX                                             


----------------------------------------------------------------------------

NICMOS reference files
===============     
Directory NREF: 
===============

                                           DATABASE
ROOT     EXTENSION  FILE_TYPE              RELATION
---------------------------------------------------------
ROOTNAME_DRK.FITS   DARK           NICMOS_FILE and NICMOS_ROW              
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                  NICMOS_FILE and NICMOS_ROW                               


----------------------------------------------------------------------------

Back to the CDBS Operations Page