Shortname:    OMSO2G
Longname:     OMI/Aura Sulfur Dioxide (SO2) Total Column Daily L2 Global 0.125deg Lat/Lon Grid
PFS Version:  0.9.80
Date:         13 February 2008
Author(s):    Peter Leonard (ADNET)

PGE Version:               0.9.80
Lead Algorithm Scientist:  Nick Krotkov (GEST)
Lead Algorithm Developer:  Peter Leonard (ADNET)
Lead PGE Developer:        Peter Leonard (ADNET)
PGE Developer(s):          Peter Leonard (ADNET)

Description: >
  
 This document specifies the format of the Ozone Monitoring Instrument (OMI)
 OMSO2G product, which is the daily Level 2G (L2G) gridded data product that
 corresponds to the OMSO2 product.  The latter is the U.S. OMI Science Team's
 total column sulphur dioxide orbital Level 2 (L2) swath data product
 (Reference 1).
  
 The L2G product contains 24 UTC hours of L2 product subsetted onto a
 longitude-latitude grid.
  
 An OMI L2G day is defined to be the 24 hours that lie between UTC times of
 0 hours, 0 minutes, 0 seconds and 23 hours, 59 minutes, 59.999999 seconds.
  
 The L2G product contains the data for all L2 "scenes" that
 1) have observation times that lie within the L2G day in question,
 2) have centers that lie within the L2G grid cell in question, and
 3) are "good".
  
 A "good" OMSO2 L2 scene is defined as one that has
 i)  a solar zenith angle that is less than or equal to 88.0 degrees, and
 ii) an SO2 column amount 15-km (STL) that is not equal to the missing value.
  
 The adopted L2G grid is a 0.125-degree by 0.125-degree grid in longitude and
 latitude.  The dimensions of this grid are 2880 by 1440.  The origin of the
 grid is at lower left.  That is, the grid cell at coordinates (1, 1)
 is centered at (longitude = -179.9375 , latitude = -89.9375),
 and the grid cell at coordinates (2880, 1440)
 is centered at (longitude =  179.9375 , latitude =  89.9375).
  
 The adopted L2G grid is consistent with the document entitled "Definition
 of OMI Grids for Level 3 and Level 4 Data Products" by J.P. Veefkind et al.
 (Reference 2).
  
 The L2G product currently excludes L2 data collected in spatial and spectral
 zoom modes.
  
 Each "good" OMSO2 L2 scene is mapped onto only one L2G grid cell.
  
 The number of L2 scenes that are mapped onto a given L2G grid cell can range
 from 0 to 6, and the corresponding data are stored in an additional dimension
 of the grid.
  
 The L2 data are not averaged or weighted in any way in the L2G product.
  
 The product is stored as one HDF-EOS 5 grid file, and has a size of 140 MB.
  
 The format of the L2G product files is consistent with the document entitled
 "HDF-EOS Aura File Format Guidelines" by C. Craig et al. (Reference 3).
  
Global Metadata:
 
 - Metadata Name:     EndUTC
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Data Source:       PGE
   Description: >
    UTC at the end of the L2G granule in "YYYY-MM-DDT23:59:59.999999Z" format.
 
 - Metadata Name:     FirstLineInOrbit
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     1
   Maximum Value:     1700
   Data Source:       PGE
   Description: >
    The first line number in each L2 orbit that contributes to the L2G granule.
 
 - Metadata Name:     GranuleDay
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     31
   Data Source:       PGE
   Description:       The day of the month at the start of the L2G granule.
 
 - Metadata Name:     GranuleDayOfYear
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     366
   Data Source:       PGE
   Description:       The day of the year at the start of the L2G granule.

 - Metadata Name:     GranuleMonth
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     12
   Data Source:       PGE
   Description:       The month of the year at the start of the L2G granule.

 - Metadata Name:     GranuleYear
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     2000
   Maximum Value:     2099
   Data Source:       PGE
   Description:       The (four-digit) year at the start of the L2G granule.

 - Metadata Name:     HDFEOSVersion
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Data Source:       HE
   Description: >
    The version of HDF-EOS 5 used in production.  Example is "HDFEOS_5.1.8".

 - Metadata Name:     InstrumentName
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            OMI
   Data Source:       PGE
   Description:       Actual is "OMI" (see Section 6.1 of Reference 3).
 
 - Metadata Name:     LastLineInOrbit
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     1
   Maximum Value:     1700
   Data Source:       PGE
   Description: >
    The last line number in each L2 orbit that contributes to the L2G granule.
 
 - Metadata Name:     NumberOfLinesMissingGeolocation
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     1
   Maximum Value:     1700
   Data Source:       PGE
   Description: >
    The number of lines in each L2 orbit that are missing geolocation (a.k.a.
    number of "bad" lines in each L2 file).
 
 - Metadata Name:     OrbitNumber
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     1
   Maximum Value:     999999
   Data Source:       L2
   Description:       The OMI orbit number for each L2 input granule.
 
 - Metadata Name:     OrbitPeriod
   Mandatory:         T
   Data Type:         HE5T_NATIVE_DOUBLE
   Number of Values:  1,16
   Minimum Value:     5000.0
   Maximum Value:     7000.0
   Data Source:       PGE
   Description:       The Aura orbital period for each L2 input granule.
 
 - Metadata Name:     Period
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            Daily,Weekly,Monthly
   Data Source:       PGE
   Description:       The duration of the L2G granule.  Actual is "Daily".

 - Metadata Name:     PGEVERSION
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Data Source:       PCF
   Description:       Example is "0.9.80" (see Appendix K of Reference 4).

 - Metadata Name:     ProcessLevel
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            2G
   Data Source:       PGE
   Description:       Actual is "2G".

 - Metadata Name:     QAPercentCloudCover
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     0
   Maximum Value:     100
   Data Source:       L2
   Description: >
    The percent of data that have cloud cover in each L2 input granule.

 - Metadata Name:     QAPercentMissingData
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     0
   Maximum Value:     100
   Data Source:       L2
   Description: >
    The percent of Level 1B calibrated radiance data that is missing from each
    L2 input granule.

 - Metadata Name:     QAPercentOutOfBoundsData
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1,16
   Minimum Value:     0
   Maximum Value:     100
   Data Source:       L2
   Description: >
    The percent of data that are out of bounds in each L2 input granule.
 
 - Metadata Name:     StartUTC
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Data Source:       PGE
   Description: >
    UTC at the start of the L2G granule in "YYYY-MM-DDT00:00:00.000000Z" format.

 - Metadata Name:     TAI93At0zOfGranule
   Mandatory:         T
   Data Type:         HE5T_NATIVE_DOUBLE
   Number of Values:  1
   Minimum Value:     0.0
   Maximum Value:     1.0e+30
   Data Source:       PGE
   Description: >
    The TAI93 time at 0z of the L2G granule (see Section 6.1 of Reference 3).
 
