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 [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 [force/area]. This is a read-only property.

fric f

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

kn f

\(k_n\) - normal stiffness [stress/length] 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 [stress/length] with default value 0.0.

rgap f

\(g_r\) - reference gap [length] with default value 0.0.

sb_area f

\(A\) - cross-sectional area. This is a read-only property.

sb_bmul f

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

sb_coh f

\(c\) - cohesion [stress] with default value 0.0.

sb_cut f

\(\gamma\) - tensile strength reduction factor.

sb_fa f

\(\phi\) - friction angle [degrees] with default value 0.0.

sb_force v

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

sb_mcf f

\(\beta\) - moment-contribution factor. This is a read-only property.

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}\) - radius. This is a read-only property.

sb_rmul f

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

sb_shear f

\(\tau_{c}\) - shear strength [stress]. This is a read-only property.

sb_sigma f

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

sb_slip b

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

sb_slipb b

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

sb_slipt b

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

sb_soft f

\(\zeta\) - tensile-softening factor.

sb_state i

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

sb_tau f

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

sb_ten f

\(\sigma_c\) - tensile strength [stress] with default value 0.0.

sb_tmul f

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

user_area f

\(A\) - cross-sectional area (constant)