Release Notes for MRST 2024a

Highlights of MRST 2024a

The new release comes with some improvements in functionality and minor bug fixes. In particular we would like to highlight the following: 

  • A major revision of co2lab. The module has been split into multiple submodules. Function interfaces have been simplified. Older code has been updated to bring it into sync with newer developments in MRST. See full release notes for more details.
  • A new module contributed by Lluís Saló from MIT. Contains many useful utilities for simulation of CO2 storage, including a diffusion definition for black-oil models, many different functions for CO2 properties from the literature and examples demonstrating the effect of the relative permeability hysteresis.

Changes to core

  • Improved behavior for settings.mat file that should alleviate issues seen by some users when upgrading MRST and/or setting paths.
  • Support for AD variables outer product

New modules


  • Diffusion definition for black-oil model.
  • Different functions for CO2 properties taken from literature.
  • Examples demonstrating the effect of the relative permeability hysteresis.

Changes to existing modules


  • Robustness in upscaleModelTPFA when model has fluid regions
  • Pre-computed transmissibilities can be passed to setMPFADiscretizations
  • Support for AD variables in gravity term for standard fluxes
  • Improved support for AD in boundary conditions
  • Corrected definition of cumulative sum for plotWellSols. Most significant for very long report steps.
  • controlLogicFn in simulateScheduleAD can now modify the state of the system.
  • Deprecated function addModelSensitivites has been removed.


  • Support for relative permeability hysteresis via the co2lab-mit module
  • Fix to interpPVT for empty inputs


  • Improved support for initialisation of states with volume shifts.


  • Improved support for keywords and fixes to well parsing.


  • Support for multiple fluid regions.


  • Fix bug in output format leading to error message when gravity is disabled for 2D grids.
  • Support for simulating DATA files directly in Jutul (SimulateDataFileJutul) and reading output back to MRST so that the parsing and processing is done in the Julia session. This can be a lot faster than MRST's parser and has extended support for compositional keywords.


  • The module has been subdivided into multiple modules:
    • co2lab-common: common functionality needed by the other modules
    • co2lab-spillpoint: functionality related to spill-point analysis
    • co2lab-ve: functionality related to vertical equilibrium simulations based on the fully implicit formulation and the MRST automatic differentiation framework.
    • co2lab-legacy: older vertical equilibrium simulation code, based on sequential splitting and assuming incompressible fluids.
    • co2lab-demo: interactive demos
  • The model based on the fully implicit formulation has undergone major revisions in terms of robustness and ease of use. It has also been brought in sync with later developments in the rest of MRST (property functions, optimization module), and made fully differentiable.
  • The handling of dissolution in VE simulation has been made more robust.
  • The makeVEFluid function has been simplified.
  • Streamlined and reduced number of utility functions.
  • Updated and improved code documentation.
  • Several new examples in the co2lab-ve module.

Published April 25, 2024