swell

bulk f

elastic bulk modulus, \(K\)

cohesion f

cohesion, \(c\)

constant-a-1 f

swelling property, \(a_1\)

constant-a-3 f

swelling property, \(a_3\)

constant-c-1 f

swelling property, \(c_1\)

constant-c-3 f

swelling property, \(c_3\)

constant-m-1 f

swelling property, \(m_1\)

constant-m-3 f

swelling property, \(m_3\)

dilation f

dilation angle, \(\psi\). The default is 0.0.

dip f

dip angle [degrees] of the local swelling plane

dip-direction f

dip direction [degrees] of the local swelling plane

friction f

internal angle of friction, \(\phi\)

normal v

normal direction of the local swelling plane, (\(n_x\), \(n_y\), \(n_z\))

normal-x f

x-component of the normal direction to the local swelling plane, \(n_x\)

normal-y f

y-component of the normal direction to the local swelling plane, \(n_y\)

normal-z f

z-component of the normal direction to the local swelling plane, \(n_z\)

poisson f

Poisson’s ratio, \(\nu\)

pressure-reference f

atmospheric pressure, \(p_a\)

shear f

elastic shear modulus, \(G\)

tension f

tension limit, \(\sigma^t\). The default is 0.0.

young f

Young’s modulus, \(E\)

flag-swell i

[advanced] flag of swelling function, (1 - logarithmic; 2 - linear). The default is 1.

flag-brittle b

[advanced] If true, the tension limit is set to 0 in the event of tensile failure. The default is false.

number-start i

[advanced] number of steps over which swelling strains are introduced, \(N_s\). The default is 1.

count-swell i

[read only] count of step number after swelling starts, must be reset to zero to start a new swelling episode

stress-local-vertical f

[read only] local total stress vertical stress when swelling starts; must be reset to zero when soil swelling properties are changed

stress-swell-xx f

[read only] xx swelling stress component

stress-swell-yy f

[read only] yy swelling stress component

stress-swell-zz f

[read only] zz swelling stress component

stress-swell-xy f

[read only] xy swelling stress component

stress-swell-xz f

[read only] xz swelling stress component

stress-swell-yz f

[read only] yz swelling stress component

Notes:

• The local swelling plane is a plane defined so that the swelling is isotropic in this plane.
• Only one of the two options is required to define the elasticity: bulk modulus \(K\) and shear modulus \(G\), or Young’s modulus \(E\) and Poisson’s ratio \(\nu\). When choosing the latter, Young’s modulus \(E\) must be assigned in advance of Poisson’s ratio \(\nu\).
• The tension cut-off is \({\sigma}^t = min({\sigma}^t, c/\tan \phi)\).

Footnotes

Advanced properties have default values and do not require specification for simpler applications of the model.

Read only properties cannot be set by the user. However, they may be listed, plotted, or accessed through FISH.