Grid Metadata:
 
 - Metadata Name:     GCTPProjectionCode
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     99
   Data Source:       PGE
   Description: >
    The GCTP projection code of the L2G grid.  Actual is 0, which corresponds
    to the geographic projection.
 
 - Metadata Name:     GridName
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            OMI Total Column Amount SO2
   Data Source:       PGE
   Description:       Actual is "OMI Total Column Amount SO2".
 
 - Metadata Name:     GridOrigin
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            Center
   Data Source:       PGE
   Description: >
    The origin of the L2G grid.  Actual is "Center" (see Section 6.2 of
    Reference 3).
 
 - Metadata Name:     GridSpacing
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Data Source:       PGE
   Description: >
    Spacing of L2G grid (in degrees).  Actual is "(0.125,0.125)".
 
 - Metadata Name:     GridSpacingUnit
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            deg
   Data Source:       PGE
   Description: >
    Unit for GridSpacing.  Actual is "deg".
 
 - Metadata Name:     GridSpan
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Data Source:       PGE
   Description: >
    Span of L2G grid (in degrees).  Actual is "(-180,180,-90,90)".
 
 - Metadata Name:     GridSpanUnit
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            deg
   Data Source:       PGE
   Description: >
    Unit for GridSpan.  Actual is "deg".
 
 - Metadata Name:     MaximumNumberOfCandidatesPerGridCell
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     15
   Data Source:       PGE
   Description: >
    The maximum number of L2 scenes per cell in the L2G grid (this can be as
    large as 8).
 
 - Metadata Name:     MinimumNumberOfCandidatesPerGridCell
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     8
   Data Source:       PGE
   Description: >
    The minimum number of L2 scenes per cell in the L2G grid (this is typically
    0, because empty L2G grid cells are quite common).
 
 - Metadata Name:     NumberOfEmptyGridCells
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     4147200
   Data Source:       PGE
   Description: >
    The number of cells in the L2G grid that do not contain any L2 scenes.
 
 - Metadata Name:     NumberOfDuplicateScenesAcceptedIntoGrid
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     1500000
   Data Source:       PGE
   Description: >
    The number of L2 scenes accepted into L2G grid cells that already contain
    one or more L2 scenes.
 
 - Metadata Name:     NumberOfGridCells
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     4147200
   Data Source:       PGE
   Description:       The total number of cells in the L2G grid.
 
 - Metadata Name:     NumberOfLatitudesInGrid
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     1440
   Data Source:       PGE
   Description:       The number of latitude bins in the L2G grid.
 
 - Metadata Name:     NumberOfLongitudesInGrid
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     2880
   Data Source:       PGE
   Description:       The number of longitude bins in the L2G grid.
 
 - Metadata Name:     NumberOfMultiplyPopulatedGridCells
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     4147200
   Data Source:       PGE
   Description: >
    The number of cells in the L2G grid that contain two or more L2 scenes.
 
 - Metadata Name:     NumberOfPopulatedGridCells
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     4147200
   Data Source:       PGE
   Description: >
    The number of cells in the L2G grid that contain one or more L2 scenes.
 
 - Metadata Name:     NumberOfScenesAcceptedIntoGrid
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     1500000
   Data Source:       PGE
   Description:       The number of L2 scenes accepted into the L2G grid.
 
 - Metadata Name:     NumberOfScenesConsideredForGrid
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     1500000
   Data Source:       PGE
   Description:       The number of L2 scenes considered for the L2G grid.
 
 - Metadata Name:     NumberOfScenesRejectedFromGrid
   Mandatory:         T
   Data Type:         HE5T_NATIVE_INT
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     1500000
   Data Source:       PGE
   Description:       The number of L2 scenes rejected from the L2G grid.
 
 - Metadata Name:     Projection
   Mandatory:         T
   Data Type:         HE5T_NATIVE_CHAR
   Number of Values:  1
   Valids:            Geographic
   Data Source:       PGE
   Description: >
    The map projection of the L2G grid.  Actual is "Geographic" (see
    Section 6.2 of Reference 3).
 
