Underworld

a long term geodynamics simulation platform

Underworld Frequently Asked Questions and Links

Using Underworld already installed on a cluster

Each recent Undeworld release is pre-installed and ready to use on supported computer clusters. See links on the Cluster page for using Underworld release modules on clusters.

What Dependency Software Do I Need to Compile and Run Underworld on My Local Machine?

See Dependencies.

How do I Choose Which Version of Underworld to Use on My Local Machine?

See Releases.

Downloading and installing your own copy of Underworld

To install your own copy of Underworld onto your local machine, follow the instructions and links from the Underworld installation page

How do I / Can I Update My Copy of Underworld?

See Updates.

Environment Variables - Checking, Editing, Saving and Settings

See EnvVariables for general settings and links on the Cluster page for compiling on supported computer clusters..

Configuration Conditions and Options

See CompileSCons and links on the Cluster page for compiling on supported computer clusters.

I'm getting a dyld error when I try to run a model on my mac (using PETSc 2.3.2)

If you have been able to compile and make Underworld on your local mac, but can't run any problems without getting an error message that begins with "dyld:", then you need to set your DYLD_LIBRARY_PATH. To do this in your .bashrc (or .bash_profile depending on how you have set it up), make sure you have the equivalent of:

For the PETSc 2.3.2 libray path, add:

export LD_LIBRARY_PATH=$PETSC_DIR/lib/$PETSC_ARCH:$LD_LIBRARY_PATH

For the MPICH 2 library path, add:

export LD_LIBRARY_PATH=$MPI_DIR/lib:$LD_LIBRARY_PATH

then you will then need to set the dynamic library path:

export DYLD_LIBRARY_PATH=$LD_LIBRARY_PATH

You will then need to source your .bashrc to include the changes. Note: it may be worth trying to run the xml files again before you do a reconfigure and make, as they may not be necessary.

Underworld won't run (when using Mpich 2)

If you are using Mpich 2 and your models won't run, mpd may not be running (see Setting up and Testing mpd). To set mpd running, type (where /usr/local/mpich-optimised is the directory into which you built the copy of Mpich 2 that you built PETSc and Underworld with):

/usr/local/mpich-optimised/bin/mpd &;

and then try runninng your model again. If your model still won't run, please consult Technical Support.

Submitting an Underworld bug or feature request

Registered members of the Underworld community can submit an Underworld bug/feature request using the Underworld Trac's "new ticket". The front page of the Underworld Trac is at http://csd.vpac.org/trac/AuScope/Underworld/, and is part of the entire Multi-project Trac for all AuScope projects.

-- Wendy Mason - 13 January 2010