pyratbay 2.0.0b3__tar.gz → 2.0.0b4__tar.gz

{pyratbay-2.0.0b3 → pyratbay-2.0.0b4}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pyratbay
-Version: 2.0.0b3
+Version: 2.0.0b4
 Summary: Python Radiative Transfer in a Bayesian Framework
 Author-email: Patricio Cubillos <patricio.cubillos@oeaw.ac.at>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -356,6 +356,7 @@ Requires-Dist: h5py>=3.10.0
 Provides-Extra: test
 Requires-Dist: pytest>=3.9; extra == "test"
 Requires-Dist: mpi4py>=3.1.4; extra == "test"
+Dynamic: license-file
 
 # Pyrat Bay: Python Radiative Transfer in a Bayesian framework
 

{pyratbay-2.0.0b3 → pyratbay-2.0.0b4}/docs/getstarted.rst

@@ -36,7 +36,7 @@ The following table details what each of these steps do.
 | ``spectrum``   | Compute forward-modeling spectra (transmission or          |
 |                | emission)                                                  |
 +----------------+------------------------------------------------------------+
-| ``mcmc``       | Run an atmospheric retrieval                               |
+| ``retrieval``  | Run an atmospheric retrievals                              |
 +----------------+------------------------------------------------------------+
 
 Any of these steps can be run either interactively though the Python
@@ -85,7 +85,7 @@ To install ``Pyrat Bay`` run the following command from the terminal:
 
 .. code-block:: shell
 
-    pip install pyratbay
+    pip install pyratbay>=2.0.0b3
 
 Or if you prefer conda:
 
@@ -134,16 +134,15 @@ Download the water line-transition database from the HITRAN server and unzip it:
 
 Copy the input and configuration files for the demo from the `examples
 folder
-<https://github.com/pcubillos/pyratbay/tree/master/examples/demo>`_ to
+<https://github.com/pcubillos/pyratbay/tree/ver2.0/examples/>`_ to
 your working directory.  For example, use the following shell commands:
 
 .. code-block:: shell
 
-    demo_path=https://raw.githubusercontent.com/pcubillos/pyratbay/master/examples/demo
-    wget $demo_path/demo_spectrum-emission.cfg
-    wget $demo_path/demo_spectrum-transmission.cfg
-    wget $demo_path/demo_tli-hitran.cfg
-    wget $demo_path/uniform.atm
+    demo=https://raw.githubusercontent.com/pcubillos/pyratbay/ver2.0/tutorials/
+    wget $demo/tutorial_tli_hitran_H2O.cfg
+    wget $demo/tutorial_spectrum_emission.cfg
+    wget $demo/tutorial_spectrum_transmission.cfg
 
 
 Execute these commands from the shell to create a
@@ -153,11 +152,11 @@ transmission and emission spectra:
 .. code-block:: shell
 
    # Format line-by-line opacity:
-   pbay -c demo_tli-hitran.cfg
+   pbay -c tutorial_tli_hitran_H2O.cfg
 
    # Compute transmission and emission spectra:
-   pbay -c demo_spectrum-transmission.cfg
-   pbay -c demo_spectrum-emission.cfg
+   pbay -c tutorial_spectrum_transmission.cfg
+   pbay -c tutorial_spectrum_emission.cfg
 
 .. Outputs
    ^^^^^^^
@@ -172,44 +171,51 @@ interactive mode, I suggest starting the session with ``ipython
 
 .. code-block:: python
 
+  import pyratbay as pb
+  import pyratbay.spectrum as ps
+  import pyratbay.io as io
   import matplotlib
-  from scipy.ndimage.filters import gaussian_filter1d as gaussf
   import matplotlib.pyplot as plt
   plt.ion()
 
-  import pyratbay as pb
-  import pyratbay.io as io
 
