Skip to main content
Version: Latest

Rheology

Each element carries one rheology, chosen for the whole model by mat.rheology_type, and per-material parameters given as lists, one value per material. This page gives the laws and their parameters. How the stress is integrated over a time step, the visco-elastic update and the Mohr–Coulomb return, is in Constitutive update.

Sign convention: stress and strain are positive in tension. In 2D the strain and stress have the components , and .

The rheologies​

rheology_typeStress update
elasticlinear elasticity
viscouslinear viscous flow, with incompressibility enforced by the bulk modulus (experimental)
maxwellelastic and viscous in series
elasto-plasticelasticity with Mohr–Coulomb plasticity
elasto-visco-plasticMaxwell or elasto-plastic, whichever gives the smaller stress
elasto-plastic-rate-state-frictionelasto-plastic, with the friction coefficient from rate-and-state friction
elasto-visco-plastic-rate-state-frictionelasto-visco-plastic, with rate-and-state friction

Short aliases ending in -rsf are accepted for the last two.

Elasticity​

The stress increment from a strain increment is

with the bulk modulus (mat.bulk_modulus) and shear modulus (mat.shear_modulus). With pore-fluid flow the update acts on the effective stress; see Poromechanics.

In 2D, mat.is_plane_strain = yes keeps the out-of-plane strain at zero and tracks the out-of-plane stress , which then enters the plastic yield test. Without it, the 2D update uses only the in-plane components.

Viscous flow and the creep law​

viscous, maxwell and the visco-plastic rheologies take their viscosity from a power-law creep law (Chen & Morgan, 1990):

where

SymbolMeaningParameter
stress exponentmat.visc_exponent
pre-exponential coefficient, in MPa smat.visc_coefficient
activation energy, J/molmat.visc_activation_energy
activation volume, m³/molmat.visc_activation_volume
second invariant of the strain rate, at least s⁻¹
mean stress, , positive in tension
element temperature, the mean of its nodes, K
8.3144 J/mol/K

The factor converts MPa s to Pa s. Because is positive in tension, compression () lowers the viscosity when ; the common form with pressure corresponds to entering here. The result is clipped to [mat.min_viscosity, mat.max_viscosity] (defaults and Pa s). A constant viscosity is obtained with min_viscosity = max_viscosity, as in the Maxwell benchmark.

The viscous rheology sets the deviatoric stress to and the mean stress to times the volumetric strain. maxwell integrates elastic and viscous deformation in series over the step; its relaxation time is .

Plasticity​

elasto-plastic limits the stress by the Mohr–Coulomb shear criterion and a tension cut-off,

with the principal stresses (so is the most compressive), cohesion and friction angle . The stress is admissible while and . Plastic flow in shear follows the dilation angle through , which may differ from (non-associated flow). The tension cut-off is

or max_tension alone when . The return to the yield surface, including the edge where two shear faces meet, is described in Constitutive update.

Strain softening​

Cohesion, friction angle and dilation angle change linearly with the accumulated plastic strain between two values:

and likewise for and . The parameters are mat.pls0 and mat.pls1 (, ), mat.cohesion0 and mat.cohesion1, mat.friction_angle0 and mat.friction_angle1, and mat.dilation_angle0 and mat.dilation_angle1 (degrees). Equal start and end values give a material without softening. Softening is what lets a brittle layer localize into shear bands; see the shear-band benchmark.

Elasto-visco-plastic​

elasto-visco-plastic computes both a Maxwell stress and an elasto-plastic stress from the same strain increment and keeps the one with the smaller second invariant. Cold, strong regions are therefore limited by plasticity and hot, weak regions by viscous creep, with no separate switch. Plastic strain accumulates only in elements that take the elasto-plastic stress.

Several materials in one element​

Each element records how many markers of each material it holds. Its properties are marker-weighted means. The viscosity and the bulk and shear moduli are harmonic means, for example

where is the fraction of the element's markers of material . The strength parameters (cohesion, friction and dilation angles), the heat capacity and the thermal conductivity are arithmetic means. The harmonic mean lets a weak material control an element it shares with a strong one.

Parameters​

ParameterMeaningDefault
mat.rheology_typerheology, see the table aboverequired
mat.num_materialsnumber of materials; lists take one value per material1
mat.bulk_modulus, mat.shear_modulus, (Pa)[128.2e9], [80.5e9]
mat.visc_exponent, mat.visc_coefficient, [3.05], [1.25e-1]
mat.visc_activation_energy, mat.visc_activation_volume, [3.76e5], [0]
mat.min_viscosity, mat.max_viscosityviscosity limits (Pa s)1e18, 1e24
mat.pls0, mat.pls1plastic strain where softening starts and ends[0], [0.1]
mat.cohesion0, mat.cohesion1cohesion before and after softening (Pa)[4e7], [4e6]
mat.friction_angle0, mat.friction_angle1friction angle (°)[30], [5]
mat.dilation_angle0, mat.dilation_angle1dilation angle (°)[0], [0]
mat.max_tensionupper limit of the tension cut-off (Pa)1e9
mat.is_plane_strainplane-strain update in 2Dno

Most models set their own values. All parameters are listed in the parameter reference.

Reference​

Chen, Y., & Morgan, W. J. (1990). A nonlinear rheology model for mid-ocean ridge axis topography. Journal of Geophysical Research, 95(B11), 17583–17604.