Command manual

Command list


Material properties
Attention: This command is in the beta stage and the format may change over time.
"Optional title"
mid, $\rho$, $G$
$A_0$, $B_0$, $A_f$, $B_f$, $\epsilon_f$, $\sigma_s$, $t_s$, $\alpha_s$
$K_1$, $K_2$, $K_3$, $\beta$, $K_c$, $\sigma_0^{max}$, $\sigma_f^{max}$

Parameter definition

mid Unique material identification number
$\rho$ Density
$G$ Shear modulus
$A_0$ Yield surface parameter
$B_0$ Yield surface parameter
$A_f$ Failure surface parameter
$B_f$ Failure surface parameter
$\epsilon_f$ Volumetric crushing strain
$\sigma_s$ Spall strength
default: $A_0/2$
$t_s$ Time to develop spall fracture at threshold stress
$\alpha_s$ Exponent controlling time to develop spall fracture
$K_1$ Linear bulk stiffness term
$K_2$ Quadratic bulk stiffness term
$K_3$ Cubic bulk stiffness term
$\beta$ Parameter controlling the plastic flow direction at crushing. $\beta$ must be larger than 0 and can not exceed 1.
default: 1 $\rightarrow$ associated plastic flow
$K_c$ Fracture toughness
default: not used
$\sigma_0^{max}$ Shear strength cap of undamaged material
default: not used
$\sigma_f^{max}$ Shear strength cap of fully damaged material
default: not used


This is a ceramic model with different failure mechanisms in compression and tension. The material is assumed to have a pressure dependent shear resistance. At positive pressures, plastic flow is a combination of shearing and dilatation. Inelastic dilatation is interpreted as crushing that gradually reduces the shear resistance of the material. A brittle fracture criterion combined with node splitting is used on the tensile side. Note that node splitting can not occur in MERGE or REFINE interfaces.

For positive pressures the yield function $\Phi$ is defined as:

$\Phi = \sigma_{eff} - \sigma_0 \cdot (1-D_c) - \sigma_f \cdot D_c$


$\sigma_0 = \mathrm{min} (\sigma_0^{max}, A_0 + B_0 \cdot p)$
$\sigma_f = \mathrm{min} (\sigma_f^{max}, A_f + B_f \cdot p)$

Further, $\sigma_{eff}$ is the effective von Mises stress, $p$ is the pressure and $D_c$ is a crushing damage parameter ranging from 0 to 1. The inelastic flow direction is defined as:

$\dot \epsilon_{vol}^p = \beta \dot\lambda \displaystyle{ \frac{\partial \Phi}{\partial p} }$
$\dot \epsilon_{dev}^p = \dot\lambda \displaystyle{ \frac{\partial \Phi}{\partial \sigma_{eff}} }$

Here $\epsilon_{vol}^p$ is a volumetric crushing strain and $\epsilon_{dev}^p$ is a deviatoric inelastic shear strain. $0 \lt \beta \leq 1$ is controlling the amount of volumetric dilatation during plastic flow.

$D_c = \mathrm{min}(1, \displaystyle{ \frac{\epsilon_{dev}^p}{\epsilon_f} })$

In addition there is a brittle spall criterion. Cracks initiate once a spall damage parameter, $D_s$, has evolved from 0 to 1.

$\dot D_s = \left\{ \begin{array}{cc} \displaystyle{\frac{1}{t_s} \cdot ( \frac{\sigma_1}{\sigma_s (1 - D_c)(1 - D_0)} )^{\alpha_s}} & \sigma_1 \geq \sigma_s (1 - D_c) (1 - D_0)\\ 0 & \sigma_1 \lt \sigma_s (1 - D_c) (1 - D_0) \end{array} \right. $

where $\sigma_1$ is the maximum principal stress and $\sigma_s$ is the spall stress of undamaged material.

$D_0$ is an optional initial defect (damage) value that can be defined through INITIAL_DAMAGE_RANDOM or INITIAL_DAMAGE_SURFACE_RANDOM. Accounting for initial defects is essential for a physically realistic behavior of many brittle materials. It is generally more important when dealing with relatively small material volumes.

Crack propagation is optionally controlled by a stress intensity criterion. The stress intensity $K_I$ is estimated for the integration points surrounding the crack tip. The crack will propagate if $K_I > K_c$ (Modus I crack).

The pressure-volume relationship is cubic in compression:

$p = K_1 ( \mu + \epsilon_{vol}^p ) + K_2 \mu^2 + K_3 \mu^3 \;\;\; \mu > 0$

and linear in tension:

$p = K_1 ( \mu + \epsilon_{vol}^p ) \;\;\; \mu \lt 0$


$\mu = \rho/\rho_0 - 1$
Yield stress as a function of pressure and damage
Yield stress as a function of pressure and damage