-  wl, transmission = io.read_spectrum("./transmission_spectrum_demo.dat", wn=False)
-  wl, emission     = io.read_spectrum("./emission_spectrum_demo.dat", wn=False)
+  wl, transmission = io.read_spectrum("./transmission_spectrum_tutorial.dat", wn=False)
+  wl, emission = io.read_spectrum("./emission_spectrum_tutorial.dat", wn=False)
+
+  bin_wl = ps.constant_resolution_spectrum(0.3, 8.0, resolution=200)
+  bin_transit = ps.bin_spectrum(bin_wl, wl, transmission)
+  bin_emission = ps.bin_spectrum(bin_wl, wl, emission)
 
-  plt.figure(0, figsize=(7,5))
+  fig = plt.figure(0)
   plt.clf()
-  plt.subplots_adjust(0.14, 0.1, 0.95, 0.95, hspace=0.15)
+  fig.set_size_inches(7,5)
+  plt.subplots_adjust(0.12, 0.1, 0.98, 0.95, hspace=0.15)
   ax = plt.subplot(211)
-  plt.plot(wl, 100*transmission, "b", label="pyrat transmission model", lw=1.0)
-  plt.plot(wl, gaussf(100*transmission, sigma=5.0), "orange", lw=1.25)
+  plt.plot(wl, 100*transmission, color="royalblue", label="transmission model", lw=1.0)
+  plt.plot(bin_wl, 100*bin_transit, "salmon", lw=1.5)
   plt.xscale('log')
-  plt.ylabel(r"$(R_{\rm p}/R_{\rm s})^2}$  (%)")
+  plt.ylabel('Transit depth (%)')
   ax.get_xaxis().set_major_formatter(matplotlib.ticker.ScalarFormatter())
-  ax.set_xticks([0.5, 0.7, 1.0, 2.0, 3.0, 4.0, 5.0])
-  plt.xlim(0.5, 5.5)
-  plt.ylim(1.88, 2.15)
+  ax.set_xticks([0.3, 0.5, 0.7, 1.0, 2.0, 3.0, 5.0, 7.0])
+  ax.tick_params(which='both', direction='in')
+  plt.xlim(0.3, 8.0)
+  plt.ylim(1.88, 2.17)
   plt.legend(loc="upper left")
 
   ax = plt.subplot(212)
-  plt.plot(wl, emission, "b", label="pyrat emission model", lw=1.0)
-  plt.plot(wl, gaussf(emission, sigma=5.0), "orange", lw=1.25)
+  plt.plot(wl, emission, "royalblue", label="emission model", lw=1.0)
+  plt.plot(bin_wl, bin_emission, "salmon", lw=1.5)
   plt.xscale('log')
   plt.xlabel(r"Wavelength  (um)")
-  plt.ylabel(r"$F_{\rm planet}$ (erg s$^{-1}$ cm$^{-2}$ cm)")
+  plt.ylabel(r"$F_{\rm p}$ (erg s$^{-1}$ cm$^{-2}$ cm)")
   ax.get_xaxis().set_major_formatter(matplotlib.ticker.ScalarFormatter())
-  ax.set_xticks([0.5, 0.7, 1.0, 2.0, 3.0, 4.0, 5.0])
-  plt.ylim(0, 60000)
-  plt.xlim(0.5, 5.5)
+  ax.set_xticks([0.3, 0.5, 0.7, 1.0, 2.0, 3.0, 5.0, 7.0])
+  ax.tick_params(which='both', direction='in')
+  plt.ylim(0, 52000)
+  plt.xlim(0.3, 8.0)
   plt.legend(loc="upper left")
   plt.draw()
-  plt.savefig("pyrat_spectrum_demo.pdf")
+  plt.savefig("pyrat_spectrum_demo.png", dpi=300)
 
 The output figure should look like this:
 
@@ -249,7 +255,7 @@ importing the ``Pyrat Bay`` package:
 .. code-block:: python
 
     import pyratbay as pb
-    pyrat = pb.run('demo_spectrum-transmission.cfg')
+    pyrat = pb.run('tutorial_spectrum_transmission.cfg')
     ax = pyrat.plot_spectrum()
 
 The output vary depending on the selected run mode.  Additional low-