Grid Dimensions:
 
 - Dimension Name:    nCandidate
   Data Type:         HE5T_NATIVE_INT
   Dimension Type:    FIXED
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     8
   Data Source:       PGE
   Description: >
    The L2-candidate-scenes dimension of the L2G grid.  The size of this
    dimension is currently set at 8.
 
 - Dimension Name:    XDim
   Data Type:         HE5T_NATIVE_INT
   Dimension Type:    FIXED
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     2880
   Data Source:       PGE
   Description: >
    The longitudes dimension of the L2G grid.  There are currently 2880
    0.125-degree-wide bins between longitudes -180.0 and 180.0 degrees.
 
 - Dimension Name:    YDim
   Data Type:         HE5T_NATIVE_INT
   Dimension Type:    FIXED
   Number of Values:  1
   Minimum Value:     1
   Maximum Value:     1440
   Data Source:       PGE
   Description: >
    The latitudes dimension of the L2G grid.  There are currently 1440
    0.125-degree-wide bins between latitudes -90.0 and 90.0 degrees.

Geolocation Fields:
 
 - Field Name:               GroundPixelQualityFlags
   Data Type:                HE5T_NATIVE_UINT16
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            65534
   Missing Value:            65535
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Ground Pixel Quality Flags
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The ground pixel quality flags for each L2 candidate scene in each L2G grid
    cell:
 
    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 5 for more details.)

 - Field Name:               Latitude
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -90.0
   Maximum Value:            90.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg
   Data Source:              L2
   Title:                    Geodetic Latitude
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The geodetic latitude (in degrees) on the ground at the center of each L2
    candidate scene in each L2G grid cell.
 
 - Field Name:               LineNumber
   Data Type:                HE5T_NATIVE_INT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            1
   Maximum Value:            1700
   Missing Value:            -2000000000
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Line Number of Candidate Scene
   Unique Field Definition:  OMI-Specific
   Description: >
    The line number for each L2 candidate scene in each L2G grid cell.

 - Field Name:               Longitude
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -180.0
   Maximum Value:            180.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg
   Data Source:              L2
   Title:                    Geodetic Longitude
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The geodetic longitude (in degrees) on the ground at the center of each L2
    candidate scene in each L2G grid cell.
 
 - Field Name:               NumberOfCandidateScenes
   Data Type:                HE5T_NATIVE_INT
   Dimensions:               YDim,XDim
   Minimum Value:            0
   Maximum Value:            8
   Missing Value:            0
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              PGE
   Title:                    Number of Candidate Scenes
   Unique Field Definition:  OMI-Specific
   Description: >
    The number of L2 candidate scenes in each L2G grid cell.
 
 - Field Name:               OrbitNumber
   Data Type:                HE5T_NATIVE_INT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            1
   Maximum Value:            999999
   Missing Value:            -2000000000
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Orbit Number of Candidate Scene
   Unique Field Definition:  OMI-Specific
   Description: >
    The orbit number for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               PathLength
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            2.0
   Maximum Value:            100.0
   Missing Value:            1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              PGE
   Title:                    Path Length
   Unique Field Definition:  OMI-Specific
   Description: >
    The path length [= sec(solar zenith angle) + sec(viewing zenith angle)] for
    each L2 candidate scene in each L2G grid cell.

 - Field Name:               RelativeAzimuthAngle
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -180.0
   Maximum Value:            180.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg(EastofNorth)
   Data Source:              L2
   Title:                    Relative Azimuth Angle (sun + 180 - view)
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The relative (sun + 180 - view) azimuth angle (in degrees) on the ground at
    the center of each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               SceneNumber
   Data Type:                HE5T_NATIVE_INT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            1
   Maximum Value:            60
   Missing Value:            -2000000000
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Scene Number of Candidate Scene
   Unique Field Definition:  OMI-Specific
   Description: >
    The cross-track ground-pixel number for each L2 candidate scene in each L2G
    grid cell.

 - Field Name:               SecondsInDay
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            86401.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    s
   Data Source:              L2
   Title:                    Seconds after UTC midnight
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The time after UTC midnight (in seconds) for each L2 candidate scene in each
    L2G grid cell.
 
 - Field Name:               SolarAzimuthAngle
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -180.0
   Maximum Value:            180.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg(EastofNorth)
   Data Source:              L2
   Title:                    Solar Azimuth Angle
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The solar azimuth angle (in degrees) defined East-of-North on the ground at
    the center of each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               SolarZenithAngle
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            180.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg
   Data Source:              L2
   Title:                    Solar Zenith Angle
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The solar zenith angle (in degrees) on the ground at the center of each L2
    candidate scene in each L2G grid cell.
 
 - Field Name:               SpacecraftAltitude
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            4.0e+05
   Maximum Value:            9.0e+05
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    m
   Data Source:              L2
   Title:                    Spacecraft Altitude
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    Spacecraft altitude (in m) for each L2 candidate scene in each L2G grid
    cell.

 - Field Name:               SpacecraftLatitude
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -90.0
   Maximum Value:            90.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg
   Data Source:              L2
   Title:                    Spacecraft Latitude
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    Spacecraft latitude (in degrees) for each L2 candidate scene in each L2G
    grid cell.

 - Field Name:               SpacecraftLongitude
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -180.0
   Maximum Value:            180.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg
   Data Source:              L2
   Title:                    Spacecraft Longitude
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    Spacecraft longitude (in degrees) for each L2 candidate scene in each L2G
    grid cell.

 - Field Name:               TerrainHeight
   Data Type:                HE5T_NATIVE_INT16
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -200
   Maximum Value:            10000
   Missing Value:            -32767
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    m
   Data Source:              L2
   Title:                    Terrain Height
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The terrain height (in meters) at the center of each L2 candidate scene in
    each L2G grid cell.

 - Field Name:               Time
   Data Type:                HE5T_NATIVE_DOUBLE
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -5.0e+09
   Maximum Value:            1.0e+10
   Missing Value:            -1.2676506002282294e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    s
   Data Source:              L2
   Title:                    Time at Start of Scan (TAI93)
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The TAI93 time (in seconds) for each L2 candidate scene in each L2G grid
    cell.
 
 - Field Name:               ViewingAzimuthAngle
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -180.0
   Maximum Value:            180.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg(EastofNorth)
   Data Source:              L2
   Title:                    Viewing Azimuth Angle
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    Viewing azimuth angle (in degrees) defined East-of-North on the ground at
    the center of each L2 candidate scene in each L2G grid cell.

 - Field Name:               ViewingZenithAngle
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            70.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    deg
   Data Source:              L2
   Title:                    Viewing Zenith Angle
   Unique Field Definition:  TOMS-Aura-Shared
   Description: >
    The viewing zenith angle (in degrees) on the ground at the center of each L2
    candidate scene in each L2G grid cell.
 
