Storm depends on several other tools. Partly, they are packed with Storm. This page describes dependencies which are assumed to be present on the target system. We both give a general list, as well as operating system specific hints how to install them.
For the compilation step, a C++14-compliant compiler is required. Storm is known to work with
- GCC 5.3, GCC 6
- clang 3.5.0
- AppleClang 8.0.0
Newer versions of these compilers will probably work, but are not necessarily tested. In particular, the following list of compilers is known to not work.
- GCC versions 4.9.1 and older
- clang 3.4 and older
The following two lists provide an overview over the required and recommended dependencies of Storm. Required dependencies are absolutely essential for Storm to be compiled and must be installed. Recommended dependencies are optional, but not installing them may severely limit the offered functionality.
- boost (>= 1.61)
- Z3 (not strictly required, but already needed for standard tasks like PRISM/JANI model building)
- xerces-c (needed for the parsing and export of XML files, in particular for GSPNs)
- Eigen3 (installation prevents an expensive part of the build step)
- MathSAT (needed by the abstraction refinement engine, needs to be configured manually during the configuration)
OS specific preparations
We collected some platform specific hints to ease the installation of Storm on the supported operating systems. Since Storm has some optional dependencies that enhance it’s functionality, and some dependencies that are strictly required, we show how to install both the required and recommended dependencies. The installation instructions of the recommended dependencies already include the required dependencies.
macOS 10.12 “Sierra” and higher
First of all, you need to download and install Xcode and its command line utilities to have the suitable command line tools. For more details, we refer to this tutorial.
Furthermore, we recommend the usage of Homebrew to install the missing packages, but MacPorts might (at some point) have the desired dependencies as well.
$ brew install cln ginac automake cmake boost gmp glpk hwloc
$ brew install cln ginac automake cmake boost gmp glpk hwloc z3 xerces-c
Debian 9 “Stretch” and higher, and
Ubuntu 18.04 “Bionic Beaver” and higher
$ sudo apt-get install build-essential git cmake libboost-all-dev libcln-dev libgmp-dev libginac-dev automake libglpk-dev libhwloc-dev
$ sudo apt-get install build-essential git cmake libboost-all-dev libcln-dev libgmp-dev libginac-dev automake libglpk-dev libhwloc-dev libz3-dev libxerces-c-dev libeigen3-dev
Manually installing dependencies optional
Storm makes use of CArL for the representation of rationals and rational functions. If you don’t have it installed on your system, our build script will download and configure it automatically for you. However, under certain circumstances, you might want to install CArL yourself. This may for example be advantageous if you need to repeatedly build Storm from scratch or you want to change its source code. Installing CArL is as easy as
$ git clone -b master14 https://github.com/smtrat/carl $ cd carl $ mkdir build $ cd build $ cmake -DUSE_CLN_NUMBERS=ON -DUSE_GINAC=ON -DTHREAD_SAFE=ON .. $ make lib_carl
Make sure you are using the
master14 branch of CArL as the current master branch uses a newer C++ standard that Storm does not require and therefore does not enable.
Once it is build, it will register itself to cmake so Storm can find your build automatically.
There may be problems with this auto-detection mechanism if you have multiple versions of CArL installed. We strongly recommend to have CArL just once and completely remove the build folder of Storm if one is already present. Rerunning
cmake should then pick up on the “new” version of CArL.
Storm requires Boost to be available in a version that is at least 1.61. On the supported operating systems this can be easily achieved with readily available package managers. If your system does not allow for an easy installation of this Boost version, you might need to build it yourself.
$ wget https://sourceforge.net/projects/boost/files/boost/1.63.0/boost_1_63_0.tar.gz $ tar -xzf boost_1_63_0.tar.gz $ cd boost_1_63_0 $ ./bootstrap.sh $ ./bjam
If you want to install Boost in some other location, you can provide a
--prefix=path/to/installation/prefix to bootstrap.
If you installed your self-built Boost version into standard system locations, it should automatically be found by Storm. However, if it resides in a non-standard location, you need to make Storm aware of it, by passing
-DBOOST_ROOT=/path/to/boost to the
cmake invocation in the configuration step.