Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Geodynamics
Underworld
A parallel, particle-in-cell finite element code for modelling the solid Earth as a complex fluid — from a laptop to a supercomputer, driven from Python.

Underworld solves the equations of slow, viscous flow on a finite element mesh while carrying material history on particles that move through it. That combination is what lets a model track stress, damage and composition through the very large deformations that geology produces — mountain building, subduction, mantle convection over hundreds of millions of years.

The current version, Underworld 3, is a ground-up rewrite. Models are written as symbolic expressions in SymPy, which the code compiles to C and hands to PETSc to solve. You write the physics; the machinery for discretising, differentiating and solving it is generated. There is a note on how that works.

Underworld is open source, developed in the open, and supported by AuScope under the Australian Government’s NCRIS programme.

Technical Notes
30 notes on how the code works and what it has been used for — methods, worked examples, benchmarks and design rationale. 30 carry a registered DOI and a fixed archival PDF. Read the series, or contribute one.
Latest
News, releases, and guides to getting Underworld running.
2025

Underworld3 published in Journal of Open Source Software

The aim of underworld3 is to provide strong support to users in developing sophisticated mathematical models, and provide the ability to interrogate those models during development and at run-time. Underworld3 encodes the mathematical structure of the equations it solves in symbolic form.
Read doi10.59350/a085z-qzh60

Underworld Geodynamic Modelling Workshop. Perth, 7 May 2025

You are invited to a full-day workshop on Underworld — a computational Geodynamics / Tectonics modelling framework. This is an excellent opportunity for researchers, students, and professionals interested in computational geodynamics and Earth science modelling to learn about Underworld.
Read doi10.59350/8vp5e-6cx59
2022

Folding UWGeodynamics into Underworld

Read doi10.59350/ng0d5-23959

Configuring and Installing PETSc for Underworld

Read doi10.6084/m9.figshare.33193509

Developing Underworld using Python Virtual Environments

Read doi10.6084/m9.figshare.33193515
2021

How to install Underworld on Mac OSX (Apple Silicon M1)

The new generation of Apple Mac comes with the new Apple Silicon (M1) chip which has an Arm architecture (as opposed to the older generation that had i386 Intel processor). This brings all manner of troubles and requirements for the development of codes.
Read doi10.6084/m9.figshare.33193455
2020

How to build Conda packages?

Read doi10.6084/m9.figshare.33193440

Getting started with Pull requests

Read doi10.6084/m9.figshare.33193434

Here comes Conda...

Sharing a workflow environment is also paramount if we want to make sure that reproducibility can be effectively tested. An environment management system such as conda allows us to do so.
Read doi10.59350/4c21r-t7c68

Underworld 2.10

Underworld 2.10 has dropped... kidding this is a benchmark model proposed by Schmalholz, 2011, A simple analytical solution for slab detachment.
Read doi10.59350/dwxt3-tgj66

Stripy 2.0 released

Generating Voronoi diagrams and interpolating / smoothing with spline tensions are among a list of new features in Stripy 2.0
Read doi10.59350/bpy2d-6ww41

COVID-19 lockdown leads to seismic noise “quiet period”

A new study by an international team of scientists found lockdown measures to stop the spread of COVID-19 led to a 50 per cent reduction in seismic noise around the world. The researchers, including Meghan Miller and Louis Moresi from ANU analysed datasets from over 300 seismic stations.
Read doi10.59350/werfa-yd829

Australian cities are quiet during lockdown. Earthquake scientists are making the most of it

Meghan S. Miller (ANU) Louis Moresi (ANU) Our responses to the COVID-19 pandemic have dramatically changed human activity all over the world. Sensitive instruments are detecting far less of the noise and vibration produced by humans in motion.
Read doi10.59350/qpft6-wks47

Australian Seismometers in Schools - Noise monitoring dashboard

How we built a simple dashboard using Github actions with open source software and openly available (FAIR) data.
Read doi10.6084/m9.figshare.33193428

Underworld publication news: Crustal thickness anomalies in stable continents.

Read doi10.59350/1561x-bcp63

Underworld 2.9

The Underworld 2.9 release is available from Github, as a docker container and via zenodo (doi:10.5281/zenodo.3964957) it is also available through pip install for the first time
Read doi10.59350/p0vnx-b9498

JOSS publication - Underworld 2

Read doi10.59350/gbzdq-dtj52
2019

Getting started: 60 seconds to Underworld

As the old truism states, the best way to learn is by doing. This guide can get you from zero to hero in 60 seconds - give or take.
Read doi10.6084/m9.figshare.33193419

An automated (zotero) bibliography in a webpage

Read doi10.6084/m9.figshare.33193416

Underworld Release 2.8

Read doi10.59350/90fe7-qqe67
2018

Cite Underworld from Zenodo

Read doi10.6084/m9.figshare.33193404
2016

Underworld2 Workshop at CIG 2016 Meeting

Read doi10.59350/m1brb-ah254
2015

Underworld and Docker (part 2)

Read doi10.6084/m9.figshare.33193341

Underworld and Docker (part 1)

Read doi10.6084/m9.figshare.33193329