cap-yield
cohesion f

ultimate cohesion, \(c\). The default is 0.0.

dilation f

ultimate dilation angle, \(\psi_f\). The default is 0.0.

friction f

ultimate friction angle, \(\phi_f\). If the specified value is less than 0.1 degree, it will be limited to 0.1 degree for numerical stability.

friction-mobilized f

mobilized friction angle, \(\phi_m\), which should be initialized no less than the value determined by \(\phi^{nc}_m\) (see this equation) via a command or FISH function.

pressure-cap f

cap pressure, \(p_c\), which can be initialized via a command or a FISH function.

pressure-initial f

initial mean effective stress, \(p_{ini}\). Required if pressure-cap is not specified. It can be initialized via a command or a FISH function.

pressure-reference f

reference pressure, \(p_{ref}\). A non-zero value should be specified based on the unit of stress/pressure adopted in the model.

poisson f

current Poisson’s ratio, \(\nu\). The default is 0.2.

shear-reference f

dimensionless elastic shear modulus reference value, \(G_{ref}\). A non-zero value should be specified.

tension f

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

alpha f

[advanced] dimensionless cap yielding surface parameter, \(\alpha\). The default is 1.0.

beta f

[advanced] dimensionless calibration factor, \(\beta\). The default is 1.0.

dilation-mobilized f

[advanced] current mobilized dilation angle, \(\psi_m\). It is read-only, except for table-dilation ǂ 0.

exponent f

[advanced] exponent for the pressure-dependent elastic moduli, \(m\). The default is 0.5, and the upper limit is 0.99.

failure-ratio f

[advanced] failure ratio, \(R_f\). The default is 0.9.

flag-brittle b

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

flag-cap i

[advanced]

= 0 (default), no cap. The elastic moduli are functions of the mean effective stress, and pressure_initial should be specified.

= 1, with cap. The elastic moduli are functions of the cap pressure and pressure_cap should be specified via a command or a FISH function, or calculated internally otherwise, see information on pressure_cap.

flag-dilation i

[advanced]

= 0 (default), the built-in Rowe dilation rule is used.

= 1, \(\psi_m\)\(\psi_f\).

= 2, \(\phi_{cv}\) should be specified and \(\psi_m\) is calculated from this equation.

flag-shear i

[advanced]

= 0 (default), the built-in shear hardening law is used.

= 1, \(\phi_m\)\(\phi_f\).

friction-0 f

[advanced] initial mobilized friction angle, \(\phi_0\) associated with zero plastic shear strain. By default, \(\phi_0\) = \(\phi_m\) if \(\epsilon_{ps}\) is initialized to 0.0; otherwise, \(\phi_0\) = 0.0 if not specified.

friction-critical f

[advanced] constant \(\phi_{cv}\). The default value is calculated by this equation. Required for specification only if flag-dilation = 2.

over-consolidation-ratio f

[advanced] over-consolidation ratio, \(OCR\). The default is 1.0.

multiplier f

[advanced] multiplier on current plastic cap modulus to give elastic bulk and shear moduli, \(R\). The default is 5.0 with cap and 0.0 without cap.

shear-maximum f

[advanced] maximum (upper-bound limit) of the elastic shear modulus, \(G^e_{max}\). The default internally calculated value is \(10 \times G^e_{ini}\), where \(G^e_{ini}\) is the initial \(G^e\) when the model is first time set up.

shear-minimum f

[advanced] minimum (lower-bound limit) of the elastic shear modulus, \(G^e_{min}\). The default internally calculated value is \(0.1 \times G^e_{ini}\), where \(G^e_{ini}\) is the initial \(G^e\) when the model is first time set up.

strain-shear-plastic f

[advanced] accumulated plastic shear strain, \(\gamma^p\). By default, it is initialized internally.

strain-tensile-plastic f

[advanced] accumulated plastic shear strain, \(e^{pt}\). The default initial value is 0.0.

strain-volumetric-plastic f

[advanced] accumulated plastic volumetric strain, \(e^p\). By default, it is initialized internally.

table-pressure-cap s

[advanced] name of the table relating cap pressure to plastic volume strain.

table-cohesion s

[advanced] name of the table relating cohesion to plastic shear strain.

table-dilation s

[advanced] name of the table relating mobilized dilation angle to plastic shear strain.

table-friction s

[advanced] name of the table relating mobilized friction angle to plastic shear strain.

table-tension s

[advanced] name of the table relating tensile strength to plastic tensile strain.

void-initial f

[advanced] initial void ratio, \(\hat{e}_{ini}\). The default is 1.0.

void-maximum f

[advanced] allowable maximum void ratio, \(\hat{e}_{max}\). The default is 999.0, a virtual value to bypass the dilatancy cut-off.

bulk f

[read only] current elastic bulk modulus

pressure-effective-cy f

[read only] mean effective stress, \(p\)

shear f

[read only] current elastic shear modulus

stress-deviatoric-cy f

[read only] deviatoric stress, \(q\)

void f

[read only] current void ratio, \(\hat{e}\)

young f

[read only] current elastic Young’s modulus, \(E\)

Notes:
  • The tension cut-off is \({\sigma}^t = min({\sigma}^t, c/\tan \phi)\).
  • One parameter between \(p_c\) and \(p_{ini}\) must be specified.
  • The void related parameters, \(\hat{e}_{ini}\) and \(\hat{e}_{max}\), are for dilatancy cut-off only. If dilatancy cut-off is not taken into account, these parameters are not required for input (default values are used).
  • The tension table and flag-brittle should not be active at the same time.

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.