Project

General

Profile

Advanced configuration

Configuring iSALE is achieved by running the following command in the iSALE root directory:

./configure [--prefix=</installation/directory/>]

where --prefix=</installation/directory/> is an optional argument that allows the user to specify the location of the directory into which iSALE will be installed. If a prefix is not specified, iSALE will install into the default directory /tmp/hydrocode. Note that the install directory does not have to exist before configuration, but the user must have permission to create this directory or the install process will fail.

By default, the configure process will set-up iSALE so that only iSALE2D/3D (and required libraries) are compiled. To compile other subprograms (e.g., visualisation software) some other optional configure arguments are required, which are described below.

Instructions for configuring iSALE for use on specific platforms are given here:

Re-configuring

If you want to configure iSALE again, using the same options as before, there is a short-cut for doing this:

./config.status --recheck

VIMoD

To configure iSALE to use VIMoD for visualisation of data add the optional argument:

--with-vimod

Note that by default this will install various files needed by VIMoD to the directory <prefix>/share/vimod. You can change this path by using the optional argument

--with-vimod-path=<path>

Vimod depends on qt-3.3. The corresponding library, header files, and binaries are usually found automatically by configure. If not (configuration of vimod or other qt-based projects fails), you can use following arguments to configure vimod manually:

--with-qt-libpath=<path>
set path where qt-3.3 library (libqt-mt.so) is found.
--with-qt-includes=<path>
specify where to find qt-header files.
--with-uic=<executable>
set location of uic (qt binary). Please be sure that this uic-binary belongs to qt v3.3 and not newer versions of qt.
--with-moc=<executable>
set location of moc (qt binary). Please be sure that this moc-binary belongs to qt v3.3 and not newer versions of qt.

pySALEPlot

pySALEPlot is a simple plotting program for processing iSALE2D model output. It uses the PYTHON package as well as NumPy and matplotlib, so this must be installed on your system before you can install and use iSALEPlot. For more information about installing pySALEPlot, see here.

To configure iSALE to use pySALEPlot for visualisation of data you need to add the optional argument:

--with-pysaleplot

iSALEPlot

iSALEPlot is a simple plotting program for processing iSALE2D model output. It uses the PGPLOT library, so this must be installed on your system before you can install and use iSALEPlot. For more information about installing PGPLOT see these pages.

To configure iSALE to use iSALEPlot for visualisation of data you need to add two optional arguments:

--with-isaleplot

and:

--with-pgplot-lib="</path/to/pgplot/library> -l<other_required_libs>" 

Where </path/to/pgplot/library> specifies the location of the PGPLOT library, and <other_required_libs> are the names of other libraries that PGPLOT requires, such as PNG, X11 and Aquaterm libraries. For example, to configure iSALE to use iSALEPlot on Imperial's AMCG Linux systems, the required command is:

./configure --with-isaleplot --with-pgplot-lib="/usr/lib/libpgplot.a -lpng -lX11" 

MPI

iSALE3D uses MPI to parallelize computations. By default, iSALE3D is configured to run in serial (i.e. MPI is disabled). To enable MPI, configure with the optional argument:

--with-mpi

Compiling with MPI requires that MPI libraries are installed on your system. By default, iSALE expects the MPI library to be: /usr/local/lib/libmpich.a. If the MPI library is in a different place on your system, use:

--with-mpi-lib=</path/to/mpi/library>

to specify its location. For example, on Imperial's AMCG Linux systems, the required command is:

./configure --with-mpi --with-mpi-lib=/usr/lib/openmpi/lib/libmpi.a

Editing the iSALE manual (developers only)

To modify the manual, developers will need to add the option:

--with-docsrc

to the configure command. This requires pdflatex as a prerequisite.

--

Not what you're looking for? If you do not find specific information, feel free to contact us...