# /ANIM/SHELL/IDPLY/DAMA

Engine Keyword Generates animation files containing damage values for shell elements that use ply based composite properties, /PROP/STACK (TYPE17), /PROP/TYPE51, or /PCOMPP. The damage value is the maximum of damage over time and of all failure criteria associated to the material.

## Format

/ANIM/SHELL/IDPLY/DAMA/`Keyword5`/`Keyword6`

## Definitions

## Comments

- Ply ID number is
`prop_ID`from /PROP/TYPE19 (PLY)/`prop_ID`or`ply_ID`from`/PLY`/`ply_ID`. - For fully integrated
BATOZ shells,
`I`_{shell}=12, the value output is the maximum value of the in-plane Gauss points for a particular through the thickness integration point. - This applies only to failure criteria defined with /FAIL keywords. Failure defined inside material laws (/MAT/GURSON) is currently not available.
- The
damage value, D is the maximum value of all failure criteria of the
model. The damage value which is displayed is the maximum damage value over
time.
In case of composite shell element property TYPE51, the damage value for one ply is computed as the maximum value over the all integration points of its ply.

(1) $$D(T)={\mathrm{max}}_{t\le T}\left(D(t)\right)$$ - The damage
value,
`D`is 0 ≤ D ≤ 1. The status for fracture is:Free, if 0 ≤ D < 1

Failure, if D = 1

`D`is computed for every failure criteria as follows:- Strain based failure (/FAIL/BIQUAD)
(2) $$D={\displaystyle \sum \frac{\text{\Delta}{\epsilon}_{p}}{{\epsilon}_{f}}}$$ - Johnson-Cook failure (/FAIL/JOHNSON)
(3) $$D=\sum \frac{\mathrm{\text{\Delta}}{\varepsilon}_{p}}{{\varepsilon}_{f}}$$ - Tuler-Butcher failure (/FAIL/TBUTCHER)
(4) $$D=\frac{{\underset{0}{\overset{t}{\int}}\left(\sigma -{\sigma}_{r}\right)}^{\lambda}dt}{K}$$ - Wilkins failure (/FAIL/WILKINS)
(5) $$D=\frac{{\displaystyle \int {W}_{1}{W}_{2}d{\epsilon}_{p}}}{{D}_{f}}$$ - FLD failure (/FAIL/FLD)
(6) $$D=\underset{time}{Max}\left(\frac{{\epsilon}_{major}}{{\epsilon}_{\mathrm{lim}}}\right)$$

Where,- ${\epsilon}_{\mathrm{lim}}$
- Strain limit from FLD function

- BAO-XUE-Wierzbicki failure (/FAIL/WIERZBICKI)
(7) $$D={\displaystyle \sum \frac{\text{\Delta}{\epsilon}_{p}}{{\overline{\epsilon}}_{f}}}$$ - Strain failure model (/FAIL/TENSSTRAIN)
(8) $$D=\underset{\mathit{time}}{\mathit{Max}}\left(\frac{{\varepsilon}_{1}-{\varepsilon}_{{t}_{1}}}{{\varepsilon}_{{t}_{2}}-{\varepsilon}_{{t}_{1}}}\right)$$ - Strain failure model (/FAIL/FABRIC)
(9) $$D=Max\left(\frac{{\epsilon}_{1}-{\epsilon}_{f1}}{{\epsilon}_{r1}-{\epsilon}_{f1}},\frac{{\epsilon}_{2}-{\epsilon}_{f2}}{{\epsilon}_{r2}-{\epsilon}_{f2}}\right)$$ - Energy density failure model (/FAIL/ENERGY):
(10) $$D=\underset{\mathit{time}}{\mathit{Max}}\left(\frac{E-{E}_{1}}{{E}_{2}-{E}_{1}}\right)$$ - Chang failure (/FAIL/CHANG)The maximum damage for different failure mode:
(11) $$D=\mathit{Max}\left({e}_{f}{}^{2},{e}_{c}{}^{2},{e}_{m}{}^{2},{e}_{d}{}^{2}\right)$$ - Hashin Composite failure (/FAIL/HASHIN)
The maximum damage for different failure mode

For uni-directional lamina model:(12) $$D=Max\left({F}_{1},{F}_{2},{F}_{3},{F}_{4},{F}_{5}\right)$$For fabric lamina model:(13) $$D=Max\left({F}_{1},{F}_{2},{F}_{3},{F}_{4},{F}_{5},{F}_{6},{F}_{7}\right)$$ - Puck Composite failure (/FAIL/PUCK) The maximum damage for different failure mode:
(14) $$D=\mathit{Max}\left({e}_{f}(\mathit{tensile}),{e}_{f}(\mathit{compression}),{e}_{f}(\mathit{ModeA}),{e}_{f}(\mathit{ModeB}),{e}_{f}(\mathit{ModeC})\right)$$ - Strain Failure Model with dependence on Lode angle (/FAIL/TAB1)
(15) $$D=\frac{\sum \mathrm{\text{\Delta}}D}{{D}_{crit}}$$ - NXT Failure Model (/FAIL/NXT)
(16) $$D=\frac{{\lambda}_{f}}{2}$$

- Strain based failure (/FAIL/BIQUAD)