Underworld

a long term geodynamics simulation platform

Mercurial Download and Installation

Why Mercurial?

Mercurial is now being used as Underworld's version control system. The instructions below detail how install Mercurial. Further information on Mercurial is available here.

Before you install Mercurial

Prior to setting up and compiling Mercurial, please ensure that you have installed the correct version of Python for your operating system.

You will need to download at least version 1.5.3 of Mercurial.

Installing Mercurial using MacPorts (mac only)

Note: If you intend to use Macports packages to install the dependencies required by Underworld and gLucifer, we recommend you use Macports for all dependencies (except PETSc). This will avoid problems of confusion between Macports-installed and default system libraries such as X11, which can cause run-time issues.

Type the following (from any directory, assuming you have MacPorts in your path):

port install mercurial

Installing Mercurial using Binaries

You can get Mercurial here, and be sure to look at the binary builds option (which includes disk images for macs) here. The same page also supplies intructions for downloading Mercurial using some package managers (such as fink or macports on macs). Please note that if you are using Ubuntu 8.04 or less the packaged version of Mercurial is older than the one required and you will need to build from source.

Mercurial Forest Plugin (developers only)

Developers (only) will also require the forest plugin. See this for instructions.

Setting Up Environment Variables (mac only)

Mac users may have to add these lines to their ~/.bashrc (if you are using bash) or ~/.tcshrc (if you are using tcsh):

bash:

export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:${PATH}
export LC_ALL=en_EN.UTF-8
export LANG=en_EN.UTF-8

tcsh:

setenv PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:${PATH}
setenv LC_ALL=en_EN.UTF-8
setenv LANG=en_EN.UTF-8

-- Wendy Mason - 28 June 2011
-- Jerico Revote - 28 June 2011
-- Julian Giordani - 28 June 2011
-- Patrick Sunter - 21 October 2010
-- Wendy Sharples - 21 October 2010
-- John Spencer - 23 August 2010