<p align="center">
<img src="https://github.com/ExPlanetology/atmodeller/blob/main/docs/logo.png" alt="atmodeller logo" width="300"/>
</p>
# Atmodeller
[](https://github.com/ExPlanetology/atmodeller/releases/tag/v0.8.2)
[](https://www.python.org/downloads/release/python-3100/)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/ExPlanetology/atmodeller/actions/workflows/python-package.yml)
[](https://github.com/ExPlanetology/atmodeller)
## About
Atmodeller is a Python package that uses [JAX](https://jax.readthedocs.io/en/latest/index.html) to compute the partitioning of volatiles between a planetary atmosphere and its rocky interior. It is released under [The GNU General Public License v3.0 or later](https://www.gnu.org/licenses/gpl-3.0.en.html).
## Documentation
The documentation is available online, with options to download it in EPUB or PDF format:
[https://atmodeller.readthedocs.io/en/latest/](https://atmodeller.readthedocs.io/en/latest/)
## Quick install
Atmodeller is a Python package that can be installed on a variety of platforms (e.g. Mac, Windows, Linux). It is recommended to install Atmodeller in a dedicated Python environment. Before installation, create and activate the environment, then run:
```pip install atmodeller```
Downloading the source code is also recommended if you'd like access to the example notebooks in `notebooks/`.
## Citation
If you use Atmodeller, or data from Atmodeller, please cite:
- Bower, D. J., Thompson, M. A., Hakim, K., Tian, M., and Sossi, P. A. (2025), Diversity of rocky planet atmospheres in the C-H-O-N-S-Cl system with interior dissolution, non-ideality and condensation: Application to TRAPPIST-1e and sub-Neptunes, The Astrophysical Journal, submitted. ArXiv e-print [2507.00499](https://arxiv.org/abs/2507.00499).
The data from the above study are also available for download at https://doi.org/10.17605/OSF.IO/PC5TD.
## Basic usage
Jupyter notebooks in the `notebooks/` directory demonstrate how to perform single and batch calculations, and how to integrate Atmodeller into time-dependent simulations. A simple example of how to use Atmodeller is provided below:
```
from atmodeller import (
InteriorAtmosphere,
Planet,
Species,
SpeciesCollection,
earth_oceans_to_hydrogen_mass,
)
from atmodeller.solubility import get_solubility_models
solubility_models = get_solubility_models()
# Get the available solubility models
print("solubility models = ", solubility_models.keys())
H2_g = Species.create_gas("H2")
H2O_g = Species.create_gas("H2O", solubility=solubility_models["H2O_peridotite_sossi23"])
O2_g = Species.create_gas("O2")
species = SpeciesCollection((H2_g, H2O_g, O2_g))
planet = Planet()
interior_atmosphere = InteriorAtmosphere(species)
oceans = 1
h_kg = earth_oceans_to_hydrogen_mass(oceans)
o_kg = 6.25774e20
mass_constraints = {
"H": h_kg,
"O": o_kg,
}
# If you do not specify an initial solution guess then a default will be used
# Initial solution guess number density (molecules/m^3)
initial_log_number_density = 50
interior_atmosphere.solve(
planet=planet,
initial_log_number_density=initial_log_number_density,
mass_constraints=mass_constraints,
)
output = interior_atmosphere.output
# Quick look at the solution
solution = output.quick_look()
# Get complete solution as a dictionary
solution_asdict = output.asdict()
print("solution_asdict =", solution_asdict)
# Write the complete solution to Excel
output.to_excel("example_single")
```
## Funding
Atmodeller was created as part of a SERI-funded ERC Starting grant '2ATMO' granted to P. Sossi (Contract no. MB22.00033), with additional funding provided through a Swiss National Science Foundation (SNSF) Eccellenza Professorship (#203668).
Raw data
{
"_id": null,
"home_page": null,
"name": "atmodeller",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "astrobiology, atmospheres, chemical-equilibrium, degassing, equinox, exoplanets, geochemistry, habitability, jax, magma-ocean, numerical-modeling, planetary-science, thermodynamics, volatile-partitioning",
"author": null,
"author_email": "Dan J Bower <dbower@eaps.ethz.ch>",
"download_url": "https://files.pythonhosted.org/packages/af/0d/e009bbfea1d1548be3b3509e2e8dba05ef3a5332c4dfee535c7ec54a21cb/atmodeller-0.8.2.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n<img src=\"https://github.com/ExPlanetology/atmodeller/blob/main/docs/logo.png\" alt=\"atmodeller logo\" width=\"300\"/>\n</p>\n\n# Atmodeller\n\n[](https://github.com/ExPlanetology/atmodeller/releases/tag/v0.8.2)\n[](https://www.python.org/downloads/release/python-3100/)\n[](https://www.gnu.org/licenses/gpl-3.0)\n[](https://github.com/ExPlanetology/atmodeller/actions/workflows/python-package.yml)\n[](https://github.com/ExPlanetology/atmodeller)\n\n## About\nAtmodeller is a Python package that uses [JAX](https://jax.readthedocs.io/en/latest/index.html) to compute the partitioning of volatiles between a planetary atmosphere and its rocky interior. It is released under [The GNU General Public License v3.0 or later](https://www.gnu.org/licenses/gpl-3.0.en.html).\n\n## Documentation\n\nThe documentation is available online, with options to download it in EPUB or PDF format:\n\n[https://atmodeller.readthedocs.io/en/latest/](https://atmodeller.readthedocs.io/en/latest/)\n\n## Quick install\n\nAtmodeller is a Python package that can be installed on a variety of platforms (e.g. Mac, Windows, Linux). It is recommended to install Atmodeller in a dedicated Python environment. Before installation, create and activate the environment, then run:\n\n```pip install atmodeller```\n\nDownloading the source code is also recommended if you'd like access to the example notebooks in `notebooks/`.\n\n## Citation\n\nIf you use Atmodeller, or data from Atmodeller, please cite:\n\n- Bower, D. J., Thompson, M. A., Hakim, K., Tian, M., and Sossi, P. A. (2025), Diversity of rocky planet atmospheres in the C-H-O-N-S-Cl system with interior dissolution, non-ideality and condensation: Application to TRAPPIST-1e and sub-Neptunes, The Astrophysical Journal, submitted. ArXiv e-print [2507.00499](https://arxiv.org/abs/2507.00499).\n\nThe data from the above study are also available for download at https://doi.org/10.17605/OSF.IO/PC5TD.\n\n## Basic usage\n\nJupyter notebooks in the `notebooks/` directory demonstrate how to perform single and batch calculations, and how to integrate Atmodeller into time-dependent simulations. A simple example of how to use Atmodeller is provided below:\n\n```\nfrom atmodeller import (\n InteriorAtmosphere,\n Planet,\n Species,\n SpeciesCollection,\n earth_oceans_to_hydrogen_mass,\n)\nfrom atmodeller.solubility import get_solubility_models\n\nsolubility_models = get_solubility_models()\n# Get the available solubility models\nprint(\"solubility models = \", solubility_models.keys())\n\nH2_g = Species.create_gas(\"H2\")\nH2O_g = Species.create_gas(\"H2O\", solubility=solubility_models[\"H2O_peridotite_sossi23\"])\nO2_g = Species.create_gas(\"O2\")\n\nspecies = SpeciesCollection((H2_g, H2O_g, O2_g))\nplanet = Planet()\ninterior_atmosphere = InteriorAtmosphere(species)\n\noceans = 1\nh_kg = earth_oceans_to_hydrogen_mass(oceans)\no_kg = 6.25774e20\nmass_constraints = {\n \"H\": h_kg,\n \"O\": o_kg,\n}\n\n# If you do not specify an initial solution guess then a default will be used\n# Initial solution guess number density (molecules/m^3)\ninitial_log_number_density = 50\n\ninterior_atmosphere.solve(\n planet=planet,\n initial_log_number_density=initial_log_number_density,\n mass_constraints=mass_constraints,\n)\noutput = interior_atmosphere.output\n\n# Quick look at the solution\nsolution = output.quick_look()\n\n# Get complete solution as a dictionary\nsolution_asdict = output.asdict()\nprint(\"solution_asdict =\", solution_asdict)\n\n# Write the complete solution to Excel\noutput.to_excel(\"example_single\")\n```\n\n## Funding\nAtmodeller was created as part of a SERI-funded ERC Starting grant '2ATMO' granted to P. Sossi (Contract no. MB22.00033), with additional funding provided through a Swiss National Science Foundation (SNSF) Eccellenza Professorship (#203668).",
"bugtrack_url": null,
"license": null,
"summary": "Volatile partitioning between a rocky interior and atmosphere",
"version": "0.8.2",
"project_urls": {
"documentation": "https://atmodeller.readthedocs.io/en/latest",
"homepage": "https://planetology.ethz.ch",
"issues": "https://github.com/ExPlanetology/atmodeller/issues",
"repository": "https://github.com/ExPlanetology/atmodeller"
},
"split_keywords": [
"astrobiology",
" atmospheres",
" chemical-equilibrium",
" degassing",
" equinox",
" exoplanets",
" geochemistry",
" habitability",
" jax",
" magma-ocean",
" numerical-modeling",
" planetary-science",
" thermodynamics",
" volatile-partitioning"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ed1f69d971285c4f0667af0d36fccdd93cb84e545bba76a9c60e71ddd17963d1",
"md5": "b9bc66e61f1f3b03e5a08ef3e79555da",
"sha256": "3778c541b3e581a9ed3df62e17f6834c86ab02e2f6483a9171d9d7404575baa3"
},
"downloads": -1,
"filename": "atmodeller-0.8.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b9bc66e61f1f3b03e5a08ef3e79555da",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 9191211,
"upload_time": "2025-07-15T19:20:30",
"upload_time_iso_8601": "2025-07-15T19:20:30.087605Z",
"url": "https://files.pythonhosted.org/packages/ed/1f/69d971285c4f0667af0d36fccdd93cb84e545bba76a9c60e71ddd17963d1/atmodeller-0.8.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "af0de009bbfea1d1548be3b3509e2e8dba05ef3a5332c4dfee535c7ec54a21cb",
"md5": "c438b54e7a8b08c7241e4b6438477457",
"sha256": "b83cde5b28bff2c8883816cb4b3fbe8619bcbf2e3bd195c74e29af65f64d1c74"
},
"downloads": -1,
"filename": "atmodeller-0.8.2.tar.gz",
"has_sig": false,
"md5_digest": "c438b54e7a8b08c7241e4b6438477457",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 9224351,
"upload_time": "2025-07-15T19:20:32",
"upload_time_iso_8601": "2025-07-15T19:20:32.511927Z",
"url": "https://files.pythonhosted.org/packages/af/0d/e009bbfea1d1548be3b3509e2e8dba05ef3a5332c4dfee535c7ec54a21cb/atmodeller-0.8.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-15 19:20:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ExPlanetology",
"github_project": "atmodeller",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "atmodeller"
}
JSON
