unicellar 0.1.0. Single-cell reservoir modeling toolbox

Python library to quickly set up and run single-cell reservoir models of CO2/H2 storages and petroleum fields

Single-cell reservoir model (SCRM) = material balance equation (MBE) + analytical aquifer
SCRM is solved for pressure at each time step to forecast pressure dynamics for known fluid production/injection scenarios.
Alternatively, MBE can be solved for ultimate storage capacity (USC) to estimate the maximal fluid volume that can be stored in the reservoir at a given pressure and cumulative production/injection.

Use cases:

1. to history-match the reservoir pressure dynamics by tuning reservoir and aquifer parameters
2. to quickly estimate the Ultimate Storage Capacity (USC) of the reservoir for different reservoir parameters and storage scenarios.
3. to forecast reservoir pressure dynamics for a production/injection scenario
4. to quickly set up a fast proxy model to support a full-field model's design and history matching

This PDF in /docs describes an application to CO2 storage planning in a depleted petroleum reservoir [3].

OK. What else can it do?

It also features the following functions:

• to plot results in nice & neat Plotly charts
• to read Eclipse results from RSM files
• to read Eclipse (E100) PVT keywords (PVTO, PVCO, PVTG, PVDG) to set up fluid properties
• to fetch various PVT properties from the NIST database [1]
• to estimate the work required to compress a fluid from one pressure to another
• to estimate bottomhole pressure (BHP) from tubing head pressure (THP) and vice versa through the column weight

How to install

requirements

Unicellar is built on numpy, scipy, pandas, matplotlib, and plotly (listed in requirements.txt). There are no exotic/esoteric dependencies, and you are almost certain to meet all the requirements. Nevertheless, if you use conda/mamba package manager (if you use pip, go to the next section), you may install the requirements in your current environment:

conda install pandas scipy numpy matplotlib plotly -c conda-forge

... or create a separate environment by:

conda create -n uTest pandas scipy numpy matplotlib plotly -c conda-forge

(you may replace "uTest" with your environment name).

installation

1. Download or clone the library.
2. In a terminal: navigate to the root folder containing setup.py by cd
3. run pip install .

using without installation

Alternatively, you may just download or clone the library and call it from Python scripts or Jupyter notebooks as follows   (provided that your environment features the required packages):

import sys
sys.path.append("path to the "unicellar" folder with  __init__.py")
import unicellar

What to start with?

Check out \examples (arranged by complexity):

• radial_aquifer.py
• gas_storage.py
• single-cells.py
• oil+gas_cap+aquifer.py
• lbr1.py

On the model:

A black oil formulation used for PVT props. is largely compatible with black oil reservoir simulators (like Eclipse, OPM, tNavigator etc.). The following components are currently available:

• oil (with dissolved gas)
• free gas that can dissolve in oil
• water
• CO2: an inert storage fluid that does not dissolve in other fluids. It can be CO2, H2, CH4 etc.

On the name choice:

UNICELLAR = unicellular (an organism that consists of a single cell) + cellar (an underground storage room)

Acknowledgements

This code has been developed in the REPP-CO2, STRATEGY CCUS, and CO2-SPICER projects. The REPP-CO2 project was supported by Norway Grants from the CZ-08 Carbon Capture and Storage programme (Norway Grants 2009-2014). The STRATEGY CCUS project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 837754. The CO2-SPICER project benefits from a € 2.32 mil. grant from Norway and Technology Agency of the Czech Republic.

References

1. Eric W. Lemmon, Ian H. Bell, Marcia L. Huber, and Mark O. McLinden, "Thermophysical Properties of Fluid Systems" in NIST Chemistry WebBook, NIST Standard Reference Database Number 69, Eds. P.J. Linstrom and W.G. Mallard, National Institute of Standards and Technology, Gaithersburg MD, 20899, https://doi.org/10.18434/T4D303, (retrieved November 29, 2022).

2. Hladik V. et al., "LBr-1 – Research CO2 Storage Pilot in the Czech Republic", 13th International Conference on Greenhouse Gas Control Technologies, GHGT-13, 14-18 November 2016, Lausanne, Switzerland, https://doi.org/10.1016/j.egypro.2017.03.1712

3. Khrulenko, A., Berenblyum, R., "Single-cell reservoir model for CO2 storage planning", Conference poster, TCCS-12 (12th Trondheim Conference on CO2 Capture, Transport and Storage), 19-21 June 2023, Trondheim, Norway, poster URL