Building and Installing IPLT from Source

Installing the dependencies

IPLT is based on OpenStructure and uses the GNU Scientific library (gsl) in addition to the OpenStructure dependencies to perform some calculations. Therefore before IPLT can be compiled the following dependencies have to be installed:

Downloading IPLT

These are the latest snapshots, tar/gzipped for your convenience. After download, issue the following command to unpack: 

tar -xzf iplt-rev<revision>.tgz

Configuring

IPLT uses CMake for compiling and building the project. The next required step is to configure the build environment using cmake. You can do that by invoking cmake in the project directory: 

cmake . <options>

There are two kinds of options: Options that let you control the building behaviour and options that let you tell CMake where to find the dependencies. All of them are passed to CMake with via -D<opt>=<value>.

Flags to Control the Dependencies

By default, CMake searches the standard directories for dependencies. However, on some systems, this might not be enough. Here is a short description of how CMake figures out what dependencies to take and how you can influence it.

  • OpenStructure is controlled via the OPENSTRUCTURE_ROOT option. It should be set to the absolute path of the OpenStructure installation.
  • Boost is mainly controlled via the BOOST_ROOT option. If boost wasn’t found, it should be set to the prefix of the boost installation.
  • QT_QMAKE_EXECUTABLE defines the exact Qt installation to take. It should be set to the full path to qmake.
  • PYTHON_ROOT is the Python equivalent of BOOST_ROOT. It should be set to the prefix path containing the python binary, headers and libraries.
  • SYS_ROOT controls the general prefix for searching libraries and headers. By default, it is set to /.

Build Options

  • If OPTIMIZE is set to 1, an optimized version of IPLT is built.

Building the Project

Type make. If you are using a multi-core machine, you can use the -j flag to run multiple jobs at once.

Attachments