BEAT-II Record: GOME_L2

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of GOME_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	Tangent latitude of the measurement
longitude	double	[main]	included	Tangent longitude of the measurement
corner_latitude	double	[main, 4]	included	Corner latitudes for the (co-added) ground pixel of the measurement
corner_longitude	double	[main, 4]	included	Corner latitudes for the (co-added) ground pixel of the measurement
o3_column	double	[main]	included	Ozone total column
o3_column_unit	string		included	DU or mol/cm^2
o3_column_error	double	[main]	included	Relative error on the Ozone total column
o3_column_error_unit	string		included	%
no2_column	double	[main]	excluded	NO2 total column
no2_column_unit	string		excluded	mol/cm^2
no2_column_error	double	[main]	excluded	Relative error on the NO2 total column
no2_column_error_unit	string		excluded	%
amf_o3_cloud_top	double	[main]	included	AMF to cloud-top for Ozone
amf_o3_cloud_top_error	double	[main]	included	Relative error on the AMF to cloud-top for Ozone
amf_o3_surface	double	[main]	included	AMF to ground for Ozone
amf_o3_surface_error	double	[main]	included	Relative error on the AMF to ground for Ozone
amf_no2_cloud_top	double	[main]	excluded	AMF to cloud-top for NO2
amf_no2_cloud_top_error	double	[main]	excluded	Relative error on the AMF to cloud-top for NO2
amf_no2_surface	double	[main]	excluded	AMF to ground for NO2
amf_no2_surface_error	double	[main]	excluded	Relative error on the AMF to ground for NO2
cloud_fraction	double	[main]	excluded	Cloud fraction
cloud_fraction_error	double	[main]	excluded	Relative error on the cloud fraction (in %)
height_cloud_top	double	[main]	excluded	Cloud top height (in km)
height_cloud_top_error	double	[main]	excluded	Relative error on the cloud top height (in %)
pressure_cloud_top	double	[main]	excluded	Cloud top pressure (in hPa)
pressure_cloud_top_error	double	[main]	excluded	Relative error on the cloud top pressure (in %)
albedo_cloud_top	double	[main]	excluded	Cloud top albedo
albedo_cloud_top_error	double	[main]	excluded	Relative error on the cloud top albedo (in %)
pressure_surface	double	[main]	excluded	Surface pressure (in hPa)
height_surface	double	[main]	excluded	Surface height (in km)
albedo_surface	double	[main]	excluded	Surface albedo
solar_zenith_angle	double	[main]	excluded	Solar zenith angle at instrument
los_zenith_angle	double	[main]	excluded	Viewing zenith angle at instrument
relative_azimuth_angle	double	[main]	excluded	Relative azimuth angle at instrument
solar_zenith_angle_toa	double	[main]	excluded	Solar zenith angle at top of atmosphere
los_zenith_angle_toa	double	[main]	excluded	Viewing zenith angle at top of atmosphere
relative_azimuth_angle_toa	double	[main]	excluded	Relative azimuth angle at top of atmosphere
scan_subset_counter	uint8	[main]	excluded	The relative index (0-3) of this measurement within a scan (forward + backward)
scan_direction	string	[main]	excluded	The scan direction for each measurement: 'forward' or 'backward'

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
o3_column_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
o3_column_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
o3_column_error	double	Only include elements that match the list of given filter option values
no2_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
no2_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
no2_column	double	Only include elements that match the list of given filter option values
no2_column_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
no2_column_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
no2_column_error	double	Only include elements that match the list of given filter option values
amf_o3_cloud_top_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_o3_cloud_top_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_o3_cloud_top	double	Only include elements that match the list of given filter option values
amf_o3_cloud_top_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_o3_cloud_top_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_o3_cloud_top_error	double	Only include elements that match the list of given filter option values
amf_o3_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_o3_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_o3_surface	double	Only include elements that match the list of given filter option values
amf_o3_surface_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_o3_surface_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_o3_surface_error	double	Only include elements that match the list of given filter option values
amf_no2_cloud_top_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_no2_cloud_top_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_no2_cloud_top	double	Only include elements that match the list of given filter option values
amf_no2_cloud_top_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_no2_cloud_top_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_no2_cloud_top_error	double	Only include elements that match the list of given filter option values
amf_no2_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_no2_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_no2_surface	double	Only include elements that match the list of given filter option values
amf_no2_surface_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
amf_no2_surface_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
amf_no2_surface_error	double	Only include elements that match the list of given filter option values
cloud_fraction_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
cloud_fraction_max	double	Only include elements for which the value is less than or equal to the provided filter option value
cloud_fraction	double	Only include elements that match the list of given filter option values
cloud_fraction_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
cloud_fraction_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
cloud_fraction_error	double	Only include elements that match the list of given filter option values
height_cloud_top_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
height_cloud_top_max	double	Only include elements for which the value is less than or equal to the provided filter option value
height_cloud_top	double	Only include elements that match the list of given filter option values
height_cloud_top_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
height_cloud_top_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
height_cloud_top_error	double	Only include elements that match the list of given filter option values
pressure_cloud_top_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
pressure_cloud_top_max	double	Only include elements for which the value is less than or equal to the provided filter option value
pressure_cloud_top	double	Only include elements that match the list of given filter option values
pressure_cloud_top_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
pressure_cloud_top_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
pressure_cloud_top_error	double	Only include elements that match the list of given filter option values
albedo_cloud_top_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
albedo_cloud_top_max	double	Only include elements for which the value is less than or equal to the provided filter option value
albedo_cloud_top	double	Only include elements that match the list of given filter option values
albedo_cloud_top_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
albedo_cloud_top_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
albedo_cloud_top_error	double	Only include elements that match the list of given filter option values
pressure_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
pressure_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
pressure_surface	double	Only include elements that match the list of given filter option values
height_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
height_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
height_surface	double	Only include elements that match the list of given filter option values
albedo_surface_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
albedo_surface_max	double	Only include elements for which the value is less than or equal to the provided filter option value
albedo_surface	double	Only include elements that match the list of given filter option values
solar_zenith_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle	double	Only include elements that match the list of given filter option values
los_zenith_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_zenith_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_zenith_angle	double	Only include elements that match the list of given filter option values
relative_azimuth_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
relative_azimuth_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
relative_azimuth_angle	double	Only include elements that match the list of given filter option values
solar_zenith_angle_toa_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_toa_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle_toa	double	Only include elements that match the list of given filter option values
los_zenith_angle_toa_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_zenith_angle_toa_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_zenith_angle_toa	double	Only include elements that match the list of given filter option values
relative_azimuth_angle_toa_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
relative_azimuth_angle_toa_max	double	Only include elements for which the value is less than or equal to the provided filter option value
relative_azimuth_angle_toa	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
scan_direction	string	Only include elements that match the list of given filter option values
o3_column_variant	string	Select between the Ozone total column values in Dobson Units (the default, if no filter option is provided), the Ozone VCD for window 0 (vcd0) or the VCD for window 1 (vcd1). This option also affects which AMF values for Ozone are ingested (none, window 0, or window 1)

