Karl-JT / HistoryMatching

Tutorial on history matching with ensembles

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

History matching tutorial

Run in the cloud (no installation required)

  • on Colab (requires Google login):
    Open In Colab
  • on a NORCE server (only available at specific times, to specific users):
    JupyterHub

OR: install

Use this option for development, or if you simply want faster computations (your typical laptop is 10x faster than Google's free offering).

Prerequisite: Python>=3.9

If you're an expert, setup a python environment however you like. Otherwise: Install Anaconda, then open the Anaconda terminal and run the following commands:

conda create --yes --name my-env python=3.9
conda activate my-env
python --version

Ensure the printed version is 3.9 or more.
Keep using the same terminal for the commands below.

Install

  • Download and unzip (or git clone) this repository (see the green button up top)
  • Move the resulting folder wherever you like
  • cd into the folder
  • Install requirements:
    pip install -r path/to/requirements.txt

Launch

  • Launch the "notebook server" by executing:
    jupyter-notebook
    This will open up a page in your web browser that is a file navigator.
  • Click on HistoryMatch.ipynb.

Developer guide

For development, you probably want to install requirements-dev.txt.

Personally I prefer to develop mostly in the format of standard python script. Then, thanks to the jupytext extension, I can convert this (.py) to a notebook (.ipynb) simply by opening the file in Jupyter, and ensuring that the file > Jupytext menu has check marks on both "Pair with ipynb" and "Pair with light script".

If you use vim I suggest folding (rather than wrapping) the comment blocks (corresponding to markdown cells) using

:setlocal foldmethod=expr foldexpr=getline(v:lnum)=~'^\#\ ' fdl=0

Contributors

This work has been developed by Patrick N. Raanes, researcher at NORCE. The project has been funded by DIGIRES, a project sponsored by industry partners and the PETROMAKS2 programme of the Research Council of Norway.

About

Tutorial on history matching with ensembles

License:MIT License


Languages

Language:Jupyter Notebook 52.8%Language:Python 46.7%Language:Shell 0.5%