BEAT-II Record: OMI_L2_OMTO3

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of OMI_L2_OMTO3 data. The 'default' column indicates whether the specified data item is included in the ingestion by default or not. You can change which data items are ingested by making use of the include and exclude filter options (see below).

field nametypedimensionsdefaultdescription
typestring includedreference to the type of data in this record
timedouble[main]includedThe time of the measurement (in seconds since 2000-01-01 00:00:00)
latitudedouble[main]includedThe center latitude for a ground pixel
longitudedouble[main]includedThe center longitude for a ground pixel
corner_latitudedouble[main, 4]includedThe corner latitude values for a ground pixel
corner_longitudedouble[main, 4]includedThe corner longitude values for a ground pixel
o3_columndouble[main]includedOzone vertical column density
o3_column_unitstring includedDU
o3_column_validityint32[main]excludedFlags describing the ozone vertical column processing quality
cloud_fractiondouble[main]excludedEffective or radiative cloud fraction
pressure_clouddouble[main]excludedEffective cloud pressure
pressure_cloud_unitstring excludedhPa
pressure_cloud_topdouble[main]excludedCloud top pressure
pressure_cloud_top_unitstring excludedhPa
solar_zenith_angle_wgs84double[main]excludedSolar zenith angle at WGS84 ellipsoid for center co-ordinate of the ground pixel
solar_azimuth_angle_wgs84double[main]excludedSolar azimuth angle at WGS84 ellipsoid for center co-ordinate of the ground pixel, defined Easth-of-North
viewing_zenith_angle_wgs84double[main]excludedViewing zenith angle at WGS84 ellipsoid for center co-ordinate of the ground pixel
viewing_azimuth_angle_wgs84double[main]excludedSolar azimuth angle at WGS84 ellipsoid for center co-ordinate of the ground pixel, defined Easth-of-North

Ingestion filter options

Ingestion filter options are passed as a ',' or ';' separated string to the ingestion function. Each filter option needs to be formulated as option_name=value[ value value] (some options accept more than one value). For example, if a product has filter options 'altitude_min' and 'time_min' you can provide a filter option string "latitude_min=30,time_min=2003-01-01" to get all measurements at or above 30km and on or after January 1st 2003.

option nametypedescription
includestringProvide a space-separated list of field names to ingest additional data items (i.e. fields that are not ingested by default). You can use the special case include=* to indicate that you want to ingest all available data items.
excludestringProvide a space-separated list of field names that you don't want ingested. Mind that the exclude filter is processed after the include filter.
time_mintime*Only include elements for which the value is greater than or equal to the provided filter option value
time_maxtime*Only include elements for which the value is less than or equal to the provided filter option value
timetime*Only include elements that match the list of given filter option values
latitude_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
latitude_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
latitudedoubleOnly include elements that match the list of given filter option values
longitude_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
longitude_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
longitudedoubleOnly include elements that match the list of given filter option values
o3_column_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
o3_column_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
o3_columndoubleOnly include elements that match the list of given filter option values
o3_column_validity_minintegerOnly include elements for which the value is greater than or equal to the provided filter option value
o3_column_validity_maxintegerOnly include elements for which the value is less than or equal to the provided filter option value
o3_column_validityintegerOnly include elements that match the list of given filter option values
cloud_fraction_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
cloud_fraction_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
cloud_fractiondoubleOnly include elements that match the list of given filter option values
pressure_cloud_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
pressure_cloud_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
pressure_clouddoubleOnly include elements that match the list of given filter option values
pressure_cloud_top_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
pressure_cloud_top_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
pressure_cloud_topdoubleOnly include elements that match the list of given filter option values
solar_zenith_angle_wgs84_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_wgs84_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle_wgs84doubleOnly include elements that match the list of given filter option values
solar_azimuth_angle_wgs84_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
solar_azimuth_angle_wgs84_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
solar_azimuth_angle_wgs84doubleOnly include elements that match the list of given filter option values
viewing_zenith_angle_wgs84_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
viewing_zenith_angle_wgs84_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
viewing_zenith_angle_wgs84doubleOnly include elements that match the list of given filter option values
viewing_azimuth_angle_wgs84_mindoubleOnly include elements for which the value is greater than or equal to the provided filter option value
viewing_azimuth_angle_wgs84_maxdoubleOnly include elements for which the value is less than or equal to the provided filter option value
viewing_azimuth_angle_wgs84doubleOnly include elements that match the list of given filter option values
cloud_fraction_variantstring'effective' (default) or 'radiative'

