Skip to main content
Version: Latest

Rate-and-state friction under a velocity step

A pressurized cell sheared at yield sees its loading rate rise tenfold. Rate-and-state friction jumps by , then decays over the slip distance to the new steady state (: velocity weakening).

DES follows its exact discrete recursion to round-off at every step (state and friction identical, stress within 9e-16), so the state is updated once per physical time step, not once per PT iteration. Against the continuum solution the largest friction error after the step is 9.56e-04, 4.67e-04, 2.31e-04, 1.15e-04 for steps of 1, 0.5, 0.25, 0.125 s: first order, against a jump of 0.0230.

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

Problem setup​

Setup

Cell. The material-strength unit cell: every node prescribed, normal extension rates , plane strain, initial stress with MPa and a fixed pore pressure of 0.8 MPa (), cohesion 100 kPa, no dilation.

Friction. EP-RSF with the aging law: , , mm, , , so the cell starts and stays at steady state; slip rate (total-strain-rate projection).

Rate step. After 64 s at the cell restarts from its last checkpoint at for another 64 s.

What is compared. Friction, state and principal shear stress at every step against the exact discrete recursion and the continuum solution, for steps of 1, 0.5, 0.25 and 0.125 s.

Input and how to run​

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

# Loads the 2D cell at the slow rate for 512 steps of 0.125 s (64 s) and writes cell.save.* and cell.chkpt.* at every step; the last checkpoint (frame 512) is the starting point of the second stage.
dynearthsol2d input.cfg
# Restarts from cell frame 512 with ten times the boundary velocity and runs to step 1024 (another 64 s), writing step.save.*; no checkpoint is shipped, so the first stage must be run first.
dynearthsol2d step.cfg

Settings that define this example​

SettingValueWhat it does here
mat.rheology_typeelasto-plastic-rate-state-frictionelasto-plastic-rate-state-friction: Mohr–Coulomb plasticity whose friction coefficient follows rate-and-state friction
mat.state_var_model11: aging law for the state variable θ
mat.direct_a[0.01]direct-effect parameter a = 0.01: the instant friction jump at the rate step is a ln 10
mat.evolution_b[0.015]evolution parameter b = 0.015 > a, so the material is velocity weakening and the new steady friction is lower by (b − a) ln 10
mat.characteristic_distance[0.001]slip distance D_c = 1 mm over which friction relaxes to the new steady state
mat.characteristic_velocity[1.1048543456039805e-05]reference slip rate V0, set equal to the initial slip rate V1 so the cell starts at steady state with μ = tan 30°
control.rsf_slip_rate_projection_option11: slip rate V = 2w ε̇_II from the total deviatoric strain rate (w is the element's minimum altitude)
monitor.output_state_variabletruewrites the state variable and the dynamic friction coefficient to every frame
bc.vbc_val_x17.8125e-06extension rate of the cell (right face velocity); step.cfg multiplies it by 10
bc.vbc_val_z1-7.8125e-06equal shortening rate on the top; step.cfg multiplies it by 10
ic.pore_pressure_value800000.0fixed pore pressure 0.8 MPa (uniform, pore_pressure_option 2)
ic.initial_stress[-1000000.0, -1000000.0, 0.0]isotropic total stress of −1 MPa
control.fixed_dt0.125time step 0.125 s, the finest step of the study
sim.checkpoint_frame_interval11: a checkpoint at every frame, so the rate step can restart from the last one

input.cfg holds all 70 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
dynamic friction coefficientelement friction coefficient μ, plotted across the rate step in panel (a)
friction state variableelement state θ; compared with the exact forward-Euler recursion at every step
stresselement total stress; half the principal-stress difference is the shear stress at yield in panel (b)

Result: DES and the analytical solution​

Result

(a) Friction coefficient across the tenfold step in loading rate, against time from the step: solid line, continuum solution; thin stepped line, the forward-Euler recursion at the same time step; symbols, DES at the finest time step. (b) Principal shear stress at yield, which follows the friction coefficient through the Mohr–Coulomb load. (c) Largest friction error against the continuum solution after the step, for each time step, with a first-order reference slope.

This verifies the evolving rate-and-state friction of the effective-stress plasticity, which the strength page checks only at constant friction.

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

python3 tests/functional/hydromechanics/check_rsf_step.py dynearthsol2d OUT --refinements 1 2 4 8

The study’s full numbers: record.json.

Analytical reference​

is the state variable, the slip rate, the element's minimum altitude and half the principal-stress difference. DES advances by forward Euler, once per physical step.

Derivation​

With held constant the aging law is linear in and integrates to the exponential above; at friction jumps by through the direct effect and relaxes to the new steady state, a net change of .

With every node prescribed and no dilation, the stress is elastic until yield and then equals the Mohr–Coulomb load at the current friction. The discrete reference repeats DES’s forward-Euler update; the continuum one is exact.

Dieterich (1979), Journal of Geophysical Research 84(B5), 2161–2168; Ruina (1983), Journal of Geophysical Research 88(B12), 10359–10370.

Original reference.

Validity and limits​

Aging law and the total-strain-rate slip projection only; constant pore pressure; no dilation, no elastic interaction (every node prescribed), so stick–slip instability is not tested.