Skip to content

Well-Pattern Impedance

The analytic hydraulic impedance of a doublet, five-spot or inverted five-spot well pattern, as implemented in src/tango_core/components/reservoir/wellpattern_impedance.py and used by LumpedReservoir. Status: available.

The WellPattern enum

WellPattern(StrEnum) lists the supported well patterns. Its .impedance() method returns the analytic hydraulic impedance Z (Pa·s/kg), which relates mass flow rate to pressure drop: ΔP = ṁ · Z. The formulas follow Birdsell, D.T., Adams, B.M., Deb, P., Ogland-Hand, J.D., Bielicki, J.M., Fleming, M.R., & Saar, M.O. (2024). Analytical solutions to evaluate the geothermal energy generation potential from sedimentary-basin reservoirs. Geothermics, 116, 102843.

With L the well spacing, D the effective well diameter, k the permeability, b_eff = thickness · net_to_gross_ratio, μ the viscosity and ρ the density:

Pattern (layout.well_pattern) Member Impedance Z Status
DOUBLET WellPattern.Doublet μ · (ln(L / (e·D)) + D/L) / (ρ · k · b_eff · π) available
5SPOT WellPattern.FiveSpot μ / (4 · ρ · k · b_eff) · ln(4L / (π·D)) available
INVERTED_5SPOT WellPattern.InvertedFiveSpot μ / (ρ · k · b_eff) · ln(4L / (π·D)) available
AGS_DOUBLET WellPattern.AGSDoublet none; raises NotImplementedError planned

Names are case-insensitive: WellPattern("doublet") and WellPattern("DOUBLET") are the same member.

Use in LumpedReservoir

LumpedReservoir (src/tango_core/components/reservoir/lumped.py) holds the configured pattern and defaults to WellPattern.Doublet when layout.well_pattern is absent. Each solve evaluates the impedance with the fluid properties at the current state:

Z = self.wp.impedance(
    mu=mu,
    rho=rho,
    permeability=self.permeability,
    thickness=self.thickness,
    net_to_gross_ratio=self.net_to_gross_ratio,
    well_spacing=self.well_spacing,
    well_eff_diameter=self.well_eff_diameter,
)

dp = mdot * Z

The doublet formula is the same expression that was previously written inline in LumpedReservoir; moving it into WellPattern added the five-spot patterns without changing doublet results.

Tests

tests/regtest/test_config_validation.py covers the config side:

Config Result
undefined_well_pattern.yml: a name that matches no pattern ConfigError
well_pattern_not_implemented.yml: AGS_DOUBLET NotImplementedError
no_well_pattern.yml: no well_pattern key A warning; the reservoir uses DOUBLET