* Time values can be passed as either 'yyyy-mm-dd', 'yyyy-mm-ddThh:mm:ss', 'yyyy-mm-ddThh:mm:ss.uuuuuu' or a floating point value indicating the amount of seconds since 2000-01-01 00:00:00.

Mapping description

Below a description is provided on how each data item in the ingested record was retrieved from the product.

field namemapping description
time path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/Time[]
descriptionThe time converted from TAI93 to seconds since 2000-01-01T00:00:00
latitude path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/Latitude[]
longitude path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/Longitude[]
corner_latitude descriptionThe shape and size of each ground pixel is not included in the product. BEAT therefore provides its own approximation. The calculation is based on interpolation of the available center coordinates for each of the ground pixels. Each corner coordinate is determined by its four surrounding center coordinates. The corner coordinate is exactly at the intersection of the cross that can be made with these four points (each line of the cross is the minimal distance along the earth surface from one center coordinate to the other). In situations where a corner coordinate is not surrounded by four center coordinates (i.e. at the boundaries) virtual center coordinates are created by means of extrapolation. The virtual center coordinate is placed such that the distance to its nearest real center coordinate equals the distance between that nearest real center coordinate and the next center coordinate going further inwards. In mathematical notation: when c(i,m+1) is the virtual center coordinate and c(i,m) and c(i,m-1) are real center coordinates, then |c(i,m+1) - c(i,m)| = |c(i,m) - c(i,m-1)| and all three coordinates should lie on the same great circle. The four virtual coordinates that lie in the utmost corners of the boundaries are calculated by extrapolating in a diagonal direction (e.g. c(n+1,m+1) is calculated from c(n,m) and c(n-1,m-1))
corner_longitude descriptionThe shape and size of each ground pixel is not included in the product. BEAT therefore provides its own approximation. The calculation is based on interpolation of the available center coordinates for each of the ground pixels. Each corner coordinate is determined by its four surrounding center coordinates. The corner coordinate is exactly at the intersection of the cross that can be made with these four points (each line of the cross is the minimal distance along the earth surface from one center coordinate to the other). In situations where a corner coordinate is not surrounded by four center coordinates (i.e. at the boundaries) virtual center coordinates are created by means of extrapolation. The virtual center coordinate is placed such that the distance to its nearest real center coordinate equals the distance between that nearest real center coordinate and the next center coordinate going further inwards. In mathematical notation: when c(i,m+1) is the virtual center coordinate and c(i,m) and c(i,m-1) are real center coordinates, then |c(i,m+1) - c(i,m)| = |c(i,m) - c(i,m-1)| and all three coordinates should lie on the same great circle. The four virtual coordinates that lie in the utmost corners of the boundaries are calculated by extrapolating in a diagonal direction (e.g. c(n+1,m+1) is calculated from c(n,m) and c(n-1,m-1))
o3_column path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/ColumnAmountO3[]
o3_column_unit descriptionWill be set to "DU"
o3_column_validity path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/QualityFlags[]
cloud_fraction conditionV2 product
path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/CloudFraction[]
 
conditioncloud_fraction_variant=effective and V3 product
path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/fc[]
 
conditioncloud_fraction_variant=radiative and V3 product
path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/RadiativeCloudFraction[]
pressure_cloud conditionV3 product
path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/CloudPressure[]
pressure_cloud_unit conditionV3 product
descriptionWill be set to "hPa"
pressure_cloud_top conditionV2 product
path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Data_Fields/CloudTopPressure[]
pressure_cloud_top_unit conditionV2 product
descriptionWill be set to "hPa"
solar_zenith_angle_wgs84 path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/SolarZenithAngle[]
solar_azimuth_angle_wgs84 path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/SolarAzimuthAngle[]
viewing_zenith_angle_wgs84 path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/ViewingZenithAngle[]
viewing_azimuth_angle_wgs84 path/HDFEOS/SWATHS/OMI_Column_Amount_O3/Geolocation_Fields/ViewingAzimuthAngle[]