This is a fork of the Underworld package to be used for geoscience tutorials. Please refer for original package if you are looking for underworld 2 repo: https://github.com/underworldcode/underworld2
Please visit the Underworld documentation site for an overview of installation, numerical methods, usage and the API reference.
https://underworld2.readthedocs.io
In particular, the Getting Started section of the User Guide might be useful place to start.
Underworld is an open-source project licensed under LGPL Version 3. See LICENSE.md
and LGPLv3.txt
for details.
Note that for releases 2.9.0
, 2.9.1
, 2.9.2
, 2.9.3
and 2.9.4
, the incorrect text was erroneously included within LGPLv3.txt
, although these releases must still to be considered as licensed under LGPL Version 3.
If you use this software, please remember to cite it using one or more of the following references.
To cite the Underworld2 software package, please use:
Mansour, J., Giordani, J., Moresi, L., Beucher, R., Kaluza, O., Velic, M., Farrington, R., Quenette, S., Beall, A., 2020, Underworld2: Python Geodynamics Modelling for Desktop, HPC and Cloud, Journal of Open Source Software, 5(47), 1797, https://doi.org/10.21105/joss.01797
If you would also like to cite the codebase itself, you may use the Zenodo reference:
https://doi.org/10.5281/zenodo.1436039
Note that the above DOI URL will always resolve to the latest Underworld2 release. DOIs for previous versions are also available via the above DOI.
Details of the algorithms are citeable via the following references:
Moresi, L., Dufour, F., and Muhlhaus, H.B., 2002, Mantle convection modeling with viscoelastic/brittle lithosphere: Numerical methodology and plate tectonic modeling: Pure And Applied Geophysics, v. 159, no. 10, p. 2335–2356, https://doi.org/10.1007/s00024-002-8738-3
Moresi, L., Dufour, F., and Muhlhaus, H.B., 2003, A Lagrangian integration point finite element method for large deformation modeling of viscoelastic geomaterials: Journal of Computational Physics, v. 184, no. 2, p. 476–497, https://doi.org/10.1016/S0021-9991(02)00031-1
Moresi, L., Quenette, S., Lemiale, V., Mériaux, C., Appelbe, W., Mühlhaus, 2007, Computational approaches to studying non-linear dynamics of the crust and mantle: Phys. Earth Planet. Inter, v. 163, p. 69–82, https://doi.org/10.1016/j.pepi.2007.06.009