# Definition

Denote the so-called "tensile strength" of the material by $$T$$$. It may be constant, or governed by a Hardening or Softening law. The yield function is f = \mbox{max}(\sigma_{I},\ \sigma_{II},\ \sigma_{III}) - T \ . Here $$\sigma_{I}$$$, $$\sigma_{II}$$$and $$\sigma_{III}$$$ are the principal stresses (the eigenvalues of $$\sigma$$$). Therefore this type of plasticity models situations where the material fails under tensile load. This plasticity is associative, so the flow potential is r_{ij} = \frac{\partial f}{\partial \sigma_{ij}} \ . The hardening law is defined through h = -1 \ . so that $$q=q_{\mathrm{old}}+\gamma$$$, so that $$q$$$is the accumulated sum of $$\gamma$$$ over all "time steps".

# Geometrical description and some useful identities

In principal stress space, the yield surface is a "triangular pyramid". Sometimes this is called a "triangular cone", or simply a "cone" in the literature, since many other types of yield functions also map out conical-like regions of admissible stress space.

Tensile yield surface is a triangular pyramid in principal stress space. The admissible region is shaded. The principal stresses, $$\sigma_{I}$$$, $$\sigma_{II}$$$ and $$\sigma_{III}$$$are labelled as sI, sII and sIII in this figure. The tensile yield surface in principal stress space, with $$\sigma_{m}$$$ (labelled as sM), $$\bar{\sigma}$$$(labelled as sBar), and the octahedral plane marked. The principal stresses, $$\sigma_{I}$$$, $$\sigma_{II}$$$and $$\sigma_{III}$$$ are labelled as sI, sII and sIII.

The tensile yield surface on the octahedral plane (with $$\sigma_{m}$$$constant) and the meridional plane (with Lode angle $$\theta$$$ constant). Also shown is the smoothing described below. The invariants are $$\sigma_{m}$$$(labelled as sM), $$\bar{\sigma}$$$ (labelled as sBar), and the Lode angle, $$\theta$$$is labelled as th. The triangular pyramid is shown in the first Figure, where the shaded region shows the admissible region. In that figure the principal stresses are labelled sI, sII and sIII. These stresses form an orthogonal basis. Another frequently-used basis involves the three stress invariants, which form a cylindrical-like basis in stress space, and is shown in the second Figure. The "mean stress" $$\sigma_{m} = \frac{1}{3}\mbox{Tr}\,\sigma$$$, (labelled as sM in the figure) is the axial direction. The "deviatoric shear stress", $$\bar{\sigma} = \sqrt{\frac{1}{2}s_{ij}s_{ij}}$$$, where the "deviatoric stress" $$s_{ij} = \sigma_{ij} - \sigma_{m}\delta_{ij}$$$, measures along the radial direction, and is labelled sBar in the Figure. Finally, the "Lode angle" is an angular coordinate, $$\theta$$$defined by $$\sin 3\theta = -\frac{3\sqrt{3}J_{3}}{2\bar{\sigma}^{3}}$$$ with $$J_{3} = \mbox{det}s$$$, and $$-\pi/6 \leq \theta \leq \pi/6$$$. These final bounds mean that only the region $$\sigma_{I} \geq \sigma_{II} \geq \sigma_{III}$$$is being considered, but the other regions are clearly related. There are two commonly-used planes related to this latter basis. The "octahedral plane" has $$\sigma_{m}$$$ constant. The "meridional plane" has $$\theta$$$constant. The tensile yield surface is shown on these planes in the third Figure. On the octahedral plane, the yield surface appears as a triangle, with vertices at $$\theta = 30$$$deg. The smoothing described below, smooths these vertices (which are edges of the triangular pyramid). On the meridional plane the yield surface appears as a line with slope dependent on $$\theta$$$, and the triangular pyramid has its tip at $$\sigma_{m}=T$$$. The smoothing described below rounds this tip.

