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 |