PDS_VERSION_ID        = PDS3
RECORD_TYPE           = "STREAM"

OBJECT                = TEXT
  PUBLICATION_DATE    = 2006-03-01
  NOTE                = "Description of the CALIB directory"
END_OBJECT            = TEXT
END

        CALIB Directory Content

The CALIB folder contains the various database information required to calibrate OSIRIS images.
The information provided is stored in a format readable by the OSIRIS calibration pipeline software which may
not always follow the PDS standard. All information is, however, either readable using either a text editor (ascii
format) of a std PDS data file reader (PDS image data and PDS table data).

The CALIB folder has the following structure:

   CALIB --|-- ABSCAL               : Folder containing the DN/s to W/m2/sr/nm  for various optical filter combinations
           |
           |-- ADC                  : Folder containing the low/high adc offset valid for the various amplifier combinations
           |
           |-- BIAS                 : Folder containing the bias offsets for th various operational modes of OSIRIS
           |
           |-- DISTORSION            : Folder containing the optical distorsion model parameters for the cameras
           |
           |-- FILTERS              : Folder containing the filter transmission curves for the various optical filters
           |
           |-- FLATFIELDS           : Folder containing the flatfields for the various filter combinations
           |
           |-- MIRRORS              : Folder containing the mirror reflectivity curves (for both single mirror and for full optical path)
           |
           |
           |-- QE                   : The CCD quantum efficiency
           |
           |-- SHUTTER                : Folder containing calibration parameters for the two shutter mechanisms of the cameras


ABSCAL:
    Contains files with the format  <camera>_<model>_AbsCal_V<version>_<Creation Date>.txt

    The data files conatins <tag>=<value> lists with the format:
        abs<filter>_A      contains the absolute calibration constant for for <filter>   [(DN/s) / (W/m2/nm/sr)]
        abs<filter_A_Err   contains an error estimate for abs<filter>_A
        abs<filter>_T       contains the average transmission coifficient for <filter>

ADC:
    Contains the ADC offset added to the images by the readout electronics for various readout configuration

    The data files conatins <tag>=<value> lists with the format:
        adc_offset_a        contains the ADC offset for amplifier chain A
        adc_offset_b        contains the ADC offset for amplifier chain B
        adc_offset_ab        contains the ADC offset for amplifier chain AB

BIAS:
    Contains the BIAS offset added to the images by the readout electronics for various readout configuration

    The data files conatins <tag>=<value> lists with the format:
    <WIN Mode>_<Binning>_<amplifier>_SYNC<sync value>

FILTERS:
    Contains filter transmission curves for the various optical filter that can be placed in the optical beam

    The folder contains files with the names: <camera>_<model>_<filter name>_V<version>_<creation date>.tab

    the first column contains the wavelength [nm]
    the second column contains the transmission [fraction]
    the third column contains the reflectivity of the filter surface

FLATFIELDS:
    Contains the flatfields required to calibration OSIRIS images

    The folder contains files with the names: <camera>_<model>_<filter number>_V<version>_<creation date>.img

    The data files are stored in a data format that can be read with a PDS image reader

MIRRORS:
    Contains the reflectivity curves for the mirrors of OSIRIS

    The folder contains files with the names: <camera>_<model>_MIRROR_V<version>_<creation date>.tab

    The data files are tabular text files with:

    the first colum containing the wavelength [nm]
    the second column containg the single mirror reflectance
    the third column containg the integrated mirror responce of the full optical system

QE:
    Contains the quantom efficiency of the OSIRIS CCD's

    The folder contains files with the names: <camera>_<model>_QE_V<version>_<creation date>.img (std calibration file)
                                        or
                                              <camera>_<model>_QE-<temperature>_V<version>_<creation date>.img (remperature calibration file)

    The data files are tabular text files with:

    the first colum containing the wavelength [nm]
    the second column containg the QE of the CCD at wavelength
    the third column containg the reflectivity of the CCD at wavelength

SHUTTER:
    Contains parameters describing the transfer function from shutter pulse index to CCD physical location.

    The folder contains files with the names: <camera>_<model>_SHM-B<blade>_V<version>_<creation date>.txt

    The shutter motion transfer function is described as:
        d = d0 + L(sin(th0) + sin(n*deg_per_stripe + thZ - th0))

           where n is the pulse index and the other parameters are found in the calibration file as <tag>=<value> data