Limitations
Morrigan is a statistical model of the giant-impact phase, not an N-body integrator. Its approximations are inherited from Kimura et al. (2025)1 and from the choices of this implementation; the ones a user should hold in mind are listed here.
Dynamical approximations
- Semi-analytic timing. Instability times come from the Petit et al. (2020)3 crossing-time fit and calibrated interaction timescales, not from direct integration. Individual system histories are statistical realisations; only ensemble statistics are meaningful for comparison with N-body results.
- Perfect merging. Collisions always merge the pair. There is no fragmentation, no hit-and-run channel, and no debris, so a body only ever grows: the merged mass is the exact sum of the two, and mass leaves a system only when a body is ejected or falls into the star.
- Single impact angle. One configured impact angle applies to every collision of a run; the model does not draw a distribution of impact geometries.
- Linear secular theory. Eccentricities between events follow the Laplace-Lagrange solution, which is linear in eccentricity and excludes inclination; the model is two-dimensional, and radially overlapping neighbours are simply decoupled from the secular solution.
- No dissipation. There is no gas drag, no tidal damping, and no dynamical friction from a planetesimal population; excitation is removed only by mergers, ejections2 (whether through an eccentricity driven past unity or a scattering that leaves an orbit hyperbolic), and the star-infall cutoff.
Atmospheres
- The model carries no atmosphere. Bodies are bare: a mass is a bulk mass, a radius follows from it at the configured bulk density, and no envelope is tracked or shed. A giant impact erodes a real atmosphere, and that erosion is applied downstream by the consumer rather than here; in a coupled PROTEUS run it comes from
zephyrus.collision.mass_loss, evaluated from the impact geometry each record carries. The scaling law itself is Kegerreis et al. (2020)4. - Bodies are bulk objects in the dynamics too: radii do not distinguish a rocky core from an envelope, so a body with a heavy envelope is represented by its bulk mass and radius alone.
Impact melt
- A bulk melt fraction only. The melt fraction is the mantle-averaged energy criterion of Nakajima et al. (2021)5, a mean energy gain over \(E_M\), a value the authors call not well constrained; the shape of the melt pool and the pressure at its base (their eqs. 9 to 11 and 13 in arXiv:2004.04269v2) are not computed. The fit is least certain for grazing impacts: the relative 1-sigma of the internal energy fit grows from 0.06 head-on to 0.63 at 90Β°. The merging coefficients of Nakajima et al. come from impacts at the escape speed only, so a merger faster than that is outside their data even when it is below the critical speed and inside the flagged range.
- Merging coefficients for every merger. A collision faster than the Genda et al. (2012)6 critical speed would be a hit-and-run in the SPH runs; Morrigan merges it and evaluates the merging fit, flagged by
above_v_cr. Outside the campaign's mass, mass-ratio and speed range the fit is extrapolated andmelt_in_rangeis false; the merging fit itself comes from the runs at \(v_\mathrm{imp} = v_\mathrm{esc}\).
Numerical conventions
- The gravitational constant is carried at three significant figures (6.67e-11), the au as 1.5e11 m (0.27 % from the defined value), and the year as 365 days; results agree with CODATA-constant implementations only to the corresponding relative level, which matters when cross-checking against other codes.
- All Monte Carlo draws share numpy's global random state, seeded per system. Library code must never reseed mid-run; a hidden reseed would silently correlate ensemble members.
- Ejections remove the body excited past unity eccentricity; its unbound orbit is not followed, and the survivor's orbit conserves the pair's orbital energy at the moment of the event.
- The excitation applied to a pair before a collision is drawn without an upper bound, and so is the fallback taken when no draw satisfies the overlap condition. A body can therefore enter the collision branch already past unity eccentricity, which the ejection branch treats as grounds for removing it: the two branches disagree about what an unbound orbit means. Such a body is removed on the same step by the perihelion cut, so it does not survive to be reported, and the impact histories
run_systemreturns are unaffected. A caller reading the raw merger list rather than the returned histories can see an eccentricity at or above one and should check for it.
References
-
Kimura, T., Hoshino, H., Kokubo, E., Matsumoto, Y. & Ikoma, M., Semi-analytical Model for the Dynamical Evolution of Planetary Systems via Giant Impacts, The Astrophysical Journal, 989, 109, 2025. ↩
-
Kimura, T., Kokubo, E., Matsumoto, Y., Mordasini, C. & Ikoma, M., Semi-analytical model for the dynamical evolution of planetary system II: Application to systems formed by a planet formation model, arXiv:2507.03906, 2025. ↩
-
Petit, A.C., Pichierri, G., Davies, M.B. & Johansen, A., The path to instability in compact multi-planetary systems, Astronomy & Astrophysics, 641, A176, 2020. ↩
-
Kegerreis, J.A., Eke, V.R., Catling, D.C., Massey, R.J., Teodoro, L.F.A. & Zahnle, K.J., Atmospheric Erosion by Giant Impacts onto Terrestrial Planets: A Scaling Law for any Speed, Angle, Mass, and Density, The Astrophysical Journal Letters, 901, L31, 2020. ↩
-
Nakajima, M., Golabek, G.J., WΓΌnnemann, K., Rubie, D.C., Burger, C., Melosh, H.J., Jacobson, S.A., Manske, L. & Hull, S.D., Scaling laws for the geometry of an impact-induced magma ocean, Earth and Planetary Science Letters, 568, 116983, 2021. ↩
-
Genda, H., Kokubo, E. & Ida, S., Merging criteria for giant impacts of protoplanets, The Astrophysical Journal, 744, 137, 2012. ↩