Soft Bond Model Properties

The properties of the Soft-Bond Model are shown below for reference. More detailed information regarding these properties is presented here.

Note

Some properties are read only as stated below.

softbond
dp_force v

\(\mathbf{F^d}\) - dashpot force in units force. Expressed in the contact plane coordinate system. This is a read-only property.

dp_mode i

\(M_d\) - dashpot mode with default value 0.

dp_nratio f

\(\beta_n\) - normal critical damping ratio with default value 0.0.

dp_sratio f

\(\beta_s\) - shear critical damping ratio with default value 0.0.

emod f

\(E^*\) - effective modulus in units force/area. This is a read-only property.

fric f

\(\mu\) - friction coefficient with default value 0.0.

kn f

\(k_n\) - normal stiffness in units stress/disp, with default value 0.0.

kratio f

\(\kappa^*\) - normal-to-shear stiffness ratio. This is a read-only property.

ks f
\(k_s\) - shear stiffness in units stress/disp, with default value 0.0.
rgap f

\(g_r\) - reference gap in units length with default value 0.0.

sb_area f

\(A\) - area of the contact. This is a read-only property.

sb_bmul f

\(\lambda_b\) - bending friction multiplier, with default value of 1.0.

sb_cut f

\(\gamma\) - bond softening tensile strength factor.

sb_force v

\(\mathbf{F}\) - linear force in units force with default value \(\mathbf{0}\). Expressed in the contact plane coordinate system.

sb_mode i

\(M_l\) - normal-force update mode with default value 0 (absolute update mode). Incremental normal-force update mode is set with \(M_l\) = 1. When the bond is activated, \(M_l\) is automatically set to 1

sb_moment v

\(\mathbf{M}\) - moment. Expressed in the contact plane coordinate system.

sb_radius

\(\overline{R}\) - Effective contact radius. This is a read-only property.

sb_rmul f

\(\lambda\) - Radius multiplier. with default value 1.0.

sb_slip b

\(s\) - slip state. This is a read only property.

sb_slipb b

\(sb\) - bending slip state. This is a read only property.

sb_slipt b

\(sb\) - twisting slip state. This is a read only property.

sb_soft f

\(\zeta\) - bond softening factor.

sb_shear f

\(\tau_{c}\) - bond shear strength in units stress. This is a read-only property.

sb_sigma f

\(\sigma\) - bond normal stress at bond periphery in units stress. This is a read-only property.

sb_state i

\(B\) - bond state. This is a read-only property.

sb_tau f

\(\tau\) - bond shear stress at bond periphery in units stress. This is a read-only property.

sb_ten f

\(\sigma_c\) - bond tensile strength in units stress with default value 0.0.

sb_tmul f

\(\lambda_t\) - Twisting friction multiplier, with default value of 1.0.

user_area f

\(A\) - set contact area to the constant value f.