Contact details and license

The multifluid Fluidity/IC-Ferst code base is developed and used at a number of academic institutions across the UK, including Imperial College London, the University of Aberdeen and London South Bank University. The code is released under the GNU Lesser Public License version 2.1. Public releases are made at irregular intervals, with internal releases on a monthly cycle.

To request access to the development repository, or to request further information, please contact the heads of the project, Professor Christopher Pain or Professor Matthew D. Jackson.

Department of Earth Science and Engineering
Royal School of Mines
Prince Consort Road
Imperial College London
SW7 2BP

How to install


IC-FERST is developed and run on Linux. To install on such machines it is necessary to install certain supporting software.

The basic list of supporting software, and method of installation, is the same as for the single phase Fluidity code.

Installing on Ubuntu

This is the best supported operating system. Intructions to install the necessary packages using the system package managers are given here. Once the fluidity-dev package has been installed, your system should be able to compile the IC-Ferst/ Multifluid Fluidity package, which may be downloaded at the foot of this page. The list of commands to get IC-FERST working is as follows:

– First install the Fluidity dependencies

sudo apt-add-repository ppa:fluidity-core/ppa
sudo apt-get update
sudo apt-get install fluidity fluidity-dev
export PETSC_DIR=/usr/lib/petscdir/3.6.3

It can be downloaded from github with the following one-line command

mkdir ICFERST && cd ICFERST && git init && git remote add -t  master  -f origin git@github.com:Multifluids/icferst.git && git checkout master

– Next Navigate to the root directory of your IC-FERST folder

cd IC-FERST-FOLDER/
./configure --enable-2d-adaptivity
make mp

Using the diamond GUI to configure test cases

The input files are “EXAMPLE.mpml”. This files can be either manipulated using diamond a GUI, or a text file. To open the diamond GUI for ICFERST this is an example, found in the examples folder in IC-FERST-FOLDER/legacy_reservoir_prototype/tests/3D_BL

diamond -s IC-FERST-FOLDER/legacy_reservoir_prototype/schemas/multiphase.rng 3D_test.mpml

Installing on other Linux systems

Although less well supported, the code has been found to run successfully on Red Hat and OpenSUSE systemd. A list of hints and tips for these and other systems may be found here.