Skip to content

Geothermal example with group controls ​

Geothermal   Wells   Introduction  

while four producers supply hot water. Group targets share a surface rate that they collectively aim to achieve, with individual wells subject to their own limits (e.g. on bottom-hole-pressure).

julia
using Jutul, JutulDarcy, GLMakie
bar, day, year, darcy = si_units(:bar, :day, :year, :darcy)
(100000.0, 86400.0, 3.1556952e7, 9.86923266716013e-13)

Reservoir and wells ​

A smooth permeability variation gives the wells a bit different rates as the pressure limit and consequently different allocations of the group rate.

julia
mesh = CartesianMesh((15, 11, 2), (1200.0, 800.0, 60.0))
geometry = tpfv_geometry(mesh)
permeability = zeros(number_of_cells(mesh))
for cell in 1:number_of_cells(mesh)
    x = geometry.cell_centroids[1, cell]
    y = geometry.cell_centroids[2, cell]
    permeability[cell] = 0.25darcy*exp(0.6*sin(2pi*x/1200)*cos(2pi*y/800))
end
domain = reservoir_domain(mesh; permeability, porosity = 0.18)

injectors = [:I1, :I2, :I3]
producers = [:P1, :P2, :P3, :P4]
injector_rows = [3, 6, 9]
producer_rows = [2, 5, 8, 10]
wells = []
for i in eachindex(injectors)
    well = setup_vertical_well(domain, 3, injector_rows[i];
        name = injectors[i], simple_well = true)
    push!(wells, well)
end
for i in eachindex(producers)
    well = setup_vertical_well(domain, 13, producer_rows[i];
        name = producers[i], simple_well = true)
    push!(wells, well)
end

Group allocation ​

Group allocation uses potential weights by default where each well receives a share based on its maximal potential for injection or production at the corresponding BHP limit. Set a group to false for equal weights. Every well in a group receives the same target for the entire group.

julia
model = setup_reservoir_model(domain, :geothermal;
    wells,
    well_groups = Dict(:Injection => injectors, :Production => producers),
    group_use_potentials = Dict(:Injection => false)
)
MultiModel with 9 models and 56 cross-terms. 716 equations, 716 degrees of freedom and 4819 parameters.

  models:
    1) Reservoir (660x660)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ MinimalTPFATopology (330 cells, 773 faces)
    2) I1 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [I1] (1 nodes, 0 segments, 2 perforations)
    3) I2 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [I2] (1 nodes, 0 segments, 2 perforations)
    4) I3 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [I3] (1 nodes, 0 segments, 2 perforations)
    5) P1 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [P1] (1 nodes, 0 segments, 2 perforations)
    6) P2 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [P2] (1 nodes, 0 segments, 2 perforations)
    7) P3 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [P3] (1 nodes, 0 segments, 2 perforations)
    8) P4 (2x2)
       SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,))
       ∈ SimpleWell [P4] (1 nodes, 0 segments, 2 perforations)
    9) Facility (42x42)
       JutulDarcy.FacilitySystem{SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}}(SinglePhaseSystem{AqueousPhase, Tuple{Float64}, 1}(AqueousPhase(), (998.20715,)))
       ∈ WellGroup([:I1, :I2, :I3, :P1, :P2, :P3, :P4], true, true, Dict(:I3 => :Injection, :P1 => :Production, :P3 => :Production, :I2 => :Injection, :P4 => :Production, :P2 => :Production, :I1 => :Injection), Dict(:Production => [:P1, :P2, :P3, :P4], :Injection => [:I1, :I2, :I3]), Dict(:Production => [4, 5, 6, 7], :Injection => [1, 2, 3]), Dict{Symbol, Bool}(:Production => 1, :Injection => 0))

  cross_terms:
    1) I1 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    2) I1 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    3) I2 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    4) I2 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    5) I3 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    6) I3 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    7) P1 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    8) P1 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    9) P2 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    10) P2 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    11) P3 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    12) P3 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    13) P4 <-> Reservoir (Eqs: mass_conservation <-> mass_conservation)
       JutulDarcy.ReservoirFromWellFlowCT
    14) P4 <-> Reservoir (Eqs: energy_conservation <-> energy_conservation)
       JutulDarcy.ReservoirFromWellThermalCT
    15) Facility  -> I3 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    16) I3  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    17) I3  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    18) Facility  -> I3 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    19) I3  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    20) I3  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT
    21) Facility  -> P1 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    22) P1  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    23) P1  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    24) Facility  -> P1 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    25) P1  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    26) P1  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT
    27) Facility  -> I2 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    28) I2  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    29) I2  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    30) Facility  -> I2 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    31) I2  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    32) I2  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT
    33) Facility  -> P3 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    34) P3  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    35) P3  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    36) Facility  -> P3 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    37) P3  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    38) P3  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT
    39) Facility  -> P4 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    40) P4  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    41) P4  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    42) Facility  -> P4 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    43) P4  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    44) P4  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT
    45) Facility  -> I1 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    46) I1  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    47) I1  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    48) Facility  -> I1 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    49) I1  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    50) I1  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT
    51) Facility  -> P2 (Eq: mass_conservation)
       JutulDarcy.WellFromFacilityFlowCT
    52) P2  -> Facility (Eq: bottom_hole_pressure_equation)
       JutulDarcy.FacilityFromWellBottomHolePressureCT
    53) P2  -> Facility (Eq: surface_component_rates_equation)
       JutulDarcy.FacilityFromWellSurfaceComponentRatesCT
    54) Facility  -> P2 (Eq: energy_conservation)
       JutulDarcy.WellFromFacilityThermalCT
    55) P2  -> Facility (Eq: temperature_equation)
       JutulDarcy.FacilityFromWellTemperatureCT
    56) P2  -> Facility (Eq: enthalpy_equation)
       JutulDarcy.FacilityFromWellEnthalpyCT

