BEAT-II Record: GOMOS_EXT_L2

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of GOMOS_EXT_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	The latitude at half-measurement
longitude	double	[main]	included	The longitude at half-measurement
altitude	double	[main]	included	The altitude at half-measurement in km
transmission	double	[main, spectra]	included
transmission_description	string		included	Describes which transmission data was ingested
wavelength_per_profile	double	[profile, spectra]	included	The nominal wavelength assignment for each of the detector pixels
wavelength_per_profile_unit	string		included	nm
integration_time_per_profile	double	[profile]	included	The integration time for a readout (in seconds)
integration_time	double	[main]	excluded	The integration time for a readout (in seconds)
instrument_latitude	double	[main]	excluded	Latitude of the satellite position
instrument_longitude	double	[main]	excluded	Longitude of the satellite position
instrument_altitude	double	[main]	excluded	Altitude of the satellite in km
illumination_condition_per_profile	string	[profile]	included	The ilumination condition for each profile: 'dark', 'bright', 'twilight', 'straylight', or 'twilight/straylight'

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
integration_time_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
integration_time_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
integration_time_per_profile	double	Only include elements that match the list of given filter option values
integration_time_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
integration_time_max	double	Only include elements for which the value is less than or equal to the provided filter option value
integration_time	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
illumination_condition_per_profile	string	Only include elements that match the list of given filter option values
wavelength_min	double	Only include data where the wavelength is greater then or equal to the value provided (in nm)
wavelength_max	double	Only include data where the wavelength is less than or equal to the value provided (in nm)
transmission_variant	string	When 'model' is selected the transmission model function will be retrieved

^* 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	/ext_mds[]/dsr_time
latitude	path	/ext_ads[]/tangent_lat
longitude	path	/ext_ads[]/tangent_long
altitude	path	/ext_ads[]/tangent_alt
	description	The value is divided by 1000 to convert it to km
transmission	path	/ext_mds[]/trans[]
	description	transmission corrected for scintillation and dilution effects
	condition	transmission_variant=model
	path	/ext_mds[]/trans_model[]
	description	transmission model function
transmission_description	description	Is included with a value 'model function' if the transmission model function was ingested (depends on transmission_variant filter option)
wavelength_per_profile	path	/ext_nom_wav_assignment/nom_wl[]
wavelength_per_profile_unit	description	Will be set to "nm"
integration_time_per_profile	path	/sph/samp_duration
	description	The integration time is the same for all readouts in a profile
integration_time	path	/sph/samp_duration
	description	This is a variant of the integration_time_per_profile where the integration time is replicated for each profile element
instrument_latitude	path	/ext_ads[]/lat
	description	The latitude of the satellite
instrument_longitude	path	/ext_ads[]/longit
	description	The longitude of the satellite
instrument_altitude	path	/ext_ads[]/alt
	description	The altitude of the satellite. The value is divided by 1000 to convert it to km
illumination_condition_per_profile	condition	product version 0
	path	/ext_summary_quality[0]/limb_flag
	description	Old products only provide dark limb and bright limb information; no straylight and twilight
	condition	product version 1 and higher
	path	/ext_summary_quality[0]/obs_illum_cond