MRST - MATLAB Reservoir Simulation Toolbox

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.


The MRST book

K.-A. Lie. An introduction to reservoir simulation using MATLAB/GNU Octave: User guide for the MATLAB Reservoir Simulation Toolbox (MRST). Cambridge University Press, 2019.

This 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. The book will soon be electronically available as Gold Open Access from Cambridge University Press. Meanwhile, preliminary versions of some of the chapters are available online. To cite the book, please refer to the published version and not the preliminary manuscript.



User guides

The following two user guides document two GUIs for flow diagnostics pre- and postprocessing:


Autogenerated documentation

Autogenerated documentation from MRST's source code and examples can be found here. The documentation gives an overview of each individual module and documents all the main functions and class objects typset on a standard format.

We use the Sphinx documentation system to generate these files.



A JOLT is a short learning module that consist of a set of 3-10 min videos that cover one specific topic. The first JOLT explains what MRST is, shows how to download the software, and instructs you how to make your first flow solvers. The JOLT also contains an interview with Knut-Andreas Lie, in which he explain the background of MRST and why it is release free, open-source software. 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.


Reservoir modelling and simulation with MRST, by Ø.S. Klemetsdal, Transform 2021, Software Underground, 20 April 2021

Building an Open-Source Community Code: the MATLAB Reservoir Simulation Toolbox (MRST), by K-A Lie, GeoScience & GeoEnergy Webinars, 27 August 2020.

Reservoir Modeling Using MATLAB - The MATLAB Reservoir Simulation Toolbox (MRST), by K-A Lie, MATLAB Energy Conference, 17 November 2020.



 Modules and tutorials

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.



Key papers about MRST

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

Published June 14, 2011