expreccs#

A framework for dynamic regional-to-site boundary conditions in CO2 storage simulations.

expreccs creates integrated regional, reference, and site models and projects dynamic boundary conditions between nonconforming OPM Flow grids. It supports pressure-interference studies, comparison of boundary treatments, and reproducible regional-to-site modeling workflows.

Get started

Understand the two-stage regional-to-site workflow and project context.

Introduction
Install

Install expreccs, OPM Flow, and optional visualization tools.

Installation
Configure a study

Define integrated reference, regional, and site models in TOML.

Configuration reference
Explore examples

Run integrated studies and project boundaries between existing decks.

Examples

Quick installation#

Install the current development version:

pip install git+https://github.com/cssr-tools/expreccs.git

See Installation for virtual environments, OPM Flow, ResInsight, plopm, optional LaTeX support, and installation from source.

Quick start#

Run an integrated regional, reference, and site study:

expreccs -i examples/example1.toml -o hello_world

Project dynamic boundary conditions between existing regional and site models:

expreccs -i "tests/regional/REGIONAL tests/site/SITE" -o projected

Display the available command-line options:

expreccs --help

See Examples for complete workflows, Configuration reference for TOML settings, and Command-line reference for exact syntax, accepted values, defaults, and workflow compatibility.

What can expreccs do?#

Build integrated studies

Generate reference, regional, and site corner-point models with heterogeneous properties, faults, hysteresis, salinity, wells, and operational schedules.

Project dynamic boundaries

Map pressure, pressure increase, flux, and pore-volume effects from regional models to regular or irregular site boundaries.

Compare modeling strategies

Evaluate open, projected, two-point, per-FIPNUM, projected-pore-volume, and boundary-well approaches against a reference simulation.

Support reproducible research

Reproduce the 2025 hierarchical regional-to-site study using the configurations and scripts under examples/paper_2025.