BEAT-II Record: GOSAT_FTS_L1b_band3s
Fields
The table below gives an overview of possible fields that can be returned from an ingestion of GOSAT_FTS_L1b_band3s 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 | Start time of the measurement (in seconds since 2000-01-01 00:00:00) |
latitude | double | [main] | included | Center latitude of the measurement |
longitude | double | [main] | included | Center longitude of the measurement |
spectral_radiance | double | [main, spectra] | included | Radiances derived by taking the norm of the fourier transform of measured wavelengths |
spectral_radiance_unit | string | included | V/cm^-1 | |
wavenumber | double | [main, spectra] | included | The wavenumber for each point in the spectrum |
wavenumber_unit | string | included | cm^-1 |
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 |
|---|---|---|
data | string | Since this record type is not the default type of data that will be ingested for a GOSAT_FTS_L1b product, you will have to provide a filter option data=band3s 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 |
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) |
* 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 | /exposureAttribute/pointAttribute/Time[] |
| description | The record with year/month/day/hour/min/sec values is converted to a single double value givingthe amount of seconds since 2000-01-01 00:00:00 | |
latitude |
path | /exposureAttribute/pointAttribute/geometricInfo/centerLat[] |
longitude |
path | /exposureAttribute/pointAttribute/geometricInfo/centerLon[] |
spectral_radiance |
path | /Spectrum/SWIR/band3/obsWavelength[,1,,] |
| description | The radiance returned is the complex norm of the complex value that is stored in the product. In other words, what is returned is sqrt(real * real + imag * imag). | |
spectral_radiance_unit |
description | Will be set to "V/cm^-1" |
wavenumber |
path | /exposureAttribute/pointAttribute/RadiometricCorrectionInfo/spectrumObsWavelengthRange_SWIR |
| description | The wavenumbers are calculated by evaluating the function a.x + b for x = 0 .. N-1 with a,b the wavelength range parameters in the product | |
wavenumber_unit |
description | Will be set to "cm^-1" |