BEAT-II Record: GOMOS_TRA_L1_satu

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of GOMOS_TRA_L1_satu 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. There will always be one profile per product
time	double	[main]	included	The time of the measurement (in seconds since 2000-01-01 00:00:00)
satu_x	double	[main]	included	X value of the star tracker data
satu_y	double	[main]	included	Y value of the star tracker data
instrument_latitude	double	[main]	included	Latitude of the satellite position
instrument_longitude	double	[main]	included	Longitude of the satellite position
instrument_altitude	double	[main]	included	Altitude of the satellite in km
illumination_condition_per_profile	string	[profile]	included	The ilumination condition for each profile: 'dark', 'bright', 'twilight', 'straylight', or 'twilight/straylight'

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 GOMOS_TRA_L1 product, you will have to provide a filter option data=satu 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
satu_x_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
satu_x_max	double	Only include elements for which the value is less than or equal to the provided filter option value
satu_x	double	Only include elements that match the list of given filter option values
satu_y_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
satu_y_max	double	Only include elements for which the value is less than or equal to the provided filter option value
satu_y	double	Only include elements that match the list of given filter option values
instrument_latitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
instrument_latitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
instrument_latitude	double	Only include elements that match the list of given filter option values
instrument_longitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
instrument_longitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
instrument_longitude	double	Only include elements that match the list of given filter option values
instrument_altitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
instrument_altitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
instrument_altitude	double	Only include elements that match the list of given filter option values
illumination_condition_per_profile	string	Only include elements that match the list of given filter option values

^* 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	/tra_transmission[]/dsr_time
	description	The time for each of the 50 SATU measurements in a DSR is: dsr_time + i * 0.001, i = 0..49
satu_x	condition	product version 0
	path	/tra_satu_and_sfa_data[]/satu_out_x[]
	description	Each value 'x' is calibrated by applying x = 1000000 * (tra_occultation_data[0].satu_offset + tra_occultation_data[0].satu_gain * x)
	condition	product version 1 or higher
	path	/tra_satu_and_sfa_data[]/satu_mispointing_angle_x[]
satu_y	condition	product version 0
	path	/tra_satu_and_sfa_data[]/satu_out_y[]
	description	Each value 'y' is calibrated by applying y = 1000000 * (tra_occultation_data[0].satu_offset + tra_occultation_data[0].satu_gain * y)
	condition	product version 1 or higher
	path	/tra_satu_and_sfa_data[]/satu_mispointing_angle_y[]
instrument_latitude	path	/tra_geolocation[]/lat[1]
	description	The latitude at half-measurement. The value is duplicated for each of the 50 SATU measurements per DSR
instrument_longitude	path	/tra_geolocation[]/longit[1]
	description	The longitude at half-measurement. The value is duplicated for each of the 50 SATU measurements per DSR
instrument_altitude	path	/tra_geolocation[]/alt[1]
	description	The altitude at half-measurement. The value is duplicated for each of the 50 SATU measurements per DSR
illumination_condition_per_profile	condition	product version 0
	path	/tra_summary_quality[0]/limb_flag
	description	Old products only provide dark limb and bright limb information; no straylight and twilight
	condition	product version 1 and higher
	path	/tra_summary_quality[0]/obs_illum_cond