ReadHITRAN

Workspace.ReadHITRAN(self: pyarts.arts._Workspace, abs_lines: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.ArrayOfAbsorptionLines]] = self.abs_lines, filename: Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String], fmin: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = -1e99, fmax: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = 1e99, globalquantumnumbers: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "DEFAULT_GLOBAL", localquantumnumbers: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "DEFAULT_LOCAL", hitran_type: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "Online", normalization_option: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "None", mirroring_option: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "None", population_option: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "LTE", lineshapetype_option: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "VP", cutoff_option: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.String]] = "None", cutoff_value: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = 750e9, linemixinglimit_value: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Numeric]] = -1, verbosity: Optional[Union[pyarts.arts.WorkspaceVariable, pyarts.arts.Verbosity]] = self.verbosity) → None

Reads a HITRAN .par file.

The HITRAN type switch can be:

  • "Pre2004": for old format

  • "Post2004": for new format

  • "Online": for the online format with quantum numbers (recommended)

Be careful setting the options!

Note that the isoptopologues in Hitran changes between its versions. We support only one version of Hitran isoptopologues per commit. To read an older version of Hitran, you should down-grade to the correct commit-version. If you still want to make use of modern features, you must also store the generated abs_lines to file and reload the catalog in the new version of Arts. This step needs only be done once per version of Hitran you are using

The complete flow to downgrade, read Hitran, and update is:

  1. ‘git checkout <commit hash>’ to get the old version of Arts

  2. Compile the program

  3. Run ReadHITRAN() to get abs_lines of that version of Hitran

  4. Run abs_linesWriteSpeciesSplitCatalog() to store the abs_lines to a folder

  5. ‘git checkout -’ to get back to your previous version of Arts

  6. Compile the program

  7. Use abs_linesReadSpeciesSplitCatalog() to read what abs_lines

The <commit hash> required per version of Hitran are:

  • Hitran 2020-XXXX: Your current version is OK.

  • Hitran 2004-2016: 60a9664f69f10b3f3eef3d9456282c3638b637fc

  • Hitran pre-2004: d81802cc7fe887446715491ee8a9eab8e370a0c7

Author(s): Hermann Berg, Thomas Kuhn, Richard Larsson

Parameters:

  • abs_lines (ArrayOfAbsorptionLines, optional) – A list of spectral line data. See abs_lines, defaults to self.abs_lines [OUT]

  • filename (String) – Name of the HITRAN file. [IN]

  • fmin (Numeric, optional) – Minimum frequency of read lines. Defaults to -1e99 [IN]

  • fmax (Numeric, optional) – Maximum frequency of read lines. Defaults to 1e99 [IN]

  • globalquantumnumbers (String, optional) – Global quantum number list (space-separated, default gives all). Defaults to "DEFAULT_GLOBAL" [IN]

  • localquantumnumbers (String, optional) – Local quantum number list (space-separated, default gives all). Defaults to "DEFAULT_LOCAL" [IN]

  • hitran_type (String, optional) – Method to use to read the line data. Defaults to "Online" [IN]

  • normalization_option (String, optional) – Normalization option, see abs_linesNormalization(). Defaults to "None" [IN]

  • mirroring_option (String, optional) – Mirroring option, see abs_linesMirroring(). Defaults to "None" [IN]

  • population_option (String, optional) – Population option, see abs_linesPopulation(). Defaults to "LTE" [IN]

  • lineshapetype_option (String, optional) – Lineshape option, see abs_linesLineShapeType(). Defaults to "VP" [IN]

  • cutoff_option (String, optional) – Cutoff option, see abs_linesCutoff(). Defaults to "None" [IN]

  • cutoff_value (Numeric, optional) – Cutoff value, see abs_linesCutoff(). Defaults to 750e9 [IN]

  • linemixinglimit_value (Numeric, optional) – Line mixing limit, see abs_linesLinemixingLimit(). Defaults to -1 [IN]

  • verbosity (Verbosity) – ARTS verbosity. See verbosity, defaults to self.verbosity [IN]