Xstressmechanics

require.mx('mxjs/geotech/xstressmechanics.js');

This library contains several functions to manipulate and stress tensors and perfom calculations of stress This does not contain functions for strength and strain calculations as these are dependent on specific models of material behaviour such functions are/should be provided in seperate libraries. For the calculation of rock mass strength see the Xrockstrength library

StatusName
Number I1 ( number ↓Sa, number ↓Sb, number ↓Sc )

Returns the The first invariant of stress, I1

Number J2 ( number ↓Sxx, number ↓Syy, number ↓Szz, number ↓Sxy, number ↓Syz, number ↓Sxz )

Returns the second deviatoric stress invariant, J2

Number J3 ( number ↓Sxx, number ↓Syy, number ↓Szz, number ↓Sxy, number ↓Syz, number ↓Sxz )

Returns the third deviatoric stress invariant, J3

PrincipalFromInvariants ( number ↓J2, number ↓J3, number ↓LodeAngle, [array] )

Returns the principal stresses from the stress invariants without needing to get eigenvalues. Slightly fater than using eigenvalues.

Number Thetasin ( number ↓J2, number ↓J3 )

Returns the "Lode angle" as the "asin(F)" formulation. Which is used by the the Xrockstrength library. PLEASE NOTE the "acos(F)" formulation is more common. please make sure you use the correct formulation.


Library Functions

↑I1 = Lib.I1 ( ↓Sa, ↓Sb, ↓Sc )

Returns the The first invariant of stress, I1

Parameters:
  • number ↓Sa - ┌ Principle stresses or Cartesian stress components Sxx, Syy or Szz...
  • number ↓Sb - │ Result is independent of the order of stress components
  • number ↓Sc - └
Returns: Number ↑I1
↑J2 = Lib.J2 ( ↓Sxx, ↓Syy, ↓Szz, ↓Sxy, ↓Syz, ↓Sxz )

Returns the second deviatoric stress invariant, J2

Parameters:
  • number ↓Sxx - ┌ Cartesian normal stress components...
  • number ↓Syy - | for principal stress substitute Sxx, Syy, Szz...
  • number ↓Szz - └ for principal stresses, order is irrelevant
  • number ↓Sxy - ┌ Cartesian shear stress components...
  • number ↓Syz - | for principal stress, Sxy, Syz, Sxz = 0
  • number ↓Sxz - └
Returns: Number ↑J2
↑J3 = Lib.J3 ( ↓Sxx, ↓Syy, ↓Szz, ↓Sxy, ↓Syz, ↓Sxz )

Returns the third deviatoric stress invariant, J3

Parameters:
  • number ↓Sxx - ┌ Cartesian normal stress components...
  • number ↓Syy - | for principal stress substitute Sxx, Syy, Szz...
  • number ↓Szz - └ for principal stresses, order is irrelevant
  • number ↓Sxy - ┌ Cartesian shear stress components...
  • number ↓Syz - | for principal stress, Sxy, Syz, Sxz = 0
  • number ↓Sxz - └
Returns: Number ↑J3
Lib.PrincipalFromInvariants ( ↓J2, ↓J3, ↓LodeAngle, [array] )

Returns the principal stresses from the stress invariants without needing to get eigenvalues. Slightly fater than using eigenvalues.

Parameters:
  • number ↓J2 - Second deviatoric stress invariant
  • number ↓J3 - Third deviatoric stress invariant
  • number ↓LodeAngle - (Note this is the -asin version)
  • [array] - ↑[sig3, sig2, sig1]
↑LodeAngle = Lib.Thetasin ( ↓J2, ↓J3 )

Returns the "Lode angle" as the "asin(F)" formulation. Which is used by the the Xrockstrength library. PLEASE NOTE the "acos(F)" formulation is more common. please make sure you use the correct formulation.

Parameters:
  • number ↓J2 - Second deviatoric stress invariant
  • number ↓J3 - Third deviatoric stress invariant
Returns: Number ↑LodeAngle