{pyratbay-2.0.0b3 → pyratbay-2.0.0b4}/docs/index.rst

@@ -57,7 +57,7 @@ The radiative-transfer include opacity sources from:
 - Na and K alkali resonant lines
 - Gray and Mie (soon) aerosol opacities
 
-Bayesian (MCMC) posterior sampling of atmospheric parameters:
+Bayesian (MCMC and Nested sampling) posterior sampling of atmospheric parameters:
 
 - Molecular abundances
 - Temperature profile
@@ -81,10 +81,9 @@ Documentation
    :includehidden:
 
    getstarted
-   tli_tutorial
+   line_sampling
    atm_tutorial
    spec_tutorial
-   opac_tutorial
    retrieval_tutorial
    cookbooks/recipes
    api
@@ -103,7 +102,7 @@ If you found ``Pyrat Bay`` useful for your research, please cite this article:
 Please prefer to channel your feedback or inquiries through the Github issue tracker: `<https://github.com/pcubillos/pyratbay>`_, or alternatively through this email: `patricio.cubillos[at]oeaw.ac.at`_.
 
 ``Pyrat Bay`` is open-source software under the GNU GPL v2 license (see
-:ref:`license`) and is compatible with Python>=3.6.
+:ref:`license`) and is compatible with Python>=3.9.
 
 
 .. _Patricio Cubillos: https://github.com/pcubillos/

pyratbay-2.0.0b4/docs/line_sampling.rst