Data Fields:

 - Field Name:               AlgorithmFlag_PBL
   Data Type:                HE5T_NATIVE_UINT8
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            20
   Missing Value:            255
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Algorithm Flag for PBL
   Unique Field Definition:  OMI-Specific
   Description: >
    The PBL processing flag indicating the algorithm path for each L2 candidate
    scene in each L2G grid cell:
      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.

 - Field Name:               AlgorithmFlag_STL
   Data Type:                HE5T_NATIVE_UINT8
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            20
   Missing Value:            255
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Algorithm Flag for STL
   Unique Field Definition:  OMI-Specific
   Description: >
    The STL processing flag indicating the algorithm path for each L2 candidate
    scene in each L2G grid cell:
      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.

 - Field Name:               AlgorithmFlag_TRL
   Data Type:                HE5T_NATIVE_UINT8
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            20
   Missing Value:            255
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Algorithm Flag for TRL
   Unique Field Definition:  OMI-Specific
   Description: >
    The TRL processing flag indicating the algorithm path for each L2 candidate
    scene in each L2G grid cell:
      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.
 
 - Field Name:               AlgorithmFlag_TRM
   Data Type:                HE5T_NATIVE_UINT8
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            20
   Missing Value:            255
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Algorithm Flag for TRM
   Unique Field Definition:  OMI-Specific
   Description: >
    The TRM processing flag indicating the algorithm path for each L2 candidate
    scene in each L2G grid cell:
      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.

 - Field Name:               ChiSquareLfit
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            100.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Chi-square for least square fit
   Unique Field Definition:  OMI-Specific
   Description: >
    The Chi square for the STL linear least square fit for each L2 candidate
    scene in each L2G grid cell.
 
 - Field Name:               CloudPressure
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            1013.25
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    hPa
   Data Source:              L2
   Title:                    Effective Cloud Pressure
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The effective cloud pressure (in hPa) for each L2 candidate scene in each
    L2G grid cell.
 
 - Field Name:               ColumnAmountO3
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            50.0
   Maximum Value:            700.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Best Total Ozone Solution
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The best total ozone solution (in DU) from OMTO3 for each L2 candidate scene
    in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_PBL
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (PBL)
   Unique Field Definition:  OMI-Specific
   Description: >
    The retrieved vertical column amount SO2 with a boundary-layer SO2
    profile averaged from in-situ aircraft measurments over the eastern
    United States for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_STL
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (STL)
   Unique Field Definition:  OMI-Specific
   Description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile
    similar to the standard ozone profile in Umkehr layer 3 (roughly between
    15 and 20 km altitude) for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_TRL
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (TRL)
   Unique Field Definition:  OMI-Specific
   Description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile
    similar to the standard ozone profile in Umkehr layer 0 (roughly between
    0 and 5 km altitude) for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_TRM
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (TRM)
   Unique Field Definition:  OMI-Specific
   Description: >
    The retrieved vertical column amount SO2 with a prescribed SO2 profile
    similar to the standard ozone profile in Umkehr layer 1 (roughly between
    5 and 10 km altitude) for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_PBLbrd
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (PBL)
   Unique Field Definition:  OMI-Specific
   Description: >
    The BRD retrieved vertical column amount SO2 with a boundary-layer SO2
    profile averaged from in-situ aircraft measurments over the eastern
    United States for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_STLbrd
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (STL)
   Unique Field Definition:  OMI-Specific
   Description: >
    The BRD retrieved vertical column amount SO2 with a prescribed SO2 profile
    similar to the standard ozone profile in Umkehr layer 3 (roughly between
    15 and 20 km altitude) for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               ColumnAmountSO2_TRMbrd
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -10.0
   Maximum Value:            2000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Vertical Column Amount SO2 (TRM)
   Unique Field Definition:  OMI-Specific
   Description: >
    The BRD retrieved vertical column amount SO2 with a prescribed SO2 profile
    similar to the standard ozone profile in Umkehr layer 1 (roughly between
    5 and 10 km altitude) for each L2 candidate scene in each L2G grid cell.
 
 - Field Name:               deltaO3
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -1000.0
   Maximum Value:            1000.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    DU
   Data Source:              L2
   Title:                    Ozone adjustment from least square fit
   Unique Field Definition:  OMI-Specific
   Description: >
    The ozone adjustment derived from fitting method for each L2 candidate scene
    in each L2G grid cell.

 - Field Name:               deltaRefl
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -1.0
   Maximum Value:            1.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Reflectivity adjustment from least square fit
   Unique Field Definition:  OMI-Specific
   Description: >
    The zeroth order coefficient R331 of reflectivity for each L2 candidate scene
    in each L2G grid cell [reflectivity vs. wavelength is described by a second
    order polynomial, R = R331 + c1*(lambda - 331) + c2*(lambda - 331)**2].
 
 - Field Name:               QualityFlags_PBL
   Data Type:                HE5T_NATIVE_UINT16
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            65534
   Missing Value:            65535
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Quality Flags for PBL
   Unique Field Definition:  OMI-Specific
   Description: >
    The quality flags PBL for each L2 candidate scene in each L2G grid cell:
 
    Bits 0 to 3 and 7 to 10 are flags that are set to 0 for FALSE (good value),
    or 1 for TRUE (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 DU)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
 
    Bits 4 to 6 together represents one number with value ranging from 0 to 7,
    and is equal to the first 4 bits of the OMTO3 QualityFlags. 
 
    Bits 11 to 15 are reserved for future use (currently set to 0).

 - Field Name:               QualityFlags_STL
   Data Type:                HE5T_NATIVE_UINT16
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            65534
   Missing Value:            65535
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Quality Flags for STL
   Unique Field Definition:  OMI-Specific
   Description: >
    The quality flags STL for each L2 candidate scene in each L2G grid cell:
 
    Bits 0 to 3 and 7 to 10 are flags that are set to 0 for FALSE (good value),
    or 1 for TRUE (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 DU)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
 
    Bits 4 to 6 together represents one number with value ranging from 0 to 7,
    and is equal to the first 4 bits of the OMTO3 QualityFlags. 
 
    Bits 11 to 15 are reserved for future use (currently set to 0).

 - Field Name:               QualityFlags_TRL
   Data Type:                HE5T_NATIVE_UINT16
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            65534
   Missing Value:            65535
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Quality Flags for TRL
   Unique Field Definition:  OMI-Specific
   Description: >
    The quality flags TRL for each L2 candidate scene in each L2G grid cell:
 
    Bits 0 to 3 and 7 to 10 are flags that are set to 0 for FALSE (good value),
    or 1 for TRUE (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 DU)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
 
    Bits 4 to 6 together represents one number with value ranging from 0 to 7,
    and is equal to the first 4 bits of the OMTO3 QualityFlags. 
 
    Bits 11 to 15 are reserved for future use (currently set to 0).
 
 - Field Name:               QualityFlags_TRM
   Data Type:                HE5T_NATIVE_UINT16
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0
   Maximum Value:            65534
   Missing Value:            65535
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Quality Flags for TRM
   Unique Field Definition:  OMI-Specific
   Description: >
    The quality flags TRM for each L2 candidate scene in each L2G grid cell:
 
    Bits 0 to 3 and 7 to 10 are flags that are set to 0 for FALSE (good value),
    or 1 for TRUE (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 DU)
      Bit  2 - UV Aerosol Index > 3
      Bit  3 - Reflectivity at 331 nm > 15%
      Bit  7 - Descending
      Bit  8 - reflectivity error
      Bit  9 - geolocation error
      Bit 10 - L1B warning, error, or missing
 
    Bits 4 to 6 together represents one number with value ranging from 0 to 7,
    and is equal to the first 4 bits of the OMTO3 QualityFlags. 
 
    Bits 11 to 15 are reserved for future use (currently set to 0).
 
 - Field Name:               RadiativeCloudFraction
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            1.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Radiative Cloud Fraction
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The radiative cloud fraction (= fc * lc331 / lm331) for each L2 candidate
    scene in each L2G grid cell.
 
 - Field Name:               Reflectivity331
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -15.0
   Maximum Value:            115.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    "%"
   Data Source:              L2
   Title:                    Effective Surface Reflectivity at 331 nm
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The effective surface reflectivity at 331 nm (in percent) for each L2
    candidate scene in each L2G grid cell.

 - Field Name:               Rlambda1st
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -1.0
   Maximum Value:            1.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    1st order R vs. wavelength coefficient
   Unique Field Definition:  OMI-Specific
   Description: >
    The first order coefficient c2 of reflectivity for each L2 candidate scene
    in each L2G grid cell [reflectivity vs. wavelength is described by a second
    order polynomial, R = R331 + c1*(lambda - 331) + c2*(lambda - 331)**2].

 - Field Name:               Rlambda2nd
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -1.0
   Maximum Value:            1.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    2nd order R vs. wavelength coefficient
   Unique Field Definition:  OMI-Specific
   Description: >
    The second order coefficient c2 of reflectivity for each L2 candidate scene
    in each L2G grid cell [reflectivity vs. wavelength is described by a second
    order polynomial, R = R331 + c1*(lambda - 331) + c2*(lambda - 331)**2].

 - Field Name:               SO2indexP1
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -30.0
   Maximum Value:            30.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Pair 1 SO2 Index
   Unique Field Definition:  OMI-Specific
   Description: >
    The Pair 1 (311.9 and 310.8 nm) SO2 Index for each L2 candidate scene in
    each L2G grid cell.

 - Field Name:               SO2indexP2
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -30.0
   Maximum Value:            30.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Pair 2 SO2 Index
   Unique Field Definition:  OMI-Specific
   Description: >
    The Pair 2 (313.2 and 311.9 nm) SO2 Index for each L2 candidate scene in
    each L2G grid cell.

 - Field Name:               SO2indexP3
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -30.0
   Maximum Value:            30.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    Pair 3 SO2 Index
   Unique Field Definition:  OMI-Specific
   Description: >
    The Pair 3 (314.4 and 313.2 nm) SO2 Index for each L2 candidate scene in
    each L2G grid cell.

 - Field Name:               TerrainPressure
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            0.0
   Maximum Value:            1013.25
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    hPa
   Data Source:              L2
   Title:                    Terrain Pressure
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The terrain pressure (in hPa) at the center of each L2 candidate scene in
    each L2G grid cell.

 - Field Name:               UVAerosolIndex
   Data Type:                HE5T_NATIVE_FLOAT
   Dimensions:               nCandidate,YDim,XDim
   Minimum Value:            -50.0
   Maximum Value:            50.0
   Missing Value:            -1.2676506e+30
   Offset:                   0.0
   Scale Factor:             1.0
   Units:                    NoUnits
   Data Source:              L2
   Title:                    UV Aerosol Index
   Unique Field Definition:  TOMS-OMI-Shared
   Description: >
    The UV aerosol index for each L2 candidate scene in each L2G grid cell.
 
