Configuring iSALE is achieved by running the following command in the iSALE root directory:
--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:
- AMCG Linux (Ubuntu) workstations at Imperial College London
- Apple MacBook Pro laptops
- MfN-cluster with MPI using ifort-compiler
- MfN-cluster with MPI using gfortran-compiler
- MfN Linux (Ubuntu) workstations (MPI disabled)
If you want to configure iSALE again, using the same options as before, there is a short-cut for doing this:
To configure iSALE to use VIMoD for visualisation of data add the optional argument:
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
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:
|set path where qt-3.3 library (libqt-mt.so) is found.|
|specify where to find qt-header files.|
|set location of uic (qt binary). Please be sure that this uic-binary belongs to qt v3.3 and not newer versions of qt.|
|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 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:
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:
</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"
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:
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:
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:
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...