@@ -0,0 +1,222 @@
+.. |H2O| replace:: H\ :sub:`2`\ O
+.. |CO2| replace:: CO\ :sub:`2`
+.. |CH4| replace:: CH\ :sub:`4`
+.. |H2|  replace:: H\ :sub:`2`
+.. |N2O| replace:: N\ :sub:`2`\ O
+.. |NO2| replace:: NO\ :sub:`2`
+
+
+.. _line_sampling:
+
+Line Sampling
+=============
+
+
+`Pyrat Bay` enable users to generate their own line-sampled
+cross-section files out of line-by-line data.  In this process, users
+can make all the customization that they deem necessary (e.g.,
+line-wing cutoffs, sampling rates, wavelength ranges, temperature
+ranges, pressure ranges).
+
+There are two steps needed to compute cross sections:
+
+1. Convert line lists from their **original format** (e.g., HITRAN or
+   ExoMol) into transition-line information files (**TLI**).
+
+2. Conver **TLI** files into **cross-section tables** (saved as Numpy
+   ``.npz`` files).
+
+
+
+Available Databases
+-------------------
+
+``Pyrat Bay`` can process line-lists from the two main sources of
+line-transition data of interest for exoplanet atmospheres: HITRAN [Gordon2022]_ and
+Exomol [Tennyson2016]_.  Additionally, ``Pyrat Bay`` is also compatible with
+``repack`` [Cubillos2017b]_, a package extracting only the strong line
+transitions from large HITEMP, ExoMol, or AMES databases (reducing
+from billions to millions of lines).
+
+The tables below show the main species of interest to model exoplanet
+atmospheres from each database (non-exhaustive, there are move species
+available in each database).
+
+.. list-table:: Available linelists from HITRAN
+   :header-rows: 1
+   :widths: 7, 20, 25
+
+   * - Source
+     - Species (label)
+     - References
+   * - HITEMP
+     - `H2O <https://hitran.org/hitemp/>`__ (2010)
+     - [Rothman2010]_
+   * - 
+     - `CO2 <https://hitran.org/hitemp/>`__ (2024)
+     - [Hargreaves2025]_
+   * - 
+     - `CO <https://hitran.org/hitemp/>`__ (2019)
+     - [Li2015]_
+   * - 
+     - `CH4 <https://hitran.org/hitemp/>`__ (2020)
+     - [Hargreaves2020]_
+   * - 
+     - `N2O <https://hitran.org/hitemp/>`__ (2019)
+     - [Hargreaves2019]_
+   * - 
+     - `NO <https://hitran.org/hitemp/>`__ (2019)
+     - [Hargreaves2019]_
+   * - HITRAN
+     - `H2O, NH3, and many others <https://hitran.org/lbl/>`__
+     - [Gordon2022]_
+
+
+
+.. list-table:: Available linelists from ExoMol
+   :header-rows: 1
+   :widths: 7, 20, 25
+
+   * - Source
+     - Species (label)
+     - References
+   * - ExoMol
+     - `H2O <https://www.exomol.com/data/molecules/H2O/>`__ (pokazatel)
+     - [Polyansky2018]_
+   * - 
+     - `CO2 <https://www.exomol.com/data/molecules/CO2/12C-16O2/UCL-4000/>`__ (ucl4000)
+     - [Yurchenko2020]_
+   * - 
+     - `CH4 <https://www.exomol.com/data/molecules/CH4/12C-1H4/MM/>`__ (mm)
+     - [Yurchenko2024a]_
+   * - 
+     - `NH3 <https://www.exomol.com/data/molecules/NH3/>`__ (coyute)
+     - [Coles2019]_ [Yurchenko2024b]_
+   * - 
+     - `TiO <https://www.exomol.com/data/molecules/TiO/>`__ (toto)
+     - [McKemmish2019]_
+   * - 
+     - `VO <https://www.exomol.com/data/molecules/VO/51V-16O/HyVO/>`__ (hyvo)
+     - [Bowesman2024]_
+   * - 
+     - `HCN <https://www.exomol.com/data/molecules/HCN/>`__ (harris & larner)
+     - [Harris2008]_ [Barber2014]_
+   * - 
+     - `SO2 <https://www.exomol.com/data/molecules/SO2/32S-16O2/ExoAmes/>`__ (exoames)
+     - [Underwood2016]_
+   * - 
+     - `H2S <https://www.exomol.com/data/molecules/H2S/1H2-32S/AYT2/>`__ (ayt2)
+     - [Azzam2016]_ [Chubb2018]_
+   * - 
+     - `C2H2 <https://www.exomol.com/data/molecules/C2H2/12C2-1H2/aCeTY/>`__ (acety)
+     - [Chubb2020]_
+
+
+
+.. list-table:: Available linelists from repack
+   :header-rows: 1
+   :widths: 7, 20, 25
+
+   * - Source
+     - Species (label)
+     - References
+   * - repack
+     - `H2O <https://zenodo.org/api/records/14266247/draft/files/H2O_exomol_pokazatel_0.24-500.0um_100-3500K_threshold_0.01_lbl.dat>`__ (exomol, pokazatel)
+     -  [Cubillos2017b]_ [Polyansky2018]_
+   * - 
+     - `CO2 <https://zenodo.org/api/records/14266247/draft/files/CO2_exomol_ucl4000_0.5-500.0um_100-3500K_threshold_0.01_lbl.dat>`__ (exomol, ucl4000)
+     - [Cubillos2017b]_ [Yurchenko2020]_
+   * - 
+     - `CO2 <https://zenodo.org/api/records/14266247/draft/files/CO2_ames_ai3000k_0.5-50.0um_100-3500K_threshold_0.01_lbl.dat>`__ (ames, ai3000k) 
+     - [Cubillos2017b]_ 
+   * - 
+     - `CH4 <https://zenodo.org/api/records/14266247/draft/files/CH4_exomol_mm_0.83-50.0um_100-3000K_threshold_0.03_lbl.dat>`__ (exomol, mm)
+     - [Cubillos2017b]_ [Yurchenko2024a]_
+   * - 
+     - `NH3 <https://zenodo.org/api/records/14266247/draft/files/NH3_exomol_coyute_0.5-500.0um_100-3000K_threshold_0.01_lbl.dat>`__ (exomol, coyute)
+     - [Cubillos2017b]_ [Coles2019]_ [Yurchenko2024b]_
+   * - 
+     - `TiO <https://zenodo.org/api/records/14266247/draft/files/TiO_exomol_toto_0.33-500um_100-3500K_threshold_0.01_lbl.dat>`__ (exomol, toto)
+     - [Cubillos2017b]_ [McKemmish2019]_
+   * - 
+     - `VO <https://zenodo.org/api/records/14266247/draft/files/VO_exomol_hyvo_0.22-50um_100-3500K_threshold_0.01_lbl.dat>`__ (exomol, hyvo)
+     - [Cubillos2017b]_ [Bowesman2024]_
+   * - 
+     - `HCN <https://zenodo.org/api/records/14266247/draft/files/HCN_exomol_harris-larner_0.56-500um_100-3500K_threshold_0.01_lbl.dat>`__ (exomol, harris larner)
+     - [Cubillos2017b]_ [Harris2008]_ [Barber2014]_
+   * - 
+     - `SO2 <https://zenodo.org/api/records/14266247/draft/files/SO2_exomol_exoames_1.25-100.0um_100-3500K_threshold_0.03_lbl.dat>`__ (exomol, exoames)
+     - [Cubillos2017b]_ [Underwood2016]_
+   * - 
+     - `H2S <https://zenodo.org/api/records/14266247/draft/files/H2S_exomol_ayt2_0.28-500.0um_100-3500K_threshold_0.01_lbl.dat>`__ (exomol, ayt2) 
+     - [Cubillos2017b]_ [Azzam2016]_ [Chubb2018]_
+   * - 
+     - `C2H2 <https://zenodo.org/api/records/14266247/draft/files/C2H2_exomol_acety_1.0-500.0um_100-3500K_threshold_0.03_lbl.dat>`__ (exomol, acety)
+     - [Cubillos2017b]_ [Chubb2020]_
+   * - 
+     - `C2H4 <https://zenodo.org/api/records/14266247/draft/files/C2H4_exomol_mayty_1.4-500um_100-3500K_threshold_0.03_lbl.dat>`__ (exomol, mayty)
+     - [Cubillos2017b]_ [Mant2018]_
+
+
+
+.. _sample_tli_cfg:
+
+Line-sampling Tutorials
+-----------------------
+
+The following links show step-by-step tutorials to compute
+cross-section tables (i.e., line sampling) from each database:
+
+- :doc:`cookbooks/line_sampling/line_list_hitran`
+- :doc:`cookbooks/line_sampling/line_list_exomol`
+- :doc:`cookbooks/line_sampling/line_list_repack`
+
+
+Computing cross sections often require to sample millions-to-billions
+of line transitions. Thus, it can both become a computer-intensive
+calculation and require/produce large files. ``Pyrat Bay`` was
+designed with this two-step approach to optimize these calculations.
+
+Below there are a few useful notes to keep in mind when computing
+cross sections.
+
+
+Partition functions
+~~~~~~~~~~~~~~~~~~~
+
+While line-list databases do not change often with time, thus, TLI
+files containing the line transitions can typically be computed only
+once, and being used for many projects.  For this reason, it is
+recommended to compute TLI files with the widest possible available
+wavelength range.
+
+TLI calculations also requires the input of partition functions, which
+depend on the temperature.  Ideally, you also want to compute TLI
+files with the widest temperature range.  The tutorials above show how
+to obtain partition functions from each database.  In addition, this
+tutorial below shows more in general how to handle partition functions
+(e.g., how to compute PFs at high temperatures):
+
+- :doc:`cookbooks/partition_functions`
+
+
+Cross sections
+~~~~~~~~~~~~~~
+
+In contrast, cross sections might need to be more frequently
+re-computed for specific project to adjust, for example, to the
+sampling resolution or grid boundaries (in `T`, `p`, or
+:math:`\lambda`), or need to separate between different isotopes of a
+same species.  Use the tutorials above as a template, and modifies
+them to adjust to the scientific requirements/machine capabilities
+that each project requires.
+
+
+If in a hurry and want to immediately start computing spectra, ``Pyrat
+Bay`` is also compatible with the `petitRADTRANS
+<https://petitradtrans.readthedocs.io/en/latest/content/available_opacities.html#high-resolution-opacities-lbl-lambda-delta-lambda-10-6>`_
+cross section files [Molliere2019]_.  These files can be directly used
+as input in spectrum or retrieval calculations (and can be used in
+combination with the ``wn_thinning`` argument of the configuration
+files to reduce the sampling resolution).  More documentation on this
+is coming `soon`.