Core Metadata:

 - Metadata Name:     AssociatedInstrumentShortName
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids:            OMI
   Data Source:       MCF
   Description:       Actual is "OMI".

 - Metadata Name:     AssociatedPlatformShortName
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids:            Aura
   Data Source:       MCF
   Description:       Actual is "Aura".

 - Metadata Name:     AssociatedSensorShortName
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids:            CCD Ultra Violet,CCD Visible
   Data Source:       MCF
   Description:       Actual is "CCD Ultra Violet".

 - Metadata Name:     AutomaticQualityFlag
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids:            Passed,Suspect,Failed
   Data Source:       PGE
   Description:       Actual is "Failed".
 
 - Metadata Name:     AutomaticQualityFlagExplanation
   Mandatory:         T
   Data Type:         VA255
   Number of Values:  1
   Data Source:       PGE
   Description: >
    Actual is "An automatic quality investigation has not yet been devised."
 
 - Metadata Name:     DayNightFlag
   Mandatory:         T
   Data Type:         VA5
   Number of Values:  1
   Valids:            Day,Night,Both
   Data Source:       MCF
   Description:       Actual is "Day".
 
 - Metadata Name:     EastBoundingCoordinate
   Mandatory:         T
   Data Type:         LF
   Number of Values:  1
   Minimum Value:     -180.0
   Maximum Value:     180.0
   Data Source:       PGE
   Description: >
    The terrestrial longitude (in degrees) of the easternmost data in the L2G
    granule, which is typically 180.0 degrees.

 - Metadata Name:     EquatorCrossingDate
   Mandatory:         T
   Data Type:         D
   Number of Values:  1,16
   Data Source:       L2
   Description: >
    The date of the ascending equator crossing for each L2 input granule.

 - Metadata Name:     EquatorCrossingLongitude
   Mandatory:         T
   Data Type:         LF
   Number of Values:  1,16
   Minimum Value:     -180.0
   Maximum Value:     180.0
   Data Source:       L2
   Description: >
    The terrestrial longitude of the ascending equator crossing for each L2
    input granule.

 - Metadata Name:     EquatorCrossingTime
   Mandatory:         T
   Data Type:         T
   Number of Values:  1,16
   Data Source:       L2
   Description: >
    The time of the ascending equator crossing for each L2 input granule.

 - Metadata Name:     InputPointer
   Mandatory:         T
   Data Type:         VA255
   Number of Values:  1,16
   Data Source:       PCF
   Description: >
    A list of the L2 input granules.  Example is
    ("OMI-Aura_L2-OMSO2_2006m1112t2240-o12388_v002-2006m1113t182218.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t0019-o12389_v002-2006m1113t182705.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t0157-o12390_v002-2006m1113t182709.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t0336-o12391_v002-2006m1113t175625.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t0515-o12392_v002-2006m1113t175625.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t0654-o12393_v002-2006m1113t202839.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t0833-o12394_v002-2006m1113t220505.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t1012-o12395_v002-2006m1113t220052.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t1151-o12396_v002-2006m1114t172624.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t1330-o12397_v002-2006m1114t174114.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t1508-o12398_v002-2006m1114t174530.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t1647-o12399_v002-2006m1114t172518.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t1826-o12400_v002-2006m1114t171452.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t2005-o12401_v002-2006m1114t171451.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t2144-o12402_v002-2006m1114t171454.he5",
     "OMI-Aura_L2-OMSO2_2006m1113t2323-o12403_v002-2006m1114t171603.he5").

 - Metadata Name:     LocalGranuleID
   Mandatory:         T
   Data Type:         VA80
   Number of Values:  1
   Data Source:       PGE
   Description: >
    Example is "OMI-Aura_L2G-OMSO2G_2006m1113_v002-2007m0706t212329.he5"
    (see Appendix E of Reference 4).

 - Metadata Name:     LocalityValue
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Data Source:       MCF
   Description:       Actual is "Global".

 - Metadata Name:     LOCALVERSIONID
   Mandatory:         T
   Data Type:         VA60
   Number of Values:  1
   Data Source:       PCF
   Description: >
    MD5 fingerprint of the HDF product file.  Example valids are
    "RFC1321 MD5 = not yet calculated" and "RFC1321 MD5 = [0-9,a-f]{32}".
 
 - Metadata Name:     NorthBoundingCoordinate
   Mandatory:         T
   Data Type:         LF
   Number of Values:  1
   Minimum Value:     -90.0
   Maximum Value:     90.0
   Data Source:       PGE
   Description: >
    The terrestrial latitude (in degrees) of the northernmost data in the L2G
    granule, which typically lies in the range from 65.0 to 90.0 degrees.

 - Metadata Name:     OperationalQualityFlag
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids: >
    Passed,Failed,Being Investigated,Not Investigated,Inferred Passed,
    Inferred Failed,Suspect
   Data Source:       PGE
   Description: >
    Actual is "Passed".

 - Metadata Name:     OperationalQualityFlagExplanation
   Mandatory:         T
   Data Type:         VA255
   Number of Values:  1
   Data Source:       PGE
   Description: >
    Actual is "This granule passed operational tests that were administered
    by the OMI SIPS.  QA metadata was extracted and the file was successfully
    read using standard HDF-EOS utilities.".

 - Metadata Name:     OrbitNumber
   Mandatory:         T
   Data Type:         I
   Number of Values:  1,16
   Minimum Value:     1
   Maximum Value:     999999
   Data Source:       L2
   Description:       The OMI orbit number for each L2 input granule.

 - Metadata Name:     ParameterName
   Mandatory:         T
   Data Type:         VA40
   Number of Values:  1
   Valids:            Total Column Sulphur Dioxide
   Data Source:       PGE
   Description: >
    The measured science parameter expressed in the L2G granule.  Actual is
    "Total Column Sulphur Dioxide".

 - Metadata Name:     PGEVERSION
   Mandatory:         T
   Data Type:         VA10
   Number of Values:  1
   Data Source:       PCF
   Description:       Example is "0.9.80" (see Appendix K of Reference 4).

 - Metadata Name:     ProductionDateTime
   Mandatory:         T
   Data Type:         DT
   Number of Values:  1
   Data Source:       TK
   Description:       The date and time of the Level 2G processing.
 
 - Metadata Name:     QAPercentCloudCover
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     100
   Data Source:       PGE
   Description: >
    An average for the entire L2G granule of the percent of data that have
    cloud cover.

 - Metadata Name:     QAPercentMissingData
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     100
   Data Source:       PGE
   Description: >
    An average for the entire L2G granule of the percent of missing Level 1B
    calibrated radiance data.

 - Metadata Name:     QAPercentOutOfBoundsData
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     100
   Data Source:       PGE
   Description: >
    An average for the entire L2G granule of the percent of data that are out
    of bounds.
 
 - Metadata Name:     RangeBeginningDate
   Mandatory:         T
   Data Type:         D
   Number of Values:  1
   Data Source:       PGE
   Description:       The year, month and day when the L2G granule begins.

 - Metadata Name:     RangeBeginningTime
   Mandatory:         T
   Data Type:         T
   Number of Values:  1
   Data Source:       PGE
   Description: >
    The hour, minute, second and fraction of a second when the L2G granule
    begins.

 - Metadata Name:     RangeEndingDate
   Mandatory:         T
   Data Type:         D
   Number of Values:  1
   Data Source:       PGE
   Description:       The year, month and day when the L2G granule ends.

 - Metadata Name:     RangeEndingTime
   Mandatory:         T
   Data Type:         T
   Number of Values:  1
   Data Source:       PGE
   Description: >
    The hour, minute, second and fraction of a second when the L2G granule ends.

 - Metadata Name:     REPROCESSINGACTUAL
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids: >
    processed 1 time,processed 2 times,processed 3 times,processed 4 times
   Data Source:       PCF
   Description: >
    An indication of what reprocessing has been performed on the L2G granule.
 
 - Metadata Name:     ReprocessingPlanned
   Mandatory:         T
   Data Type:         VA40
   Number of Values:  1
   Valids: >
    no further update anticipated,further update is anticipated,
    further update anticipated using enhanced PGE
   Data Source:       DP
   Description:       Actual is "further update is anticipated".

 - Metadata Name:     ScienceQualityFlag
   Mandatory:         T
   Data Type:         VA20
   Number of Values:  1
   Valids: >
    Passed,Failed,Being Investigated,Not Investigated,Inferred Passed,
    Inferred Failed,Suspect
   Data Source:       DP
   Description:       Actual is "Not Investigated".

 - Metadata Name:     ScienceQualityFlagExplanation
   Mandatory:         T
   Data Type:         VA255
   Number of Values:  1
   Data Source:       DP
   Description: >
    Actual is "An updated science quality flag and explanation is put in the
    product .met file when a granule has been evaluated.  The flag value in
    this file, Not Investigated, is an automatic default that is put into
    every granule during production.".

 - Metadata Name:     ShortName
   Mandatory:         T
   Data Type:         VA8
   Number of Values:  1
   Valids:            OMSO2G
   Data Source:       MCF
   Description:       Actual is "OMSO2G".

 - Metadata Name:     SizeMBECSDataGranule
   Mandatory:         F
   Data Type:         LF
   Number of Values:  1
   Minimum Value:     0.0
   Maximum Value:     10000.0
   Data Source:       DSS
   Description: >
    The volume of data (in MB) contained in the L2G granule (this Metadata will
    not appear in the L2G granule).
 
 - Metadata Name:     SouthBoundingCoordinate
   Mandatory:         T
   Data Type:         LF
   Number of Values:  1
   Minimum Value:     -90.0
   Maximum Value:     90.0
   Data Source:       PGE
   Description: >
    The terrestrial latitude (in degrees) of the southernmost data in the L2G
    granule, which typically lies in the range from -90.0 to -65.0 degrees.

 - Metadata Name:     VERSIONID
   Mandatory:         T
   Data Type:         SI
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     999
   Data Source:       PCF
   Description:       Example is 3.
 
 - Metadata Name:     WestBoundingCoordinate
   Mandatory:         T
   Data Type:         LF
   Number of Values:  1
   Minimum Value:     -180.0
   Maximum Value:     180.0
   Data Source:       PGE
   Description: >
    The terrestrial longitude (in degrees) of the westernmost data in the L2G
    granule, which is typically -180.0 degrees.

