NASA Logo, National Aeronautics and Space Administration

 
Product General Information:
 
 ESDT ShortName:  OMIAuraSO2
 ESDT LongName:   OMI/Aura TOMS SO2 Vertical Column 1-Orbit L2 Swath 13x24 km
 PFS Version:     0.1.2
 PFS Date:        2014-08-16
 PFS Author:      P. Leonard (ADNET)
 App Version:     0.1.0
 App Developers:  P. Leonard (ADNET)
 App Scientists:  Nick Krotkov (NASA), P.K. Bhartia (NASA), Brad Fisher (SSAI), Can Li (ESSIC)
 
Product Overview: >
 
 This document specifies the format for the OMIAuraSO2 Level 2 (L2) swath
 product.  The OMIAuraSO2 product provides SO2 column amount estimates
 based on OMI (Ozone Monitoring Instrument) observations, and is tied to
 the OMSO2 (Reference 1) and OMTO3 (Reference 2) products.
 
 The OMIAuraSO2 product is stored as one HDF5 swath file for each granule
 (i.e., one orbit) of OMSO2 L2 data, and has a size range of up to 40 Mb.
 The Metadata in the product file are consistent with the MEaSUREs Metadata
 requirements (References 3 and 4).  The field names and dimension order are
 inspired by the Aura File Format Guidelines document (Reference 5).
 