{pyratbay-2.0.0b3 → pyratbay-2.0.0b4}/docs/references.rst

@@ -3,12 +3,14 @@
 References
 ==========
 
-.. [Asplund2009] `Asplund et al. (2009): The Chemical Composition of the Sun <https://ui.adsabs.harvard.edu/abs/2009ARA&A..47..481A>`_
+.. .. [Asplund2009] `Asplund et al. (2009): The Chemical Composition of the Sun <https://ui.adsabs.harvard.edu/abs/2009ARA&A..47..481A>`_
 
 .. [Asplund2021] `Asplund et al. (2021): The chemical make-up of the Sun: A 2020 vision <https://ui.adsabs.harvard.edu/abs/2021A%26A...653A.141A>`_
 
 .. [Azzam2016] `Azzam et al. (2016): ExoMol molecular line lists - XVI. The rotation-vibration spectrum of hot H2S <https://ui.adsabs.harvard.edu/abs/2016MNRAS.460.4063A>`_
 
+.. [Barber2014] `Barber et al (2014): ExoMol line lists - III. An improved hot rotation-vibration line list for HCN and HNC <https://ui.adsabs.harvard.edu/abs/2014MNRAS.437.1828B>`_
+
 .. [Blecic2016] `Blecic et al (2016): TEA: A Code Calculating Thermochemical Equilibrium Abundances <https://ui.adsabs.harvard.edu/abs/2016ApJS..225....4B>`_
 
 .. [Borysow1988] `Borysow et al. (1988): Collision-induced Rototranslational Absorption Spectra of H2-He Pairs at Temperatures from 40 to 3000 K <https://ui.adsabs.harvard.edu/abs/1988ApJ...326..509B>`_