Model storage will be optimized for compilation performance.

Initialize hydrostatic pressure from 120 bar at the reservoir's mid-depth. One equilibrium region covers the reservoir, initially at 140 degrees Celsius.

julia
equilibrium = EquilibriumRegion(model, 120bar, 30.0;
    temperature = convert_to_si(140.0, :Celsius))
state0 = setup_reservoir_state(model, equilibrium)

# Inspect permeability and well locations
plot_reservoir(model; key = :permeability, fancy = false)

Set up well constraints ​

Both groups request 1200 surface cubic metres per day of water. Injection is positive and production is negative. We set the same group rate for all wells in a group.

julia
rate = 1200.0/day
injection = InjectorControl(GroupSurfaceWaterRateTarget(rate), [1.0];
    density = 1000.0, temperature = convert_to_si(40.0, :Celsius))
production = ProducerControl(GroupSurfaceWaterRateTarget(-rate))
control = Dict{Symbol, Any}()
for well in injectors
    control[well] = injection
end
for well in producers
    control[well] = production
end

Individual limits ​

Pressure limits protect all wells. I1 and P1 also have tighter rate limits; their unused shares are redistributed among the other group members when they are operating on the limits.

julia
limits = Dict{Symbol, Any}()
for well in injectors
    limits[well] = (bhp = 170bar,)
end
for well in producers
    limits[well] = (bhp = 70bar,)
end
limits[:I1] = (bhp = 170bar, wrat = 250.0/day)
limits[:P1] = (bhp = 70bar, wrat = -180.0/day)
forces = setup_reservoir_forces(model; control, limits)
Dict{Symbol, Any} with 9 entries:
  :I3        => (mask = nothing,)
  :P1        => (mask = nothing,)
  :I2        => (mask = nothing,)
  :P3        => (mask = nothing,)
  :P4        => (mask = nothing,)
  :Reservoir => (bc = nothing, sources = nothing)
  :I1        => (mask = nothing,)
  :P2        => (mask = nothing,)
  :Facility  => (control = Dict{Symbol, Any}(:I3=>InjectorControl{GroupSurfaceW…

Simulate and inspect ​

Run ten years, with shorter initial steps to establish the well controls.

julia
dt = [5day, 10day, 15day]
for step in 1:40
    push!(dt, (10year - 30day)/40)
end
dt = fill(31day, 12*10)
result = simulate_reservoir(state0, model, dt; forces = forces, output_substates = true)
ReservoirSimResult with 124 entries:

  wells (7 present):
    :I3
    :P1
    :I2
    :P3
    :P4
    :I1
    :P2
    Results per well:
       :wrat => Vector{Float64} of size (124,)
       :factor => Vector{Float64} of size (124,)
       :Aqueous_mass_rate => Vector{Float64} of size (124,)
       :temperature => Vector{Float64} of size (124,)
       :bhp => Vector{Float64} of size (124,)
       :mrat => Vector{Float64} of size (124,)
       :lrat => Vector{Float64} of size (124,)
       :mass_rate => Vector{Float64} of size (124,)
       :rate => Vector{Float64} of size (124,)
       :control => Vector{Symbol} of size (124,)
       :wcut => Vector{Float64} of size (124,)

  states (Vector with 124 entries, reservoir variables for each state)
    :Pressure => Vector{Float64} of size (330,)
    :TotalMasses => Matrix{Float64} of size (1, 330)
    :TotalThermalEnergy => Vector{Float64} of size (330,)
    :FluidEnthalpy => Matrix{Float64} of size (1, 330)
    :Temperature => Vector{Float64} of size (330,)
    :PhaseMassDensities => Matrix{Float64} of size (1, 330)
    :RockInternalEnergy => Vector{Float64} of size (330,)
    :FluidInternalEnergy => Matrix{Float64} of size (1, 330)

  time (report time for each state)
     Vector{Float64} of length 124

  result (extended states, reports)
     SimResult with 120 entries

  extra
     Dict{Any, Any} with keys :simulator, :config

  Completed at Nov. 17 2026 12:57 after 20 seconds, 279 milliseconds, 525.9 microseconds.

Show the final temperature distribution and the individual well histories.

julia
plot_reservoir(model, result.states; key = :Temperature, step = length(result.states), fancy = false)
# Plot group summaries

Group totals stay at their targets while the remaining wells have capacity. Production eventually falls below its target as producers reach the BHP limit. Compare these curves with individual rates and BHPs in the well plot. Group rates and cumulative volumes are included in the simulation summary.

julia
plot_summary(result; plots = [
    "Injection:GWIR", "Production:GWPR",
    "Injection:GWIT", "Production:GWPT",
], cols = 2)
# Plot the individual producers to see the limits
plot_summary(result; plots = [
    "P1:WWPT", "P1:WBHP",
    "P2:WWPT", "P2:WBHP",
    "P3:WWPT", "P3:WBHP"
], cols = 3)

Download this example ​

Download the Julia script or the Jupyter notebook.

This example took 64.987787553 seconds to complete.

This page was generated using Literate.jl.