Product Specific Attributes:

 - Metadata Name:     NrMeasurements
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     30000
   Data Source:       PGE
   Description: >
    The number of measurements used to create the L2G granule.

 - Metadata Name:     NrSpatialZoom
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     0
   Data Source:       PGE
   Description: >
    The number of measurements in spatial zoom mode.  Actual is 0, because
    zoom measurements are excluded from the L2G granule.

 - Metadata Name:     NrSpectralZoom
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     0
   Data Source:       PGE
   Description: >
    The number of measurements in spectral zoom mode.  Actual is 0, because
    zoom measurements are excluded from the L2G granule.

 - Metadata Name:     NrZoom
   Mandatory:         T
   Data Type:         I
   Number of Values:  1
   Minimum Value:     0
   Maximum Value:     0
   Data Source:       PGE
   Description: >
    The number of measurements in zoom modes.  Actual is 0, because zoom
    measurements are excluded from the L2G granule.

 - Metadata Name:     SolarEclipse
   Mandatory:         T
   Data Type:         VA10
   Number of Values:  1
   Valids:            TRUE,FALSE
   Data Source:       PGE
   Description: >
    The indicator that during part of the measurements a solar eclipse occurred.

 - Metadata Name:     SouthAtlanticAnomalyCrossing
   Mandatory:         T
   Data Type:         VA10
   Number of Values:  1
   Valids:            TRUE,FALSE
   Data Source:       PGE
   Description: >
    The indicator that during part of the measurements the spacecraft was
    in the South Atlantic Anomaly.

