SPIDER: model overview
Here you can find a detailed overview of the SPIDER formulation.
Note
This model overview is taken from the notes and contains an extended description of the equations and derivations related to the SPIDER code. It is still work in progress.
Mass coordinate definition
1 defines:
We similarly define, since we only consider the mantle bounded between \(r_{\rm cmb}\) and \(r\):
Taking the derivative with respect to \(r\):
Integrating:
Note that \(\xi\) is referred to as a "mass coordinate" and has length dimension. This equation is the inverse transformation, allowing conversion between radius \(r\) and mass coordinate \(\xi\).
Implementation
Currently, using the Adams-Williamson EOS we compute \(\rho_0\) analytically using the same integration limits for \(\xi\) and \(r\), i.e., \(\xi_{\rm surf}=r_{\rm surf}\) and \(\xi_{\rm cmb}=r_{\rm cmb}\). Hence \(\rho_0\) is the 'actual' average density of the mantle. We then prescribe a mesh using \(\xi\); each \(\xi\) corresponds to a shell containing mass \(m\).
For the non-linear solution, it is natural to set the \(\xi\) coordinate as the initial guess for the \(r\) coordinate. The Jacobian of the objective function is simply the infinitesimal mass segment in physical coordinates \(r^2 \rho(r)\).
Partial derivatives
We compute the partial derivatives under the coordinate transformation from \(r \rightarrow \xi\), with time \(t\) remaining as the second variable:
where \(U\) is the local barycentric velocity in the radial direction.
Implementation
We time step the following equation in SPIDER:
This description is known as the "Lagrangian description" 2 because we are following mass elements.
Integral form
3 instead solve the integral form:
Fluxes
Heat flux becomes:
Hydrostatic pressure
We use the Adams-Williamson equation of state to compute the hydrostatic pressure profile.
Pressure
Adams-Williamson equation of state:
where \(\rho_r\) is reference surface density, \(g\) gravity, \(\beta\) compressibility, and \(z\) is depth.
Pressure gradient:
Density is:
For any such EOS with a simple relation between \(\rho\) and \(r\), we can integrate to directly compute the mass coordinate \(\xi\) for a given \(r\):
An intuitive option is to set \(\rho_0\) such that \(\xi=1.0\) at the planetary surface, with \(\xi=0\) at the innermost boundary.
General formulation
Multiply by \(r^2/\rho\) and differentiate with respect to \(r\):
Combined with an EOS of the form \(p=p(\rho)\), this is an ordinary second order differential equation for the density or pressure.
-
Yutaka Abe, Basic equations for evolution of partially molten mantle and core, The Earth's Central Part: Its Structure and Dynamics, 1995. ↩
-
Rudolf Kippenhahn; Alfred Weigert; Achim Weiss, Stellar Structure and Evolution, Springer, 2012. ↩
-
Dan J. Bower; Patrick Sanan; Aaron S. Wolf, Numerical solution of a non-linear conservation law applicable to the interior dynamics of partially molten planets, Phys. Earth Planet. Inter., 2018. ↩