MRST - MATLAB Reservoir Simulation Toolbox

Documentation and publications
There are several sources you can consult to learn more about MRST, including a textbook, a series of short videos (Jolts), and the many tutorials that follow the software; some of these are also available as webpages. In addition, almost all functions in MRST are documented in a similar way as in MATLAB. Last but not least, we have tried to maintain an updated list of scholarly work in which MRST is utilized. The list consists of more than 100 master/PhD theses and 130+ journal/conference papers written by authors outside of SINTEF.


The MRST book

K.-A. Lie. An introduction to reservoir simulation using MATLAB: User guide for the Matlab Reservoir Simulation Toolbox (MRST). SINTEF ICT, December 2016

The MRST book is the primary resource to learn about MRST and the various models, solvers, and workflow tools that are implemented in the software. Scripts and functions necessary for most of the examples can be found in the 'book' module of the official MRST release. A copy of some of the unpublished book chapters can be obtained upon request.



A Jolt is a short learning module that consist of a set of 3-10 minute videos that cover one specific topic. The first Jolt consists explains what MRST is, how to download the software, and how to make your first flow solvers. The Jolt also contains an interview in which we explain the background of MRST and why we have chosen to release the software as free, open-source. The second Jolt introduces you to the kinds of grids that are used in reservoir simulation, outlines how grids are represented in MRST, and discusses how to use the software to generate structured and unstructured grids.



Tutorial lectures

The MRST team has given several short courses and tutorial lectures on the software and reservoir simulation in more general. We have collected some slide sets and a few video recordings and hope that you find them useful.



 Tutorial codes

All modules in MRST have a set of tutorial scripts that introduce you to the basic functionality of the module. Several of these are also available on the module webpages. In addition, we have number of tutorials that introduce you to basic functionality of MRST.


Autogenerated documentation

Autogenerated documentation from MRST's source code and examples can be found here. We use the Sphinx documentation system to generate these files.


Citing MRST

If you are using MRST in any publication, we would be grateful if you cite the MRST book or one of the following three papers (possibly in addition to a link to our webpage):


K. Bao, K.-A. Lie, O. Møyner, and M. Liu. Fully implicit simulation of polymer flooding with MRST. Comput. Geosci., Vol. 21, Issue 5-6, pp. 1219-1244, 2017. DOI: 10.1007/s10596-017-9627-2. Also available from: Springer Nature ShareIt.

An earlier version was published as: K. Bao, K.-A. Lie, O. Møyner, and M. Liu. Fully-implicit simulation of polymer flooding with MRST. ECMOR XV, Amsterdam, Netherlands, 29 Aug--1 Sept, 2016. DOI: 10.3997/2214-4609.201601880


S. Krogstad, K.-A. Lie, O. Møyner, H. M. Nilsen, X. Raynaud, and B. Skaflestad. MRST-AD - an open-source framework for rapid prototyping and evaluation of reservoir simulation problems. Paper 173317-MS presented at the 2015 Reservoir simulation Symposium, Houston, Texas, USA, 23-25 February 2015.


K.-A. Lie, S. Krogstad, I. S. Ligaarden, J. R. Natvig, H. M. Nilsen, and B. Skaflestad. Open source MATLAB implementation of consistent discretisations on complex grids. Comput. Geosci., , Vol. 16, No. 2, pp. 297-322, 2012. DOI: 10.1007/s10596-011-9244-4
Complete MATLAB scripts that reproduce (almost) all the figures and examples in the paper are available for download, see e.g., Example 5 and Example 6.

An earlier version was published as: K.-A. Lie, S. Krogstad, I. S. Ligaarden, J. R. Natvig, H. M. Nilsen, and B. Skaflestad. Discretisation on complex grids -- Open source MATLAB implementation. Proceedings of ECMOR XII, Oxford, UK, 6-9 September 2010


Scientific publications utilizing MRST

MRST has been used in a large number of journal articles, conference proceedings, and master and doctoral theses. We try to collect as many as possible of these publications and have compiled them in separate lists. If your paper is missing in the lists, if have you used MRST in your thesis, or if have you supervised students using MRST, we are of course very happy to hear about it. If you provide us with publication details, we will list your publication or details about the thesis. If you also provide us with an illustrateive picture and a short description, we will highlight your work  on our gallery pages. Contact:

Published June 14, 2011