Archived Metadata:

 - Metadata Name:     ESDTDescriptorRevision
   Mandatory:         T
   Data Type:         VA10
   Number of Values:  1
   Data Source:       MCF
   Description: >
    The version of the ESDT descriptor file as determined by ECS.

 - Metadata Name:     LongName
   Mandatory:         T
   Data Type:         VA80
   Number of Values:  1
   Valids: >
    OMI/Aura Sulfur Dioxide (SO2) Total Column Daily L2 Global 0.125deg Lat/Lon Grid
   Data Source:       MCF
   Description: >
    Actual is
    "OMI/Aura Sulfur Dioxide (SO2) Total Column Daily L2 Global 0.125deg Lat/Lon Grid".
 
References: >
 
  1. "OMSO2 README File"
     (In Preparation, February 2008)
 
  2. "Definition of OMI Grids for Level 3 and Level 4 Data Products"
     (OMI-Grids_L3L4, SD-OMIE-KNMI-443, 25 January 2005)

  3. "HDF-EOS Aura File Format Guidelines"
     (OMI-AURA-DATA-GUIDE, Version 2.12, 24 October 2006)

  4. "OMI Science Software Delivery Guide for Version 0.9"
     (OMI-SSDG-0.9.10, Version 0.9.10, 22 June 2005)

  5. "OMI GDPS Input/Output Data Specification (IODS) Volume 2"
     (OMI-GDPS-IODS-2, SD-OMIE-7200-DS-467, 8 November 2004)
 
  6. "OMSO2G ECS Metadata Requirements"
     (OMI-OMSO2G_Metadata_RD, Version 0.9.45, In Preparation)

  7. "Release 6A Implementation Earth Science Data Model for the ECS Project"
     (420-TP-022-002, June 2001)
     (http://edhs1.gsfc.nasa.gov/waisdata/rel6/html/tp4202202.html and
      http://edhs1.gsfc.nasa.gov/waisdata/rel6/html/tp42022_adds.html)