BEAT-II Record: IASI_L2

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of IASI_L2 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 name	type	dimensions	default	description
type	string		included	reference to the type of data in this record
time	double	[main]	included	The time of the measurement at end of integration time (in seconds since 2000-01-01 00:00:00)
latitude	double	[main]	included	Center latitude of the measurement
longitude	double	[main]	included	Center longitude of the measurement
corner_latitude	double	[main, 4]	included	Corner latitude of the measurement
corner_longitude	double	[main, 4]	included	Corner longitude of the measurement
o3_column	double	[main]	included*	Ozone vertical column mass density
o3_column_unit	string		included*	kg/m^2
n2o_column	double	[main]	excluded	N2O vertical column mass density
n2o_column_unit	string		excluded	kg/m^2
co_column	double	[main]	excluded	CO vertical column mass density
co_column_unit	string		excluded	kg/m^2
ch4_column	double	[main]	excluded	CH4 vertical column mass density
ch4_column_unit	string		excluded	kg/m^2
co2_column	double	[main]	excluded	CO2 vertical column mass density
co2_column_unit	string		excluded	kg/m^2
solar_zenith_angle_surface	double	[main]	excluded	Solar zenith angle at the surface
los_zenith_angle_surface	double	[main]	excluded	Line of sight zenith angle at the surface
solar_azimuth_angle_surface	double	[main]	excluded	Solar azimuth angle at the surface
los_azimuth_angle_surface	double	[main]	excluded	Line of sight azimuth angle at the surface
scan_subset_counter	uint8	[main]	excluded	The relative index (0-119) of this measurement within an MDR

^* Included by default only if no 'include' ingestion filter option was provided.

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 name	type	description
product_version	integer	If multiple product format versions for this product type exist, you can use this filter option to select from which ones data should be ingested (i.e. you can provide a space-separated list of allowed product format version numbers). The list of available version numbers for this product type can be found in the CODA Product Format Definitions documentation.
include	string	Provide 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.
exclude	string	Provide 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_min	time*	Only include elements for which the value is greater than or equal to the provided filter option value
time_max	time*	Only include elements for which the value is less than or equal to the provided filter option value
time	time*	Only include elements that match the list of given filter option values
latitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
latitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
latitude	double	Only include elements that match the list of given filter option values
longitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
longitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
longitude	double	Only include elements that match the list of given filter option values
o3_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
o3_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
o3_column	double	Only include elements that match the list of given filter option values
n2o_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
n2o_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
n2o_column	double	Only include elements that match the list of given filter option values
co_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
co_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
co_column	double	Only include elements that match the list of given filter option values
ch4_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
ch4_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
ch4_column	double	Only include elements that match the list of given filter option values
co2_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
co2_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
co2_column	double	Only include elements that match the list of given filter option values
solar_zenith_angle_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle_surface	double	Only include elements that match the list of given filter option values
los_zenith_angle_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_zenith_angle_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_zenith_angle_surface	double	Only include elements that match the list of given filter option values
solar_azimuth_angle_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_azimuth_angle_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_azimuth_angle_surface	double	Only include elements that match the list of given filter option values
los_azimuth_angle_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_azimuth_angle_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_azimuth_angle_surface	double	Only include elements that match the list of given filter option values
scan_subset_counter_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
scan_subset_counter_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
scan_subset_counter	integer	Only include elements that match the list of given filter option values

^* 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 name	mapping description
time	path	/MDR[]/MDR/RECORD_HEADER/RECORD_START_TIME
	description	The time for a scan is the MDR start time + the scan id (0..29) times 8 / 37. Each part of the 2x2 matrix of a scan will get assigned the same measurement time (i.e. there are 30 unique time values per mdr)
latitude	path	/MDR[]/MDR/EARTH_LOCATION[,0]
longitude	path	/MDR[]/MDR/EARTH_LOCATION[,1]
corner_latitude	path	/MDR[]/MDR/EARTH_LOCATION[]
	description	The corner coordinates are rough estimates of the circle areas for the scan elements. The size of a scan element (in a certain direction) is taken to be half the distance, from center to center, from a scan element to its nearest neigbouring scan element
corner_longitude	path	/MDR[]/MDR/EARTH_LOCATION[]
	description	The corner coordinates are rough estimates of the circle areas for the scan elements. The size of a scan element (in a certain direction) is taken to be half the distance, from center to center, from a scan element to its nearest neigbouring scan element
o3_column	path	/MDR[]/MDR/INTEGRATED_OZONE[]
o3_column_unit	description	Will be set to "kg/m^2"
n2o_column	path	/MDR[]/MDR/INTEGRATED_N2O[]
n2o_column_unit	description	Will be set to "kg/m^2"
co_column	path	/MDR[]/MDR/INTEGRATED_CO[]
co_column_unit	description	Will be set to "kg/m^2"
ch4_column	path	/MDR[]/MDR/INTEGRATED_CH4[]
ch4_column_unit	description	Will be set to "kg/m^2"
co2_column	path	/MDR[]/MDR/INTEGRATED_CO2[]
co2_column_unit	description	Will be set to "kg/m^2"
solar_zenith_angle_surface	path	/MDR[]/MDR/ANGULAR_RELATION[,0]
los_zenith_angle_surface	path	/MDR[]/MDR/ANGULAR_RELATION[,1]
solar_azimuth_angle_surface	path	/MDR[]/MDR/ANGULAR_RELATION[,2]
los_azimuth_angle_surface	path	/MDR[]/MDR/ANGULAR_RELATION[,3]