Skip to content

Package docstring ​

JutulDarcy Module

Paper Zenodo Dev Dev Build Status Downloads Downloads

Jutul Darcy logo

Visit the docs at https://sintefmath.github.io/JutulDarcy.jl/stable/

Reservoir simulation in Julia

JutulDarcy.jl is a toolkit for building, running and interacting with reservoir simulation models written in Julia. The software covers Darcy-scale subsurface flow with wells (CO2 sequestration, geothermal reservoirs, gas/H2 storage, oil/gas fields) using the Jutul.jl framework for differentiable programming developed by the Applied Computational Science group at SINTEF Digital.

Key features

JutulDarcy is a general purpose porous media simulator toolkit with high performance written in Julia. It is fully differentiable with respect to forces and discretization parameters. The package contains utilities for building, plotting, running and analysing models. Extensive validation examples provide comparison to other solvers.

Physical systems

  • Single-phase flow

  • Immiscible multi-phase flow

  • Black-oil type models with support for both dissolved vapor (Rs) and vaporized liquid (Rv)

  • Equation-of-state compositional flow with up to three phases and any number of components (Peng-Robinson, Søreide-Whitson, Soave-Redlich Kwong, ...)

  • Specialized CO2-brine model for CO2 storage

  • Thermal effects

  • Tracers and polymer EOR

  • Geothermal systems (see also Fimbul.jl for extended geothermal capabilities)

All solvers can incorporate general multisegment wells with rigorous mass balance, friction pressure loss, complex well limits and time-dependent controls.

Architecture

  • Written in pure Julia, with automatic differentiation and dynamic sparsity detection

  • Support for sensitivities with respect to any model parameters using the adjoint method

  • Support for GPU execution via KernelAbstractions - run in parallel on both NVIDIA and AMD cards.

  • High performance assembly and linear solvers, with support for two-stage CPR BILU(0)-CPR Krylov solvers

  • MPI support with domain decomposition and BoomerAMG-CPR solver with automatic METIS partitioning

  • Support for consistent discretizations (AvgMPFA / NTPFA)

Input/output and workflow tools

  • Support for reading in and running .DATA and .AFI files with corner point grids, with support for non-conformal faults and inactive cells.

  • Unstructured grids and complex cases input from the Matlab Reservoir Simulation Toolbox (MRST) using the jutul module

  • 3D visualization of grids and wells by loading a Makie.jl backend (requires Julia 1.10, GLMakie for interactivity)

  • Interactive plotting of well curves, field responses and other quantities of interest.

  • Automatically coarsen models to reduce runtime.

Example run times on benchmarks

Small benchmarks

NameCellsReport stepsPreconditionerTime [s]
SPE1CASE2300120block-ILU(0)0.30
SPE9900035block-ILU(0)3.41
Egg18553123CPR-block-ILU(0)8.60
Norne44417247CPR-block-ILU(0)228.8

Numbers are given for serial CPU solves with hypre as the pressure solver in CPR.

Parallel/GPU benchmarks

JutulDarcy supports parallelism by leveraging threads, MPI and GPU (CUDA/AMD). The solvers are fully resident on GPU, allowing for much faster solves for larger models. A few examples on consumer grade hardware (Ryzen 9 7950X with 15 threads, and a RTX4080 GPU):

NameCellsTypeCPU Time [s]GPU Time [s]
SPE10 model 21,082,4652-phase immiscible179.011.8
OLYMPUS realization 1192,7502-phase immiscible75.832.5
UHS Benchmark study44,6528-component EoS170.456.3

Paper and citing

The main paper describing JutulDarcy.jl is JutulDarcy.jl - a Fully Differentiable High-Performance Reservoir Simulator Based on Automatic Differentiation, available as open access from Springer:

bibtex
@article{jutuldarcy,
  title={JutulDarcy.jl - a fully differentiable high-performance reservoir simulator based on automatic differentiation},
  author={M{\o}yner, Olav},
  journal={Computational Geosciences},
  volume={29},
  number={30},
  year={2025},
  publisher={Springer}
}

DOI link to open access paper. If you use JutulDarcy in your work, please cite this paper.

List of papers that make use of JutulDarcy.jl (add your own!)

Getting started

Julia

Install Julia and add the package to your environment of choice:

julia
using Pkg
Pkg.add("GLMakie")
Pkg.add("Jutul")
Pkg.add("JutulDarcy")

You can then run any of the examples in the examples directory by including them.

For a minimal example that runs an industry standard input file and produces interactive plots:

julia
using JutulDarcy, GLMakie
spe9_dir = JutulDarcy.GeoEnergyIO.test_input_file_path("SPE9")
file_path = joinpath(spe9_dir, "SPE9.DATA")
case = setup_case_from_data_file(file_path)
result = simulate_reservoir(case)
plot_reservoir_simulation_result(case.model, result)

Note that interactive plotting requires GLMakie, which may not work if you are running Julia over SSH.

Python

There is also a Python interface. You can install JutulDarcy using pip:

bash
pip install jutuldarcy

See the PyJutulDarcy documentation for setup, examples, and the Python API reference.

Compiled executable

It is also possible to build an executable. See the JutulDarcyApps.jl repository for more information.

Additional examples and further reading

The documentation is the main source of information, including published versions of the examples. In addition, see the examples folder for more information. Some functionality is also demonstrated in the tests.

Internals and undocumented functions are subject to change at this time. However, the main interface for the reservoir simulator itself is stable and follows semantic versioning for breakage.

source