MRST - MATLAB Reservoir Simulation Toolbox

Downloading MRST


The MATLAB Reservoir Simulation Toolbox (MRST) is available for download under the GNU General Public License (GPL).

The previous release of MRST, designated 2018b, is described in a separate document.

Highlights of Release 2019a

MRST 2019a was released on the 28th of June, 2019. We refer the reader to the complete Release Notes for MRST 2019a for a detailed description of the new features as well as issues to keep in mind if upgrading from previous releases of MRST. Here, we highlight some of the new features available in MRST 2019a.

  • Extensions of the AD-framework to use more general function relations. This makes it easier to change the discretizations, functional dependencies and obtain sensitivities with respect to any variable. This includes adaptive implicit, explicit and fully-implicit support in all solvers, as well as new solvers such as higher-order WENO-discretizations. See the stateFunctionTutorial.m and wenoExampleAD.m in ad-core for more information and demonstrations of usage.
  • Support for Mex-acceleration has been added to most AD-solvers. Compiled versions of all standard discrete operators (discrete gradient, upwinding, discrete divergence, face average etc). This can be orders of magnitude faster for larger problems and execute in parallel through OpenMP. For instance, assembling a residual on the form Accumulation + Div(flux) for a 3D grid with 1,000,000 cells and 5 variables per cell is sped up a factor 30 from the pure Matlab implementation on the same computer, a reduction from 5.2 seconds to 0.17 seconds. The example blackoilTutorialMexAcceleration.m in ad-blackoil demonstrates how to make use of this functionality.
  • Support for many additional features useful for simulation of petroleum recovery from Eclipse-type decks: Two and three-point relative permeability endpoint scaling, threshold pressures, multiple PVT regions and a few other smaller points

If you use MRST in writing a publication, the developers must be properly acknowledged by referring to the MRST webpage or citing the MRST book or one of our overview papers:

We would also be grateful if you send us an email with (pointers to) your publication.

Do note, however, that MRST requires at least MATLAB version 7.4 (R2007a). Some modules, notably the module for Multiscale Finite-Volume discretisions, require MATLAB version 7.9 (R2009b) or later. Morever, you have to run the startup.m script in the MRST root directory in order to initialize the package. If you start MATLAB from within the MRST root directory, startup.m will be run automatically, otherwise please navigate to the MRST root directory and type startup on the MATLAB command line.

We also refer to our list of Frequently Asked Questions which contains additional details on installation and basic use of MRST.

Download MRST

The most recent edition of MRST was released on the June 28th 2019. Unless you have specific reasons not to, you should generally choose the most recent version of the package. Note that while MRST releases are named using a scheme that is similar to the MATLAB software from The MathWorks, the naming does not reflect minimum requirements on the MATLAB version with which it is used. The release manager verifies that the MRST software does run on the same MATLAB version however (e.g., that MRST 2018a runs on MATLAB 2018a).

Please click the on the following link to download the sources to the current release, MRST 2019a (Windows), or MRST 2019a (Unix/Linux).

Earlier Editions of MRST

For backwards compatibility, we also publish the sources to earlier editions of the MRST software. These editions are unmaintained, however, and we encourage our users to employ the current release if possible. In particular we publish the following software packages (in the form of GZip-compressed TAR files)

  • The previous release, MRST 2018b, published on the 20th of December 2018.
  • The 17th release, MRST 2018a, published on the 1st of August 2018.
  • The 16th release, MRST 2017b, published on the 21st of December 2017.
  • The 15th release, MRST 2017a, published on the 15th of June 2017.
  • The 14th release, MRST 2016b, published on the 14th of December 2016.
  • The 13th release, MRST 2016a, published on the 8th of July 2016.
  • The 12th release, MRST 2015b, published on the 17th of December 2015.
  • The 11th release, MRST 2015a, published on the 12th of May 2015.
  • The tenth release, MRST 2014b, published on the 12th of November 2014.
  • The ninth release, MRST 2014a, published on the 14th of May 2014.
  • The eighth release, MRST 2013b, published on the 18th of October 2013.
  • The seventh release, MRST 2013a, published on the 18th of April 2013.
  • The sixth release, MRST 2012b, published on the 20th of December 2012.
  • The fifth release, MRST 2012a, published on the 3rd of October, 2012.
  • The fourth release, MRST 2011b, published on the 2nd of January 2012.
  • The third release, MRST 2011a, published on the 22nd of February 2011.
  • The second release, MRST 2010a, published on the 12th of March 2010.
  • The first release, designated MRST 1.1, published in April of 2009.


If you have questions, feedback, or suggestions, please contact

Register for updates

As noted in the terms of usage, we ask that you register your country/affiliation to let us better evaluate the usage of MRST. If you provide an e-mail address we will notify you when a new major version of MRST, or a critical bugfix for the current version is released. We will not share your e-mail address with any third party, and we will only use it for updates to MRST.

Name (optional):
Email (optional):
I would like to receive emails about major updates to MRST

Published March 28, 2009