block.subcontact.state.string

Syntax

s = block.subcontact.state.string(bscp)

Get the subcontact state indicator as a string

Different joint constitutive models will have different potential states (see Constitutive Models in 3DEC). The potential states for the Mohr-Coulomb model are shown in the table below.

MC Failure State Strings

Label

Failure in shear now

slip-n

Failure in tension now

tension-n

Failure in shear in the past

slip-p

Failure in tension in the past

tension-p

Combinations of states are possible. For example, a subcontact that failed in tension in the past and is shearing now would have a state string value of tension-p shear-n. A value of none indicates no failure (elastic).

Returns:

i - state indicator

Accepts:

i - state indicator

Arguments:

bscp - block subcontact pointer