File-Level Attributes:
 
 - attribute:         AuthorAffiliation
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The affiliation of the author of the product.  Actual is "NASA/GSFC".

 - attribute:         AuthorName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The name of the author of the product.  Actual is "N. Krotkov, et al.".
 
 - attribute:         Conventions
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Metadata Conventions used.  Actual is "CF-1.0".
 
 - attribute:         DayNightFlag
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The flag that indicates whether the product includes day-side observations, night-side observations, or both.  Actual is "Day".
 
 - attribute:         EastBoundingCoordinate
   mandatory:         T
   data_type:         H5T_NATIVE_REAL
   number_of_values:  1
   valid_min:         -180.0
   valid_max:         180.0
   description: >
    The terrestrial longitude (in degrees) of the easternmost data in the granule.
 
 - attribute:         EquatorCrossingDate
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description:       >
    The UTC year, month and day of the ascending equator crossing in the granule.  Example is "2010-12-25".
 
 - attribute:         EquatorCrossingLongitude
   mandatory:         T
   data_type:         H5T_NATIVE_REAL
   number_of_values:  1
   valid_min:         -180.0
   valid_max:         180.0
   description:       >
    The longitude of the ascending equator crossing in the granule.
 
 - attribute:         EquatorCrossingTime
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description:       >
    The UTC hour, minute and second of the ascending equator crossing in the granule.  Example is "12:00:00".

 - attribute:         GranuleDay
   mandatory:         T
   data_type:         H5T_NATIVE_INTEGER
   number_of_values:  1
   valid_min:         1
   valid_max:         31
   description: >
    The UTC day of the month at the start of the granule.
 
 - attribute:         GranuleDayOfYear
   mandatory:         T
   data_type:         H5T_NATIVE_INTEGER
   number_of_values:  1
   valid_min:         1
   valid_max:         366
   description: >
    The UTC day of the year at the start of the granule.

 - attribute:         GranuleMonth
   mandatory:         T
   data_type:         H5T_NATIVE_INTEGER
   number_of_values:  1
   valid_min:         1
   valid_max:         12
   description: >
    The UTC month at the start of the granule.

 - attribute:         GranuleYear
   mandatory:         T
   data_type:         H5T_NATIVE_INTEGER
   number_of_values:  1
   valid_min:         2004
   valid_max:         2020
   description: >
    The (four-digit) UTC year at the start of the granule.
 
 - attribute:         HDFVersion
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The version of HDF used to create the product.  Example is "5-1.8.8".
 
 - attribute:         identifier_product_doi
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Digital Object Identifier.  Actual is "10.5067/MEASURES/SO2/DATA201".
 
 - attribute:         identifier_product_doi_authority
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Digital Object Identifier.  Actual is "http://dx.doi.org/".
 
 - attribute:         InputFilesHDF
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The OMSO2 input file used as input for the HDF-EOS5 to HDF5 conversion processing.
 
 - attribute:         InstrumentShortName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Short Name of the instrument.  Actual is "OMI".
 
 - attribute:         LocalGranuleID
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The actual name of the product file.  Example is "OMI-Aura_L2-OMIAuraSO2_2002m0630t2354-o21434_v03-00-2014m0915t123456.h5".
 
 - attribute:         LocalityValue
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The geographic locality of the product.  Actual is "Global".
 
 - attribute:         LongName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The ESDT Long Name of the product.  Actual is "OMI/Aura TOMS SO2 Vertical Column 1-Orbit L2 Swath 13x24 km".
 
 - attribute:         NorthBoundingCoordinate
   mandatory:         T
   data_type:         H5T_NATIVE_REAL
   number_of_values:  1
   valid_min:         -90.0
   valid_max:         90.0
   description: >
    The terrestrial latitude (in degrees) of the northernmost data in the granule.
 
 - attribute:         NumTimes
   mandatory:         T
   data_type:         H5T_NATIVE_INTEGER
   number_of_values:  1
   valid_min:         1
   valid_max:         2000
   description: >
    The number of times in the granule, which is also the size of the nTimes dimension.
 
 - attribute:         OrbitNumber
   mandatory:         T
   data_type:         H5T_NATIVE_INTEGER
   number_of_values:  1
   valid_min:         1
   valid_max:         99999
   description: >
    The OMI orbit number in the granule.
 
 - attribute:         ParameterName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The measured science parameter expressed in the granule.  Actual is "Vertical Column Sulfur Dioxide".
 
 - attribute:         PGEVersion
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The version of the PGE or App that was used to create the product file.  Example is "0.0.1".

 - attribute:         PlatformShortName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Short Name of the platform.  Actual is "Aura".
 
 - attribute:         ProcessingCenter
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   valids:            ACPS,OMIDAPS,TLCF
   description: >
    The processing center where the product was created.  Example is "ACPS".
 
 - attribute:         ProcessLevel
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The process level of the product.  Actual is "2".

 - attribute:         ProductionDateTimeHDF
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The date and time of the OMSO2 to HDF5 conversion processing.  Example is "2013-03-15T12:34:56.0Z".

 - attribute:         ProductionDateTimeHE5
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The date and time of the OMSO2 processing.  Example is "2012-12-31T12:34:56.0Z".

 - attribute:         ProductType
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The temporal type of the product.  Actual is "L2 Swath".
 
 - attribute:         RangeBeginningDate
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The UTC year, month and day when the granule began.  Example is "2010-12-25".

 - attribute:         RangeBeginningTime
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The UTC hour, minute and second when the granule began.  Example is "12:00:00".

 - attribute:         RangeEndingDate
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The UTC year, month and day when the granule ended.  Example is "2010-12-26".

 - attribute:         RangeEndingTime
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The UTC hour, minute and second when the granule ended.  Example is "13:00:00".
 
 - attribute:         SensorShortName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Short Name of the sensor.  Actual is "CCD Ultra Violet".
 
 - attribute:         ShortName
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The ESDT Short Name of the product.  Actual is "OMIAuraSO2".
 
 - attribute:         SouthBoundingCoordinate
   mandatory:         T
   data_type:         H5T_NATIVE_REAL
   number_of_values:  1
   valid_min:         -90.0
   valid_max:         90.0
   description: >
    The terrestrial latitude (in degrees) of the southernmost data in the granule.
 
 - attribute:         TAI93At0zOfGranule
   mandatory:         T
   data_type:         H5T_NATIVE_DOUBLE
   number_of_values:  1
   valid_min:         -5.0e+09
   valid_max:         1.0e+10
   description: >
    The TAI93 time (in continuous seconds since 12 a.m. UTC on January 1, 1993) at 0z of the L2G granule (see Section 6.1 of Reference 5).
 
 - attribute:         VersionID
   mandatory:         T
   data_type:         H5T_NATIVE_CHARACTER
   number_of_values:  1
   description: >
    The Collection Version of the product.  Example is "3.00".
 
 - attribute:         WestBoundingCoordinate
   mandatory:         T
   data_type:         H5T_NATIVE_REAL
   number_of_values:  1
   valid_min:         -180.0
   valid_max:         180.0
   description: >
    The terrestrial longitude (in degrees) of the westernmost data in the granule.
 
