BEAT-II Record: SCIAMACHY_L1c_sun_reference
Fields
The table below gives an overview of possible fields that can be returned from an ingestion of SCIAMACHY_L1c_sun_reference 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 | |
spectral_irradiance | double | [main, spectra] | included | Sun reference spectrum |
spectral_irradiance_unit | string | included | photons/s.cm^2.nm | |
spectral_irradiance_error | double | [main, spectra] | included | Relative radiometric precission of the sun reference spectrum |
wavelength | double | [main, spectra] | included | The nominal wavelength assignment for the sun reference spectrum |
wavelength_unit | string | included | nm |
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_L1c product, you will have to provide a filter option data=sun_reference 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. |
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.
| field name | mapping description | |
|---|---|---|
spectral_irradiance |
path | /sun_reference[]/mean_ref_spec[], /sun_reference[]/sun_spect_id |
| description | only the first calibrated diffuser sun spectrum is ingested (i.e. sun_spect_id starts with 'D') | |
spectral_irradiance_unit |
description | Will be set to "photons/s.cm^2.nm" |
spectral_irradiance_error |
path | /sun_reference[]/rad_pre_mean_sun_ref_spec[], /sun_reference[]/sun_spect_id |
| description | only the first calibrated diffuser sun spectrum is ingested (i.e. sun_spect_id starts with 'D') | |
wavelength |
path | /sun_reference[]/wvlen_sun_meas[], /sun_reference[]/sun_spect_id |
wavelength_unit |
description | Will be set to "nm" |