@@ -21,6 +23,8 @@ References
 
 .. [Borysow2002] `Borysow (2002): Collision-induced absorption coefficients of H$_2$ pairs at temperatures from 60 K to 1000 K <https://ui.adsabs.harvard.edu/abs/2002A&A...390..779B>`_
 
+.. [Bowesman2024] `Bowesman et al. (2024): ExoMol line lists - LV: hyperfine-resolved molecular line list for vanadium monoxide VO <https://ui.adsabs.harvard.edu/abs/2024MNRAS.529.1321B>`_
+
 .. [Burrows2000] `Burrows et al. (2000): The Near-Infrared and Optical Spectra of Methane Dwarfs and Brown Dwarfs <http://ui.adsabs.harvard.edu/abs/2000ApJ...531..438B>`_
 
 .. [Castelli2003] `Castelli & Krucz (2003): New Grids of ATLAS9 Model Atmospheres <https://ui.adsabs.harvard.edu/abs/2003IAUS..210P.A20C>`_
@@ -39,14 +43,26 @@ References
 
 .. [Dalgarno1962] `Dalgarno & Williams (1962): Rayleigh Scattering by Molecular Hydrogen <http://ui.adsabs.harvard.edu/abs/1962ApJ...136..690D>`_
 
+.. [Gamache2017] `Gamache et al. (2017): Total internal partition sums for 166 isotopologues of 51 molecules important in planetary atmospheres: Application to HITRAN2016 and beyond <https://ui.adsabs.harvard.edu/abs/2017JQSRT.203...70G>`_
+
+.. [Gamache2021] `Gamache et al. (2021): Total internal partition sums for the HITRAN2020 database <https://ui.adsabs.harvard.edu/abs/2021JQSRT.27107713G>`_
+
+.. [Gordon2022] `Gordon et al. (2022): The HITRAN2020 molecular spectroscopic database <https://ui.adsabs.harvard.edu/abs/2022JQSRT.27707949G>`_
+
 .. [Griffith2014] `Griffith (2014): Disentangling degenerate solutions from primary transit and secondary eclipse spectroscopy of exoplanets <https://ui.adsabs.harvard.edu/abs/2014RSPTA.37230086G>`_
 
 .. [Hargreaves2019] `Hargreaves et al. (2019): Spectroscopic line parameters of NO, NO2, and N2O for the HITEMP database <https://ui.adsabs.harvard.edu/abs/2019JQSRT.232...35H>`_
 
