An open-source model for extreme atmospheres on rocky exoplanets
AGNI's primary purpose is to simulate the atmospheric temperature-, height-, and compositional-structures of atmospheres overlying magma oceans. It does this while ensuring that radiative-convective equilibrium is maintained throughout the atmosphere. SOCRATES is used to perform correlated-k radiative transfer including: shortwave irradiation from the star, surface emission, line absorption, Rayleigh scattering, parameterised clouds, and collisional absorption. Mixing length theory is used to parametrise convection. AGNI also supports real gas equations of state, self-gravitation, and various spectral surface compositions. Accounting for these energy transport processes permits an energy-conserving calculation of atmospheric structure, obtained using numerical optimisation, which also yields realistic cooling rates for young rocky planets with magma oceans.
Pronounced as ag-nee. Named after the fire deity of Hinduism.
The documentation is structured following the Diátaxis framework:
| Section | Purpose |
|---|---|
| Tutorials | Step-by-step guides. Start here to install the code and run your first simulation. |
| How-to guides | Task-oriented recipes for specific goals; e.g. configuration, grid runs. |
| Explanation | Background reading on the physics, numerics, and ecosystem context. |
| Reference | Complete code API and config-file reference for people who like details. |
Contact: see information on my website homepage.
GitHub: https://github.com/nichollsh/AGNI
If you use AGNI, please cite the following papers:
- Nicholls et al. (2025a) - 10.1093/mnras/stae2772
- Nicholls et al. (2025b) - 10.21105/joss.07726
- Nicholls et al. (in rev) - 2507.02656
This software is available under the GPLv3. Copyright © 2023-2026 Harrison Nicholls.