BEAT-II Record: GOSAT_FTS_L2_CO2_TC

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of GOSAT_FTS_L2_CO2_TC 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	The time of the measurement at end of integration time (in seconds since 2000-01-01 00:00:00)
latitude	double	[main]	included	Latitude of the measurement
longitude	double	[main]	included	Longitude of the measurement
corner_latitude	double	[main, 4]	included	4 corner latitudes for the geospatial footprint of the measurement
corner_longitude	double	[main, 4]	included	4 corner latitudes for the geospatial footprint of the measurement
co2_column	double	[main]	included	CO2 total column
co2_column_unit	string		included	molec/cm^2
co2_column_error	double	[main]	included	Absolute error on the CO2 total column
co2_column_error_unit	string		included	molec/cm^2
solar_zenith_angle	double	[main]	excluded	Solar zenith angle at observation point
los_zenith_angle	double	[main]	excluded	Viewing zenith angle at observation point
solar_azimuth_angle	double	[main]	excluded	Solar azimuth angle at observation point
los_azimuth_angle	double	[main]	excluded	Viewing azimuth angle at observation point

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
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
co2_column_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
co2_column_max	double	Only include elements for which the value is less than or equal to the provided filter option value
co2_column	double	Only include elements that match the list of given filter option values
co2_column_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
co2_column_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
co2_column_error	double	Only include elements that match the list of given filter option values
solar_zenith_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_zenith_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_zenith_angle	double	Only include elements that match the list of given filter option values
los_zenith_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_zenith_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_zenith_angle	double	Only include elements that match the list of given filter option values
solar_azimuth_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
solar_azimuth_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
solar_azimuth_angle	double	Only include elements that match the list of given filter option values
los_azimuth_angle_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
los_azimuth_angle_max	double	Only include elements for which the value is less than or equal to the provided filter option value
los_azimuth_angle	double	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	/scanAttribute/time[]
latitude	path	/Data/geolocation/latitude[]
longitude	path	/Data/geolocation/longitude[]
corner_latitude	path	/Data/geolocation/footPrintLatitude
corner_longitude	path	/Data/geolocation/footPrintLongitude
co2_column	path	/Data/totalColumn/CO2TotalColumn
co2_column_unit	description	Will be set to "molec/cm^2"
co2_column_error	path	/Data/totalColumn/CO2TotalColumnSmoothingError, /Data/totalColumn/CO2TotalColumnRetrievalNoise, /Data/totalColumn/CO2TotalColumnInterferenceError, /Data/totalColumn/CO2TotalColumnExternalNoise
	description	The returned error is the sum of all four error components
co2_column_error_unit	description	Will be set to "molec/cm^2"
solar_zenith_angle	path	/Data/geolocation/solarZenith[]
los_zenith_angle	path	/Data/geolocation/satelliteZenith[]
	description	The viewing angle is the opposite of the satellite angle. The returned angle is thus 180 - angle.
solar_azimuth_angle	path	/Data/geolocation/solarAzimuth[]
los_azimuth_angle	path	/Data/geolocation/satelliteAzimuth[]
	description	The viewing angle is the opposite of the satellite angle. The returned angle is thus angle + 180 (mapped to [0,360]).