Skip to content

Reservoir

reservoir components/reservoir/ · config type: reservoir

The reservoir sits between the injection well and the production well. It turns the injected flow into a pressure drop across the well pattern and returns the produced temperature, which falls over the years as the rock cools. One variant exists, lumped: a closed-form model with no internal iteration. The well pattern (doublet, five-spot) comes from layout.well_pattern. External reservoir simulators (CMG, MOOSE, Eclipse, OPM, tNAV) are planned as further variants of this type.

How the model works

Lumped-parameter reservoir component for tango.

LumpedReservoir models the subsurface as a single pressure-drop element using a doublet radial-flow impedance formula and tracks thermal depletion via a cumulative-energy model. See References below for both.

Pressure model (doublet impedance): Z = μ · [ln(L / (e · D)) + D / L] / (ρ · k · b_eff · π) ΔP = ṁ · Z

Temperature model (thermal depletion): E += ṁ · (h_out − h_in) · Δt (cumulative energy extracted) ψ = E / (V_rock · ρ_rock · Cp_rock · (T₀ − T_inj)) γ = depletion_curve(ψ, p1, p2, p3) (Adams 2015 fitting function) T_outlet = T_inj + γ · (T₀ − T_inj)

where T₀ = initial reservoir temperature, T_inj = current injection temperature.

References

Doublet impedance: Adams & Schädle (2020), genGEO; see docs/SOURCES.md#adams2020gengeo. Thermal depletion (cumulative-energy / γ(ψ) fitting function): Adams et al. (2015); see docs/SOURCES.md#adams2015.

Config keys

reservoir · lumped → LumpedReservoir

Key Type Default Meaning
component_idx int required undocumented
save_interval int \| None 1 undocumented
prev int required undocumented
next int required undocumented
reservoir_depth float required undocumented
thickness float required undocumented
permeability float required undocumented
porosity float required undocumented
hydro_static_pressure float required undocumented
over_pressure_percentage float required undocumented
brine_density float 1000.0 undocumented
gravity float 9.81 undocumented
well_eff_diameter float 0.41 undocumented
net_to_gross_ratio float 1.0 undocumented

Filled in automatically, not set in this block: common from the common: block, well_spacing from layout.well_spacing, well_pattern from layout.well_pattern.

Outputs per timestep

Columns in <name>.smry.csv, where <name> is the component's key in the config.

reservoir · lumped → LumpedReservoir

Column Meaning
<name>_T_inlet undocumented
<name>_T_outlet undocumented
<name>_P_inlet undocumented
<name>_P_outlet undocumented
<name>_mass_rate undocumented
<name>_T_reservoir_initial undocumented
<name>_P_reservoir undocumented
<name>_rho undocumented
<name>_mu undocumented
<name>_impedance undocumented
<name>_delta_p_darcy undocumented
<name>_h_inlet undocumented
<name>_h_outlet undocumented
<name>_psi undocumented
<name>_gamma undocumented
<name>_p1 undocumented
<name>_p2 undocumented
<name>_p3 undocumented
<name>_energy_extraction_rate undocumented
<name>_energy_extracted undocumented
<name>_ever_solved undocumented