BEAT-II Record: GOMOS_LIMB_L1

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of GOMOS_LIMB_L1 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 of the apparent tangent point
longitude	double	[main]	included	The longitude of the apparent tangent point
altitude	double	[main]	included	The altitude of the apparent tangent point in km
spectral_background	double	[main, spectra]	included	The background spectra
spectral_background_unit	string		included	e
spectral_background_description	string		included	Indicates whether the lower/upper, corrected/uncorrected background spectra were retrieved
spectral_background_error	double	[main, spectra]	included	Error bar for the background spectra
spectral_background_error_unit	string		included	%
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)
spectral_background_variant	string	A single option value or combination (space separated) of two options values can be provided: 'corrected' (default) and 'uncorrected' select between background spectra with or without straylight and IR-vignetting corrections. 'lower' (default) and 'upper' select between the lower and upper background spectra

^* 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	/lim_mds[]/dsr_time
latitude	condition	latitude_variant=lower
	path	/lim_ads[]/tangent_lat[0]
	condition	latitude_variant=upper
	path	/lim_ads[]/tangent_lat[1]
longitude	condition	longitude_variant=lower
	path	/lim_ads[]/tangent_long[0]
	condition	longitude_variant=upper
	path	/lim_ads[]/tangent_long[1]
altitude	condition	altitude_variant=lower
	path	/lim_ads[]/tangent_alt[0]
	description	The value is divided by 1000 to convert it to km
	condition	altitude_variant=upper
	path	/lim_ads[]/tangent_alt[1]
	description	The value is divided by 1000 to convert it to km
spectral_background	condition	spectral_background_variant=upper uncorrected
	path	/lim_mds[]/up_low_back_no_corr[0,]
	condition	spectral_background_variant=lower uncorrected
	path	/lim_mds[]/up_low_back_no_corr[1,]
	condition	spectral_background_variant=upper corrected
	path	/lim_mds[]/up_low_back_corr[0,]
	condition	spectral_background_variant=lower corrected
	path	/lim_mds[]/up_low_back_corr[1,]
spectral_background_unit	description	Will be set to "e"
spectral_background_description	description	Value depends on spectral_background_variant filter option
spectral_background_error	condition	spectral_background_error_variant=upper corrected
	path	/lim_mds[]/err_up_low_back_corr[0,]
	condition	spectral_background_error_variant=lower corrected
	path	/lim_mds[]/err_up_low_back_corr[1,]
spectral_background_error_unit	description	Will be set to "%"
wavelength_per_profile	path	/lim_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	/lim_ads[]/lat
	description	The latitude of the satellite
instrument_longitude	path	/lim_ads[]/longit
	description	The longitude of the satellite
instrument_altitude	path	/lim_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	/lim_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	/lim_summary_quality[0]/obs_illum_cond