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$, $E$
$\eta$, cid${}_{fe}$, cid${}_{fv}$, $c_{dec}$, $\sigma_{cut}$, $\gamma$

Parameter definition

mid Unique material identification number
$\rho$ Density
$E$ Young's modulus of fully compacted foam
$\eta$ Initial porosity (between 0 and 1)
cid${}_{fe}$ ID of elastic compaction stress curve ($f^e$)
cid${}_{fv}$ ID of viscous stress curve ($f^v$)
$c_{dec}$ Viscous decay parameter
$\sigma_{cut}$ Tensile cut-off stress
$\gamma$ Hysteresis parameter


This is a model for visco-elastic foams. The elastic response is based on a formulation using the right stretch tensor $\mathbf{U}$ and its principal stretches $(\lambda_1, \lambda_2, \lambda_3)$.

$\displaystyle{ \mathbf{U} = \sum_{i=1}^3 \lambda_i \mathbf{v}_i \otimes \mathbf{v}_i}$

The total stress $\mathbf{\sigma}$ is the sum of an elastic and a viscous component.

$\displaystyle{ \mathbf{\sigma} = \left( \frac{J_{min}}{J} \right)^{\gamma} \left( \mathbf{\sigma}^e + \mathbf{\sigma}^v \right) = \left( \frac{J_{min}}{J} \right)^{\gamma} \left( \sum_{i=1}^3 \sigma_i^e \mathbf{v}_i \otimes \mathbf{v}_i + \sigma^v \right) }$

Note that the principal elastic stresses $(\sigma_1^e, \sigma_2^e, \sigma_3^e)$ coincide with the principal stretches of $\mathbf{U}$.

$J_{min}/J$ is the ratio between the smallest relative volume during the process and the current relative volume. That is, $J = \mathrm{det}\mathbf{F}$, where $\mathbf{F}$ is the deformation gradient.

The magnitude of the elastic stresses is defined from Young's modulus $E$, the initial porosity $\eta$ and from the compaction stress curve $f^e$. $f^e$ is basically a CURVE defining quasi-static compaction stress versus uni-axial (engineering) strain.

$\displaystyle{ \sigma_i^e = \left\{ \begin{array}{lcl} -\mathrm{min} \left( E \eta_i, f^e(\eta_i) \right) & : & \eta_i \leq \eta \\ -\mathrm{min} \left( E \eta_i, f^e(\eta) + E (\eta_i - \eta) \right) & : & \eta_i \gt \eta \end{array} \right. }$

$\eta_i$ a measure of the compaction in principal direction $i$.

$\displaystyle{ \eta_i = \frac{\eta (1 - \lambda_i)}{\eta + \frac{1}{\lambda_j \lambda_k} - 1} }$

where $(i,j,k) = (1,2,3), (2,3,1)$ or $(3,1,2)$. Note that there is a coupling between the different directions. Hence, a compaction in directions $j$ and $k$ $(\lambda_j \lambda_k \lt 1)$ will decrease the porosity and, hence, reduce the room for compaction in direction $i$.

In uni-axial compression $\eta_i = 1 - \lambda_i$.

The viscous stress tensor is defined as:

$\displaystyle{ \mathbf{\sigma}^v(t) = \frac{1}{c_{dec}} \int_0^t f^v(\dot{\mathbf{\epsilon}}) \frac{\dot{\mathbf{\epsilon}}}{\vert \dot{\mathbf{\epsilon}}\vert} e^{(\tau-t)/c_{dec}} \mathrm{d}\tau }$

$f^v$ is a CURVE of effective viscous stress versus effective strain rate.


Quasi-static compression of foam

An example showing how compression in one principal direction affects the compression resistance in another direction.

dens = 150.0, "density"
E = 1.0e8, "Youngs modulus"
eta = 0.7, "initial porosity"
1, [%dens], [%E]
[%eta], 99
"stress-compaction curve"
0.0, 0.0
0.01, 1.0e5
0.015, 1.3e5
0.02, 1.5e5
0.025, 1.6e5
0.5, 2.6e5
0.6, 3.7e5
0.65, 7.8e5
0.7, 2.2e6
z-stress versus z-compaction
z-stress versus z-compaction