Skip to main content

License Docs codecov Unit Tests Integration Tests

Zalmoxis

Interior structure solver for rocky planets and sub-Neptunes.

Zalmoxis computes self-consistent radial profiles of density, pressure, temperature, gravity, and phase state for differentiated planets from 0.1 to 50 Earth masses. Given a total mass, layer composition, and temperature mode, it iteratively solves the coupled hydrostatic equilibrium equations to determine the planet's radius and internal structure.

Features

  • Multiple EOS families: PALEOS unified tables (iron, MgSiO3, H2O), Chabrier H2 for sub-Neptune interiors, Wolf & Bower 2018, Seager 2007, and analytic polytropes
  • Multi-material mixing: volume-additive harmonic mean with per-component phase-aware suppression
  • H2 miscibility: binodal suppression models for H2-silicate and H2-H2O phase boundaries
  • Temperature modes: adiabatic (self-consistent), isothermal, linear, or prescribed profiles
  • Parameter grids: sweep any combination of input parameters via TOML grid files

Quick start

# Install
git clone https://github.com/FormingWorlds/Zalmoxis.git
cd Zalmoxis
pip install -e .

# Download EOS data into $FWL_DATA (linked from data/)
export FWL_DATA=/path/to/fwl_data
bash tools/setup/get_zalmoxis.sh

# Run default config (1 Earth-mass, PALEOS iron + MgSiO3)
python -m zalmoxis -c input/default.toml

See the installation guide and usage guide for details.

Documentation

Full documentation: proteus-framework.org/Zalmoxis

Part of PROTEUS

Zalmoxis is the interior structure module of the PROTEUS framework for coupled atmosphere-interior evolution of rocky planets and sub-Neptunes.

Contributing

Contributions are welcome. Please read the Code of Conduct and contributing guidelines before opening a pull request. If you encounter issues, please open an issue.

License

Apache License 2.0

Metadata

Release files for fwl-zalmoxis 26.10.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fwl-zalmoxis 26.10.21
File Size Uploaded Provenance
fwl_zalmoxis-26.10.21.tar.gz 5.7 MB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for fwl-zalmoxis 26.10.21
File Interpreter ABI Platform
fwl_zalmoxis-26.10.21-py3-none-any.whl Python 3 none any Details

Total release size: 5.9 MB

Release files / fwl_zalmoxis-26.10.21.tar.gz

Download URL fwl_zalmoxis-26.10.21.tar.gz
Size 5.7 MB
Tags Source
SHA-256 checksum
How to use checksums
ef6978e99a10a91b959001d874fe6cb6a06114541d1845d7429794166bf1a94c
BLAKE2b-256 checksum
How to use checksums
1ff7364bad83a3ba5ee68eac72525d0ade2b31918188c13582f2786eac707c34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Release files / fwl_zalmoxis-26.10.21-py3-none-any.whl

Download URL fwl_zalmoxis-26.10.21-py3-none-any.whl
Size 203.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4b883134e0f027e8864eef7bee1ee6cc0fccaf29f88071e0078e80307f0f19da
BLAKE2b-256 checksum
How to use checksums
655cb46df50ed1d0ab383ab563b0eb5c598bd9a7411f021a5cb57d7c24bf416a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Security for fwl-zalmoxis 26.10.21

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for fwl_zalmoxis-26.10.21.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page