Short Installation Instructions • uqsa

Prerequisits

The simulators (ODE solvers) we use need the GNU Scientific library (GSL) to be installed in your system.

sudo apt install libgsl-dev # on Ubuntu

The model building part of UQSA (transferring the SBtab network model to a mathematical model in C or R) also requires that you have a C compiler (e.g. gcc).

sudo apt install gcc        # on Ubuntu

On some systems the GSL may be installed in an unexpected location (on clusters this will almost certainly be the case). So, we rely on pkg-config to find this location.

sudo apt install pkg-config # on Ubuntu

You probably know the equivalent commands on your system.

The following Sections have instructions for several different operating systems, for convenience.

On macOS

To install libraries and science related software, people typically opt for homebrew, or nix. Here is an example using homebrew:

# macOS has a lot of issues with xcode, maybe agree to Xcode license?
brew install pkg-config gsl

MacOS does not have a default package manager for software of this kind. There is probably no easier way of getting the above done on a factory fresh device without first installing brew or nix.

It may be unnecessary to install gcc, if you already have clang.

On GNU/Linux

Debian/Ubuntu derived:

sudo apt install pkg-config gcc libgsl-dev

Other distributions have some version of this:

sudo apk add gsl pkgconf            # Alpine
sudo guix install gsl pkg-config    # GNU Guix
sudo pacman -S gsl pkgconf          # Arch, btw.
sudo zypper install gsl pkg-config  # OpenSuSE, SLES

… and many more.

Installation of the R packages

In order to use UQSA you (obviously) need the R language (maybe R-studio). We will assume that you already have R.

To auto-generate model-code in R, you need to install the package Ryacas, which is needed for model building:

install.packages("Ryacas")

You can now install the packages developed by the UQSA team:

remotes::install_github("icpm-kth/uqsa",dependencies=TRUE)

MPI

MPI is intended for compute clusters (HPC) and is typically not needed if you have one machine you want to do simulations on.

We do have several examples about MPI usage with this package (see documentation on Parallel chains with MPI and Example UQ on deterministic AKAR4 with MPI). However, if you want to try them, you will need MPI.

To install MPI on Debian/Ubuntu, in the shell:

sudo apt install libopenmpi-dev

To install R bindings, in R:

install.packages("pbdMPI")

On other systems, install the equivalent package for OpenMPI (R package interfacing with MPI libraries on your system).