ert

library22.0.3pypypi✓ verified 88d ago

ERT (Ensemble based Reservoir Tool) is an open-source tool for ensemble-based reservoir management, including history matching, uncertainty quantification, and optimization. Current version is 21.1.1, with monthly releases following a versioning scheme based on calendar year and patch number.

data devops workflow

pip install ert

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ERT

ert

datapythonv22.0.3

Install

48.9s avg

Import

11370ms

Disk

1618MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v11.1.11 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 48.9s · import 6.822s · 1433.6MB

1618MB installed

● package 1618MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ErtAnalysisError

✓ from ert.analysis import ErtAnalysisError

Commonly imported from old paths or submodules.

ert

✓ import ert

✗ import libres or import res

The old 'res' or 'libres' package was merged into ERT. Use the top-level 'ert' package.

ErtScript

✓ from ert.script import ErtScript

ErtScript base class for workflows.

ert_config

✓ from ert.config import ErtConfig

Configuration parser.

Load an ERT configuration and demonstrate basic imports.

from ert import ErtConfig from ert.analysis import ErtAnalysisError # Load configuration from a file config = ErtConfig.from_file("config.ert") print(config) # Minimal example to run an ensemble experiment # (requires a valid ERT configuration file with forward model) # For more details see https://ert.readthedocs.io/en/latest/

ert --version

Debug

Known issues

breakingThe 'res' and 'libres' packages have been removed. All imports must use the 'ert' package instead.

fix

Replace 'from res import *' with 'from ert import *' and update all import paths to use the new structure.

affects: >=21.0.0

breakingPython 3.11 or later is required. Python 3.10 and earlier are not supported.

fix

Upgrade to Python 3.11 or newer.

affects: >=21.0.0

deprecatedThe synthetic_forward_model keyword is deprecated. Use FORWARD_MODEL with a shell command instead.

fix

Replace 'SYNTHETIC_FORWARD_MODEL' with 'FORWARD_MODEL <shell_command>' in your configuration.

affects: >=21.0.0

gotchaConfiguration parsing may fail silently if the config file contains unknown keywords. Always validate with 'ert configdump'.

fix

Run 'ert configdump -v <config.ert>' to check for errors.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'ErtAnalysisError' from 'ert'

The symbol is not exposed at the top-level package; it's in a submodule.

fix

Use 'from ert.analysis import ErtAnalysisError' instead.

ModuleNotFoundError: No module named 'res'

The old 'res' package was removed in ERT 21.0.0.

fix

Replace 'import res' with 'import ert' and update all dependent imports.

TypeError: __init__() got an unexpected keyword argument 'ens_path'

The API changed between versions; 'ens_path' is no longer accepted in the constructor.

fix

Check the ERT API documentation for the correct arguments or use the new configuration-loading approach.

ert configdump: error: unrecognized arguments: --help

The CLI interface changed; use 'ert --help' for top-level help.

fix

Run 'ert --help' or 'ert configdump --help' for subcommand help.

Upgrade

Version history

22.0.3latest on PyPI · released Jun 4, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

32 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/equinor/ert ↗

packagehttps://pypi.org/project/ert/ ↗

homepagehttps://ert.readthedocs.io ↗