Skip to main content
Version: Latest

Steady infiltration: Brooks–Corey law

A constant inflow from the top produces a steady suction profile above a water table at the base. The Brooks–Corey law stays saturated up to its air-entry suction, so the profile has a kink where desaturation begins.

Largest pressure error: 18.84 Pa, 1.69% of the profile range.

At a glance
Dimension2D
Buildmake ndims=2 from the poromechanics source (not yet merged; DynEarthSol #134)
Inputsbc.zip
Reproduce withDynEarthSol 3774df0

Problem setup​

Setup

Water boundaries. Constant downward inflow m/s at the top. Base pressure zero; sides sealed.

Air entry. Pressure-based Pa, and . The material stays saturated down to Pa.

Mechanical conditions and comparison. Side-normal displacement and base vertical displacement fixed; traction-free top. Start hydrostatic and compare steady pressure, including the air-entry transition.

Input and how to run​

Every file this example needs is in bc.zip. Run from that folder:

# Runs the 2D column with fixed 300 s steps for about 23 days (2e6 s), long enough to reach the steady profile. DES writes column.save.* at the start, halfway and at the end; the page compares the last frame.
dynearthsol2d input.cfg

Settings that define this example​

SettingValueWhat it does here
control.has_hydraulic_diffusiontrueturns on Darcy flow, here partly saturated (Richards) flow
control.has_PTtruePT solver: mechanical equilibrium is reached by iteration within each step
control.gravity9.81gravity drives the downward flow and sets the hydrostatic start
sim.max_time_in_yr0.06337752907015713 yr = 2e+06 sabout 2e6 s in fixed 300 s steps, long enough for the column to reach steady state
bc.hbc_z02type 2: the base is held at the pressure in bc.hbc_pressure, here 0, the water table
bc.hbc_z13type 3: the top has the prescribed flux in bc.hbc_flux
bc.hbc_flux[0,0,0,0,0,-1.388888888888889e-06]outward Darcy flux per face; the top value −1.389e-6 m/s is an inflow of half the saturated conductivity
ic.water_table_z-1.0starts hydrostatic with the water table at the base (z = −1 m)
mat.retention_model[2]2: Brooks–Corey retention with Burdine relative permeability
mat.retention_alpha[1e-3]α_p = 1e-3 1/Pa: the soil stays saturated down to the air-entry pressure −1/α_p = −1000 Pa
mat.retention_n[1.5]Brooks–Corey pore-size index 1.5
mat.residual_saturation[0.05]residual saturation S_r = 0.05
mat.fluid_bulk_modulus[40000.0]deliberately small (4e4 Pa) to allow a larger stable flow step; storage does not affect the steady profile
mat.hydraulic_perm[2.8372409106354064e-13]gives saturated conductivity K_s = 2.78e-6 m/s (1 cm/h)

input.cfg holds all 54 settings that differ from DES’s defaults; dynearthsol2d -h lists every option with its default.

Output​

See Running the examples for output files, the Python reader and ParaView conversion.

FieldWhat to look at
pore pressurethe steady pressure profile at the last frame, compared with the reference
coordinatethe height of each node above the base

Result: DES and the analytical solution​

Result

Steady pressure (kPa) against height above the water table at the end of the run: DES nodes (circles) and the steady-infiltration reference for the Brooks–Corey law (line). The profile bends where the soil starts to desaturate at the air-entry pressure.

This checks the retention-dependent conductivity and the flux boundary. It does not test transient storage or coupled slope behaviour.

To reproduce the whole study behind this figure, from the DES source folder:

python3 tests/functional/hydromechanics/check_unsaturated_column.py dynearthsol2d OUT

The study’s full numbers: record.json.

Analytical reference​

Elevation runs upward from the water-table base. is positive downward infiltration, saturated hydraulic conductivity and . In the saturated zone ; air entry occurs at .

Derivation​

At steady state is constant. Darcy flow with upward includes both pressure and gravity. Rearranging and separating variables gives the integral shown above, starting from at .

For the pressure decreases with elevation toward the suction at which . The integral diverges at that limiting pressure. Storage and elastic compressibility do not enter this steady relation. The analytical relation is evaluated with an independent high-accuracy ODE solver; no DES output or fitting parameter is used.

Derived from steady Darcy flow, with the saturated segment treated as part of the same pressure-dependent law; evaluated in unsaturated_reference.py.

Validity and limits​

The steady relation is implicit and its unsaturated part is evaluated numerically, rather than treated as a closed-form profile. This test checks the conductivity and air-entry transition. The fluid modulus is deliberately reduced to shorten the run; it does not alter the steady reference and does not qualify transient storage.