^* 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	/ddr[]/glr/datetime
latitude	path	/ddr[]/glr/corners[4]/lat
longitude	path	ddr[]/glr/corners[4]/lon
	description	Each longitude will be transformed from a value in the range 0 - 360 to a value in the range -180 - 180
corner_latitude	path	/ddr[]/glr/corners[0:3]/lat
corner_longitude	path	/ddr[]/glr/corners[0:3]/lon
o3_column	path	/ddr[]/tot_ozone
	condition	o3_column_variant=vcd0
	path	/ddr[]/irr/vcd[0]
	condition	o3_column_variant=vcd1
	path	/ddr[]/irr/vcd[1]
o3_column_unit	description	Will be set to "DU"
	condition	o3_column_unit_variant=vcd0
	description	Will be set to "mol/cm^2"
	condition	o3_column_unit_variant=vcd1
	description	Will be set to "mol/cm^2"
o3_column_error	path	/ddr[]/err_ozone
	condition	o3_column_error_variant=vcd0
	path	/ddr[]/irr/error[0]
	condition	o3_column_error_variant=vcd1
	path	/ddr[]/irr/error[1]
o3_column_error_unit	description	Will be set to "%"
no2_column	path	/ddr[]/irr/vcd[2]
no2_column_unit	description	Will be set to "mol/cm^2"
no2_column_error	path	/ddr[]/irr/error[2]
no2_column_error_unit	description	Will be set to "%"
amf_o3_cloud_top	condition	o3_column_variant filter option is "vcd0"
	path	/ddr[]/amf/cld_top[0]
	condition	o3_column_variant filter option is "vcd1"
	path	/ddr[]/amf/cld_top[1]
