BEAT-II Record: GOMOS_RR_L2

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of GOMOS_RR_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
elements_per_profile	int32	[profile]	included	List of number of ingested points per profile. There will always be one profile per product
time	double	[main]	included	The time of the measurement (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
altitude	double	[main]	included	Tangent altitude of the measurement in km
o3	double	[main]	included*	Ozone local density
o3_unit	string		included*	cm^-3
o3_error	double	[main]	included*	Standard deviation for the ozone local density
o3_error_unit	string		excluded	%
o3_validity	uint8	[main]	excluded	PCD value for the ozone local density
no2	double	[main]	excluded	NO2 local density
no2_unit	string		excluded	cm^-3
no2_error	double	[main]	excluded	Standard deviation for the NO2 local density
no2_error_unit	string		excluded	%
no2_validity	uint8	[main]	excluded	PCD value for the NO2 local density
no3	double	[main]	excluded	NO3 local density
no3_unit	string		excluded	cm^-3
no3_error	double	[main]	excluded	Standard deviation for the NO3 local density
no3_error_unit	string		excluded	%
no3_validity	uint8	[main]	excluded	PCD value for the NO3 local density
air	double	[main]	excluded	Air local density
air_unit	string		excluded	cm^-3
air_description	string		excluded	Indicates whether the model air density was retrieved
air_error	double	[main]	excluded	Standard deviation for the air local density
air_error_unit	string		excluded	%
air_validity	uint8	[main]	excluded	PCD value for the air local density
o2	double	[main]	excluded	O2 local density
o2_unit	string		excluded	cm^-3
o2_error	double	[main]	excluded	Standard deviation for the O2 local density
o2_error_unit	string		excluded	%
o2_validity	uint8	[main]	excluded	PCD value for the O2 local density
h2o	double	[main]	excluded	H2O local density
h2o_unit	string		excluded	cm^-3
h2o_error	double	[main]	excluded	Standard deviation for the H2O local density
h2o_error_unit	string		excluded	%
h2o_validity	uint8	[main]	excluded	PCD value for the H2O local density
oclo	double	[main]	excluded	OClO local density
oclo_unit	string		excluded	cm^-3
oclo_error	double	[main]	excluded	Standard deviation for the OClO local density
oclo_error_unit	string		excluded	%
oclo_validity	uint8	[main]	excluded	PCD value for the OClO local density
pressure	double	[main]	excluded	atmospheric pressure from external model (in hPa)
pressure_unit	string		excluded	hPa
temperature	double	[main]	excluded	local temperature
temperature_unit	string		excluded	K
temperature_description	string		excluded	Indicates whether the model temperature was retrieved
temperature_error	double	[main]	excluded	Standard deviation for the local temperature
temperature_error_unit	string		excluded	%
instrument_latitude	double	[main]	excluded	Latitude of the satellite position
instrument_longitude	double	[main]	included	Longitude of the satellite position
instrument_altitude	double	[main]	excluded	Altitude of the satellite in km

^* 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
altitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
altitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
altitude	double	Only include elements that match the list of given filter option values
o3_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
o3_max	double	Only include elements for which the value is less than or equal to the provided filter option value
o3	double	Only include elements that match the list of given filter option values
o3_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
o3_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
o3_error	double	Only include elements that match the list of given filter option values
o3_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
o3_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
o3_validity	integer	Only include elements that match the list of given filter option values
no2_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
no2_max	double	Only include elements for which the value is less than or equal to the provided filter option value
no2	double	Only include elements that match the list of given filter option values
no2_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
no2_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
no2_error	double	Only include elements that match the list of given filter option values
no2_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
no2_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
no2_validity	integer	Only include elements that match the list of given filter option values
no3_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
no3_max	double	Only include elements for which the value is less than or equal to the provided filter option value
no3	double	Only include elements that match the list of given filter option values
no3_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
no3_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
no3_error	double	Only include elements that match the list of given filter option values
no3_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
no3_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
no3_validity	integer	Only include elements that match the list of given filter option values
air_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
air_max	double	Only include elements for which the value is less than or equal to the provided filter option value
air	double	Only include elements that match the list of given filter option values
air_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
air_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
air_error	double	Only include elements that match the list of given filter option values
air_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
air_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
air_validity	integer	Only include elements that match the list of given filter option values
o2_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
o2_max	double	Only include elements for which the value is less than or equal to the provided filter option value
o2	double	Only include elements that match the list of given filter option values
o2_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
o2_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
o2_error	double	Only include elements that match the list of given filter option values
o2_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
o2_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
o2_validity	integer	Only include elements that match the list of given filter option values
h2o_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o	double	Only include elements that match the list of given filter option values
h2o_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_error	double	Only include elements that match the list of given filter option values
h2o_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
h2o_validity	integer	Only include elements that match the list of given filter option values
oclo_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
oclo_max	double	Only include elements for which the value is less than or equal to the provided filter option value
oclo	double	Only include elements that match the list of given filter option values
oclo_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
oclo_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
oclo_error	double	Only include elements that match the list of given filter option values
oclo_validity_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
oclo_validity_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
oclo_validity	integer	Only include elements that match the list of given filter option values
pressure_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
pressure_max	double	Only include elements for which the value is less than or equal to the provided filter option value
pressure	double	Only include elements that match the list of given filter option values
temperature_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
temperature_max	double	Only include elements for which the value is less than or equal to the provided filter option value
temperature	double	Only include elements that match the list of given filter option values
temperature_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
temperature_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
temperature_error	double	Only include elements that match the list of given filter option values
instrument_latitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
instrument_latitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
instrument_latitude	double	Only include elements that match the list of given filter option values
instrument_longitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
instrument_longitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
instrument_longitude	double	Only include elements that match the list of given filter option values
instrument_altitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
instrument_altitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
instrument_altitude	double	Only include elements that match the list of given filter option values
temperature_variant	string	If set to 'model' the tangent point temperature from an external model is ingested, otherwise the local temperature is read
air_variant	string	If set to 'model' the air density from an external model is ingested, otherwise the local air density is read

^* 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	/rr_geolocation[]/dsr_time
latitude	path	/rr_geolocation[]/tangent_lat
longitude	path	/rr_geolocation[]/tangent_long
altitude	path	/rr_geolocation[]/tangent_alt
	description	The value is divided by 1000 to convert it to km
o3	path	/rr_local_species_density[]/o3
o3_unit	description	Will be set to "cm^-3"
o3_error	path	/rr_local_species_density[]/o3_std
o3_error_unit	description	Will be set to "%"
o3_validity	path	/rr_local_species_density[]/pcd[0]
no2	path	/rr_local_species_density[]/no2
no2_unit	description	Will be set to "cm^-3"
no2_error	path	/rr_local_species_density[]/no2_std
no2_error_unit	description	Will be set to "%"
no2_validity	path	/rr_local_species_density[]/pcd[1]
no3	path	/rr_local_species_density[]/no3
no3_unit	description	Will be set to "cm^-3"
no3_error	path	/rr_local_species_density[]/no3_std
no3_error_unit	description	Will be set to "%"
no3_validity	path	/rr_local_species_density[]/pcd[2]
air	path	/rr_local_species_density[]/air
	condition	air_variant=model and product version > 0
	path	/rr_geolocation[]/tangent_density
air_unit	description	Will be set to "cm^-3"
air_description	description	Value depends on air_variant filter option
air_error	path	/rr_local_species_density[]/air_std
	description	Not available when the model air density is retrieved
air_error_unit	description	Will be set to "%"
air_validity	path	/rr_local_species_density[]/pcd[3]
	description	Not available when the model air density is retrieved
o2	path	/rr_local_species_density[]/o2
o2_unit	description	Will be set to "cm^-3"
o2_error	path	/rr_local_species_density[]/o2_std
o2_error_unit	description	Will be set to "%"
o2_validity	path	/rr_local_species_density[]/pcd[4]
h2o	path	/rr_local_species_density[]/h2o
h2o_unit	description	Will be set to "cm^-3"
h2o_error	path	/rr_local_species_density[]/h2o_std
h2o_error_unit	description	Will be set to "%"
h2o_validity	path	/rr_local_species_density[]/pcd[5]
oclo	path	/rr_local_species_density[]/oclo
oclo_unit	description	Will be set to "cm^-3"
oclo_error	path	/rr_local_species_density[]/oclo_std
oclo_error_unit	description	Will be set to "%"
oclo_validity	path	/rr_local_species_density[]/pcd[6]
pressure	path	/rr_geolocation[]/tangent_atm_p
	description	The value is divided by 100 to convert it to hPa
pressure_unit	description	Will be set to "hPa"
temperature	path	/rr_geolocation[]/local_temp
	condition	temperature_variant=model
	path	/rr_geolocation[]/tangent_temp
temperature_unit	description	Will be set to "K"
temperature_description	description	Value depends on temperature_variant filter option
temperature_error	path	/rr_geolocation[]/local_temp_std
temperature_error_unit	description	Will be set to "%"
instrument_latitude	path	/rr_geolocation[]/lat
	description	Latitude of the satellite position
instrument_longitude	path	/rr_geolocation[]/longit
instrument_altitude	path	/rr_geolocation[]/alt
	description	The value is divided by 1000 to convert it to km