archnemesis 1.1.0

ArchNEMESIS is an open-source Python package developed for the analysis of remote sensing spectroscopic observations of planetary atmospheres. It is based on the widely used NEMESIS (Non-linear Optimal Estimator for MultivariatE Spectral analySIS) radiative transfer and retrieval tool, which has been extensively used for the investigation of a wide variety of planetary environments.

ArchNEMESIS is currently maintained by Juan Alday and Joseph Penn. The NEMESIS algorithm, code archNEMESIS is based on, was originally developed by Patrick Irwin.

If interested users are missing key points in the documentation, would appreciate seeing jupyter notebooks for certain purposes, or want to report issues, please do so by contacting us or joining our Discord channel.

Documentation

For full documentation, visit archnemesis.readthedocs.io.

Installation

There are three main ways to install archNEMESIS, depending on your use case:

Installing from GitHub (developer mode)

The latest version of code has to be downloaded from Github under a GNU General Public License v3. To do so, type in the command window:

git clone https://github.com/juanaldayparejo/archnemesis-dist.git

Before installing archNEMESIS, we recommend users to create and load a new Python virtual environment for a clean install:

python -m venv name_of_virtual_environment/
source name_of_virtual_environment/bin/activate

Then move into the package directory:

cd archnemesis-dist

Finally, we need to install the library. Given that archNEMESIS is a highly dynamic package were new additions are frequently introduced, we recommend installing the package but keeping it editable by typing:

pip install --editable .

This will install archNEMESIS, but with the ability to update any changes made to the code (e.g., when introducing new model parameterisations or methods). In addition, it will install all the required libraries archNEMESIS depends on.

Installing from PyPI

The simplest way to install archNEMESIS is via PyPI.
We recommend doing this inside a clean Python virtual environment:

python -m venv archnemesis-env
source archnemesis-env/bin/activate
pip install archnemesis

This will install the latest stable release of the package along with its dependencies. It is the recommended method if you just want to use the library without editing the source code.

Contributing to archNEMESIS

If you want to contribute to the development of archNEMESIS, please follow our Contribution Guidelines.

Citing archNEMESIS

If archNEMESIS has been significant in your research, we suggest citing the following articles:

• archNEMESIS reference publication:

  • Alday, J., Penn, J., Irwin, P., Mason, J., Yang, J. and Dobinson, J. (2025) archNEMESIS: An Open-Source Python Package for Analysis of Planetary Atmospheric Spectra, Journal of Open Research Software, 13(1), p. 10. doi: 10.5334/jors.554.

• NEMESIS reference publication:

  • Irwin, P. G. J., Teanby, N. A., De Kok, R., Fletcher, L. N., Howett, C. J. A., Tsang, C. C. C., ... & Parrish, P. D. (2008). The NEMESIS planetary atmosphere radiative transfer and retrieval tool. Journal of Quantitative Spectroscopy and Radiative Transfer, 109(6), 1136-1150. doi: 10.1016/j.jqsrt.2007.11.006.

Support

If you have questions, suggestions, or encounter issues, you can:

• Open an issue on the GitHub Issues page
• Ask questions on the GitHub Discussions tab
• Join our Discord channel.
• Contact the maintainer via email: juan.alday@open.ac.uk

Please note: This is a research software package maintained as time allows. While we aim to respond in a timely manner (i.e., within a week), we cannot guarantee a fixed response time.

Revision history

• 1.1.0 (25 June, 2026)

  • Option for custom planet parameters.
  • Calculations for selection averaging points for disc-averaged measurements.
  • Implementation of special forward model for primary transit observations of exoplanets.
  • Filter signal integration for modelling radiometer-like instruments.
  • Implementation of first version of Emissions_0 class for modelling atmospheric emissions.
  • Optimised code to allow for fewer classes to be defined.
  • Major update in line data calculations: created archNEMESIS format for storing spectroscopic line data.
  • Major update in line data calculations: optimised absorption cross section calculations with numba.
  • Major update in line data calculations: implemented functionality to calculation a pseudo-continuum from weak lines.
  • Major update in line data calculations: implemented functionality to run calculation of cross sections at runtime (ILBL=1).

• 1.0.6 (16 December, 2025)

  • Fixing bugs to reconcile results with NEMESIS.
  • Implemented LineData class with functionality to extract data from HITRAN using HAPI.
  • Implemented first version of cross section calculations.
  • Combined radiative transfer calculations with and without gradients in same function (CIRSradg is now CIRSrad(gradients=True)).
  • Added forward modelling error capabilities.
  • First implementation of nemesisdisc, forward model type for gradient calculations (no scattering) and multiple averaging points.
  • Added functionality to read information from previous retrievals (LIN parameter).
  • Implemented AOTF spectrometer modelling capabilities in nemesisSO.
  • Implemented integration of signal across filters in nemesis (for modelling spectra from radiometers).

• 1.0.5 (8 July, 2025)

  • New release of archNEMESIS for publication at Journal of Open Research Software.
  • Fixed minor bugs throughout the code.
  • Added unit test for calculation of optical properties using Mie Theory.
  • Updated setup file to avoid dependency conflicts.

• 1.0.4 (2 July, 2025)

  • New release of archNEMESIS for release on PyPI and Docker Hub.

• 1.0.3 (19 June, 2025)

  • New release of archNEMESIS for first release on PyPI.

• 1.0.2 (19 June, 2025)

  • Fixed minor bugs throughout the code.
  • Included new model parameterisations.
  • Included new automatic tests (e.g., forward models for solar occultation and limb geometry).
  • Flags now identified with ENUMS rather than magic numbers.
  • Model parameterisations now defined as classes.

• 1.0.1 (2 April, 2025)

  • Fixed minor bugs throughout the code.
  • Implementation of Oren-Nayar surface reflectance model.
  • Implementation of different surface reflectance models in multiple scattering calculations.
  • Included new automatic tests.
  • Included new model parameterisations.

• 1.0.0 (27 January, 2025)

  • First release for publication at Journal of Open Research Software.

Dependencies

• Numerical calculations: numpy; scipy
• Visualisations: matplotlib; basemap; corner
• File handling: h5py
• Optimisation: numba; joblib
• Nested sampling: pymultinest
• Extraction of ERA-5 model profiles: cdsapi; pygrib