Model overview
CALLIOPE is a 0-D equilibrium outgassing solver for the magma-ocean atmosphere coupling. It treats the silicate mantle and the overlying gas-phase atmosphere as a single thermodynamic system in equilibrium at the surface, and asks: for a given total elemental inventory and a given magma-ocean state, what surface partial pressures and dissolved-volatile masses simultaneously satisfy (i) gas-phase chemical equilibrium, (ii) gas-melt solubility equilibrium, and (iii) elemental mass conservation?
This page summarises the model assumptions, the variables it solves for, and how it relates to the upstream papers (Bower et al. 2019 1, 2022 2; Nicholls et al. 2024 12). Each component has its own dedicated page.
What is in the model
- Eleven gas-phase species (
calliope.constants.volatile_species): H\(_2\)O, CO\(_2\), O\(_2\), H\(_2\), CH\(_4\), CO, N\(_2\), S\(_2\), SO\(_2\), H\(_2\)S, NH\(_3\). - Five elements: H, C, N, S always solved. O is either a derived quantity set by the oxygen-fugacity buffer (buffered mode,
equilibrium_atmosphere) or a fifth budgeted element with \(\Delta\mathrm{IW}\) as the additional unknown (authoritative-O mode,equilibrium_atmosphere_authoritative_O). The two modes share all physics functions and differ only in their unknown set; see Authoritative-oxygen mode. -
Six equilibrium reactions (gas-phase, surface temperature):
Reaction Source \(\mathrm{H_2O} \rightleftharpoons \mathrm{H_2} + \tfrac{1}{2}\,\mathrm{O_2}\) JANAF ( janaf_H2) and Schaefer & Fegley 2017 17 (schaefer_H)\(\mathrm{CO_2} \rightleftharpoons \mathrm{CO} + \tfrac{1}{2}\,\mathrm{O_2}\) JANAF ( janaf_CO) and Schaefer & Fegley 2017 17 (schaefer_C)\(\mathrm{CO_2} + 2\,\mathrm{H_2} \rightleftharpoons \mathrm{CH_4} + \mathrm{O_2}\) Schaefer & Fegley 2017 17 ( schaefer_CH4)\(\tfrac{1}{2}\,\mathrm{S_2} + \mathrm{O_2} \rightleftharpoons \mathrm{SO_2}\) JANAF, doubled form ( janaf_SO2)\(\tfrac{1}{2}\,\mathrm{S_2} + \mathrm{H_2} \rightleftharpoons \mathrm{H_2S}\) JANAF, doubled form ( janaf_H2S)\(\tfrac{1}{2}\,\mathrm{N_2} + \tfrac{3}{2}\,\mathrm{H_2} \rightleftharpoons \mathrm{NH_3}\) JANAF, doubled form ( janaf_NH3) -
One oxygen-fugacity buffer: Hirschmann (2021) 9 iron-wรผstite (default; matches atmodeller's buffer above 1000 K), Fischer et al. (2011) 7, or the legacy O'Neill & Eggins (2002) 15 IW. The shift \(\Delta\mathrm{IW}\) sets \(\log_{10} f_{\mathrm{O}_2}\) relative to the buffer; under the buffered mode it is a user-prescribed input, under the authoritative-O mode it is a solver unknown.
- One solubility law per species with multiple alternative compositions (peridotite, basalt, lunar glass, anorthite-diopside) selectable via constructor argument.
- An optional metal reservoir: with
metal_massabove zero, liquid metal in equilibrium with the melt takes part of the H, C, N and S, and O and Si from the silicate FeO. It is off by default. See Metal reservoir.
What is not in the model
- No interior structure: gravity, radius, mantle mass come in as scalar inputs. Use Zalmoxis for these.
- No interior thermal evolution: \(T_\mathrm{magma}\) and \(\Phi_\mathrm{global}\) come in as scalars. Use Aragog or SPIDER.
- No radiative transfer: surface partial pressures come out, optical depths and surface temperature come from AGNI or JANUS.
- No atmospheric escape: per-iteration mass loss is computed by the PROTEUS escape module (ZEPHYRUS).
- No solid-phase partitioning: dissolved-mass fields are written into
_kg_solidslots that always read0.0; CALLIOPE only resolves melt and gas reservoirs. The PROTEUS atmosphere modules handle solid-phase trapping if any. - No real-gas EOS: all species are treated as ideal gases, so partial pressure \(\equiv\) fugacity. For non-ideal real-gas effects use atmodeller (Bower et al. 2025 3).
- No condensation: every species is in the gas phase. Condensation chemistry happens in AGNI / JANUS.
Mathematical statement
CALLIOPE assembles one mass-conservation equation per solved element. Each equation has the structure
Under the buffered mode the equation set spans \(e \in \{\mathrm{H}, \mathrm{C}, \mathrm{N}, \mathrm{S}\}\), the four primary partial pressures are the unknowns, and the \(4\times 4\) system is solved with scipy.optimize.fsolve (Powell hybrid). Under the authoritative-O mode the equation set spans \(e \in \{\mathrm{H}, \mathrm{C}, \mathrm{N}, \mathrm{S}, \mathrm{O}\}\), the unknown vector is extended with \(\Delta\mathrm{IW}\), and the \(5\times 5\) system is solved with the same outer loop (Authoritative-oxygen mode).
With a metal reservoir, each of the H, C, N and S equations gains a third term on the left, the mass of the element in the metal, \(D_e M_\mathrm{metal} w_e^\mathrm{melt}\) (Metal reservoir).
The seven secondary partial pressures are not independent in either mode: they are algebraic functions of the primaries via the six equilibrium constants, evaluated at \(T = T_\mathrm{magma}\) and \(\log_{10} f_{\mathrm{O}_2} = \log_{10} f_{\mathrm{O}_2}^\mathrm{IW}(T) + \Delta\mathrm{IW}\).
The four pieces of physics decompose cleanly:
| Component | Page | Implementation |
|---|---|---|
| Speciation tree (primary \(\to\) secondary) | Equilibrium chemistry | chemistry.ModifiedKeq, solve.get_partial_pressures |
| Atmospheric column mass | Mass balance & solver | solve.atmosphere_mass |
| Dissolved mass via Henry / power-law / multi-arg solubility | Solubility laws | solubility.SolubilityH2O, ..., solve.dissolved_mass |
| Hirschmann IW buffer (default), Fischer IW buffer, O'Neill IW buffer (legacy) | Oxygen fugacity | oxygen_fugacity.OxygenFugacity |
| Optional metal reservoir (core term, partition laws) | Metal reservoir | metal.mass_D, metal.metal_masses, solve._with_metal |
Lineage
- Bower et al. (2019) 1 introduced the H\(_2\)O + CO\(_2\) mass-balance + Henry's-law treatment that CALLIOPE inherits, including the molar-mass correction \(\mu_v / \bar\mu\) in the column-mass relation that earlier studies (Elkins-Tanton 2008 6; Lebrun et al. 2013 10; Salvador et al. 2017 16; Nikolaou et al. 2019 14) had omitted.
- Bower et al. (2022) 2 added the H\(_2\), CO, CH\(_4\) extensions and the explicit Schaefer & Fegley (2017) 17 IVTHANTHERMO / Chase (1998) 4 JANAF equilibrium constants for the H\(_2\)O/H\(_2\), CO\(_2\)/CO, and CO\(_2\)+H\(_2\)/CH\(_4\) couples; also adopted the O'Neill & Eggins (2002) 15 IW buffer (their Eq. 7) as the parameterisation of mantle redox state.
- Nicholls et al. (2024) 12 introduced N\(_2\) via the Libourel et al. (2003) 11 and Dasgupta et al. (2022) 5 solubility laws, which is the species set in
calliope.solve.equilibrium_atmospheretoday. - Nicholls et al. (2026) 13 demonstrated the sulfur extension (S\(_2\), SO\(_2\), H\(_2\)S) on L 98-59 d, validating the equilibrium constants and the Gaillard et al. (2022) 8 S\(_2\) solubility law against in-situ photochemical inferences.
Why four primaries
CALLIOPE's prognostic species are the four primary partial pressures, not the eleven species partial pressures: the gas-phase chemistry collapses the eleven species into four independent mass-balance constraints. N has only one solved degree of freedom even though it appears in both N\(_2\) and NH\(_3\). O is either not solved (buffered mode) or carried as an additional scalar unknown \(\Delta\mathrm{IW}\) alongside the four pressures (authoritative-O mode); in neither case is a new primary partial pressure introduced. Adding a new oxygen-bearing species (e.g. NO) would not require a new constraint, only a new entry in get_partial_pressures() and the corresponding contribution to atmospheric and dissolved mass.
Validity range
CALLIOPE is calibrated for surface temperatures of roughly \(1000 \le T_\mathrm{magma} \le 4000\) K and surface pressures of roughly \(0.1 \le p_\mathrm{surf} \le 5000\) bar. The lower end of the pressure range is set by numerical stability of the speciation walk; the upper end is the loose envelope above which one or more solubility laws extrapolate. Individual solubility laws have tighter calibration windows than the envelope (Dixon CO\(_2\): \(\le\)815 bar; Sossi H\(_2\)O peridotite: 1 atm; Hamilton H\(_2\)O basalt: 1-6 kbar; Ardia CH\(_4\): 0.7-3 GPa total pressure), see the per-law table in Solubility laws. Outside the envelope above:
- The JANAF constants for H\(_2\) and CO have a use range of only \(1500 \le T \le 3000\) K (named in their
chemistry.pydocstrings), so inside the envelope below 1500 K and above 3000 K they are used outside it; the fits for H\(_2\)S and NH\(_3\) cover \(700 \le T \le 5000\) K and log one warning per process below 700 K, but both species also depend on the H\(_2\) thatjanaf_H2sets, which the warning does not cover (see Equilibrium chemistry). The PROTEUS wrapper enforces a configurableT_floor(default 700 K), which clips temperatures belowT_floorto this value, since thermochemical equilibrium does not necessarily hold at cooler temperatures. - Above \(T \sim 4000\) K the mantle-atmosphere partitioning approximation breaks down; switch to atmodeller (Bower et al. 2025 3).
- The Sossi (2023) peridotite and Newcombe (2017) anorthite-diopside / lunar-glass H\(_2\)O laws are calibrated at 1 atm. The Dixon (1995) basalt fit is calibrated to 717 bar \(p_\mathrm{H_2O}\). For surface pressures above \(\sim\)1 kbar use the Hamilton (1964) basalt fit (1-6 kbar calibration range) or atmodeller for higher-pressure non-ideal behaviour. Applying the Sossi or Newcombe fits at kbar pressures extrapolates the partial-pressure input by 3 orders of magnitude beyond calibration; the resulting dissolved-mass error scales as \(p^{0.5}\) for the power-law fits, so the error is a factor of \(\sim\)30 at 1 kbar.
- Solid-phase partitioning is ignored; CALLIOPE handles melt and gas, plus the optional metal reservoir. Use it only when \(\Phi_\mathrm{global} > 0\), or accept that all dissolved masses will be zero.
-
D. J. Bower, D. Kitzmann, A. S. Wolf, P. Sanan, C. Dorn, A. V. Oza, Linking the evolution of terrestrial interiors and an early outgassed atmosphere to astrophysical observations, Astronomy & Astrophysics, 631, A103, 2019. SciX. ↩↩
-
D. J. Bower, K. Hakim, P. A. Sossi, P. Sanan, Retention of water in terrestrial magma oceans and carbon-rich early atmospheres, The Planetary Science Journal, 3(4), 93, 2022. SciX. ↩↩
-
D. J. Bower, M. A. Thompson, K. Hakim, M. Tian, P. A. Sossi, Diversity of low-mass planet atmospheres in the C-H-O-N-S-Cl system with interior dissolution, nonideality, and condensation: application to TRAPPIST-1e and sub-Neptunes, The Astrophysical Journal, 995, 59, 2025. SciX. ↩↩
-
M. W. Chase, NIST-JANAF Thermochemical Tables, 4th edition, Journal of Physical and Chemical Reference Data Monograph 9, 1998. ↩
-
R. Dasgupta, E. Falksen, A. Pal, C. Sun, The fate of nitrogen during parent body partial melting and accretion of the inner Solar System bodies at reducing conditions, Geochimica et Cosmochimica Acta, 336, 291โ307, 2022. SciX. ↩
-
L. T. Elkins-Tanton, Linked magma ocean solidification and atmospheric growth for Earth and Mars, Earth and Planetary Science Letters, 271, 181โ191, 2008. SciX. ↩
-
R. A. Fischer, A. J. Campbell, G. A. Shofner, O. T. Lord, P. Dera, V. B. Prakapenka, Equation of state and phase diagram of FeO, Earth and Planetary Science Letters, 304, 496โ502, 2011. SciX. ↩
-
F. Gaillard, F. Bernadou, M. Roskosz, M. A. Bouhifd, Y. Marrocchi, G. Iacono-Marziano, M. Moreira, B. Scaillet, G. Rogerie, Redox controls during magma ocean degassing, Earth and Planetary Science Letters, 577, 117255, 2022. SciX. ↩
-
M. M. Hirschmann, Iron-wรผstite revisited: A revised calibration accounting for variable stoichiometry and the effects of pressure, Geochimica et Cosmochimica Acta, 313, 74โ84, 2021. ↩
-
T. Lebrun, H. Massol, E. Chassefiรจre, A. Davaille, E. Marcq, P. Sarda, F. Leblanc, G. Brandeis, Thermal evolution of an early magma ocean in interaction with the atmosphere, Journal of Geophysical Research: Planets, 118, 1155โ1176, 2013. SciX. ↩
-
G. Libourel, B. Marty, F. Humbert, Nitrogen solubility in basaltic melt. Part I. Effect of oxygen fugacity, Geochimica et Cosmochimica Acta, 67(21), 4123โ4135, 2003. SciX. ↩
-
H. Nicholls, T. Lichtenberg, D. J. Bower, R. Pierrehumbert, Magma ocean evolution at arbitrary redox state, Journal of Geophysical Research: Planets, 129, e2024JE008576, 2024. SciX. ↩↩
-
H. Nicholls, T. Lichtenberg, R. D. Chatterjee, C. M. Guimond, E. Postolec, R. T. Pierrehumbert, Volatile-rich evolution of molten super-Earth L 98-59 d, Nature Astronomy, 2026. SciX. arXiv. ↩
-
A. Nikolaou, N. Katyal, N. Tosi, M. Godolt, J. L. Grenfell, H. Rauer, What factors affect the duration and outgassing of the terrestrial magma ocean?, The Astrophysical Journal, 875, 11, 2019. SciX. ↩
-
H. St. C. O'Neill, S. M. Eggins, The effect of melt composition on trace element partitioning: an experimental investigation of the activity coefficients of FeO, NiO, CoO, MoO\(_2\) and MoO\(_3\) in silicate melts, Chemical Geology, 186, 151โ181, 2002. SciX. ↩↩
-
A. Salvador, H. Massol, A. Davaille, E. Marcq, P. Sarda, E. Chassefiรจre, The relative influence of H\(_2\)O and CO\(_2\) on the primitive surface conditions and evolution of rocky planets, Journal of Geophysical Research: Planets, 122, 1458โ1486, 2017. SciX. ↩
-
L. Schaefer, B. Fegley, Redox states of initial atmospheres outgassed on rocky planets and planetesimals, The Astrophysical Journal, 843(2), 120, 2017. SciX. ↩↩↩↩