Finally, there are some useful identities relating these two bases. From now on, assume that the principal stresses are ordered in descending order, that is \sigma_{I} \geq \sigma_{II} \geq \sigma_{III} \ . The formulae presented below only hold for this ordering \begin{array}{rcl} \sigma_{m} & = & \frac{1}{3}(\sigma_{I} + \sigma_{II} + \sigma_{III}) \\ \sigma_{I} & = & \frac{2}{\sqrt{3}}\bar{\sigma}\sin\left(\theta + \frac{2\pi}{3}\right) + \sigma_{m} \\ \sigma_{II} & = & \frac{2}{\sqrt{3}}\bar{\sigma}\sin\theta + \sigma_{m} \\ \sigma_{III} & = & \frac{2}{\sqrt{3}}\bar{\sigma}\sin\left(\theta - \frac{2\pi}{3}\right) + \sigma_{m} \\ \sigma_{I} - \sigma_{m} & = & \bar{\sigma}\left(\cos\theta - \frac{1}{\sqrt{3}}\sin\theta\right) \\ \end{array}

# Smoothing the yield surface

### Smoothing the pyramid's edges

The edges of the pyramid also need smoothing. This is achieved in MOOSE using a technique described in AJ Abbo, AV Lyamin, SW Sloan, JP Hambleton "A C2 continuous approximation to the Mohr-Coulomb yield surface" International Journal of Solids and Structures 48 (2011) 3001-3010. The function $$K$$$mentioned above is replaced with K(\theta) = \left\{ \begin{array}{ll} A + B\sin 3\theta + C \sin^{2}3\theta & \ \ \mbox{for}\ \ \theta > \theta_{T} \\ \cos\theta - \frac{1}{\sqrt{3}}\sin\theta & \ \ \mbox{otherwise} \end{array} \right. Here $$0 \leq \theta_{T} \leq \pi/6$$$ is a user-input value determining where on the octahedral plane the smoothing should start. This formulation is slightly different than the version in the aforementioned reference which has $$|\theta|>\theta_{T}$$$, since the smoothing is not needed for $$\theta < -\theta_{T}$$$. The constants $$A$$$, $$B$$$ and $$C$$$depend on $$\theta_{T}$$$ alone and are rather lengthy: they are written in Equations (15), (16) and (17) of the aforementioned reference.

# The test suite

1. small_deform_1. A single unit element is stretched in the $$z$$$direction only, and the stress is observed to return to $$\sigma_{zz} = T$$$. No smoothing of the pyramid's tip is necessary ($$\epsilon = 0$$$), and edge smoothing is also not needed, since the return occurs along the direction $$\sigma_{II} = \sigma_{III} = 0$$$. This tests that the stress returns to the correct point in the most basic of situations.

2. small_deform_2. A single unit element is stretched in all directions. In this case smoothing of the pyramid's tip must be used. The parameters chosen are $$T=1$$$and $$\epsilon = 0.5$$$. The stress returns to the yield surface correctly at point $$\sigma_{xx} = \sigma_{yy} = \sigma_{zz} = T - \epsilon$$$. This checks that the stress returns to the pyramid's "tip" (which is rounded) correctly. 3. small_deform_3. A single element is stretched by some amount $$E$$$ in the $$z$$$and $$x$$$ directions. This causes the return direction to be along the hyper surface $$\sigma_{I} = \sigma_{II}$$$. This checks that the stress returns to the pyramid's edge (which is rounded) correctly. The tensile strength is set to $$T=1$$$, the tip smoothing is unnecessary ($$\epsilon=0$$$), and the edge smoothing parameter is $$\theta_{T} = 25$$$degrees. This latter choice means Abbo et al's $$A + B + C = 0.609965$$$. The trial stress has $$\sigma_{zz}^{\mathrm{trial}} = \sigma_{xx}^{\mathrm{trial}}$$$, so that $$\sigma_{m}^{\mathrm{trial}} = 2\sigma_{zz}^{\mathrm{trial}}/3$$$and $$\bar{\sigma}^{\mathrm{trial}} = \sigma_{zz}^{\mathrm{trial}}/\sqrt{3}$$$. If this were on the yield surface then $$(2/3)\sigma_{zz}^{\mathrm{trial}} + K\sigma_{zz}^{\mathrm{trial}}/\sqrt{3} - 1 = 0$$$, meaning $$\sigma_{zz}^{\mathrm{trial}} = 0.9815$$$. The applied deformation, $$E$$$is chosen to marginally exceed this stress, and the return-map algorithm returns to the correct point on the yield surface. 4. small_deform_4. Similar to small_deform_3, but with a larger deformation, showing that the stress returns to the pyramid's "edge" correctly. 5. small_deform_5. Repeated stretches are applied to a single unit element in the $$z$$$ and $$x$$$directions. The return always occurs along the direction $$\sigma_{I} = \sigma_{II}$$$, so edge smoothing is necessary. The repeated stretches allows the yield surface to be mapped out in the meridional plane for Lode angle $$\theta = 30$$$degrees. The result agrees perfectly with expectations, as shown in the Figure below. 6. small_deform_6. Repeated stretches are applied to a single unit element in the $$z$$$ direction only. The return always occurs along the direction $$\sigma_{II} = \sigma_{III}$$$, so edge smoothing is irrelevant. The repeated stretches allow the yield surface to be mapped out in the meridional plane for Lode angle $$\theta = -30$$$degrees. The result agrees perfectly with expectations, as shown in the Figure below.

7. small_deform_7. Similar to small_deform_6, but with 'cap' smoothing. The result agrees perfectly with expectations, as shown in the Figure below.

8. many_deforms.i This performs 1000 random large deformations of a unit element and checks that the stress returns to the yield surface each time.

9. small_deform_hard1. This checks the internal-parameter evolution in the case of hardening/softening. A single element is stretched with strain \epsilon_{zz} = t/10^{6} \ , The Young's modulus is chosen to be 20 MPa, initial tensile strength $$T=10$$$Pa, tensile residual=10Pa, tensile strength rate=0. Then the trial stress will be \sigma^{\mathrm{trial}}_{zz} = 20\,\mbox{Pa} \ . This stress is inadmissible, so it must return to $$\sigma_{zz} = T = 10\,\mbox{Pa}$$$. Moose produces the correct answer.

10. small_deform_hard2. A single element is stretched in x and z directions with strain \epsilon_{zz} = t/10^{6} \ , The Young's modulus is chosen to be 20 MPa, initial tensile strength $$T=10$$$Pa, tensile residual=10Pa, tensile strength rate=1e6. Then the trial stress will be \sigma^{\mathrm{trial}}_{xx} = \sigma^{\mathrm{trial}}_{zz} = 20\,\mbox{Pa} \ . Therefore, the trial stress is inadmissible, and the following equations must be solved The trial stress has $$\sigma_{zz}^{\mathrm{trial}} = \sigma_{xx}^{\mathrm{trial}}$$$, so that $$\sigma_{m}^{\mathrm{trial}} = 2\sigma_{zz}^{\mathrm{trial}}/3$$$and $$\bar{\sigma}^{\mathrm{trial}} = \sigma_{zz}^{\mathrm{trial}}/\sqrt{3}$$$. If this were on the yield surface then $$(2/3)\sigma_{zz}^{\mathrm{trial}} + K\sigma_{zz}^{\mathrm{trial}}/\sqrt{3} - 1 = 0$$$, meaning $$\sigma_{zz}^{\mathrm{trial}} = 0.9815$$$.

11. small_deform_hard3. Repeated stretches are made in the $$z$$$direction to a single unit element. Cubic hardening is used with $$T_{0}=1$$$, $$T_{\mathrm{res}}=0.5$$$, and $$l_{T}=0.00001$$$. The result is as expected, and shown in the figure below.

Agreement between the MOOSE implementation and the expected result for the yield surface plotted on the meridional plane

Cubic softening of the tensile strength

Cap smoothing of the yield function