BEAT-II Record: HITRAN

Fields

The table below gives an overview of possible fields that can be returned from an ingestion of HITRAN 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
line_intensity_h2o	double	[main, spectra]	included	Water vapour line intensity for the reference lines
line_intensity_h2o_unit	string		included	cm^-1/molecules.cm^-2
wavenumber	double	[main, spectra]	included	The wavenumber for each of the reference lines
wavenumber_unit	string		included	cm^-1
transition_moment	double	[main, spectra]	included	Weighted transition-moment squared
einstein_a_coefficient	double	[main, spectra]	included	Einstein A-coefficient
air_broadened_width	double	[main, spectra]	included	Air-broadened width
self_broadened_width	double	[main, spectra]	included	Self-broadened width
lower_state_energy	double	[main, spectra]	included	lower-state Energy
temperature_dependence	double	[main, spectra]	included	Temperature dependence (of air width)
pressure_shift	double	[main, spectra]	included	Pressure shift

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=HITRAN 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.
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)

Mapping description

Below a description is provided on how each data item in the ingested record was retrieved from the product.

Currently only the Water vapour spectra (reference lines) as provided by the RAL Molecular Spectroscopy Facility are supported

field name	mapping description
line_intensity_h2o	description	'line intensity' column (field #4)
line_intensity_h2o_unit	description	Will be set to "cm^-1/molecules.cm^-2"
wavenumber	description	'transition frequency' column (field #3)
wavenumber_unit	description	Will be set to "cm^-1"
transition_moment	condition	HITRAN format 1986 - 2001
	description	'R^2' column (field #5)
einstein_a_coefficient	condition	HITRAN format 2004
	description	'Einstein A-coefficient' column (field #5)
air_broadened_width	description	'Air-broadened width' column (field #6)
self_broadened_width	description	'Self-broadened width' column (field #7)
lower_state_energy	description	'lower-state Energy' column (field #8)
temperature_dependence	description	'Temperature dependence' column (field #9)
pressure_shift	description	'Pressure shift' column (field #10)