Chapter 1. Installation

Table of Contents

Install SIPPI
Install SIPPI manually from github
SGeMS (optional)

Install SIPPI

The latest stable version (v 1.5 ) of SIPPI can be downloaded from http://sippi.sourceforge.net as SIPPI.zip. This version includes mGstat, VISIM, SNESIM, and MPSlib(C++).

Unpack ZIPPI.zip somewhere, for example to 'c:\Users\tmh\SIPPI'. Then setup the Matlab path to point to the appropriate SIPPI directories by typing:

addpath c:\Users\tmh\SIPPI
sippi_set_path

For use on Windows, no other setup should be needed.

For use on Linux, no other setup should be needed

For use on OS X, Xcode with gcc libraries but be available to run some of the compiled programs. In addition, the 'DYLD_LIBRARY_PATH' must be set to point to the shared libraries neeeded by the compiled programs for OSX. In Matlab this can be set using:

setenv('DYLD_LIBRARY_PATH', '/usr/local/bin');

Install SIPPI manually from github

The current development version of SIPPI (less stable and documented) is hosted on github and can be downloaded (including mGstat, SNESIM, VISIM and MPSlib(C++)) using git:

cd INSTALL_DIR
git clone  https://github.com/cultpenguin/sippi.git SIPPI
git clone  https://github.com/cultpenguin/mgstat.git mGstat
git clone  https://github.com/ergosimulation/mps.git MPS

Then add a path to both SIPPI, mGstat and MPS in Matlab using

>> addpath INSTALL_DIR/mGstat
>> addpath INSTALL_DIR/SIPPI
>> addpath INSTALL_DIR/MPS/matlab
>> sippi_set_path

Manual compilation

SIPPI (optionally) make use of standalone programs from MPS, (github) SNESIM (github) and mGstat (VISIM github) . Pre-compiled slef-contained binaries are available for windows and Linux, but for use on OS-X one may need to manually these programs

These programs are needed to make use of the MPS, VISIM and SNESIM type a priori models (and can hence be ignored if not used).

Compiling VISIM

The source code for VISIM is located in mGstat/visim/visim_src. The compiled program should be placed in mGstat/bin and called visim.

Compiling SNESIM

The source code for SNESIM is available from github.

The compiled program should be placed in mGstat/bin and called snesim.exe (windows) snesim_glnxa64.exe (64 bit Linux) snesim_maci64.exe (64 but OS X). .

Compiling MPSlib(C++)

The source code for MPSlib(C++) is available from github. To dowload and compile MPSlib(C++) use for example

cd INSTALL_DIR
git clone  https://github.com/ergosimulation/mpslib.git MPSLIB
cd MPS
make all

Matlabs path should be updated to include INSTALL_DIR/MPSLIB/matlab.

SGeMS (optional)

To make use of the SISIM and SNESIM_STD type prior models, SGeMS needs to be available.

Currently only SGeMS version 2.1 (download) for Windows is supported by SIPPI

Support for SGeMS will be discontinued after relevase v1.5, as the MPSlib(C++) library will be used instead.