BEAT-II Record: MIPAS_L1

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of MIPAS_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
elements_per_file	int32	[file]	included	List of number of ingested points per file
time	double	[main]	included	The time of the measurement (in seconds since 2000-01-01 00:00:00)
latitude	double	[main]	included	Tangent latitude of the measurement
longitude	double	[main]	included	Tangent longitude of the measurement
altitude	double	[main]	included	Tangent altitude of the measurement in km
spectral_radiance	double	[main, spectra]	included	The measured spectral radiance
spectral_radiance_unit	string		included	W/cm^2.sr.cm^-1
wavenumber_per_file	double	[file, spectra]	included	The nominal wavenumber assignment for each of the detector pixels
wavenumber_per_file_unit	string		included	cm^-1
nesr	double	[main, spectra]	excluded	The Noise Equivalent Spectral Radiance
nesr_unit	string		excluded	W/cm^2.sr.cm^-1
fringe_count_left	int32	[main]	excluded	Commanded left fringe count
fringe_count_right	int32	[main]	excluded	Commanded right fringe count
fringe_count_error	int32	[main]	excluded	Number of detected/corrected fringe counter errors (relative fringe count error wrt the gain; i.e., the number of fringe counts (to left (-) or right(+)) the IGM is shifted to match the gain)

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
fringe_count_left_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
fringe_count_left_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
fringe_count_left	integer	Only include elements that match the list of given filter option values
fringe_count_right_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
fringe_count_right_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
fringe_count_right	integer	Only include elements that match the list of given filter option values
fringe_count_error_min	integer	Only include elements for which the value is greater than or equal to the provided filter option value
fringe_count_error_max	integer	Only include elements for which the value is less than or equal to the provided filter option value
fringe_count_error	integer	Only include elements that match the list of given filter option values
wavenumber_min	double	Only include data where the wavenumber is greater then or equal to the value provided (in cm^-1)
wavenumber_max	double	Only include data where the wavenumber is less than or equal to the value provided (in cm^-1)
band	string	Only include data from the specified bands ('A', 'AB', 'B', 'C', and/or 'D')

^* 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	/mipas_level_1b_mds[]/dsr_time
latitude	path	/mipas_level_1b_mds[]/loc_2.latitude
longitude	path	/mipas_level_1b_mds[]/loc_2.longitude
altitude	path	/mipas_level_1b_mds[]/loc_1[0]
spectral_radiance	path	/mipas_level_1b_mds[]/band[][]
spectral_radiance_unit	description	Will be set to "W/(cm^2.sr.cm^-1)"
wavenumber_per_file	path	/sph/first_wavenum[], /sph/last_wavenum[], /sph/num_points_per_band[]
	description	A concatenation of the wavenumbers for each of the 5 bands. The wavenumbers for each of the bands are retrieved via linear interpolation
wavenumber_per_file_unit	description	Will be set to "cm^-1"
nesr	path	/scan_information_ads[]/nesr_data[][], /sph/nesr_first_wavenum, /sph/nesr_last_wavenum
	description	The NESR data is interpolated between the first and last wavenumber as indicated in the SPH. Data outside the NESR wavenumber range (but within the wavenumber range of the bands) will not be extrapolated, but will be set to 0
nesr_unit	description	Will be set to "W/(cm^2.sr.cm^-1)"
fringe_count_left	path	/mipas_level_1b_mds[]/fringe_count[0]
fringe_count_right	path	/mipas_level_1b_mds[]/fringe_count[1]
fringe_count_error	path	/mipas_level_1b_mds[]/num_errs