ARTS built-in documentation server

Workspace Method abs_lines_per_speciesReadFromCatalogues

Description

Read spectral line data from different line catalogues.

For each absorption species, you can specify which catalogue to
use. Because the method creates abs_lines_per_species directly, it
replaces for example the following two method calls:

  - abs_linesReadFromHitran
  - abs_lines_per_speciesCreateFromLines

This method needs as input WSVs the list of species
abs_species. Generic input parameters must specify the names of the
catalogue files to use and the matching formats.  Names can be
anything, formats can currently be HITRAN96 (for HITRAN 1986-2001
databases), HITRAN04 (for HITRAN 2004 database), MYTRAN2, JPL, or
ARTS.  Furthermore, you have to specify minimum and maximum frequency
for each species. To safe typing, if there are less elements in the
keyword parameters than there are species, the last parameters are
applied to all following species.

Example usage:

abs_lines_per_speciesReadFromCatalogues(
   [ "../data/cat1.dat", "../data/cat2.dat" ]
   [ "MYTRAN2",          "HITRAN96"         ]
   [ 0,                  0                  ]
   [ 2000e9,             100e9              ]
)

In this example, lines for the first species will be taken from cat1,
lines for all other species will be taken from cat2. This allows you
for example to use a special line file just for water vapor lines.

Catalogues are only read once, even if several tag groups have the
same catalogue. However, in that case the frequency ranges MUST be the
same. (If you want to do fine-tuning of the frequency ranges, you can
do this inside the tag definitions, e.g., "H2O-*-0-2000e9".)

This function uses the various reading routines
(abs_linesReadFromHitran, etc.), as well as
abs_lines_per_speciesCreateFromLines.

Authors: Stefan Buehler

Synopsis

abs_lines_per_speciesReadFromCatalogues( abs_lines_per_species, abs_species, filenames, formats, fmin, fmax )

Variables

OUTabs_lines_per_species(ArrayOfArrayOfLineRecord)A list of spectral line data for each tag.
INabs_species(ArrayOfArrayOfSpeciesTag)Tag groups for scalar gas absorption.
GINfilenames(ArrayOfString)Name (and path) of the catalogue files.
GINformats(ArrayOfString)Format of each file. (Allowed formats are HITRAN96, HITRAN04, MYTRAN2, JPL, ARTS.
GINfmin(Vector)Minimum frequency for lines to read [Hz].
GINfmax(Vector)Maximum frequency for lines to read [Hz].