BEAT-II Record: BREMEN_SCIAMACHY_VISIBLE_o2

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of BREMEN_SCIAMACHY_VISIBLE_o2 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
`cross_section_o2`	double	[main, spectra]	included	O2 absorption cross section
`cross_section_o2_unit`	string		included	cm^2/molec
`wavelength`	double	[main, spectra]	included	The wavelength for each of the samples
`wavelength_unit`	string		included	nm
`temperature`	double	[main]	included	Temperature at which the absorption cross section was measured

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 BREMEN product, you will have to provide a filter option `data=SCIAMACHY_VISIBLE_o2` 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.
`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
`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)

Mapping description

Below a description is provided on how each data item in the ingested record was retrieved from the product.

Only a single cross section can be ingested. Each cross section is uniquely determined by its label, species, and temperature. The label and species are linked to the 'data' filter option (i.e. they are fixed for a record type). Using the 'temperature' filter option you can select for which temperature the cross section should be ingested. If no 'temperature' option is provided the default temperature is chosen

field name	mapping description
`cross_section_o2`	path	`/ref_spectra[id]/cross_section[], /ref_spectra[id]/label, /ref_spectra[id]/species, /ref_spectra[id]/temperature`
`cross_section_o2`	description	the ref_spectra id is the index for which label="SCIAMACHY-VISIBLE", species="O2", and temperature matches the temperature filter option (default is 293K)
`cross_section_o2_unit`	description	Will be set to "cm^2/molec"
`wavelength`	path	`/ref_spectra[id]/wavelength[], /ref_spectra[id]/label, /ref_spectra[id]/species, /ref_spectra[id]/temperature`
`wavelength`	description	the ref_spectra id is the index for which label="SCIAMACHY-VISIBLE", species="O2", and temperature matches the temperature filter option (default is 293K)
`wavelength_unit`	description	Will be set to "nm"
`temperature`	path	`/ref_spectra[id]/temperature`
`temperature`	description	Since the ref_specta index is determined from the requested temperature instead of the other way arround, the temperature value is taken from the value that was provided for the temperature filter option (or the default temperature value for this record if no filter option is provided)