Usage
This section describes how to use Obliqua. The module can be run three ways:
Full spectrum (Standalone): Compute the tidal $k$-Love number response for a full spectrum of forcing frequencies. This mode is agnostic to the orbital parameters that feed into the Hansen mode weights and dissipative response. The generated spectrum can be used as a lookup table, or to probe the quantative dissipative response of the tidal model to a wide range of forcing frequencies.
Adaptive (Standalone): Compute the tidal $k$-Love number response for a subset of forcing frequencies that are adaptively selected based on the orbital parameters and Hansen mode weights. This mode targets the physically relevant forcing frequencies and, hence, also allows for the computation of the dissipative response.
Adaptive (PROTEUS): By extension of the previous mode, the adaptive mode can be used in conjunction with the PROTEUS framework. This allows Obliqua to interact with both dynamically evolving orbital parameters and interior properties. The tidal $k$-Love number response is computed on-the-fly and is used to update the orbital evolution while the dissipative response feedsback into the interior.
Naturally, one can also use the full spectrum mode in conjunction with PROTEUS in post-processing. This can forexample be used to validate the adaptive mode or to study the impact of different forcing frequencies on the tidal response. Moreover, it may be used to test model convergence. Below, we provide here an example run of the full spectrum mode in conjunction with PROTEUS computed in post-processing.
In all cases you configure the model through a configuration file, described in the configuration guide. If you run into problems, see the troubleshooting page.
For a quick start, jump to the tutorials section!
Example output
The evolution of the tidal heating profile and the tidal $k$-Love number response is shown below for a 1D poroviscoelastic model with an evolving interior. The left panel shows the tidal heating profile as a function of radius and time, whilst the right panel shows the tidal $k$-Love number response as a function of forcing frequency and time. The planet is initially fully molten, hence fluid tides dominate the tidal response. As the planet cools, the interior solidifies and the tidal response transitions to a solid dominated regime.