BEAT-II Record: SCIAMACHY_L2_Offline_clouds_aerosol

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of SCIAMACHY_L2_Offline_clouds_aerosol 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	Measurement time
latitude	double	[main]	included	The center latitude for each nadir pixel
longitude	double	[main]	included	The center longitude for each nadir pixel
corner_latitude	double	[main, 4]	included	The corner latitudes for each nadir pixel
corner_longitude	double	[main, 4]	included	The corner longitudes for each nadir pixel
cloud_fraction	double	[main]	included	Average cloud fraction of footprint
pressure_cloud_top	double	[main]	included	Cloud-top pressure (in hPa)
height_cloud_top	double	[main]	included	Cloud-top height (in km)
absorbing_aerosol_index	double	[main]	included	Aerosol absorbing index
integration_time	double	[main]	included	The integration time for a retrieval
solar_zenith_angle_toa	double	[main]	excluded	The solar zenith angle at Top of Atmosphere for each measurement
los_zenith_angle_toa	double	[main]	excluded	The line of sight zenith angle at Top of Atmosphere for each measurement
relative_azimuth_angle_toa	double	[main]	excluded	The relative azimuth angle at Top of Atmosphere for each measurement
scan_direction	string	[main]	included	The scan direction for each measurement: 'forward', 'backward', or 'mixed' (for a measurement that consisted of one or more forward and backward scans)

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=clouds_aerosol 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_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
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
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
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
absorbing_aerosol_index_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
absorbing_aerosol_index_max	double	Only include elements for which the value is less than or equal to the provided filter option value
absorbing_aerosol_index	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
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_direction	string	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.

field name	mapping description
time	path	/clouds_aerosol[]/dsr_time
latitude	condition	No co-adding needed
	path	/geolocation_nadir[]/cen_coor_nad/latitude
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/cor_coor_nad[]
	description	the latitude of the geographic average of cor_coor_nad[2] and cor_coor_nad[3] of the N/2-th pixel
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/cen_coor_nad, /geolocation_nadir[]/cor_coor_nad[]
	description	the latitude of the geographic average of 1: the geographic average of cor_coor_nad[2] and cor_coor_nad[3] of the second pixel and 2: cen_coor_nad of the N-th pixel
longitude	condition	No co-adding needed
	path	/geolocation_nadir[]/cen_coor_nad/longitude
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/cor_coor_nad[]
	description	the longitude of the geographic average of cor_coor_nad[2] and cor_coor_nad[3] of the N/2-th pixel
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/cen_coor_nad, /geolocation_nadir[]/cor_coor_nad[]
	description	the longitude of the geographic average of 1: the geographic average of cor_coor_nad[2] and cor_coor_nad[3] of the second pixel and 2: cen_coor_nad of the N-th pixel
corner_latitude	condition	No co-adding needed
	path	/geolocation_nadir[]/cor_coor_nad[]/latitude
	description	The corners are rearranged in the following way: 0,2,3,1
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/cor_coor_nad[]
	description	cor_coor_nad[0] and cor_coor_nad[1] are taken from the first pixel and cor_coor_nad[2] and cor_coor_nad[3] are taken from the N-th pixel. The corners are rearranged in the following way: 0,2,3,1
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/cor_coor_nad[]
	description	cor_coor_nad[0] is taken from the first pixel, cor_coor_nad[2] is taken from the fourth pixel, cor_coor_nad[1] is taken from cor_coor_nad[3] of the N-th pixel, and cor_coor_nad[3] is taken from cor_coor_nad[1] from the N-th pixel. The corners are rearranged in the following way: 0,2,3,1
corner_longitude	condition	No co-adding needed
	path	/geolocation_nadir[]/cor_coor_nad[]/longitude
	description	The corners are rearranged in the following way: 0,2,3,1
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/cor_coor_nad[]
	description	cor_coor_nad[0] and cor_coor_nad[1] are taken from the first pixel and cor_coor_nad[2] and cor_coor_nad[3] are taken from the N-th pixel. The corners are rearranged in the following way: 0,2,3,1
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/cor_coor_nad[]
	description	cor_coor_nad[0] is taken from the first pixel, cor_coor_nad[2] is taken from the fourth pixel, cor_coor_nad[1] is taken from cor_coor_nad[3] of the N-th pixel, and cor_coor_nad[3] is taken from cor_coor_nad[1] from the N-th pixel. The corners are rearranged in the following way: 0,2,3,1
cloud_fraction	path	/clouds_aerosol[]/cl_frac
pressure_cloud_top	condition	applicable format specification <= PO-RS-MDA-GS2009_15_3J
	path	/clouds_aerosol[]/cl_top_pres
height_cloud_top	condition	applicable format specification >= PO-RS-MDA-GS2009_15_3K
	path	/clouds_aerosol[]/cl_top_height
absorbing_aerosol_index	path	/clouds_aerosol[]/aero_abso_ind
integration_time	path	/clouds_aerosol[]/integr_time
solar_zenith_angle_toa	condition	No co-adding needed
	path	/geolocation_nadir[]/sol_zen_angle_toa[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/sol_zen_angle_toa[2]
	description	the value at end of integration time of the N/2-th geolocation
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/sol_zen_angle_toa[1], /geolocation_nadir[]/sol_zen_angle_toa[2]
	description	the average of the value at end of integration time of the second record and the value at middle of integration time of the N-th record
los_zenith_angle_toa	condition	No co-adding needed
	path	/geolocation_nadir[]/los_zen_angle_toa[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/los_zen_angle_toa[2]
	description	the value at end of integration time of the N/2-th geolocation
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/los_zen_angle_toa[1], /geolocation_nadir[]/los_zen_angle_toa[2]
	description	the average of the value at end of integration time of the second record and the value at middle of integration time of the N-th record
relative_azimuth_angle_toa	condition	No co-adding needed
	path	/geolocation_nadir[]/rel_azi_angle_toa[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is not divisible by 5)
	path	/geolocation_nadir[]/rel_azi_angle_toa[2]
	description	the value at end of integration time of the N/2-th geolocation
	condition	Co-adding needed of both forward and backward scan pixels (N is divisible by 5)
	path	/geolocation_nadir[]/rel_azi_angle_toa[1], /geolocation_nadir[]/rel_azi_angle_toa[2]
	description	the average of the value at end of integration time of the second record and the value at middle of integration time of the N-th record
scan_direction	path	/geolocation_nadir[]/corner_coord[], /geolocation_nadir[]/dsr_time
	description	When the integration time is higher than 1s we are dealing with a mixed pixel, otherwise the scan direction is based on the corner coordinates of the first ground pixel of the measurement. The first geolocation pixel is a backscan pixel if the inproduct of the unit vector of the third corner with the outproduct of the unit vector of the first corner and the unit vector of the second corner is negative (otherwise it is part of a forward scan)