BEAT-II Record: SCIAMACHY_L2_Offline_limb_uv_3

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of SCIAMACHY_L2_Offline_limb_uv_3 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
time_per_profile	double	[profile]	included	Measurement time for each profile
altitude	double	[main]	included	The altitude for each profile point
latitude_per_profile	double	[profile]	included	The tangent latitude for the middle most profile point
longitude_per_profile	double	[profile]	included	The tangent longitude for the middle most profile point
bro_vmr	double	[main]	included	BrO volume mixing ratio
bro_vmr_unit	string		included	ppmv
bro_vmr_error	double	[main]	included	Error on the BrO vmr
bro_vmr_error_unit	string		included	%
pressure	double	[main]	included	The pressure for each profile point (in hPa)
temperature	double	[main]	included	The temperature for each profile point
integration_time_per_profile	double	[profile]	included	The integration time for the retrieved points in a profile
solar_zenith_angle_toa_per_profile	double	[profile]	excluded	The solar zenith angle at Top of Atmosphere for the middle most profile point
los_zenith_angle_toa_per_profile	double	[profile]	excluded	The line of sight zenith angle at Top of Atmosphere for the middle most profile point
relative_azimuth_angle_toa_per_profile	double	[profile]	excluded	The relative azimuth angle at Top of Atmosphere for the middle most profile point

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.
data	string	Since this record type is not the default type of data that will be ingested for a SCIAMACHY_L2_Offline product, you will have to provide a filter option data=limb_uv_3 to get this type of record.
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_per_profile_min	time*	Only include elements for which the value is greater than or equal to the provided filter option value
time_per_profile_max	time*	Only include elements for which the value is less than or equal to the provided filter option value
time_per_profile	time*	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
latitude_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
latitude_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
latitude_per_profile	double	Only include elements that match the list of given filter option values
longitude_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
longitude_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
longitude_per_profile	double	Only include elements that match the list of given filter option values
bro_vmr_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
bro_vmr_max	double	Only include elements for which the value is less than or equal to the provided filter option value
bro_vmr	double	Only include elements that match the list of given filter option values
bro_vmr_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
bro_vmr_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
bro_vmr_error	double	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
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
solar_zenith_angle_toa_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_toa_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle_toa_per_profile	double	Only include elements that match the list of given filter option values
los_zenith_angle_toa_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_zenith_angle_toa_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_zenith_angle_toa_per_profile	double	Only include elements that match the list of given filter option values
relative_azimuth_angle_toa_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
relative_azimuth_angle_toa_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
relative_azimuth_angle_toa_per_profile	double	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.

The records in the geolocation_limb data set do not have a one-to-one mapping with the records in the limb/occultation measurement datasets. Each record in the measurement dataset contains one profile retrieval (for one or more species) which was calculated using several measurement points. For the SCIAMACHY offline product this amount of limb/occultation measurements (n_meas) is unfortunately almost never equal to the amount of height levels that was used for the retrieval (n_main). For this reason it is not possible to assign a direct measurement time or tangent location to a profile point. The workaround chosen for BEAT is to use a single measurement time and tangent location per profile. The chosen time and geolocation information is taken from the middlemost measurement that was used for the retrieval (i.e. index = (n_meas - 1) / 2). The geolocation record belonging to this measurement is retrieved by comparing the measurement time measurement_grid[(n_meas - 1) / 2].dsr_time with the time of the geolocation record geolocation_limb[]/dsr_time

field name	mapping description
time_per_profile	path	/geolocation_limb[]/dsr_time
altitude	path	/lim_uv3_bro[]/tangent_height[]
latitude_per_profile	path	/geolocation_limb[]/tangent_coord[1]/latitude
longitude_per_profile	path	/geolocation_limb[]/tangent_coord[1]/longitude
bro_vmr	path	/lim_uv3_bro[]/main_species[,0]/tang_vmr
	description	Converted to ppmv by multiplying by 1E6
bro_vmr_unit	description	Will be set to "ppmv"
bro_vmr_error	path	/lim_uv3_bro[]/main_species[,0]/err_tang_vmr
bro_vmr_error_unit	description	Will be set to "%"
pressure	path	/lim_uv3_bro[]/tangent_pressure[]
temperature	path	/lim_uv3_bro[]/tangent_temp[]
integration_time_per_profile	path	/lim_uv3_bro[]/integr_time
solar_zenith_angle_toa_per_profile	path	/geolocation_limb[]/sol_zen_angle_toa[1]
los_zenith_angle_toa_per_profile	path	/geolocation_limb[]/los_zen_angle_toa[1]
relative_azimuth_angle_toa_per_profile	path	/geolocation_limb[]/rel_zen_angle_toa[1]