Geothermal example with group controls
Geothermal Wells Introductionwhile 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).
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.
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)
endGroup 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.
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.
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.
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
endIndividual 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.
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.
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.
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.
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.