Dimensions:
 
 - dimension:       nCorners
   mandatory:       T
   data_type:       H5T_NATIVE_INTEGER
   dimension_type:  FIXED
   units:           1
   long_name:       Ground Pixel Corner
   description: >
    The dimension representing the ground pixel corners.  There are four corners per ground pixel.
 
 - dimension:       nLayers
   mandatory:       T
   data_type:       H5T_NATIVE_REAL
   dimension_type:  FIXED
   units:           hPa
   long_name:       Pressure (Umkehr Layers 0 to 9 and Layers 10 Plus)
   description: >
    The dimension representing Umkehr layers 0 to 9 and layers 10 plus.  The pressure corresponds to the bottom of the layer.
 
 - dimension:       nTimes
   mandatory:       T
   data_type:       H5T_NATIVE_DOUBLE
   dimension_type:  FIXED
   units:           seconds since 1993-01-01
   long_name:       Time
   description: >
    The dimension representing the observation times in the granule.  The values are in TAI93 (time in continuous seconds since 12 a.m. UTC on January 1, 1993).
 
 - dimension:       nWavel
   mandatory:       T
   data_type:       H5T_NATIVE_REAL
   dimension_type:  FIXED
   units:           nm
   long_name:       TOMS Wavelength
   description: >
    The dimension representing the TOMS wavelengths.  The values range from 305 to 380 nm.
 
 - dimension:       nXtrack
   mandatory:       T
   data_type:       H5T_NATIVE_INTEGER
   dimension_type:  FIXED
   units:           1
   long_name:       Cross-Track Position (1-Based)
   description: >
    The dimension representing the cross-track position of the observation in the "scan" line.  The values range from 1 to 60.
 
ANCILLARY_DATA Group:
 
 - dataset:      CloudPressure
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_max:    1013.25
   _FillValue:   -1.2676506e+30
   units:        hPa
   long_name:    Effective Cloud Pressure
   description: >
    The effective cloud pressure (in hPa) associated with the ground pixel (from OMCLDRR).
 
 - dataset:      TerrainHeight
   mandatory:    T
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    -200
   valid_max:    10000
   _FillValue:   -2147483647
   units:        m
   long_name:    Terrain Height
   description: >
    The terrain height (in m) at the center of the ground pixel (from the OMI Level 1B file).
 
 - dataset:      TerrainPressure
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_min:    1013.25
   _FillValue:   -1.2676506e+30
   units:        hPa
   long_name:    Terrain Pressure
   description: >
    The terrain pressure (in hPa) at the center of the ground pixel (from OMTO3).
 
