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_type | Stress update |
|---|---|
elastic | linear elasticity |
viscous | linear viscous flow, with incompressibility enforced by the bulk modulus (experimental) |
maxwell | elastic and viscous in series |
elasto-plastic | elasticity with Mohr–Coulomb plasticity |
elasto-visco-plastic | Maxwell or elasto-plastic, whichever gives the smaller stress |
elasto-plastic-rate-state-friction | elasto-plastic, with the friction coefficient from rate-and-state friction |
elasto-visco-plastic-rate-state-friction | elasto-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
| Symbol | Meaning | Parameter |
|---|---|---|
| stress exponent | mat.visc_exponent | |
| pre-exponential coefficient, in MPa s | mat.visc_coefficient | |
| activation energy, J/mol | mat.visc_activation_energy | |
| activation volume, m³/mol | mat.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
| Parameter | Meaning | Default |
|---|---|---|
mat.rheology_type | rheology, see the table above | required |
mat.num_materials | number of materials; lists take one value per material | 1 |
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_viscosity | viscosity limits (Pa s) | 1e18, 1e24 |
mat.pls0, mat.pls1 | plastic strain where softening starts and ends | [0], [0.1] |
mat.cohesion0, mat.cohesion1 | cohesion before and after softening (Pa) | [4e7], [4e6] |
mat.friction_angle0, mat.friction_angle1 | friction angle (°) | [30], [5] |
mat.dilation_angle0, mat.dilation_angle1 | dilation angle (°) | [0], [0] |
mat.max_tension | upper limit of the tension cut-off (Pa) | 1e9 |
mat.is_plane_strain | plane-strain update in 2D | no |
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.