===================
line racer tutorial
===================

Welcome to the line racer tutorial! The following notebooks will outline the basic features of line racer, from how to calculate small line lists on your laptop to calculating the largest ones on clusters.
Additionally, all available features for the line profile and the line calculation will be explained. Moreover, how to put out the opacities in the petitRADTRANS format, if desired.
The notebooks are also available `here <https://gitlab.com/David_Haegele/line_racer/-/blob/main/docs/content/notebooks>`_.
If not already done, please have a look at the `guideline on how to install line racer <../installation.rst>`_ and the `tutorial on how to download line lists <../downloading_line_list_data.rst>`_.
However, in this notebook, we will also download the line lists needed for the examples.

Additionally, if you are interested in the details and physics behind the line calculation and opacities in general, please look at the `physical and computational background of the line calculation <../line_calculation_explanation>`_ in line racer.
Here you also get guidelines on which cutoff to use, how the line broadening works, and if a sub-Lorentzian treatment is a good choice for your case.

The following part of this tutorial will be divided into the different databases. Opacity calculations with line lists from ExoMol will be explained in most detail and then the differences for HITRAN, HITEMP and ExoAtom line lists will be outlined.

.. important:: Line racer requires to download line intensity correction data once before the first opacity calculation. This is done automatically when you prepare the opacity calculation for the first time. However, if that does not work, please download it manually from this `link <https://keeper.mpdl.mpg.de/d/cb4d751acf1941aab44b/>`_ and store the files in a folder `data/`.


.. toctree::
 :maxdepth: 1

 line_racer_exomol
 line_racer_hitran
 line_racer_hitemp
 line_racer_exoatom
 line_racer_intensity_correction
 line_racer_splitting_trans_files

