block contact property command

Syntax

block contact property keyword ... <range>

Assign joint constitutive model properties to subcontacts. The possible properties depend on the constitutive model assigned to the subcontact. Note that subcontacts must be created before properties can be assigned, using either block zone generate for deformable blocks, or block contact generate-subcontacts for rigid blocks.

Properties are name value pairs where the name is the keyword given in the command and the value type is specific to the property.

The assignment will affect any block contact whose joint model includes the property named — noting that some properties, such as friction‑residual, for instance, appear in more than one joint model). Limiting a property assignment to block contacts that have a particular joint model assignment is done using the range component of the command. For instance, in the following:

block contact property cohesion 0.7e6 range jmodel 'softening-mohr'

the range component limits the cohesion property specification to zones with a Softening Mohr-Coulomb (softening-mohr) joint model assignment.

See Constitutive Models in 3DEC for more details on each joint constitutive model.

Mohr-Coulomb (mohr) Joint Model

Properties are described in the topic area Mohr-Coulomb Joint Model In 3DEC in the 3DEC Theory section, which provides a full overview of the model. For convenience, these are also listed below.

mohr
Model Properties

cohesion    cohesion‑residual    dilation    dilation-zero    friction    friction‑residual    stiffness‑normal    stiffness‑shear    tension    tension-residual

Softening-Healing Mohr-Coulomb (softening-mohr) Joint Model

Properties are described in the topic area Softening-Healing Mohr-Coulomb Joint Model In 3DEC in the 3DEC Theory section, which provides a full overview of the model. For convenience, these are also listed below.

shmohr
Model Properties

alpha    cohesion    cohesion‑residual    dc    dilation    dilation‑residual    dilation‑zero    friction    friction‑current    friction‑residual    healing    slip    stiffness‑normal    stiffness‑shear    tension    tension‑residual

Bilinear Mohr-Coulomb (bilinear-mohr) Joint Model

Properties are described in Bilinear Mohr-Coulomb Joint Model In 3DEC, which provides a full overview of the model. For convenience, these are also listed below.

bmohr
Model Properties

cohesion    cohesion-2    cohesion‑residual    c2-residual    dilation    dilation‑2    dilation‑zero    friction    friction‑2    friction‑residual    f2-residual     nstress    nstress-residual    stiffness‑normal    stiffness‑shear    tension    tension‑residual

Continuously Yielding (cyjjm) Joint Model

Properties are described in the topic area Continuously Yielding Joint Model In 3DEC in the 3DEC Theory section, which provides a full overview of the model. For convenience, these are also listed below.

cyjm
Model Properties

al    exponent‑normal    exponent‑shear    friction‑initial    friction‑residual    kn‑current    kn‑initial    kn‑maximum    kn‑minimum    ks‑current    ks‑initial    ks‑maximum    ks‑minimum    plastic‑strain    roughness    sdisp‑peak    sdisp‑residual    sdisp    sstress‑maximum   sstress‑peak    tol    ussisref