This is the official GitHub mirror of the Matlab Reservoir Simulation Toolbox (MRST), an open source toolbox for simulation of flow, mechanics and transport in porous media developed at group for Computational Geosciences at SINTEF Digital. We only recommend getting MRST from the repositories for users who are interested in following the development actively and tolerate the occasional bug or broken feature. For most users, the MRST releases released twice each year are a better option, which comes pre-packaged and tested.
For more details on MRST, please see our website at www.mrst.no and the MRST repositories on Bitbucket.
Clone this repository:
git clone https://github.com/SINTEF-COMG/MRST.git
Once the repository has been cloned, navigate MATLAB or GNU Octave to the checked out repository
cd MRST;
run startup.m
This should initialize MRST and produce a welcome message:
Welcome to the MATLAB Reservoir Simulation Toolbox (MRST)!
You are using the release version 2022b. To download other versions of MRST
and view examples and relevant publications, please visit www.mrst.no
Useful commands for getting started:
- List all introductory examples: mrstExamples()
- List all modules: mrstPath('list')
- Load modules using GUI: mrstModule('gui')
- Explore all available data sets: mrstDatasetGUI()
- List examples of a module: mrstExamples('ad-blackoil')
- Explore modules and publications: mrstExploreModules()
- Show all examples in all modules: mrstExamples('all')
- Show settings for MRST: mrstSettings()
- Display this message: mrstStartupMessage()
For assistance and discussions about MRST, please visit our mailing list at
www.sintef.no/projectweb/mrst/forum/ (sintef-mrst@googlegroups.com)
For some common queries, see our FAQ: www.sintef.no/projectweb/mrst/faq/
You can verify your installation by running a basic tutorial that produces a plot:
flowSolverTutorial1
Note that MRST takes care not to modify files outside the checked out directory. For this reason, you will have to re-run the startup.m
function if you restart MATLAB/Octave.
To learn more about MRST, we suggest that you check out the documentation that includes two free open-access books.
MRST is currently organized into several repositories. These are added to this repository using git subtree
for your convenience together with a startup.m
script that can be run with MATLAB and GNU Octave to load these files into your path. This is primarily intended as a mirror for getting access to the development version through a single git clone. If you would rather work directly with individual repositories, please follow the instructions at the MRST core wiki at Bitbucket.
Name | Description | URL |
---|---|---|
core | Core functionality for MRST | https://bitbucket.org/mrst/mrst-core |
autodiff | Solvers based on automatic differentiation: Black-oil, compressible flow, compositional and the AD framework | https://bitbucket.org/mrst/mrst-autodiff |
solvers | Different solvers without automatic differentiation: Consistent discretizations, fractured media and geomechanics. | https://bitbucket.org/mrst/mrst-solvers |
co2lab | Numerical CO2 laboratory: Solvers and utilities for large-scale CO2 injection. | https://bitbucket.org/mrst/mrst-co2lab |
model-io | Different utilities and modules for input and output to MRST. | https://bitbucket.org/mrst/mrst-model-io |
multiscale | Solvers and routines for scale transitions, including multiscale and upscaling implementations. | https://bitbucket.org/mrst/mrst-multiscale |
visualization | Modules with a focus on visualization and graphical user interfaces. | https://bitbucket.org/mrst/mrst-visualization |
thirdparty-modules | Third-party modules for MRST. This repository contains a set of git submodules which link to other git repositories with useful modules. | https://bitbucket.org/mrst/mrst-thirdparty-modules |
The remaining modules are individual repositories and can be found in the add_remotes.sh
file.
Normally you can pull this repository to get updates to MRST. There is some delay between pushes to the individual module repositories and this repository as it is a manual process.
If you want to update manually, or if you have a local fork of this repository and you want to update the files, you should first do the following:
./add_remotes.sh
This needs only to be done once for a given clone of MRST. Once the remotes are set up and the files are executable you can update the subtrees :
./update_subtrees.sh
Note that updating the subtrees create merge commits. If you want to go back in sync with the repository (e.g. to do a git pull) you can run the following.
This will delete any local changes you have and reset it like a fresh clone had been performed.
git fetch origin
git reset --hard origin/master