Underworld-II Tutorial

Jun 23rd 8:00 am - 12:00 pm
UC Davis - Student Community Center


Thursday, June 23

UC Davis

Underworld2 is a python-friendly version of the Underworld geodynamics code which provides a programmable and flexible front end to all the functionality of the code running in a parallel HPC environment. This gives signficant advantages to the user, with access to the power of python libraries for setup of complex problems, analysis at runtime, problem steering, and coupling of multiple problems. Underworld2 is integrated with the literate programming environment of the jupyter notebook system for tutorials and as a teaching tool for solid Earth geoscience.


  • Louis Moresi, University of Melbourne
  • John Mansour, Monash University

Workshop Information

Workshop Topics

We will give a from-scratch overview of the python-based Underworld2 code using examples of interest to the mantle and lithospheric dynamics communities.

  • Getting started with Underworld / iPython notebooks
  • Introduction to the algorithms (PIC / FEM) and python constructs
  • Setting up a problem / examples
  • Solvers and equation systems
  • Parallel code
  • Moving to a supercomputer / batch environment

Our goal is to have people leave the workshop with a functioning version of Underworld and enough knowledge to tinker with the simple examples.

Technical Requirements

Docker Underworld images are the preferred avenue for Underworld usage.

Mac / WindowsKitematic Docker GUI. Details on installing Underworld2 via Kitematic are available here.

Linux: Docker toolbox (see for linux specific information). An overview of dockers, as well as details on installing Underworld2 via the docker command line interface is available here.

Those wishing to compile natively are directed to the Underworld2 github page for details.


Please registered for this tutorial through the CIG '16 registration web page.

Tags: tutorial  2016  underword  
Sign In