Subspring Network Model Methods

The methods of the Subspring Network Model model are shown below for reference. More detailed information regarding these methods is presented in the model description.

subspringnetwork

area

Set the user_area property, fixing the contact area, from the current sn_area.

assign-stiffness keyword ...

Assign normal and shear stiffness without the Poisson’s ratio correction. This should be used for assigning notional joint stiffnesses for non-bonded, pre-existing joints. The rotational stiffness is set to 0.

kn f

Normal stiffness per unit area.

kratio f

Normal-to-shear stiffness ratio.

bond keyword ...

Activate the bond.

gap f1 <f2 >

Bond contacts with the gap interval specified. If only one value is specified this is the upper bound of the interval. If two values are specified they correspond to the lower and upper bounds of the interval, respectively. By default the interval is \((-\infty,0]\).

compute-stiffness keyword ...

Compute stiffnesses to match the target Young’s modulus and Poisson ratio. Incremental normal force computation mode is activated.

emod f

Specify the effective Young’s modulus.

poisson f

Poisson ratio.

reset-disp

Set the shear displacement for all subcontacts to 0.

unbond <keyword>

Deactivate the bond.

gap f1 <f2 >

Unbond contacts with the gap interval specified. If only one value is specified this is the upper bound of the interval. If two values are specified they correspond to the lower and upper bounds of the interval, respectively. By default the interval is \((-\infty,0]\).