UDMGINI2

UDMGINI2 allows you to define the onset of damage initiation in a unidirectional composite.

Damage initiation can be defined at the constituent level (fiber and matrix) or at the composite level. This routine is called at every equilibrium iteration for every integration point of the unidirectional composite material for which you requested a user damage initiation routine. Here is a template for the interface to UDMGINI2

Variables Provided for Information

HMAT

A handle to the current material. This is passed to informational routines (Informational Routines) to access information about the material.

HPROP

A handle to the current material properties. This is passed to informational routines (Informational Routines) to access information about the material properties.

NPROPS

The number of user properties requested. See User Properties.

PROPS

User properties. See User Properties.

STRAIN

The current total strain (mechanical and thermal) of the composite, matrix, and fiber. The first column (STRAIN(:,1)) contains the composite strain, and the second and third columns contain the matrix and fiber strains respectively. Strains are ordered as such: ε₁₁, ε₂₂, ε₃₃, γ_12, γ₁₃, γ₂₃. The strains are oriented in the fiber coordinate system (1 - axis parallel to the length of the fiber). The fiber direction specified in the material definition does not affect the orientation of the strains (and stresses).

STRESS

The current total stress state of the composite, matrix, and fiber. The values of this two-dimensional array are ordered in the same manner as the STRAIN array.

DELT

The current overall change in temperature attained thus far in the analysis.

IFAIL

The current state of failure. A value of one indicates no damage initiation in either constituent. A value of two indicates the matrix has initiated damage.

MSTATE

The current overall state of the material. This encompasses all forms of nonlinearity present in the current material model. This value should only be used to pass to informational routines to obtain more information about the material such as the current material properties.

Variables Updated by the User

FI

Failure indices. The first value (FI(1)) is the failure index of the matrix, and the second value is the failure index of the fiber. If either value equals or exceeds one, that constituent is determined to have initiated damage and will be degraded appropriately. If only the matrix constituent is failed this subroutine will still be called to predict damage initiation in the fiber. Once both constituents have failed, this subroutine will no longer be called.