You have just cloned the examples_test_and_tutorials
repository for the terrainbento multi-model package. Congratulations!
If you are interested in reading about the details of terrainbento, this package is described in Barnhart et al. (2019).
The documentation for the package is provided here.
If you are interested in the source code, you can find it on GitHub. If there is a feature that terrainbento does not have that you are interested in, if you have a clarification question, or if you find an error, please make an Issue on GitHub so we can improve the package.
This notebook exists to provide a hyperlinked guide to the supporting examples, tests, and tutorials we have created in support of this package.
terrainbento was designed to make it easy to create alternative models to be compared in Earth surface dynamics. The package has 28 model programs and a model base class that makes it possible to make additional models within the same framework.
The simplest model, called Basic, evolves topography using stream power and linear diffusion. It has the following governing equation:
$\frac{\partial \eta}{\partial t} = - KQ^{1/2}S + D\nabla^2 \eta$
where $K$ and $D$ are constants, $Q$ is discharge, $S$ is local slope, and $\eta$ is the topography. Other models modify Basic by adding or changing a process component and changing the governing equation. See the model Basic documentation for additional information.
There are three additional introductory tutorials.
This section provides links to five notebooks that show the usage of five example models provided in terrainbento. In each of these notebooks we provide the governing equation(s) for the model, initialize and run the model, make a slope-area plot, save a NetCDF of the final topography, and plot a image of the final topography.
Basic the simplest landscape evolution model in the terrainbento package.
BasicVm which permits the drainage area exponent to change
BasicCh which uses a non-linear hillslope erosion and transport law
BasicVs which uses variable source area hydrology
BasisRt which allows for two lithologies with different K values