Skip to content

The code to reproduce the results of the paper "Ensemble history-matching workflow using interpretable SPADE-GAN geomodel" by K Fossum, S Alyaev, and AH Elsheikh, published in FirstBreak 2024

License

geosteering-no/spade-gan-inversion

Repository files navigation

Ensemble history-matching with SPADE-GAN geomodel

This is the code to reproduce the results of the paper Ensemble history-matching workflow using interpretable SPADE-GAN geomodel by Kristian Fossum, Sergey Alyaev, and Ahmed H. Elsheikh, published in First Break 2024.

Cite as:

Kristian Fossum, Alyaev, Sergey, and Ahmed H. Elsheikh. "Ensemble history-matching workflow using interpretable SPADE-GAN geomodel." First Break, Vol. 42, Issue 2, Feb. 2024: 57 - 63 https://doi.org/10.3997/1365-2397.fb2024014.

Latex

@article{fossum2024ensemble,
  title={Ensemble history-matching workflow using interpretable SPADE-GAN geomodel},
  author={Fossum, Kristian and Alyaev, Sergey and Elsheikh, Ahmed H},
  journal={First Break},
  volume={42},
  number={2},
  pages={57--63},
  year={2024},
  publisher={European Association of Geoscientists \& Engineers},
  doi={https://doi.org/10.3997/1365-2397.fb2024014}
}

Preview of results

The figure below shows data assimilation results for Soft data - case 2 with the hard-data-constrained prior as the starting point.

Data assimilation results for Soft data - case 2

Note that the paper uses more complex plotting based on ResInsight. We do not include it in the repository due to setup complexity.

Installation

Prerequisites

  • Ubuntu 20.04
  • Python 3.8+ (tested on 3.8.10)

Pre-configured scripts

The bash script files to install individual components are located in the Dependences folder. Alternatively, follow instructions from the library providers below.

Manual installation

1. OPM-flow

The OPM-flow simulator can be installed by following the instructions at https://opm-project.org/?page_id=245

2. Python-Ensemble-Toolbox (PET)

The PET package can be installed by following the instructions at https://github.com/Python-Ensemble-Toolbox/PET/tree/main

We recommend creating a virtual environment where all needed packages will be installed.

3. Generation of Nonstationary geological fields using GANs

The GANs package is cloned from the repository https://github.com/ai4netzero/NonstationaryGANs

Note that you need to pip install torchin the Python environment used to run the tests.

GAN.mako files in sub-directories assume that the NonstationaryGANs repository is cloned in the same directory as spade-gan-inversion

4. MPSlib

MPSlib package for generating new synthetic true fields can be installed it by following the instructions at https://github.com/ergosimulation/mpslib

The pip package is available:

pip install scikit-mps

The MPSlib-produced files to reproduce the publication are included in this repository.

Running examples from the First Break paper

The paper and this repository include three numerical examples. The SoftData examples rely on the results of the HardData example results. Run HardData first.

To run examples go to a relevant folder and follow the instructions. The example folders are

  1. HardData
  2. SoftData1
  3. SoftData2

About

The code to reproduce the results of the paper "Ensemble history-matching workflow using interpretable SPADE-GAN geomodel" by K Fossum, S Alyaev, and AH Elsheikh, published in FirstBreak 2024

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published