Poromechanics
DES3D can couple the flow of one pore fluid with deformation of the solid skeleton. Pore pressure changes the effective stress and therefore the strength, and deformation changes the pore pressure. Optional extensions cover partly saturated ground, groundwater heat transport, thermal pressurization, evolving porosity and permeability, and an immobile matrix reservoir. Fluid and heat transport use explicit substeps. The mechanical solver can use ordinary explicit stepping, GVS or PT relaxation; local pressure/content conversions do not introduce a global implicit flow solve.
Hydraulics is enabled with control.has_hydraulic_diffusion = yes.
Conventions
Stress and strain are positive in tension, as elsewhere in DES3D. Pore pressure is positive in compression, so suction is . The vertical coordinate points up, and gravity acts in . The volumetric strain is and the mean stress .
Governing equations
Effective stress
The skeleton responds to the effective stress (Biot, 1941):
where is the total stress and the Biot–Willis
coefficient (mat.biot_coeff). With
mat.derive_biot_coeff_from_bulk_moduli = yes, DES3D sets
from the drained bulk modulus (mat.bulk_modulus)
and the grain modulus (mat.bulk_modulus_s)
(Biot and Willis, 1957).
The plastic models use the effective stress in their yield functions. A rise in pore pressure moves the Mohr circle toward failure without changing the deviatoric stress. The stored stress remains the total stress, which balances the external loads.
Fluid content
The default control.hydraulic_content_model = 0 uses the linear excess
fluid volume per unit bulk volume
(Rice and Cleary, 1976)
with porosity (mat.porosity), fluid bulk modulus
(mat.fluid_bulk_modulus) and Biot modulus . The thermal term applies
only with thermal pressurization (below). Valid materials satisfy
.
Darcy flow
The Darcy flux is
where is the fluid viscosity (mat.fluid_visc), the
reference fluid density (mat.fluid_rho0) and the relative
permeability ( when saturated). The permeability tensor is the
scalar intrinsic permeability (mat.hydraulic_perm, m²) times a
dimensionless symmetric positive-definite tensor
(mat.permeability_tensor = [xx,yy,zz,xy,xz,yz], isotropic by default). In
2D its x–z part is used. Fluid mass balance closes the system:
where is a volumetric source from wells or point sources.
Weight of the saturated rock
For the default hydraulic model, gravity uses the mixture density
with the temperature-dependent solid density and saturation
( when saturated). The same density loads a wet Winkler foundation.
The reference solid density is mat.rho0. Without hydraulics, gravity uses
the solid density alone.
This gravity density must be distinguished from inertial mass. With
control.is_quasi_static = yes, ordinary explicit mechanics and GVS use
fictitious masses set by mass scaling.
The default hydraulic model's unscaled mass and wave estimates use the
saturated mixture (), even when gravity uses a lower saturation. The
finite-density model below has a separate inventory-based weight.
Coupling in time
Each physical step advances mechanics once and pressure over the same interval. Which quantity drives the pressure depends on the mechanical solver.
Strain-driven form (default content model). With ordinary explicit mechanics or GVS and pressure feedback enabled, pressure advances first from the strain rate projected from the current velocity:
The stress and nodal forces then use the new pressure. Unscaled physical inertia also uses this ordering. The sealed elastic limit gives the undrained longitudinal wave; relative-fluid inertia is not integrated as a separate momentum equation.
Fixed-stress form (PT mechanics). Mechanics first reaches equilibrium for the step. Pressure then follows from the accepted change in mean total stress, with the fixed-stress storage (Kim et al., 2011):
in 3D. In 2D, is the in-plane mean stress and . The pressure change enters the effective stress in the next mechanical update. Saving it in checkpoints makes restarts exact. Because mechanics sees the pressure one step late, the coupling error is first order in .
control.has_poroelastic_pressure_feedback = no removes the mechanical
source term (the or term). Pressure
still diffuses and still acts on the effective stress. In quasistatic
explicit/GVS runs with feedback disabled, storage is , as in the
reduced fixed-stress flow model; unscaled physical inertia uses .
Removing feedback therefore does not mean keeping the same diffusivity as
every coupled explicit case. It does not disable the pressure's effect on
skeleton strength.
Pressure sampled by a plastic return
The fixed-stress mechanical return samples , while a completed saved frame pairs its stress with . For a saturated Mohr–Coulomb material, let and . The admissible slack at the sampled pressure and the saved-frame diagnostic obey
A negative saved-frame slack during a pressure rise can therefore measure coupling lag. In the recorded pressure-driven slope, doubling 404 to 808 steps reduces the minimum in-plane saved-pressure slack from −205.617 to −102.843 Pa; using the sampled pressure gives −0.000744 and −0.000226 Pa. This timing check does not replace the three-principal material return checks. Hydraulic subcycling does not remove the mechanical lag.
After plastic yielding, the pressure source uses accepted total volumetric strain, rather than converting stress through elastic moduli. The sealed plastic cell checks the matching fixed-stress recurrence. With retention, the Bishop cell checks its own rate equation and matching stabilization.
Hydraulic substeps
Pressure diffusion often needs smaller steps than mechanics. Within each
physical step DES3D advances pressure in explicit substeps. Their size is
set by the assembled lumped storage and conductance. A long physical step,
including control.fixed_dt, can therefore contain many stable transport
substeps. This does not make an oversized mechanical step stable or remove
the coupling lag. Mechanics,
porosity and other histories advance once per physical step. Scheduled
flux and source amounts use their exact schedule integrals; prescribed
pressures are imposed at substep endpoints.
Boundary and initial conditions
Each face has a hydraulic type, bc.hbc_x0 to bc.hbc_z1 (y faces in 3D
only):
| Type | Condition |
|---|---|
0 | No normal flow (default) |
1 | Hold the initial nodal pressure |
2 | Prescribed pressure from bc.hbc_pressure (Pa) |
3 | Prescribed outward Darcy flux from bc.hbc_flux (m/s) |
bc.hbc_pressure and bc.hbc_flux list six values in the order
x0 x1 y0 y1 z0 z1. A shared piecewise-linear multiplier,
bc.hbc_schedule_time_in_yr and bc.hbc_schedule_ratio with
bc.num_hbc_schedule entries, scales types 2 and 3 in time. A repeated time
makes a step; the ratio is held outside the table. Two faces that meet must
prescribe the same pressure at their shared nodes.
ic.pore_pressure_option sets the initial pressure:
| Value | Initial pressure |
|---|---|
0 (default) | Hydrostatic, with water table = ic.water_table_z, plus ic.excess_pore_pressure away from the boundaries |
1 | Linear in between the pressures prescribed on the x0 and x1 faces |
2 | Uniform, ic.pore_pressure_value |
Above the water table the hydrostatic pressure is negative (suction).
Wells and point sources
Wells are vertical screens with a prescribed volume rate:
bc.num_wells, bc.well_x, bc.well_y (3D), bc.well_z_top,
bc.well_z_bottom and bc.well_rate. The rate is m³/s in 3D and m²/s per
unit out-of-plane length in 2D; positive extracts. The rate is spread
uniformly along the screen and integrated exactly against the element shape
functions. All wells share one schedule, bc.well_schedule_time_in_yr and
bc.well_schedule_ratio. Each step applies the exact time average of the
schedule, so the pumped volume does not depend on the step size.
Point sources ([injection] section) supply or extract fluid at chosen
points, with a constant rate or a total amount over a time window. Positive
rates supply fluid. With fluid heat advection, an injected temperature can
be set. A parallel [heat_injection] section supplies heat at points.
Partly saturated flow
Setting mat.retention_model to a nonzero value per material enables
Richards flow (Richards, 1931) with
the gas phase at zero gauge pressure. With suction , effective
saturation and residual saturation
(mat.residual_saturation), the saturation is
:
retention_model | ||
|---|---|---|
0 | 1 (saturated) | 1 |
1 van Genuchten–Mualem | , | |
2 Brooks–Corey–Burdine | for , else 1 | |
3 Gardner |
Here is mat.retention_alpha (1/Pa) and is mat.retention_n
(van Genuchten, 1980;
Mualem, 1976). For Brooks–Corey,
is the air-entry pressure and the pore-size index.
The pressure-dependent nodal content is , where is in the strain-driven form or in the fixed-stress form. Mechanical source increments are assembled separately. DES3D updates this content explicitly and inverts it for pressure node by node. Its positive capacity gives one local root. Effective stress uses Bishop's form with (Lu et al., 2010):
Suction therefore adds apparent cohesion to a partly saturated slope.
dppressure remains the raw . Each element evaluates its
own Bishop increment with its own
retention law, averaging the nodal products over the element. This differs
from multiplying an averaged saturation by an averaged pressure. Matching
fixed-stress terms use the same element law. Elements
saturated at both states keep the saturated arithmetic.
Retention cannot yet be combined with evolving porosity or permeability, thermal
pressurization, fluid heat advection or matrix exchange.
Evolving porosity and permeability
With mat.porosity_model = 1, porosity follows the deformation through an
element history, the pore strain . Each step adds
where is the solid thermal expansivity (mat.alpha, used only
with thermal pressurization), the material porosity and
recovery of previously accepted plastic pore dilation (zero unless pore
healing is enabled). A step that
would leave stops the run with a diagnostic.
mat.permeability_model lets permeability follow porosity:
| Value | Permeability |
|---|---|
0 (default) | Fixed, |
1 Kozeny–Carman | |
2 power law | , = mat.permeability_exponent |
(Costa, 2006; Yang et al., 2021).
Recovery of accepted plastic opening
Recovery uses signed plastic volume, including the out-of-plane stress in plane strain. Reversible pressure and thermal increments are excluded from the elastic stress change:
For remaining recoverable opening , each accepted interval uses
Closure precedes the new plastic increment; compaction reduces opening and
is not itself healed. Elastic dilation does not enter . With
mat.pore_healing_time ,