BEAT-II Record: SCIAMACHY_L1b_occultation

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of SCIAMACHY_L1b_occultation 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_file	int32	[file]	included	List of number of ingested points per file
elements_per_profile	int32	[profile]	included	List of number of ingested points per profile
time	double	[main]	included	Measurement time
altitude	double	[main]	included	The tangent altitude for each measurement
latitude	double	[main]	included	The center tangent latitude
longitude	double	[main]	included	The center tangent longitude
spectral_readout	double	[main, spectra]	included	The detector readout values
spectral_readout_unit	string		included	BU
wavelength_per_file	double	[file, spectra]	included	The nominal wavelength assignment for each of the detector pixels
wavelength_per_file_unit	string		included	nm
integration_time	double	[main]	included	The minimum readout time for all ingested clusters
pixel_integration_time	double	[main, spectra]	excluded	The readout time for each detector pixel
solar_zenith_angle	double	[main]	excluded	The solar zenith angle for each measurement
solar_azimuth_angle	double	[main]	excluded	The solar azimuth angle for each measurement
los_zenith_angle	double	[main]	excluded	The line of sight zenith angle for each measurement
los_azimuth_angle	double	[main]	excluded	The line of sight azimuth angle for each measurement
fixed_pattern_noise_per_file	double	[file, spectra]	excluded	Constant fraction of the fixed pattern noise (FPN) for each detector pixel
leakage_current_per_file	double	[file, spectra]	excluded	Constant fraction of the leakage current for each detector pixel
bad_pixel_mask_per_file	double	[file, spectra]	excluded	The bad pixel map for the detector pixel array

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_L1b product, you will have to provide a filter option data=occultation 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
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_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
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_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle	double	Only include elements that match the list of given filter option values
solar_azimuth_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_azimuth_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_azimuth_angle	double	Only include elements that match the list of given filter option values
los_zenith_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_zenith_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_zenith_angle	double	Only include elements that match the list of given filter option values
los_azimuth_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_azimuth_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_azimuth_angle	double	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)

^* 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	/occultation[]/dsr_time
	description	the dsr_time is increased by the number of the applicable readout multiplied by the minimum readout time for the dsr
altitude	condition	No co-adding needed
	path	/occultation[]/geo[]/tan_h[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/tan_h[2]
	description	the value at end of integration time of the N/2-th geolocation
latitude	condition	No co-adding needed
	path	/occultation[]/geo[]/tang_ground_point[1]/latitude
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/tang_ground_point[2]/latitude
	description	the tangent ground point at end of integration time of the N/2-th geolocation
longitude	condition	No co-adding needed
	path	/occultation[]/geo[]/tang_ground_point[1]/longitude
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/tang_ground_point[2]/longitude
	description	the tangent ground point at end of integration time of the N/2-th geolocation
spectral_readout	path	/nadir[]/clus_dat[]/sig[]/signal, /nadir[]/clus_dat[]/sigc[]/signal
spectral_readout_unit	description	Will be set to "BU"
wavelength_per_file	path	/spectral_base[0]/wvlen_det_pix[]
wavelength_per_file_unit	description	Will be set to "nm"
integration_time	path	/states[]/intg_times[]
	description	The minimum readout time of only those clusters from which pixel data is ingested (the value can thus be higher than the minimum readout time for a state
pixel_integration_time	path	/states[]/clus_config[]/pet, /states[]/clus_config[]/coadd_factor
	description	For all pixels in a cluster the integration time is the pixel exposure time times the coadding factor
solar_zenith_angle	condition	No co-adding needed
	path	/occultation[]/geo[]/sol_zen_ang[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/sol_zen_ang[2]
	description	the value at end of integration time of the N/2-th geolocation
solar_azimuth_angle	condition	No co-adding needed
	path	/occultation[]/geo[]/sol_azi_ang[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/sol_azi_ang[2]
	description	the value at end of integration time of the N/2-th geolocation
los_zenith_angle	condition	No co-adding needed
	path	/occultation[]/geo[]/los_zen_ang[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/los_zen_ang[2]
	description	the value at end of integration time of the N/2-th geolocation
los_azimuth_angle	condition	No co-adding needed
	path	/occultation[]/geo[]/los_azi_ang[1]
	condition	Co-adding needed and all N geolocations are within a single scan (N is smaller than 5)
	path	/occultation[]/geo[]/los_azi_ang[2]
	description	the value at end of integration time of the N/2-th geolocation
fixed_pattern_noise_per_file	path	/leakage_constant[0]/fpn_const[]
leakage_current_per_file	path	/leakage_constant[0]/leak_const[]
bad_pixel_mask_per_file	path	/ppg_etalon[0]/bad_pix_mask[]