+.. [Hargreaves2020] `Hargreaves et al. (2020): An Accurate, Extensive, and Practical Line List of Methane for the HITEMP Database <https://ui.adsabs.harvard.edu/abs/2020ApJS..247...55H>`_
+
+.. [Hargreaves2025] `Hargreaves et al. (2025): Updating the carbon dioxide line list in HITEMP <https://ui.adsabs.harvard.edu/abs/2025JQSRT.33309324H>`_
+
 .. [Harris2006] `Harris et al. (2006): Improved HCN/HNC linelist, model atmospheres and synthetic spectra for WZ Cas <https://ui.adsabs.harvard.edu/abs/2006MNRAS.367..400H>`_
 
 .. [Harris2008] `Harris et al. (2008): A HCN/HNC linelist, model atmospheres and synthetic spectra for carbon stars <https://ui.adsabs.harvard.edu/abs/2008MNRAS.390..143H>`_
 
+.. [Huang2023] `Huang et al. (2023): AI-3000K Infrared Line List for Hot CO2 <https://ui.adsabs.harvard.edu/abs/2023JMoSp.39211748H>`_
+
 .. [Iro2005] `Iro et al. (2005): A time-dependent radiative model of HD 209458b <https://ui.adsabs.harvard.edu/abs/2005A&A...436..719I>`_
 
 .. [Jorgensen2000] `Jorgensen et al. (2000): The atmospheres of cool, helium-rich white dwarfs <https://ui.adsabs.harvard.edu/abs/2000A%26A...361..283J/abstract>`_
@@ -55,7 +71,7 @@ References
 
 .. [Kurucz1970] `Kurucz (1970): Atlas: a Computer Program for Calculating Model Stellar Atmospheres <http://ui.adsabs.harvard.edu/abs/1970SAOSR.309.....K>`_
 
-.. [Laraia2011] `Laraia et al. (2011): Total internal partition sums to support planetary remote sensing <http://ui.adsabs.harvard.edu/abs/2011Icar..215..391L>`_
+.. .. [Laraia2011] `Laraia et al. (2011): Total internal partition sums to support planetary remote sensing <http://ui.adsabs.harvard.edu/abs/2011Icar..215..391L>`_
 
 .. [Lecavelier2008] `Lecavelier des Etangs et al. (2008): Rayleigh Scattering in the Transit Spectrum of HD 189733b <http://ui.adsabs.harvard.edu/abs/2008A%26A...481L..83L>`_
 
@@ -71,11 +87,14 @@ References
 
 .. [McKemmish2019] `McKemmish et al. (2019): ExoMol molecular line lists - XXXIII. The spectrum of Titanium Oxide <https://ui.adsabs.harvard.edu/abs/2019MNRAS.488.2836M>`_
 
