Cthulhu.HITEMP
==============

.. py:module:: Cthulhu.HITEMP


Functions
---------

.. autoapisummary::

   Cthulhu.HITEMP.create_id_dict
   Cthulhu.HITEMP.check
   Cthulhu.HITEMP.determine_linelist
   Cthulhu.HITEMP.create_pf
   Cthulhu.HITEMP.create_air_broad
   Cthulhu.HITEMP.summon_HITEMP


Module Contents
---------------

.. py:function:: create_id_dict()

   Recreate the table of molecular names and IDs that HITRAN uses for identification

   :returns: **molecule_dict** -- Dictionary where the keys are HITRAN molecular names and the values are the respective HITRAN molecular IDs,
             as seen on https://hitran.org/lbl/.
   :rtype: dict


.. py:function:: check(molecule, isotope)

   Checks if the parameters passed into the summon() function by the user are valid to use with the HITEMP database.

   :param molecule: Molecule name (e.g. H2O).
   :type molecule: String
   :param isotope: Isotopologue number of the molecule (1 = most common isotopologue, 2 = second most common, etc.).
   :type isotope: int

   :returns: **molecule_id_number** -- Molecule ID number of the given molecule, as given by the first column in HITEMP here: https://hitran.org/hitemp/.
   :rtype: int


.. py:function:: determine_linelist()

   Determines the molecule and isotopologue that would like to be accessed based on user input

   :returns: * **molecule_ID** (*int*) -- Molecule ID number of the given molecule, as given by the first column in HITEMP here: https://hitran.org/hitemp/.
             * **isotopologue_ID** (*int*) -- Isotopologue number of the molecule (1 = most common isotopologue, 2 = second most common, etc.).


.. py:function:: create_pf(mol_ID, iso_ID, folder, T_min=70, T_max=3001, step=1.0)

   Create partition function file using the partitionSum() function already in hapi

   :param mol_ID: Molecule ID number of the given molecule, as given by the first column in HITEMP here: https://hitran.org/hitemp/.
   :type mol_ID: int
   :param iso_ID: Isotopologue number of the molecule (1 = most common isotopologue, 2 = second most common, etc.).
   :type iso_ID: int
   :param folder: Local directory where the partition function file is to be stored.
   :type folder: String
   :param T_min: Minimum temperature (K) for which the partition function is computed by hapy.py. The default is 70.
   :type T_min: int, optional
   :param T_max: Maximum temperature (K) for which the partition function is computed by hapy.py. The default is 3001.
   :type T_max: int, optional
   :param step: Increment for temperature between T_min and T_max. The default is 1.0.
   :type step: float, optional

   :rtype: None.


.. py:function:: create_air_broad(input_dir)

   Create an air broadening file using the downloaded line list.

   :param input_dir: Local directory where the broadening file is to be stored.
   :type input_dir: String

   :rtype: None.


.. py:function:: summon_HITEMP(molecule, isotopologue)

   Main function, uses calls to other functions to perform the download

   :param molecule: Molecule ID number of the given molecule, as given by the first column in HITEMP here: https://hitran.org/hitemp/.
   :type molecule: int
   :param isotopologue: Isotopologue number of the molecule (1 = most common isotopologue, 2 = second most common, etc.).
   :type isotopologue: int

   :rtype: None.