Underworld

a long term geodynamics simulation platform

Recent Underworld Releases

See the Downloads page for operating system specific packages/binaries. See the documentation page for a guide to selecting, installing and / or using Underworld. See the downloads archive for archived documentation pertaining to prior to the previous release.

Note for Code Developers: Code developers are recommeded to check out a version controlled copy 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.

"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. Note, this sets up the code under the directory "bleedingEdge", but you can call it what you want.

hg clone https://www.underworldproject.org/hg/stgUnderworld bleedingEdge

cd bleedingEdge

hg up default

./obtainRepositories.py

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

Snapshots

Snapshots are log files that record the state of all the directories Underworld uses. Daily snapshots are generated by Underworld's testing system, Shinkou and can be used to sync the repositories to a previous state they were in. You can download a snapshot file from the "Build Attachments" located at the bottom of each build page. See Shinkou at https://www.auscope.monash.edu/engineering/build

To apply a snapshot file, called snap_file, to create a new version of the code under the directory "previousUnderworld" run:

hg fseed --snapfile "downloaded-snapfile" --root previousUnderworld

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

Underworld 1.6.0

Source Code

The Underworld-1.6.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.underworldproject.org/hg/stgUnderworld Underworld_1.6.0

Note that the last "Underworld_1.6.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.6.0

hg up 1.6.0

./obtainRepositories.py

Then type the following and look for "(1.5.x)" on each line to confirm that you have selected the 1.6.0 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.6.0 release notes are available for download at the downloads page

-- Wendy Mason - 08 June 2011
-- Julian Giordani - 10 February 2011
-- Jerico Revote - 05 November 2009
-- John Spencer
-- Kathleen Humble
-- Patrick Sunter