-.. [PS1997] `Partridge & Schwenke (1997): The determination of an accurate isotope dependent potential energy surface for water from extensive ab initio calculations and experimental data <http://ui.adsabs.harvard.edu/abs/1997JChPh.106.4618P>`_
+
+.. [Molliere2019] `Molliere et al. (2019): petitRADTRANS. A Python radiative transfer package for exoplanet characterization and retrieval <https://ui.adsabs.harvard.edu/abs/2019A&A...627A..67M>`_
+
+.. .. [PS1997] `Partridge & Schwenke (1997): The determination of an accurate isotope dependent potential energy surface for water from extensive ab initio calculations and experimental data <http://ui.adsabs.harvard.edu/abs/1997JChPh.106.4618P>`_
 
 .. [Piskunov1995] `Piskunov et al. (1995): VALD: The Vienna Atomic Line Data Base. <https://ui.adsabs.harvard.edu/abs/1995A&AS..112..525P>`_
 
-.. [Plez1998] `Plez (1998): A new TiO line list <http://ui.adsabs.harvard.edu/abs/1998A%26A...337..495P>`_
+.. .. [Plez1998] `Plez (1998): A new TiO line list <http://ui.adsabs.harvard.edu/abs/1998A%26A...337..495P>`_
 
 .. [Polyansky2018] `Polyansky et al. (2018): ExoMol molecular line lists XXX: a complete high-accuracy line list for water <https://ui.adsabs.harvard.edu/abs/2018MNRAS.480.2597P>`_
 
@@ -85,15 +104,9 @@ References
 
 .. [Rothman2010] `Rothman et al. (2010): HITEMP, the high-temperature molecular spectroscopic database <http://ui.adsabs.harvard.edu/abs/2010JQSRT.111.2139R>`_
 
-.. [Gamache2017] `Gamache et al. (2017): Total internal partition sums for 166 isotopologues of 51 molecules important in planetary atmospheres: Application to HITRAN2016 and beyond <https://ui.adsabs.harvard.edu/abs/2017JQSRT.203...70G>`_
-
-.. [Gordon2017] `Gordon et al. (2017): The HITRAN2016 molecular spectroscopic database <https://ui.adsabs.harvard.edu/abs/2017JQSRT.203....3G>`_
-
-.. [Rothman2013] `Rothman et al. (2013): The HITRAN2012 molecular spectroscopic database <http://ui.adsabs.harvard.edu/abs/2013JQSRT.130....4R>`_
+.. .. [Rothman2013] `Rothman et al. (2013): The HITRAN2012 molecular spectroscopic database <http://ui.adsabs.harvard.edu/abs/2013JQSRT.130....4R>`_
 
-.. [Schwenke1998] `Schwenke (19988): Opacity of TiO from a coupled electronic state calculation parametrized by AB initio and experimental data <http://ui.adsabs.harvard.edu/abs/1998FaDi..109..321S>`_
-
-.. [Speagle2019] `Speagle (2019): dynesty: A Dynamic Nested Sampling Package for Estimating Bayesian Posteriors and Evidences <https://ui.adsabs.harvard.edu/abs/2019arXiv190402180S>`_
+.. .. [Schwenke1998] `Schwenke (19988): Opacity of TiO from a coupled electronic state calculation parametrized by AB initio and experimental data <http://ui.adsabs.harvard.edu/abs/1998FaDi..109..321S>`_
 
 .. [Taylor2020] `Taylor et al. (2020): Understanding and mitigating biases when studying inhomogeneous emission spectra with JWST <https://ui.adsabs.harvard.edu/abs/2020MNRAS.493.4342T>`_
 
@@ -113,4 +126,7 @@ References
 
 .. [Yurchenko2020] `Yurchenko et al. (2020): ExoMol line lists - XXXIX. Ro-vibrational molecular line list for CO2 <https://ui.adsabs.harvard.edu/abs/2020MNRAS.496.5282Y>`_
 
+.. [Yurchenko2024a] `Yurchenko et al. (2024): ExoMol line lists - LVII. High accuracy ro-vibrational line list for methane (CH4) <https://ui.adsabs.harvard.edu/abs/2024MNRAS.528.3719Y>`_
+
+.. [Yurchenko2024b] `Yurchenko et al. (2024): ExoMol line lists - LX. Molecular line list for the ammonia isotopologue 15NH3 <https://ui.adsabs.harvard.edu/abs/2024MNRAS.533.3442Y>`_