GEOLOCATION_DATA Group:
 
 - dataset:      FoV75CornerLatitude
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nCorners,nXtrack,nTimes
   valid_min:    -90.0
   valid_max:    90.0
   _FillValue:   -1.2676506e+30
   units:        degrees_north
   long_name:    "Corner Latitudes for 75% Field of View Pixels on the WGS-85 Ellipsoid (CCW relative to flight direction: LL,LR,UR,UL)"
   description: >
    The geodetic latitudes (in degrees) of the corner coordinates of the 75% Field of View (i.e., overlapping) ground pixels (from OMPIXCOR).
 
 - dataset:      FoV75CornerLongitude
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nCorners,nXtrack,nTimes
   valid_min:    -180.0
   valid_max:    180.0
   _FillValue:   -1.2676506e+30
   units:        degrees_east
   long_name:    "Corner Longitudes for 75% Field of View Pixels on the WGS-85 Ellipsoid (CCW relative to flight direction: LL,LR,UR,UL)"
   Description: >
    The geodetic longitudes (in degrees) of the corner coordinates of the 75% Field of View (i.e., overlapping) ground pixels (from OMPIXCOR).
 
 - dataset:      GroundPixelQualityFlags
   mandatory:    T
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    65534
   _FillValue:   -2147483647
   units:        1
   long_name:    Ground Pixel Quality Flags
   description: >
    The ground pixel quality flags (for the ground pixel):
    Bits 0 to 3 together contain the land/water flags:
      0    - shallow ocean
      1    - land
      2    - shallow inland water
      3    - ocean coastline/lake shoreline
      4    - ephemeral (intermittent) water
      5    - deep inland water
      6    - continental shelf ocean
      7    - deep ocean
      8-14 - not used
      15   - error flag for land/water
    Bits 4 to 6 are flags that are set to 0 for FALSE, or 1 for TRUE:
      Bit 4 - sun glint possibility flag
      Bit 5 - solar eclipse possibility flag
      Bit 6 - geolocation error flag
    Bit 7 is reserved for future use (currently set to 0).
    Bits 8 to 14 together contain the snow/ice flags (based on NISE):
      0       - snow-free land
      1-100   - sea ice concentration (percent)
      101     - permanent ice (Greenland, Antarctica)
      102     - not used
      103     - dry snow
      104     - ocean (NISE-255)
      105-123 - reserved for future use
      124     - mixed pixels at coastline (NISE-252)
      125     - suspect ice value (NISE-253)
      126     - corners undefined (NISE-254)
      127     - error
    Bit 15 - NISE nearest neighbor filling flag.
    (See Section 6.2 of Reference 6 for more details.)
 
 - dataset:      Latitude
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -90.0
   valid_max:    90.0
   _FillValue:   -1.2676506e+30
   units:        degrees_north
   long_name:    Latitude
   description: >
    The terrestrial latitude (in degrees) at the center of the ground pixel.
 
 - dataset:      Longitude
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -180.0
   valid_max:    180.0
   _FillValue:   -1.2676506e+30
   units:        degrees_east
   long_name:    Longitude
   description: >
    The terrestrial longitude (in degrees) at the center of the ground pixel.
 
 - dataset:      RelativeAzimuthAngle
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -180.0
   valid_max:    180.0
   _FillValue:   -1.2676506e+30
   units:        degrees_eastofnorth
   long_name:    Relative Azimuth Angle (sun + 180 - view)
   description: >
    The relative (sun + 180 - view) azimuth angle (in degrees) at the center of the ground pixel.
 
 - dataset:      SecondsInDay
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nTimes
   valid_min:    0.0
   valid_max:    86401.0
   _FillValue:   -1.2676506e+30
   units:        s
   long_name:    Seconds After UTC Midnight
   description: >
    The time (in s) after UTC midnight at the start of the observation.
 
 - dataset:      SolarAzimuthAngle
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -180.0
   valid_max:    180.0
   _FillValue:   -1.2676506e+30
   units:        degrees_eastofnorth
   long_name:    Solar Azimuth Angle
   Description: >
    The solar azimuth angle (in degrees) at the center of the ground pixel.
 
 - dataset:      SolarZenithAngle
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_max:    90.0
   _FillValue:   -1.2676506e+30
   units:        degrees
   long_name:    Solar Zenith Angle
   description: >
    The solar zenith angle (in degrees) at the center of the ground pixel.
 
 - dataset:      Time
   mandatory:    T
   data_type:    H5T_NATIVE_DOUBLE
   dimensions:   nTimes
   valid_min:    -5.0e+09
   valid_max:    1.0e+10
   _FillValue:   -1.2676506002282294e+30
   units:        seconds since 1993-01-01
   long_name:    Time at Start of Scan (TAI93)
   description: >
    The TAI93 time (in continuous seconds since 12 a.m. UTC on January 1, 1993) of the start of the "scan".
 
 - dataset:      ViewingAzimuthAngle
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -180.0
   valid_max:    180.0
   _FillValue:   -1.2676506e+30
   units:        degrees_eastofnorth
   long_name:    Viewing Azimuth Angle
   description: >
    The viewing azimuth angle (in degrees) at the center of the ground pixel.
 
 - dataset:      ViewingZenithAngle
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_max:    70.0
   _FillValue:   -1.2676506e+30
   units:        degrees
   long_name:    Viewing Zenith Angle
   description: >
    The viewing zenith angle (in degrees) at the center of the ground pixel.
 
