BEAT-II Record: ACE_FTS_L2_ASCII_iso

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of ACE_FTS_L2_ASCII_iso 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
time_per_profile	double	[profile]	included	Measurement time of the profile
latitude_per_profile	double	[profile]	included	Latitude of the profile
longitude_per_profile	double	[profile]	included	Longitude of the profile
altitude	double	[main]	included	Altitude of each profile element (in km)
pressure	double	[main]	included	Pressure at each profile element (in hPa)
h2o_181_vmr	double	[main]	included*	H2O (181 isotopologue) vmr (in ppmv)
h2o_181_vmr_error	double	[main]	included*	Statistical error for H2O (181) vmr. If this value is -888, the vmr was not retrieved, but obtained by scaling the a priori value
h2o_171_vmr	double	[main]	excluded	H2O (171 isotopologue) vmr (in ppmv)
h2o_171_vmr_error	double	[main]	excluded	Statistical error for H2O (171) vmr. If this value is -888, the vmr was not retrieved, but obtained by scaling the a priori value
h2o_162_vmr	double	[main]	excluded	H2O (162 isotopologue) vmr (in ppmv)
h2o_162_vmr_error	double	[main]	excluded	Statistical error for H2O (162) vmr. If this value is -888, the vmr was not retrieved, but obtained by scaling the a priori value
ch4_311_vmr	double	[main]	excluded	CH4 (311 isotopologue) vmr (in ppmv)
ch4_311_vmr_error	double	[main]	excluded	Statistical error for CH4 (311) vmr. If this value is -888, the vmr was not retrieved, but obtained by scaling the a priori value
ch4_212_vmr	double	[main]	excluded	CH4 (212 isotopologue) vmr (in ppmv)
ch4_212_vmr_error	double	[main]	excluded	Statistical error for CH4 (212) vmr. If this value is -888, the vmr was not retrieved, but obtained by scaling the a priori value
temperature	double	[main]	included	Temperature of each profile element (in K)
air	double	[main]	excluded	Air density (in cm^-3)

^* Included by default only if no 'include' ingestion filter option was provided.

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_type	string	BEAT will not be able to automatically recognize this product, so you will have to provide a filter option product_type=ACE_FTS_L2_ASCII_iso to let BEAT-II know that the files that you provided are of this type.
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_per_profile_min	time*	Only include elements for which the value is greater than or equal to the provided filter option value
time_per_profile_max	time*	Only include elements for which the value is less than or equal to the provided filter option value
time_per_profile	time*	Only include elements that match the list of given filter option values
latitude_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
latitude_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
latitude_per_profile	double	Only include elements that match the list of given filter option values
longitude_per_profile_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
longitude_per_profile_max	double	Only include elements for which the value is less than or equal to the provided filter option value
longitude_per_profile	double	Only include elements that match the list of given filter option values
altitude_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
altitude_max	double	Only include elements for which the value is less than or equal to the provided filter option value
altitude	double	Only include elements that match the list of given filter option values
pressure_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
pressure_max	double	Only include elements for which the value is less than or equal to the provided filter option value
pressure	double	Only include elements that match the list of given filter option values
h2o_181_vmr_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_181_vmr_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_181_vmr	double	Only include elements that match the list of given filter option values
h2o_181_vmr_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_181_vmr_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_181_vmr_error	double	Only include elements that match the list of given filter option values
h2o_171_vmr_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_171_vmr_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_171_vmr	double	Only include elements that match the list of given filter option values
h2o_171_vmr_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_171_vmr_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_171_vmr_error	double	Only include elements that match the list of given filter option values
h2o_162_vmr_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_162_vmr_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_162_vmr	double	Only include elements that match the list of given filter option values
h2o_162_vmr_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
h2o_162_vmr_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
h2o_162_vmr_error	double	Only include elements that match the list of given filter option values
ch4_311_vmr_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
ch4_311_vmr_max	double	Only include elements for which the value is less than or equal to the provided filter option value
ch4_311_vmr	double	Only include elements that match the list of given filter option values
ch4_311_vmr_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
ch4_311_vmr_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
ch4_311_vmr_error	double	Only include elements that match the list of given filter option values
ch4_212_vmr_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
ch4_212_vmr_max	double	Only include elements for which the value is less than or equal to the provided filter option value
ch4_212_vmr	double	Only include elements that match the list of given filter option values
ch4_212_vmr_error_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
ch4_212_vmr_error_max	double	Only include elements for which the value is less than or equal to the provided filter option value
ch4_212_vmr_error	double	Only include elements that match the list of given filter option values
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
air_min	double	Only include elements for which the value is greater than or equal to the provided filter option value
air_max	double	Only include elements for which the value is less than or equal to the provided filter option value
air	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_per_profile	description	date field from header section
latitude_per_profile	description	latitude field from header section
longitude_per_profile	description	longitude field from header section
altitude	description	'z' column in table
pressure	description	'P (atm)' column in table. The pressure is converted to hPa by multiplying by 1013.25
h2o_181_vmr	description	'H2O (181)' column in table. Converted to ppmv by multiplying by 1E6
h2o_181_vmr_error	description	'181_err' column in table. Converted to ppmv by multiplying by 1E6
h2o_171_vmr	description	'H2O (171)' column in table. Converted to ppmv by multiplying by 1E6
h2o_171_vmr_error	description	'171_err' column in table. Converted to ppmv by multiplying by 1E6
h2o_162_vmr	description	'H2O (162)' column in table. Converted to ppmv by multiplying by 1E6
h2o_162_vmr_error	description	'162_err' column in table. Converted to ppmv by multiplying by 1E6
ch4_311_vmr	description	'CH4 (311)' column in table. Converted to ppmv by multiplying by 1E6
ch4_311_vmr_error	description	'311_err' column in table. Converted to ppmv by multiplying by 1E6
ch4_212_vmr	description	'CH4 (212)' column in table. Converted to ppmv by multiplying by 1E6
ch4_212_vmr_error	description	'212_err' column in table. Converted to ppmv by multiplying by 1E6
temperature	description	'T' column in table
air	description	'dens' column in table