---
id: oil-reservoir-synthesizer
version: "0.2.0"
license: GPL-3.0
license_treatment: copyleft
maintenance: active
---

# oil-reservoir-synthesizer — A generator for synthetic oil reservoir values

License: copyleft · Maintenance: active · Downloads: 83.5K/mo

## What it is and what it does

Oil Reservoir Synthesizer generates synthetic data mimicking real oil reservoir simulators like opm-flow. It uses Perlin noise to create pseudo-random but spatially coherent values for wells and blocks over time steps, producing outputs with names matching industry-standard simulators (e.g., fopr for oil production rate). The package exposes a single OilSimulator class that acts as a builder and generator: you configure wells and blocks with seed values, then step through time to retrieve simulated values.

The package depends only on numpy and installs as a pure Python wheel. It was originally part of larger projects (ERT and libres) and is maintained by Equinor. Despite active repository status, the project carries an early-stage development classification and has not released since late 2023, so stability and feature completeness should be verified before relying on it in production workflows.

Use it for:

- Generate training data for machine learning models that predict oil reservoir behavior without needing actual simulator runs
- Create test datasets for oil industry software that expects opm-flow-compatible output formats
- Prototype and validate reservoir simulation workflows before committing to expensive full simulations
- Populate synthetic well and block scenarios for algorithm development in petroleum engineering
- Benchmark performance of data processing pipelines that consume oil simulator outputs

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates synthetic oil reservoir simulator data using Perlin noise, producing pseudo-random values with names matching real oil simulator outputs like fopr (oil production rate).

Yes, if you need synthetic oil reservoir data for testing, training, or prototyping. Install friction is minimal and the dependency footprint is small. However, verify that the early-stage development status and 980-day release gap are acceptable for your use case—this is not a mature, actively-released library. The copyleft GPL-3.0 license requires any derivative distribution to remain open-source.

## Install

pip install oil-reservoir-synthesizer
uv add oil-reservoir-synthesizer
poetry add oil-reservoir-synthesizer

## Installing oil-reservoir-synthesizer

Before you install: Low install friction with a single runtime dependency (numpy). Active maintenance as of 2026-08-05, though the project is marked as early-stage (Development Status :: 1 - Planning) and last released over 980 days ago.

License in practice: Licensed under GPL-3.0 (copyleft). Any derivative work or bundled distribution must also be open-source under compatible terms; proprietary use is not permitted.

Quickstart:

pip install oil-reservoir-synthesizer

from oil_reservoir_synthesizer import OilSimulator

simulator = OilSimulator()
simulator.addWell("wellName", seed=997)
simulator.addBlock("5,5,5", seed=31)
simulator.step(scale=0.1)
print(simulator.fopr())

Verify before relying:

- Whether the package is suitable for production use given its 'Planning' development status classification
- What specific oil simulator outputs (beyond fopr) are supported by the current version
- Performance characteristics and scalability limits for large reservoir models

## Package facts

- License: GPL-3.0 (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 83.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

synthetic oil reservoir data generation, perlin noise simulator, oil production rate generator, reservoir model synthesis, opm-flow compatible data, well and block simulation, pseudo-random reservoir values, simulation, synthetic-data, petroleum

[View on SkillFed](https://skillfed.io/packages/oil-reservoir-synthesizer) · [View on PyPI](https://pypi.org/project/oil-reservoir-synthesizer/)