SCIENCE_DATA Group:
 
 - dataset:      AlgorithmFlag_PBL
   mandatory:    T
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    12
   _FillValue:   -2147483647
   units:        1
   long_name:    Algorithm Flag for PBL
   description: >
    The PBL processing flag for the retrieval indicating the algorithm path:
      0 - skipped
      1 - linear fitting, vertical column SO2, short wavelength window
      2 - linear fitting, vertical column SO2, long wavelength window
    Add 10 for snow/ice.
 
 - dataset:      AlgorithmFlag_STL
   mandatory:    T
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    12
   _FillValue:   -2147483647
   units:        1
   long_name:    Algorithm Flag for STL
   description: >
    The STL processing flag for the retrieval indicating the algorithm path:
      0 - skipped
      1 - linear fitting, vertical column SO2, short wavelength window
      2 - linear fitting, vertical column SO2, long wavelength window
    Add 10 for snow/ice.
 
 - dataset:      AlgorithmFlag_TRL
   mandatory:    T
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    12
   _FillValue:   -2147483647
   units:        1
   long_name:    Algorithm Flag for TRL
   description: >
    The TRL processing flag for the retrieval indicating the algorithm path:
      0 - skipped
      1 - linear fitting, vertical column SO2, short wavelength window
      2 - linear fitting, vertical column SO2, long wavelength window
    Add 10 for snow/ice.
 
 - dataset:      AlgorithmFlag_TRM
   mandatory:    T
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    12
   _FillValue:   -2147483647
   units:        1
   long_name:    Algorithm Flag for TRM
   description: >
    The TRM processing flag for the retrieval indicating the algorithm path:
      0 - skipped
      1 - linear fitting, vertical column SO2, short wavelength window
      2 - linear fitting, vertical column SO2, long wavelength window
    Add 10 for snow/ice.
 
 - dataset:      ChiSquare
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_max:    100.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    Chi Square of the Fitting Residuals
   description: >
    The Chi square for STL from the linear least squares fit.
 
 - dataset:      ColumnAmountO3
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    50.0
   valid_min:    700.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Best Total Ozone Solution
   description: >
    The best retrieved total ozone column amount from OMTO3.
 
 - dataset:      ColumnAmountSO2_PBL
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (PBL)
   description: >
    The retrieved vertical column amount SO2 with a boundary-layer SO2 profile averaged from in-situ aircraft measurments over the eastern United States.
 
 - dataset:      ColumnAmountSO2_PBL_TOMS
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (PBL-TOMS)
   description: >
    The retrieved vertical column amount SO2 with a boundary-layer SO2 profile averaged from in-situ aircraft measurments over the eastern United States based on the TOMS algorithm.
 
 - dataset:      ColumnAmountSO2_STL
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (STL)
   description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile similar to the standard ozone profile in Umkher layer 3 (roughly between 15 and 20 km altitude).
 
 - dataset:      ColumnAmountSO2_STL_TOMS
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (STL-TOMS)
   description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile similar to the standard ozone profile in Umkher layer 3 (roughly between 15 and 20 km altitude) based on the TOMS algorithm.
 
 - dataset:      ColumnAmountSO2_TRL
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (TRL)
   description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile similar to the standard ozone profile in Umkher layer 0 (roughly between 0 and 5 km altitude).
 
 - dataset:      ColumnAmountSO2_TRL_TOMS
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (TRL-TOMS)
   description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile similar to the standard ozone profile in Umkher layer 0 (roughly between 0 and 5 km altitude) based on the TOMS algorithm.
 
 - dataset:      ColumnAmountSO2_TRM
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (TRM)
   description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile similar to the standard ozone profile in Umkher layer 1 (roughly between 5 and 10 km altitude).
 
 - dataset:      ColumnAmountSO2_TRM_TOMS
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -10.0
   valid_min:    2000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Vertical Column Amount SO2 (TRM-TOMS)
   description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile similar to the standard ozone profile in Umkher layer 1 (roughly between 5 and 10 km altitude) based on the TOMS algorithm.
 
 - dataset:      deltaO3
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -1000.0
   valid_min:    1000.0
   _FillValue:   -1.2676506e+30
   units:        DU
   long_name:    Ozone Adjustment from Least-Squares Fit
   description: >
    The ozone adjustment derived from the least-squares fitting method.
 
 - dataset:      deltaRefl
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -1.0
   valid_min:    1.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    Adjustment to Reflectivity at 331 nm
   description: >
    The reflectivity vs. wavelength is described by a second order polynomial, R = R331 + c1*(lambda-331) + c2 *(lambda-331)**2.  The deltaRefl is the reflectivity adjustment to the zeroeth order term, R331.
 
 - dataset:      dN_dSO2_STL
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel,nXtrack,nTimes
   valid_min:    0.0
   valid_min:    10.0
   _FillValue:   -1.2676506e+30
   units:        1/DU
   long_name:    Umkehr Layer 3 SO2 Sensitivity Ratio, dN/dSO2
   description: >
    Umkehr Layer 3 SO2 sensitivity ratio, dN/dSO2.
 
 - dataset:      dN_dSO2_TRL
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel,nXtrack,nTimes
   valid_min:    0.0
   valid_min:    10.0
   _FillValue:   -1.2676506e+30
   units:        1/DU
   long_name:    Umkehr Layer 0 SO2 Sensitivity Ratio, dN/dSO2
   description: >
    Umkehr Layer 0 SO2 sensitivity ratio, dN/dSO2.
 
 - dataset:      dN_dSO2_TRM
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel,nXtrack,nTimes
   valid_min:    0.0
   valid_min:    10.0
   _FillValue:   -1.2676506e+30
   units:        1/DU
   long_name:    Umkehr Layer 1 SO2 Sensitivity Ratio, dN/dSO2
   description: >
    Umkehr Layer 1 SO2 sensitivity ratio, dN/dSO2.
 
 - dataset:      fc
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_max:    1.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    MLER Cloud Fraction
   description: >
    The MLER model effective cloud fraction parameter.
 
 - dataset:      LayerEfficiency
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nLayers,nXtrack,nTimes
   valid_min:    0.0
   valid_max:    10.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    Algorithmic Layer Efficiency
   description: >
    The total ozone algorithmic efficiency Umkehr layers 0 to 9 and layers 10 plus.
 
 - dataset:      NValue
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel,nXtrack,nTimes
   valid_min:    0.0
   valid_max:    600.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    Measured N-Values
   description: >
    The measured N-values.  N is defined as -100 times the logarithm of the ratio of the measured radiance to the solar irradiance.
 
 - dataset:      QualityFlags_PBL
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    8191
   _FillValue:   -2147483647
   units:        1
   long_name:    Quality Flags for PBL
   description: >
    The quality flags PBL for the retrieval.  Each bit corresponds to a flag that
    is set to 0 for good value, or 1 for bad value:
      Bit  0 - SO2 consistency flag (0 for SO2 from 3 pairs are consistent, 1 for not) 
      Bit  1 - geometric slant O3 column >= Threshold (currently set at 1500 D.U.)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  4 to 6 together represents one number with a value ranging from 0 to 7, and
               is equal to the first 4 bits of the OMTO3 QualityFlags. 
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
      Bit 11 - set to be same as bit 6 of the OMTO3 QualityFlags
      Bit 12 - set to be same as bit 7 of the OMTO3 QualityFlags
      Bit 13 - place holder, set to zero currently
      Bit 14 - place holder, set to zero currently 
      Bit 15 - place holder, set to zero currently
 
 - dataset:      QualityFlags_STL
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    8191
   _FillValue:   -2147483647
   units:        1
   long_name:    Quality Flags for STL
   description: >
    The quality flags STL for the retrieval.  Each bit corresponds to a flag that
    is set to 0 for good value, or 1 for bad value:
      Bit  0 - SO2 consistency flag (0 for SO2 from 3 pairs are consistent, 1 for not) 
      Bit  1 - geometric slant O3 column >= Threshold (currently set at 1500 D.U.)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  4 to 6 together represents one number with a value ranging from 0 to 7, and
               is equal to the first 4 bits of the OMTO3 QualityFlags. 
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
      Bit 11 - set to be same as bit 6 of the OMTO3 QualityFlags
      Bit 12 - set to be same as bit 7 of the OMTO3 QualityFlags
      Bit 13 - place holder, set to zero currently
      Bit 14 - place holder, set to zero currently 
      Bit 15 - place holder, set to zero currently
 
 - dataset:      QualityFlags_TRL
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    8191
   _FillValue:   -2147483647
   units:        1
   long_name:    Quality Flags for TRL
   description: >
    The quality flags TRL for the retrieval.  Each bit corresponds to a flag that
    is set to 0 for good value, or 1 for bad value:
      Bit  0 - SO2 consistency flag (0 for SO2 from 3 pairs are consistent, 1 for not) 
      Bit  1 - geometric slant O3 column >= Threshold (currently set at 1500 D.U.)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  4 to 6 together represents one number with a value ranging from 0 to 7, and
               is equal to the first 4 bits of the OMTO3 QualityFlags. 
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
      Bit 11 - set to be same as bit 6 of the OMTO3 QualityFlags
      Bit 12 - set to be same as bit 7 of the OMTO3 QualityFlags
      Bit 13 - place holder, set to zero currently
      Bit 14 - place holder, set to zero currently 
      Bit 15 - place holder, set to zero currently
 
 - dataset:      QualityFlags_TRM
   data_type:    H5T_NATIVE_INTEGER
   dimensions:   nXtrack,nTimes
   valid_min:    0
   valid_max:    8191
   _FillValue:   -2147483647
   units:        1
   long_name:    Quality Flags for TRM
   description: >
    The quality flags TRM for the retrieval.  Each bit corresponds to a flag that
    is set to 0 for good value, or 1 for bad value:
      Bit  0 - SO2 consistency flag (0 for SO2 from 3 pairs are consistent, 1 for not) 
      Bit  1 - geometric slant O3 column >= Threshold (currently set at 1500 D.U.)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  4 to 6 together represents one number with a value ranging from 0 to 7, and
               is equal to the first 4 bits of the OMTO3 QualityFlags. 
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
      Bit 11 - set to be same as bit 6 of the OMTO3 QualityFlags
      Bit 12 - set to be same as bit 7 of the OMTO3 QualityFlags
      Bit 13 - place holder, set to zero currently
      Bit 14 - place holder, set to zero currently 
      Bit 15 - place holder, set to zero currently
 
 - dataset:      RadiativeCloudFraction
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    0.0
   valid_max:    1.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    Radiative Cloud Fraction = fc*lc331/lm331
   Description: >
    The radiative cloud fraction (= fc * lc331 / lm331) associated with the retrieval.
 
 - dataset:      Reflectivity331
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -15.0
   valid_max:    115.0
   _FillValue:     -1.2676506e+30
   units:        "%"
   long_name:    Effective Surface Reflectivity at 331 nm
   description: >
    Effective surface reflectivity of the surface at 331 nm associated with the retrieval.
 
 - dataset:      Residual
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel,nXtrack,nTimes
   valid_min:    -150.0
   valid_max:    150.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    N-Value Residual
   description: >
    The N-value residuals from OMTO3.
 
 - dataset:      ResidualAdjustment
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel,nXtrack,nTimes
   valid_min:    -50.0
   valid_max:    50.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    N-Value Residual Adjustment
   description: >
    The N-value adjustment made to OMTO3 residuals.
 
 - dataset:      Rlambda1st
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -1.0
   valid_max:    1.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    First Order Term of R-Lambda Function
   description: >
    The reflectivity vs. wavelength is described by a second order polynomial, R = R331 + c1*(lambda-331) + c2 *(lambda-331)**2.  Rlambda1st is the first order coefficient c1.
 
 - dataset:      Rlambda2nd
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -1.0
   valid_max:    1.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    Second Order Term of R-Lambda Function
   description: >
    The reflectivity vs. wavelength is described by a second order polynomial, R = R331 + c1*(lambda-331) + c2 *(lambda-331)**2.  Rlambda2nd is the second order coefficient c2.
 
 - dataset:      UVAerosolIndex
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nXtrack,nTimes
   valid_min:    -50.0
   valid_max:    50.0
   _FillValue:   -1.2676506e+30
   units:        1
   long_name:    UV Aerosol Index
   description: >
    The UV aerosol index associated with the retrieval.
 
