.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/0_Database_handling/plot_hitemp_OH_database.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        You can download :ref:`below <sphx_glr_download_auto_examples_0_Database_handling_plot_hitemp_OH_database.py>`
        the full example code and run it with 🔬 `Radis-Lab <https://radis.github.io/radis-lab/>`__,

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_examples_0_Database_handling_plot_hitemp_OH_database.py:


.. _example_download_hitemp:

============================
Download the HITEMP database
============================

Database will be downloaded automatically and can be edited locally.

To compute a spectrum with the HITEMP database, see the
:ref:`Calculate a HITEMP spectrum example <example_calculate_hitemp>`

By default the database is returned as a Pandas DataFrame.
To explore huge databases (like CO2, CH4 or H2O) that do not fit in RAM,
RADIS allows you to use a Vaex DataFrame instead (out-of-RAM).
See the :ref:`Explore Database with Vaex example <example_explore_database_vaex>`

.. GENERATED FROM PYTHON SOURCE LINES 19-26

.. code-block:: Python


    from radis.io.hitemp import fetch_hitemp

    df = fetch_hitemp("OH")
    print(df.columns)






.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    Downloading 13_HITEMP2020.par.bz2 for OH (1/1).
    Download complete. Parsing OH database to /home/docs/.radisdb/hitemp/OH-13_HITEMP2020.hdf5
    [04/24/24 08:58:13] WARNING  could not close memmap for       dataset_mmap.py:94
                                 column                                             
                                 /home/docs/.radisdb/hitemp/OH-13                   
                                 _HITEMP2020_temp00000.hdf5                         
    Added HITEMP-OH database in /home/docs/radis.json
    Index(['id', 'iso', 'wav', 'int', 'A', 'airbrd', 'selbrd', 'El', 'Tdpair',
           'Pshft', 'globu', 'globl', 'locu', 'locl', 'ierr', 'iref', 'lmix', 'gp',
           'gpp'],
          dtype='object')




.. GENERATED FROM PYTHON SOURCE LINES 27-39

Returns:
::
   Index(['id', 'iso', 'wav', 'int', 'A', 'airbrd', 'selbrd', 'El', 'Tdpair',
          'Pshft', 'globu', 'globl', 'locu', 'locl', 'ierr', 'iref', 'lmix', 'gp',
          'gpp'],
         dtype='object')

Columns are described in :py:attr:`~radis.io.hitran.columns_2004`

A specific can be retrieved with the same :py:func:`~radis.io.hitemp.fetch_hitemp`
function. The already downloaded database will be used:


.. GENERATED FROM PYTHON SOURCE LINES 39-42

.. code-block:: Python


    df = fetch_hitemp("OH", load_wavenum_min=31500, load_wavenum_max=33000, isotope="1")
    df.plot("wav", "int")



.. image-sg:: /auto_examples/0_Database_handling/images/sphx_glr_plot_hitemp_OH_database_001.png
   :alt: plot hitemp OH database
   :srcset: /auto_examples/0_Database_handling/images/sphx_glr_plot_hitemp_OH_database_001.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    <Axes: xlabel='wav'>




.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 1.976 seconds)


.. _sphx_glr_download_auto_examples_0_Database_handling_plot_hitemp_OH_database.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: plot_hitemp_OH_database.ipynb <plot_hitemp_OH_database.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: plot_hitemp_OH_database.py <plot_hitemp_OH_database.py>`