Underworld

a long term geodynamics simulation platform

SCons Download and Installation

Why SCons?

SCons must be used to configure versions of Underworld later than Underworld-1.1.0 (in the past VMake was used for this). Further information is available here.

Before you install SCons

SCons comes packaged with versions of Underworld later than Underworld-1.2.0, so no longer needs to be installed separately.

Before installing SCons, note that Underworld has also moved from using Subversion to Mercurial for updating copies of Underworld-1.2.0 and later. Mercurial in turn requires particular version(s) of Python for some operating systems. Therefore, prior to setting up and compiling SCons and Mercurial, you may choose to install a version of Python that is appropriate for use with SCons and Mercurial on your operating system.

Downloading and Installing SCons 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 scons

Downloading and Installing SCons Manually

These instructions apply to any Linux, Unix or Mac operating system. The SCons source can be downloaded from this site (look for a file like scons-1.2.0.tar.gz). The minimum version of SCons for use with the Bleeding Edge version of Underworld is 1.0.0.

Untar and unzip the downloaded file (if you are on a mac, this may be done for you):

tar zxvf scons-1.2.0.tar.gz

Then navigate into the unzipped directory and type the following (root or administrator access may be required; on macs type "sudo python setup.py install" instead):

python setup.py install

This will install SCons files in to relevant subdirectories in /usr/, which is recommended. However, if you are unable to install using this command due to lack of root or administrator access, you can use the --prefix flag to specify an alternative installation location, such as your home directory, which will install SCons into subdirectories (e.g. $HOME/bin) within the directory nominated by the prefix flag:

python setup.py install --prefix=$HOME

Compiling Underworld using SCons

See Compiling UnderWorld With SCons.

-- Wendy Mason - 28 October 2010
-- Patrick Sunter - 21 October 2010
-- Wendy Sharples - 21 October 2010
-- John Spencer - 16 Jul 2008
-- Luke Hodkinson - 9 Jul 2008