SENSOR_DATA Group:
 
 - dataset:      Wavelength
   mandatory:    T
   data_type:    H5T_NATIVE_REAL
   dimensions:   nWavel
   valid_min:    300.0
   valid_max:    400.0
   _FillValue:   -1.2676506e+30
   units:        nm
   long_name:    TOMS Wavelengths
   description: >
    The TOMS wavelengths.  There are twelve wavelengths that range from 308 to 373 nm.
 
Core Metadata:  None.
 
Product Specific Attributes:  None.
 
Archived Metadata:  None.
 
References: >
 
 1. "OMSO2 README File"
    (18 August 2008)
    (http://disc.sci.gsfc.nasa.gov/Aura/data-holdings/OMI/omso2_v003.shtml)
 
 2. "OMTO3 README File"
    (3 April 2012)
    (http://disc.sci.gsfc.nasa.gov/Aura/data-holdings/OMI/omto3_v003.shtml)
 
 3. "ICD Between GES DISC S4PA and Multi-Decadal Sulfur Dioxide Climatology from Satellite Instruments/Nickolay Krotkov"
    Prepared by James Johnson
    Revised December 31, 2013
 
 4. "MEaSUREs Data at the GES DISC:  Recommendations to Data Providers"
    Prepared by Dana Ostrenga, James Johnson, and Bruce Vollmer
    Revised June 27, 2011
 
 5. "A File Format for Satellite Atmospheric Chemistry Data Based on Aura File Format Guidelines"
    Craig, C., Veefkind, P., Leonard, P., Wagner, P., Vuu, C., and Shepard, D.
    ESDS-RCF-009, May 2008
    http://www.esdswg.org/spg/rfc/esds-rfc-009/ESDS-RFC-009.pdf/view
 
 6. "OMI GDPS Input/Output Data Specification (IODS) Volume 2"
    (OMI-GDPS-IODS-2, SD-OMIE-7200-DS-467, 9 April 2003)