amf_o3_cloud_top_error	condition	o3_column_variant filter option is "vcd0" and product format version > 1
	path	/ddr[]/amf/cld_top_error[0]
	condition	o3_column_variant filter option is "vcd1" and product format version > 1
	path	/ddr[]/amf/cld_top_error[1]
amf_o3_surface	condition	o3_column_variant filter option is "vcd0"
	path	/ddr[]/amf/ground[0]
	condition	o3_column_variant filter option is "vcd1"
	path	/ddr[]/amf/ground[1]
amf_o3_surface_error	condition	o3_column_variant filter option is "vcd0" and product format version > 1
	path	/ddr[]/amf/ground_error[0]
	condition	o3_column_variant filter option is "vcd1" and product format version > 1
	path	/ddr[]/amf/ground_error[1]
amf_no2_cloud_top	path	/ddr[]/amf/cld_top[2]
amf_no2_cloud_top_error	path	/ddr[]/amf/cld_top_error[2]
amf_no2_surface	path	/ddr[]/amf/ground[2]
amf_no2_surface_error	path	/ddr[]/amf/surface_error[2]
cloud_fraction	condition	product format version == 1
	path	/ddr[]/icfa/frac
	condition	product format version > 1
	path	/ddr[]/ocra/cloud_frac
cloud_fraction_error	condition	product format version == 1
	path	/ddr[]/icfa/err_frac
	condition	product format version > 1
	path	/ddr[]/ocra/cloud_frac_error
height_cloud_top	condition	product format version > 1
	path	/ddr[]/rocinn/height
height_cloud_top_error	condition	product format version > 1
	path	/ddr[]/rocinn/height_error
pressure_cloud_top	condition	product format version == 1
	path	/ddr[]/icfa/press
	condition	product format version > 1
	path	/ddr[]/rocinn/pressure
pressure_cloud_top_error	condition	product format version == 1
	path	/ddr[]/icfa/err_press
	condition	product format version > 1
	path	/ddr[]/rocinn/pressure_error
albedo_cloud_top	condition	product format version > 1
	path	/ddr[]/rocinn/albedo
albedo_cloud_top_error	condition	product format version > 1
	path	/ddr[]/rocinn/albedo_error
pressure_surface	condition	product format version == 1
	path	/ddr[]/icfa/surf_press
	condition	product format version > 1
	path	/ddr[]/surface_pressure
height_surface	condition	product format version > 1
	path	/ddr[]/surface_height
albedo_surface	condition	product format version > 1
	path	/ddr[]/surface_albedo
solar_zenith_angle	path	/ddr[]/glr/sza[1]
los_zenith_angle	path	/ddr[]/glr/line_sight[1]
relative_azimuth_angle	path	/ddr[]/glr/rel_azi[1]
solar_zenith_angle_toa	path	/ddr[]/glr/sza_toa[1]
los_zenith_angle_toa	path	/ddr[]/glr/line_sight_toa[1]
relative_azimuth_angle_toa	path	/ddr[]/glr/rel_azi_toa[1]
scan_subset_counter	path	/ddr[]/glr/subset_counter
	description	if a measurement consisted of multiple ground pixels, the subset counter of the last pixel is taken
scan_direction	path	/ddr[]/glr/subset_counter
	description	The scan direction is based on the subset_counter of the measurement (0-2 = forward, 3 = backward)