Underworld

a long term geodynamics simulation platform

Recent Underworld Releases

See the Installation Guide for a guide to selecting, installing and / or using Underworld.


Note for Code Developers

Code developers are recommeded to check out a version controlled coy of Underworld by following the instructions on this page. However, to be able to modify the Underworld source code, you will need an account first, by contacting Louis Moresi. Once you have an account, you will also be able to access the Underworld Issue and Bug Tracking Trac.


Recent Release History

See the Downloads page for operating system specific packages/binaries.


"Bleeding Edge" version from the hg repository

Type the following to download the latest version of Underworld using Mercurial, which includes the latest modifications, but may not always be stable:

hg clone https://www.mcc.monash.edu.au/hg/stgUnderworld stgUnderworld

Note that the last "stgUnderworld" argument determines what the directory name will be of your checkout - this is entirely up you. Additionally, you will need to run the following to set the repository branch to the stable branch (as opposed to the development branch), and download all the externals for the package:

cd stgUnderworld
./obtainRepositories.py

See Compiling from Source with SCons for details of how to compile with SCons.


"Bleeding Edge" Snapshots

Daily snapshots are now being generated of the "Bleeding Edge' code repository. Download the snapshot file for the date you require (format is snapshot_yearweekday) from https://www.mcc.monash.edu.au/trac/test/build.

Check out the code from the "Bleeding Edge" repository as detailed in the section above, but before configuring, from within the directory you checked out (e.g. stgUnderworld) type the following (where filename is the pathname of the snapshot file you downloaded):

hg fseed --snapfile filename --root

Then compile with SCons by following the instructions at Compiling from Source with SCons.


Underworld 1.4

Source Code

The Underworld-1.4 stable release tarball is available for download at the downloads page.

Note: the tarball copy of Underworld cannot be updated to a later version. For instructions on how to download an updateable copy, please see the instructions below on downloading the Underworld source code using Mercurial.

As an alternative to downloading the above tarball, you can check out this version of the code from the CSD Mercurial repository:

hg clone https://www.mcc.monash.edu.au/hg/stgUnderworld Underworld_1_4

Note that the last "Underworld_1_4" argument determines what the directory name will be of your checkout - this is entirely up you. Additionally, you will need to run the following to download all the externals for the package:

cd Underworld_1_4
hg up 1.4.x
./obtainRepositories.py

Then type the following and look for "(1.4.x)" on each line to confirm that you have selected the 1.4.1 branch:

./identify-all.sh

See Compiling from Source with SCons for details of the compile process.

InputFiles Directory Only

If you are using the "underworld" module on a computer cluster (see the Cluster page for details on how to use this module), you may like to download a tarball of the InputFiles directory for this version of the code from the downloads page. For instructions on including a template InputFile directly from an Underworld module installation on a computer cluster, see the Underworld User Manual

Offline User Documentation

An offline html snapshot of the user documentation on this website for this release is available for download at the downloads page (Firefox browser recommended).

Release Notes

The Underworld-1.4 release notes are available for download at the downloads page


Underworld 1.2.0

Source Code

The Underworld-1.2.0 stable release tarball is available for download at the downloads page.

Note: the tarball copy of Underworld cannot be updated to a later version. For instructions on how to download an updateable copy, please see the instructions below on downloading the Underworld source code using Mercurial.

As an alternative to downloading the above tarball, you can check out this version of the code from the CSD Mercurial repository:

hg clone https://www.mcc.monash.edu.au/hg/stgUnderworld Underworld_1_2_0

Note that the last "Underworld_1_2_0" argument determines what the directory name will be of your checkout - this is entirely up you. Additionally, you will need to run the following to download all the externals for the package.

cd Underworld_1_2_0
hg up v1.2.x
./obtainRepositories.py

See Compiling from Source with SCons for details of the compile process.

InputFiles Directory Only

If you are using the "underworld" module on a computer cluster (see the Cluster page for details on how to use this module), you may like to download a tarball of the InputFiles directory for this version of the code from the downloads page. For instructions on including a template InputFile directly from an Underworld module installation on a computer cluster, see the Underworld User Manual

Offline User Documentation

An offline html snapshot of the user documentation on this website for this release is available for download at the downloads page (Firefox browser recommended).

Release Notes

The Underworld-1.2.0 release notes are available for download at the downloads page


-- Wendy Mason - 09 March 2010
-- Julian Giordani - 12 January 2010
-- Jerico Revote - 05 November 2009
-- John Spencer
-- Kathleen Humble
-- Patrick Sunter