materialbehaviors

Unless otherwise specified, data names are accessible in level 3 only.

A
The material parameter a in S-N fatigue equation.
Type: double
A1
The components of vector a for AOPT = 2.
Type: double
a1
First exponent in failure model.
Type: double
A2
The components of vector a for AOPT = 2.
Type: double
a2
Second exponent in failure model.
Type: double
A3
The components of vector a for AOPT = 2.
Type: double
a3
Third exponent in failure model.
Type: double
a4
Fourth exponent in failure model.
Type: double
Ai
The material parameter a in S-N fatigue equation for the i-th segment.
Type: double array
activesuppressed
Returns non-zero if the entity is set inactive, 0 otherwise.
Type: integer
ADD_option
The flag for *DEFINE_CONNECTION_PROPERTIES_ADD reference.
Type: Boolean
afailb
Ultimate bending strength in failure model.
Type: double
afailn
Ultimate tensile strength in failure mode.
Type: double
afails
Ultimate shear strength in failure model.
Type: double
afailt
Ultimate torsion strength in failure model.
Type: double
alpha
EWK pressure exponent.
Type: double
AOPT
The material axes option for *MAT_ADD_PZELECTRIC.
0.0 – Locally orthotropic with material axes determined by element nodes 1, 2, and 4, as with *DEFINE_COORDINATE_NODE.
1.0 – Locally orthotropic with material axes determined by a point in space and the global location of the element center; this is the a-direction. This option is for solid elements only.
2.0 - Globally orthotropic with material axes determined by vectors, as with *DEFINE_COORDINATE_VECTOR.
The material axes option for *MAT_ADD_INELASTICITY.
0.0 - locally orthotropic with material axes determined by element nodes.
1.0 - locally orthotropic with material axes determined by a point in space and the global location of the element center.
2.0 - globally orthotropic with material axes determined by vectors defined below.
3.0 - locally orthotropic material axes determined by rotating the material axes about the element normal by an angle.
4.0 - locally orthotropic in cylindrical coordinate system with the material axes determined by a vector and an originating point defining the centerline axis.
5.0 - "LT 0.0 the absolute value of AOPT is a coordinate system ID.
Type: double
AOPT_SYSTEM
The absolute value of AOPT is a coordinate system ID.
Type: entity
AREAEQ
The area equation number for the connection area calculation.
0 - Area_true = Area_modeled (default)
1 - Millimeter form
-1 - Meter form
Type: integer
ArrayCount
The s-N Curve Segment Cards. Include one card for each additional S-N curve segment.
Type: integer
ascalf
Scaling factor exponent.
Type: double
attributesmax
The number of attributes owned by this entity.
Type: unsigned integer
B
The material parameter b in S-N fatigue equation.
Type: double
BETA
The material angle in degrees for AOPT = 0 and AOPT = 3.
Type: double
beta
EWK asymmetric exponent.
Type: double
Bi
The material parameter b in S-N fatigue equation for the i-th segment.
Type: double array
BIAXF
The reduction factor for regularization for biaxial stress states.
Type: double
BIAXF_array
The reduction factors for regularization at triaxiality = 2/3 (biaxial).
Type: double array
BP
The fatigue strength exponent (Basquin's exponent).
Type: double
CDARCY
The coefficient of Darcy's law.
Type: double
CDF
The coefficient of Dupuit-Forchheimer law.
Type: double
color
The 1-64 color of the entity.
Type: integer
color_rgb
The RGB color of the entity.
Type: string
CON_ID
The connector ID referenced on *MAT_SPOTWELD_DAIMLERCHRYSLER.
Type: entity
Config
The configuration of the entity.
101 - LS-DYNA Failure
102 – LS-DYNA Permeability
103 – LS-DYNA Thermal
104 – LS-DYNA Porosity
105 – LS-DYNA Cohesive
106 – LS-DYNA Fatigue
107 – LS-DYNA Electricity
108 – LS-DYNA Chemical_shrinkage
109 – LS-DYNA Inelasticity
110 – LS-DYNA Dependence
111 – LS-DYNA Connection_property
401 – PAM-CRASH FAILURE
Type: unsigned integer
CP
The fatigue ductility exponent (Coffin-Manson exponent).
Type: double
D1
The components of vector d for AOPT = 2.
Type: double
d1
Energy absorption distance after failure is initiated.
Type: double
D2
The components of vector d for AOPT = 2.
Type: double
d2
Ultimate distance at complete failure.
Type: double
D11
The ID of the curve for damage tensor coefficients.
Type: entity
D12
The ID of the curve for damage tensor coefficients.
Type: entity
D14_13
The ID of the curve for damage tensor coefficients.
Type: entity
D21
The ID of the curve for damage tensor coefficients.
Type: entity
D22
The ID of the curve for damage tensor coefficients.
Type: entity
D24_23
The ID of the curve for damage tensor coefficients.
Type: entity
D3
The components of vector d for AOPT = 2.
Type: double
D33
The ID of the curve for damage tensor coefficients.
Type: entity
D41_31
The ID of the curve for damage tensor coefficients.
Type: entity
D42_32
The ID of the curve for damage tensor coefficients.
Type: entity
D44
The ID of the curve for damage tensor coefficients.
Type: entity
D55
The ID of the curve for damage tensor coefficients.
Type: entity
D66
The ID of the curve for damage tensor coefficients.
Type: entity
dc
EWK critical damage.
Type: double
DCRIT
The damage threshold value (critical damage).
Type: double
DCRIT_array
The damage threshold value (critical damage).
Type: double array
DCTYP
The damage composition option for multiple criteria.
-1.0 - Damage not coupled to stress
0.0 - Maximum
1.0 - Multiplicative
Type: double array
DDGPR
The default damage parameter for hyperbolic based damage function.
Type: double
DDGPR_Funct
The curve ID defining the default hyperbolic based damage function.
Type: entity
definedentity
True if the entity is defined, false otherwise.
Type: Boolean
DEPS
The plastic strain increment between evaluation of damage instability and evolution criteria.
Type: double
DETAN
The default tangent modulus for the spot weld element.
Type: double
DETAN_Funct
The curve ID defining the default tangent modulus function for the spot weld element.
Type: entity
DETYP
The damage evolution type.
0.0 - Linear softening, evolution of damage is a function of the plastic displacement after the initiation of damage.
1.0 - Linear softening, evolution of damage is a function of the fracture energy after the initiation of damage.
Type: double array
DEXSB
The default exponent on bending stress term.
Type: double
DEXSB_Funct
The curve ID defining the default function on bending stress term.
Type: entity
DEXSN
The default exponent on normal stress term.
Type: double
DEXSN_Funct
The curve ID defining the default function on normal stress term.
Type: entity
DEXSS
The default exponent on shear stress term.
Type: double
DEXSS_Funct
The curve ID defining the default function on shear stress term.
Type: entity
DGFAD
The default fading energy for damage type 3 and type 4.
Type: double
DGFAD_Funct
The curve ID defining the default fading energy function for damage type 3 and type 4.
Type: entity
DGPR
The damage parameter for hyperbolic based damage function.
Type: double array
DGTYP
The damage type.
0 - No damage function is used
1 - Strain based damage
2 - Failure function based damage
3 - Fading energy based damage
4 - Fading energy based damage
Type: integer
DINIT
The damage initialization option.
0.0 - No action is taken.
1.0 - Damage history is initiated based on values of initial plastic strains and initial strain tensor. This is to be used in multistage analyses.
Type: double
DITYP
The damage initiation type.
0.0 - Ductile based on stress triaxiality
1.0 - Shear
2.0 - MSFLD
3.0 - FLD
4.0 - Ductile based on normalized principal stress
Type: double array
DLCSB
The default curve ID for bending strength scale factor as a function of strain rate.
Type: entity
DLCSN
The default curve ID for normal strength scale factor as a function of strain rate.
Type: entity
DLCSS
The default curve ID for shear strength scale factor as a function of strain rate.
Type: entity
dmgelim
EWK maximum damage for element elimination.
Type: double
DMGEXP
The exponent for nonlinear damage accumulation.
Type: double
DMGEXP_array
The exponent for nonlinear damage accumulation.
Type: double array
DMGTYP
The GISSMO damage type the following applies. DMGTYP is interpreted digit-wise as follows:
DMGTYP = [𝑁𝑀] = 𝑀 + 10 × 𝑁
M.EQ.0: Damage is accumulated, no coupling to flow stress, no failure.
M.EQ.1: Damage is accumulated, element failure occurs for 𝐷 = 1. Coupling of damage to flow stress depending on parameters, see remarks below.
N.EQ.0: Equivalent plastic strain is the driving quantity for the damage.
N.GT.0: The Nth additional history variable is the driving quantity for damage.
For IDAM.LT.0 the following applies:
EQ.0: No action is taken.
EQ.1: Damage history is initiated based on values of initial plastic strains and initial strain tensor, this is to be used in multistage analyses.
Type: double
DRANK
The default rank value.
Type: double
DSB
The default bending strength.
Type: double
DSB_Funct
The curve ID defining the default bending strength function.
Type: entity
DSCLMRR
The default scaling factor for torsional moment in failure function.
Type: double
DSIGY
The default yield stress for the spot weld element.
Type: double
DSIGY_Curve
The curve ID defining the default yield stress function for the spot weld element.
Type: entity
DSN
The default normal strength.
Type: double
DSN_Funct
The curve ID defining the default normal strength function.
Type: entity
DSS
The default shear strength.
Type: double
DSS_Funct
The default shear strength.
Type: entity
DTEFLT
The time period (or inverse of the cutoff frequency) for the lowpass filter applied to the effective strain rate when MXEPS is negative.
Type: double
DTMIN
The minimum time step size at failure.
Type: double
DTYP
The flag for damage behavior for *MAT_ADD_GENERALIZED_DAMAGE.
0: - Damage is accumulated, no coupling to flow stress, no failure
1: - Damage is accumulated, element failure occurs for D = 1
DTYP is interpreted digit-wise as follows: DTYP= [N M] = M + 10 x N]
for *MAT_ADD_DAMAGE_GISSMO
Type: integer
DTYPE
The type of piezoelectric property definition.
S – Stress based definition
E – Strain based definition
Type: string
DXX
The dielectric permittivity matrix.
Type: double
DXY
The dielectric permittivity matrix.
Type: double
DXZ
The dielectric permittivity matrix.
Type: double
DYY
The dielectric permittivity matrix.
Type: double
DYZ
The dielectric permittivity matrix.
Type: double
DZZ
The dielectric permittivity matrix.
Type: double
E
Young's modulus.
Type: integer
ECRIT
LT.0.0: |ECRIT| is either a load curve ID defining critical equivalent plastic strain versus triaxiality or a table ID defining critical equivalent plastic strain as a function
EQ.0.0: Fixed value DCRIT defining critical damage is read
GT.0.0: Fixed value for stress-state independent critical equivalent plastic strain
Type: double
ECRIT_array
The critical history value (material instability).
Type: double array
ECRIT_CURVE
The critical plastic strain (material instability). |ECRIT| is either a load curve ID defining critical equivalent plastic strain versus triaxiality or a table ID defining critical equivalent plastic strain as a function of triaxiality and Lode parameter (as in LCSDG).
Type: entity
ECRIT_CURVE_array
|ECRIT| is a load curve ID defining critical history value vs. triaxiality.
Type: entity array
EFFEPS
The maximum effective strain at failure, epsilon_eff.
Type: double
ELA
The effective leakage area for blocked fabric.
Type: double
ELA_curve
|ELA| is the load curve ID of the curve defining ELA as a function of time.
Type: entity
ELAOpt
The ELA Option.
Type: Boolean
EN_option
The EN option.
Type: Boolean
enercrid
Critical strain energy density.
Type: double
ENGCRT
The critical energy for nonlocal failure criterion.
Type: double
entities
Element Entities Selection by Keywords.
Type: entity
epsin
EWK necking plastic strain.
Type: double
EPSP
The fatigue ductility coefficient.
Type: double
EPSSH
The tensorial shear strain at failure, gamma_max / 2.
Type: double
EPSTHIN
The thinning strain at failure for thin and thick shells. GT.0.0: Individual thinning for each integration point from z-strain. LT.0.0: Averaged thinning strain from element thickness change.
Type: double
ETAN
The tangent modulus to be used in the spot weld element calculation.
Type: double array
EXCL
The exclusion number.
Type: double
EXSB
The exponent on bending stress term.
Type: double array
EXSN
The exponent on normal stress term.
Type: double array
EXSS
The exponent on shear stress term.
Type: double array
FAC
The optional fabric characteristic parameter.
Type: double
FAC_curve
If X0 = 0 and FVOPT LT 7: |FAC| is the load curve ID of the curve defining FAC as a function of absolute pressure. X0 = 1 and FVOPT LT 7: |FAC| is the load curve ID defining FAC as a function of the pressure ratio defined as rp = Pair/Pbag. If FVOPT GE 7: FAC defines leakage volume flux rate as a function of absolute pressure.
Type: entity
FACOpt
The FAC option.
Type: Boolean
FADEXP
The exponent for damage-related stress fadeout. Constant fading exponent.
Type: double
FADEXP_array
The exponent for damage-related stress fadeout. Constant fading exponent.
Type: double array
FADEXP_CURVE
The exponent for damage-related stress fadeout. |FADEXP| is load curve ID defining element-size dependent fading exponent.
Type: entity
FADEXP_CURVE_array
|FADEXP| is load curve ID defining element-size dependent fading exponent.
Type: entity array
faild
The failure duration.
Type: double
failt
The failure time.
Type: double
FAILTM
The failure time. GT.0: Failure time is active during any phase of the analysis. LT.0: Failure time is set to |FAILTM|. This criterion in inactive during the dynamic relaxation phase.
Type: double
filter
Failure criterion time window type.
0 - CYCLE (default)
1 - TIME (only used for rupture model types 0,1,2,5,7)
Type: unsigned integer
flagforIDAM_DIEM
The IDAM flag for DIEM.
Type: Boolean
flagforQ1
The flag for Q1.
0 – Real
1 - Curve
Type: integer array
FLC
The optional fabric porous leakage flow coefficient.
Type: double
FLC_curve
If X0 = 0: |FLC| is the load curve ID of the curve defining FLC as a function of time. If X0 = 1: |FLC| is the load curve ID defining FLC as a function of the stretching ratio defined as rs = A/A0.
Type: entity
FLCOpt
The FLC option.
Type: Boolean
FVOPT
The fabric venting option.
1.0 - Wang-Nefske formulas for venting through an orifice are used. Blockage is not considered.
2.0 - Wang-Nefske formulas for venting through an orifice are used. Blockage of venting area due to contact is considered.
3.0 - Leakage formulas of Graefe, Krummheuer, and Siejak [1990] are used. Blockage is not considered.
4.0 - Leakage formulas of Graefe, Krummheuer, and Siejak [1990] are used. Blockage of venting area due to contact is considered.
5.0 - Leakage formulas based on flow through a porous media are used. Blockage is not considered.
6.0 - Leakage formulas based on flow through a porous media are used. Blockage of venting area due to contact is considered.
7.0 - Leakage is based on gas volume outflow versus pressure load curve [Lian, 2000]. Blockage is not considered.
8.0 - Leakage is based on gas volume outflow versus pressure load curve [Lian, 2000]. Blockage of venting or porous area due to contact is considered.
Type: double
GFAD
The fading energy for damage type 3 and 4.
Type: double array
GPT
The number of Gauss points used for integration.
0.0 – Default value 8
1.0 – One point quadrature
Type: double
HIS1
The choice of variable as driving quantity for damage, called 'history value’.
Type: integer
HIS1_CURVE
The ID of the curve defining the damage driving quantities as a function of the components of the plastic strain rate tensor, IFLG1 should be set to 1.
Type: entity
HIS2
The choice of variable as driving quantity for damage, called 'history value'.
Type: integer
HIS2_CURVE
The ID of the curve defining the damage driving quantities as a function of the components of the plastic strain rate tensor, IFLG2 should be set to 1.
Type: entity
HIS3
The choice of variable as driving quantity for damage, called 'history value'.
Type: integer
HIS3_CURVE
The ID of the curve defining the damage driving quantities as a function of the components of the plastic strain rate tensor, IFLG3 should be set to 1.
Type: entity
HISVN
The history variable used to evaluate the 3-D table LCSDG.
GT.0.0: Constant value.
LT.0.0: The constant value found at position |HISVN| where |HISVN| is the location in the history array of *INITIAL_STRESS_ SHELL/SOLID.
Type: double
id
The ID of the entity.
Type: unsigned integer
IDAM
The flag for damage model.
0 – No damage model is used.
1 - Damage models GISSMO or DIEM.
Type: integer
IDAM_DIEM
The flag for damage model.
LT.0: Damage models DIEM.
Type: integer
IDAM_size
The size of IDAM.
Type: integer
IFLG1
The damage driving quantities.
0 – Rates of history variables HISn.
1 - Specific components of the plastic strain rate tensor, see remarks for details.
2 - Predefined functions of plastic strain rate components for orthotropic damage model, HISn inputs will be ignored, IFLG2 should be set to 1. This option is for shell elements only.
Type: integer
IFLG2
The damage strain coordinate system.
0 – Local element system (shells) or global system (solids).
1 - Material system, only applicable for non-isotropic material models.
2 - Principal strain system (rotating).
3 – Principal strain system (fixed when instability/coupling starts).
Type: integer
IFLG3
The erosion criteria and damage coupling system.
0 – Erosion occurs when one of the damage parameters computer reaches unity, the damage tensor components are based on the individual damage parameters d1 to d3.
1 - Erosion occurs when a single damage parameter D reaches unity, the damage tensor components are based on this single damage parameter.
Type: integer
ifmon
Monitoring option.
0 - monitoring not activated (default)
1 - monitoring rupture criterion without rupture. Used only with material types 223, 224 and 302
Type: unsigned integer
ifrcdir
The flag to define the normal direction used for failure evaluation of the MPC-PLINK during the computation.
0 or 1 - The normal direction is the one of the lines connecting the two nodes of the spring beam element during the computation (default)
2 - The normal direction is the one of the lines connecting the two nodes of the spring-beam element during the initialization phase, and updated during the computation according to the mean rotation of the two MPCs
Type: unsigned integer
IMPULSE
The stress impulse for failure, Kf.
Type: double
include
The ID of the include file the entity is organized in.
Type: entity
includeid
The ID of the include file the entity is organized in.
Type: unsigned integer
internalid
The ID of the entity.
Type: unsigned integer
internalname
The internal name of the entity.
Type: string
intf1
Failure criterion time window in number of cycles.
Type: integer
intf2
INTF is the failure criterion time window period.
Type: integer
INTFAIL
The number of integration points required for the cohesive element to be deleted.
Type: double
irupopt
Rupture model type number.
0: uses loads criterion.
1: uses stress criterion. Used for SLINK, ELINK and TIED Interface with material types 301, 305, 307 and 371
2: user-defined rupture criterion. Used only for PLINKs
3: user-defined rupture criterion. Used only for spring-beams with material type 223 or 224
5: uses loads criterion: normal, shear, torsion and bending loads. Used with material types 223 and 224
6: EWK rupture criterion. Used for elastic-plastic shell materials - only material type 117 at the moment
7: uses loads criterion: normal, shear, torsion and bending loads. Used with material types 212, 213, 223 and 224
11: user-defined rupture criterion. Used only with material types 223, 224 and 302
12: user-defined rupture criterion. Used only with material types 223, 224 and 302
13: user-defined rupture criterion. Used only with material types 223, 224 and 302
15: user-defined plug-in. Used only with material types 223, 224 and 302
Type: unsigned integer
KP
The cyclic strain hardening coefficient.
Type: double
LAW
The inelasticity law.
Type: integer array
LCDLIM
The load curve ID defining damage limit values as a function of triaxiality.
Type: entity
LCDLIM_array
The load curve ID defining damage limit values as a function of triaxiality.
Type: entity array
LCEPS12
The load curve ID defining in-plane shear strain limit gamma12^c as a function of element size.
Type: entity
LCEPS13
The load curve ID defining through-thickness shear strain limit gamma13^c as a function of element size.
Type: entity
LCEPSMX
The load curve ID defining in-plane major strain limit epsilon1^c as a function of element size.
Type: entity
LCFLD
The load curve ID or Table ID. Load curve defines the Forming Limit Diagram. Table defines for each strain rate (LCFLD > 0) or for each shell thickness (LCFLD < 0) an associated FLD curve.
Type: entity
LCID
The load curve ID defining the thermal expansion coefficient (for isotropic material models) as a function of temperature or (for anisotropic material models) in the local material a-direction for *MAT_ADD_THERMAL_EXPANSION.
Load curve ID defining the SOC expansion coefficient (for isotropic material models) as a function of state of charge or (for anisotropic material models) in the local material a-direction for *MAT_ADD_SOC_EXPANSION.
Load curve ID defining the chemical shrinkage coefficient, beta, or a proxy in experiments for the chemical shrinkage coefficient, alpha, as a function of temperature, T for *MAT_ADD_CHEM_SHRINKAGE.
Curve ID to define the property dependence for *MAT_ADD_PROPERTY_DEPENDENCE.
Type: entity
LCID_curve
The S-N fatigue curve ID.
Type: entity
LCID_eq
The S-N fatigue curve ID.
-1 - S-N fatigue curve uses equation NS^b = a
-2 - S-N fatigue curve uses equation log(S) = a - b * log(N)
-3 - S-N fatigue curve uses equation S = a * N^b
-4 - S-N fatigue curve uses equation S = a - b * log(N)
Type: integer
LCID_option
The S-N fatigue curve ID.
0 –Curve Equation
1 –Curve ID
Type: integer
LCIDY
The load curve ID defining the thermal expansion coefficient in the local material b-direction as a function of state of charge for *MAT_ADD_THERMAL_EXPANSION.
The load curve ID defining the SOC expansion coefficient in the local material b-direction as a function of state of charge for *MAT_ADD_SOC_EXPANSION.
Type: entity
LCIDZ
The load curve ID defining the thermal expansion coefficient in the local material c-direction as a function of state of charge for *MAT_ADD_THERMAL_EXPANSION.
The load curve ID defining the SOC expansion coefficient in the local material c-direction as a function of state of charge for *MAT_ADD_SOC_EXPANSION.
Type: entity
LCKZ
The load curve giving factor on PERM as a function of z-coordinate.
Type: entity
LCPGD1
The curve defining non-linear Darcy's laws along x-directions.
Type: entity
LCPGD2
The curve defining non-linear Darcy's laws along y-directions.
Type: entity
LCPGD3
The curve defining non-linear Darcy's laws along z-directions.
Type: entity
LCREG_array
The load curve ID defining element size dependent regularization factors for history value to failure.
Type: entity array
LCREGD
The load curve ID or table ID defining element size dependent regularization factors for equivalent plastic strain to failure:
GT.0.0: Load curve ID (regularization factor as a function of element size) or table ID (regularization factor vs. element size curves vs. effective rate).
LT.0.0: |LCREGD| is a table ID (regularization factor vs. element size curves vs. triaxiality)
for *MAT_ADD_DAMAGE_GISSMO
Load curve ID defining element size dependent regularization factors for *MAT_ADD_EROSION.
Type: entity
LCREGD_TABLE
The load curve ID or Table ID defining element size dependent regulari-zation factors for equivalent plastic strain to failure. |LCREGD| is Table ID (reg. factor vs. element size curves vs. triaxiality).
Type: entity
LCSB
The curve ID for bending strength scale factor as a function of strain rate.
Type: array of entity
lcscale
Identification number of the curve for boundary dependency as a function of distance.
Type: integer
LCSDG
The failure strain curve/table or function. Load curve ID or table ID. As a load curve, it defines equivalent plastic strain to failure as a function of triaxiality. As a table, it defines for each Lode parameter value (between -1 and 1) a load curve ID giving the equivalent plastic strain to failure as a function of triaxiality for that Lode parameter value.
Type: entity
LCSDG_array
The load curve ID defining corresponding history value to failure vs. triaxiality.
Type: entity array
LCSDG_FUNCT
The failure strain curve/table or function. |LCSDG| is the ID of a function (*DEFINE_FUNCTION) with the arguments triaxiality and Lode parameter: f(ETA, L).
Type: entity
LCSN
The curve ID for normal strength scale factor as a function of strain rate.
Type: array of entity
LCSRS
The load curve ID or table ID. Load curve ID defining failure strain scaling factor for LCSDG as a function of strain r. Table ID defining failure strain scaling factor as a function of strain rate (TABLE) and triaxiality (CURVE).
Type: entity
LCSRS_array
The load curve ID defining failure history value scaling factor for LCSDG as a function of history value rate. If the first rate value in the curve is negative, it is assumed that all rate values are given as natural logarithm of the history rate. GT.0: Scale ECRIT as well. LT.0: Do not scale ECRIT.
Type: entity array
LCSS
The curve ID for shear strength scale factor as a function of strain rate.
Type: array of entity
LP2BI
The option to use a bending indicator instead of the Lode parameter.
0 - Inactive
1 - Active. Constant regularization (LCREGD) applied
2 - Active. Regularization (LCRGED) fully applied under pure membrane loading (OMEGA = 0) but not at all under pure bending (OMEGA = 1). Linear interpolation in between.
Type: double
LTYPE
The type of S-N curve.
0 – Semi-log interpolation (default)
1 – Log interpolation
2 - Linear-Linear interpolation.
Type: integer
MACF
The material axes change flag for brick elements.
1.0 – no change, default
2.0 – switch material axes a and b
3.0 – switch material axes a and c
4.0 – switch material axes b and c
Type: double
MID_array
The material ID of the shell material for which properties are defined.
Type: array of entity
MID
The material ID for which the materialbehavior applies.
Type: entity
MIDFAIL
The mid-plane failure option for shell elements.
0.0 - Inactive
1.0 - Active. Those of the non-mid-plane IP's that are already above their critical value immediately start to reduce the stresses. Those who are still below critical still do not couple, only if they reach their criterion.
2.0 - Active. All of the non-mid-plane IP's immediately start to reduce the stresses. NUMFIP is active.
3.0 - Active. Same as 2 but when D = 1 is reached in the middle integration point, the element is eroded instantaneously. NUMFIP is disregarded.
4.0 - Active. Damage and failure are applied only to the midpoint. When D = 1 at the midpoint, the element is eroded. NUMFIP is disregarded. Integration points away from the midplane see no stress reduction and no failure.
Type: double
MIDFAIL_array
The mid-plane failure option for shell elements.
0.0 - Inactive
1.0 - Active. Those of the non-mid-plane IP's that are already above their critical value immediately start to reduce the stresses. Those who are still below critical still do not couple, only if they reach their criterion.
2.0 - Active. All of the non-mid-plane IP's immediately start to reduce the stresses. NUMFIP is active.
3.0 - Active. Same as 2 but when D = 1 is reached in the middle integration point, the element is eroded instantaneously. NUMFIP is disregarded.
4.0 - Active. Damage and failure are applied only to the midpoint. When D = 1 at the midpoint, the element is eroded. NUMFIP is disregarded. Integration points away from the midplane, see no stress reduction and no failure.
Type: double array
MNEPS
The minimum principal strain at failure, epsilon_min.
Type: double
MNPRES
The minimum pressure at failure, Pmin.
Type: double
MOARFL
Modeled area flag.
0: EQ.0: Area_modeled goes down with shear (default)
1: EQ.1: Area_modeled stays constant
Type: integer
MODEL
The model definition within the specified law.
Type: integer array
moduleid
The module ID of the entity.
Type: integer
MULT
The scale factor scaling load curve given by LCID.
Type: double
MULTY
The scale factor scaling load curve given by LCIDY.
Type: double
MULTZ
The scale factor scaling load curve given by LCIDZ.
Type: double
MXEPS
The variable to invoke a failure criterion based on maximum principal strain. Maximum principal strain at failure, epsilon_max.
Type: double
MXEPS_CURVE
The variable to invoke a failure criterion based on maximum principal strain. -MXEPS is the ID of a curve giving maximum principal strain at failure as a function of effective strain rate.
Type: entity
MXPRES
The maximum pressure at failure, Pmax.
Type: double
MXTMP
The maximum temperature at failure.
Type: double
NAHSV
The number of history variables from damage model which should be stored in standard material history array for postprocessing.
Type: double
name
The name of the entity.
Type: string
NCS
The number of failure conditions to satisfy before failure occurs.
Type: double
NDIEMC
The number of damage initiation and evolution model (DIEM) criteria to be applied.
Type: integer
NFLOC_array
The optional local number of failed integration points prior to element deletion.
Type: double array
NHIS
The number of history variables as driving quantities (min = 1, max = 3).
Type: integer
NIELAWS
The number of inelasticity laws.
Type: integer
NIELINKS
The number of links/networks/phases specified by the user.
Type: integer
NODE1
The ID of node1.
Type: entity
NODE2
The ID of node2.
Type: entity
NODE3
The ID of node3.
Type: entity
NODE4
The ID of node4.
Type: entity
NODE5
The ID of node5.
Type: entity
NODE6
The ID of node6.
Type: entity
NODE7
The ID of node7.
Type: entity
NP
The cyclic strain hardening exponent.
Type: double
NSFF
The number of explicit time step cycles for stress fade-out used in the LCFLD criterion.
Type: double
Number_of_Materials
The number of Material.
Type: unsigned integer
numdata
Number of user defined cards.
Type: unsigned integer
NUMFIP
The number or percentage of failed integration points prior to element deletion.
Type: double
OPT_CARD3
The optional Card3 flag.
Type: Boolean
OPT_CARD4
The additional Failure Criteria Card.
Type: Boolean
OPT_CARD5
The additional Failure Criteria Card.
Type: Boolean
OPT_DSIGY_curve
The DSIGY Curve flag.
Type: Boolean
OPT_ECRIT_curve
The ECRIT flag.
Type: Boolean
OPT_ECRIT_curve_array
The ECRIT curve flag.
Type: Boolean array
OPT_FADEXP_curve
The FADEXP flag.
Type: Boolean
OPT_FADEXP_curve_array
The FADEXP curve flag.
Type: Boolean array
OPT_HIS1_curve
The HIS1 curve flag.
Type: Boolean
OPT_HIS2_curve
The HIS2 curve flag.
Type: Boolean
OPT_HIS3_curve
The HIS3 curve flag.
Type: Boolean
OPT_LCREGD_table
The LCREGD flag: curve Vs function.
Type: Boolean
OPT_LCSDG_funct
The LCSDG flag: curve Vs function.
Type: Boolean
OPT_LCSRS_scale
The LCREGD flag: scale Vs not scale ECRIT.
Type: Boolean
OPT_LCSRS_scale_array
The LCSRS scale flag.
Type: Boolean array
OPT_MXEPS_curve
The MXEPS flag.
Type: Boolean
OPT_SIGVM_curve
The SIGVM flag.
Type: Boolean
OPT_SIGY_curve
The SIGY Curve flag.
Type: Boolean
OPT_STOCHASTIC
The STOCHASTIC option.
Type: Boolean
Option
The option of the entity.
Type: integer
outputsuppressed
Returns non-zero if the entity is set "do not export", 0 otherwise.
Type: integer
P1
The damage initiation parameter for *MAT_ADD_DAMAGE_DIEM.
Virgin yield stress / Norton creep parameter / Norton-Bailey creep parameter / Shear decay coefficient, / Curve or table ID that defines the hardening for *MAT_ADD_INELASTICITY
Type: entity array
P1_FLOAT
The virgin yield stress, sigma0 or Norton creep parameter, A or Norton-Bailey creep parameter, A or Shear decay coefficient, betaG.
Type: double array
P2
The damage initiation parameter for *MAT_ADD_DAMAGE_DIEM.
0 – Mid layer
1 – Outer layer
Hardening / Norton creep parameter / Norton-Bailey creep parameter / Bulk decay coefficient for *MAT_ADD_INELASTICITY
Type: double array
P3
The damage initiation parameter for *MAT_ADD_DAMAGE_DIEM.
0 – Direct
1 - Incremental
Norton creep parameter / Norton-Bailey creep parameter / Shear reference temperature for *MAT_ADD_INELASTICITY
Type: double array
P4
The plane stress option for shell elements for *MAT_ADD_DAMAGE_DIEM.
0.0 - Transverse shear stresses, sigma_yz and sigma_zx, are included in the computation of stress invariants, such as the triaxiality.
1.0 - Transverse shear stresses, sigma_yz and sigma_zx, are not included in the computation of stress invariants, such as the triaxiality.
Norton-Bailey creep parameter / Shear shift coefficient for *MAT_ADD_INELASTICITY
Type: double array
P5
The load curve or table ID representing regularization factor as a function of the characteristic element size (curve) or regularization factor as a function of the characteristic element size and abscissa value of the criterion used (table) for *MAT_ADD_DAMAGE_DIEM.
Norton-Bailey creep parameter / Shear shift coefficient for *MAT_ADD_INELASTICITY
Type: double array
P5_FLOAT
The norton-Bailey creep parameter, p or Shear shift coefficient, BG.
P6
The norton-Bailey creep parameter, m or Bulk reference temperature, TG.
Type: double array
P7
The norton-Bailey creep parameter, epsilon0 or Bulk shift coefficient, AK.
Type: double array
P8
The norton-Bailey creep parameter, epsilon0 or Bulk shift coefficient, BK.
Type: double array
PA_PRE
The initial pressure of pore air.
Type: double
PA_RHO
The initial density of pore air.
Type: integer
PDDT
The pre-defined damage tensors.
0 – No pre-defined damage tensor is used
1 - Isotropic damage tensor
2 - 2-parameter isotropic damage tensor for volumetric-deviatoric split
3 – Anisotropic damage tensor as in MAT_104 (FLAG = -1)
4 - 3-parameter damage tensor associated with IFLG1 = 2
Type: integer
PERM
The permeability.
Type: double
PERM_curve
The load curve ID defining permeability.
Type: entity
PERM1
The permeability of pore air along x-direction.
Type: double
PERM1_curve
The curve ID defining permeability coefficient as a function of volume ratio of current volume to volume in the stress free state.
Type: entity
PERM1_flag
The PERM1_flag.
Type: Boolean
PERM2
The permeability of pore air along y-direction.
Type: double
PERM2_curve
The curve ID defining permeability coefficient as a function of volume ratio of current volume to volume in the stress free state.
Type: entity
PERM2_flag
The PERM2_flag.
Type: Boolean
PERM3
The permeability of pore air along z-direction.
Type: double
PERM3_curve
The curve defining permeability coefficient as a function of volume ratio of current volume to volume in the stress free state.
Type: entity
PERM3_flag
The PERM3_flag.
Type: Boolean
PID
The ID of the part for which the materialbehavior applies.
Type: entity
plim
EWK pressure limit.
Type: double
plugname
Plug-in dynamic library name.
Type: string
PMTYP
The permeability definition type.
0 - PERM is a constant.
1 - PERM is a load curve ID giving permeability (y-axis) as a function of the volume ratio of current volume to volume in the stress free state (x-axis).
2 - PERM is a load curve ID giving permeability (y-axis) as a function of effective plastic strain (x-axis) of materials other than MAT_072R3.
3 - PERM is a load curve ID giving permeability (y-axis) as a function of effective pressure (x-axis) which is positive when in compression.
Type: integer
poolid
The pool number of the entity.
Type: integer
poolname
The pool name of the entity.
Type: string
PORE
The porosity, meaning the ratio of pores to total volume.
Type: entity
PR
Poisson's ratio.
Type: double
PROP
The name of the property (same as the variable for a material model in keyword card).
Type: string
PROP
The name of the property (same as the variable for a material model in keyword card).
Type: string
PRUL
The failure rule number for this connection. EQ.1: Use data of weld partner with lower RANK (default). GE.2: Use DEFINE_FUNCTION expressions to determine weld data depending on several values of both weld partners.
Type: integer
PX12
The piezoelectric matrix.
Type: double
PX13
The piezoelectric matrix.
Type: double
PX22
The piezoelectric matrix.
Type: double
PX23
The piezoelectric matrix.
Type: double
PX33
The piezoelectric matrix.
Type: double
PY11
The piezoelectric matrix.
Type: double
PY12
The piezoelectric matrix.
Type: double
PY13
The piezoelectric matrix.
Type: double
PY22
The piezoelectric matrix.
Type: double
PY23
The piezoelectric matrix.
Type: double
PY33
The piezoelectric matrix.
Type: double
PZ11
The piezoelectric matrix.
Type: double
PZ12
The piezoelectric matrix.
Type: double
PZ13
The piezoelectric matrix.
Type: double
PZ22
The piezoelectric matrix.
Type: double
PZ23
The piezoelectric matrix.
Type: double
PZ33
The piezoelectric matrix.
Type: double
Q1
The damage evolution parameter.
Type: double array
Q1_CURVE
The damage evolution parameter.
Type: entity array
Q1_DAMAGE
The damage evolution parameter.
Type: double array
Q1
The damage evolution parameter.
Type: double array
Q2
Set to 1.0 to output information to log files (messag and d3hsp) when an integration point fails.
Type: double array
Q3
The damage evolution parameter.
Type: double array
qualifier
Non-local average type.
GLASS_EN - non-local refinement of the basic failure law for glass shell material type 126
GLASS_SD - sudden elimination non-local average type for glass shell material type 126
Type: keyword
qualifier1
Boundary dependence type.
CURVE - boundary dependence defined by a curve
Type: keyword
RADCRT
The critical radius for nonlocal failure criterion.
Type: double
radiusave
Radius to define the size of the spatial averaging region.
Type: double
RANK
The rank value.
Type: double array
rc
EWK critical distance.
Type: double
REFSZ
The reference element size, for which an additional output of damage will be generated for *MAT_ADD_GENERALIZED_DAMAGE.
Reference element size, for which an additional output of damage (and potentially plastic strain) will be generated for *MAT_ADD_DAMAGE_GISSMO.
  • GT. 0: Reference size related damage values are written to history variables ND + 9 and ND + 10.
  • LT. 0: The reference element size is |REFSZ|
Type: double
ROFLG
The flag for whether density is specified per unit area or volume.
0.0 – Density specified per unit volume (default)
1.0 - Density specified per unit area for controlling the mass of cohesive elements with an initial volume of zero
Type: double
SB
The bending strength.
Type: double array
scalrad
Scaling factor for the RADIUSave value to define the minimum distance between two centers in the same non-local average.
Type: double
SCLMRR
The scaling factor for torsional moment in failure function.
Type: double array
SHRF
The reduction factor for regularization for shear stress states.
Type: double
SHRF_array
The reduction factors for regularization at triaxiality = 0 (shear).
Type: double
SIGMAF
The fatigue strength coefficient.
Type: double
SIGP1
The maximum principal stress at failure, sigma_max.
Type: double
SIGTH
The threshold stress, sigma0.
Type: double
SIGVM
The equivalent stress at failure, sigma_signed_max.
Type: double
SIGVM_CURVE
The equivalent stress at failure, sigma_signed_max. -SIGMVM is a load curve ID giving the equivalent stress at failure as a function of the effective strain rate.
Type: entity
SIGY
The yield stress to be used in the spot weld element calculation.
Type: double array
SIGY_Curve
The yield stress to be used in the spot weld element calculation.
Type: array of entity
SIZFLG
The flag for method of element size determination.
Type: double
SN
The normal strength.
Type: double array
SNLIMIT
SNLIMIT determines the algorithm used when stress is lower than STHRES or than the lowest stress on S-N curve.
0 – Use the life at STHRES
1 – Ignored
2 - Infinity
Type: integer
SNTYPE
The stress type of S-N curve.
0 – Stress range (default)
1 – Stress amplitude
Type: integer
SOFT
The softening reduction factor for failure strain in crashfront elements . EQ.0.0: Inactive. GT.0.0: Plastic failure strain, epsilon_f (LCSDG), and critical plastic strain, epsilon_p_loc (ECRIT), will be scaled by SOFT. LT.0.0: Only plastic failure strain, epsilon_f (LCSDG), will be scaled by |SOFT|
Type: double
solver_id
The solver ID of the entity.
Type: integer
solverkeyword
The name of the solver keyword.
Type: string
solvername
The solver name of the entity for entities enabled for name pool, otherwise the internal name of the entity.
Type: string
SS
The shear strength.
Type: double array
STHRES
The fatigue threshold if the S-N curve is defined by equation (LCID < 0).
Type: double
STHRESi
The fatigue threshold stress for the i-th segment which acts as the lower stress limit of that segment.
Type: double array
THEXP
The constant undrained volumetric thermal expansion coefficient.
Type: double
THEXP_curve
|THEXP| is the ID of a load curve giving thermal expansion coefficient (y-axis) as a function of temperature (x-axis).
Type: entity
THEXP_flag
The THEXP_flag.
Type: integer
THICK
The thickness of the adhesive layer.
Type: double
timcent
Minimum time between two generated centers.
Type: double
timeelim
Time duration for sudden elimination of elements.
Type: double
timfail
Minimum time between two failure unlockings.
Type: double
Type
The type of the entity.
Type: integer
type
The failure type.
1: RUPMO
2: NLAVE
3: GLOBAL_BEHAVIOR
4: DUCTILE_CURVES
5: DUCTILE_LOOKU
6: SHEAR_CURVES
7: SHEAR_LOOKU
8: JOHNSON_COOK
9: ANISOTROPIC_FRACTURE
10: XUE_WIERZBICKI
11: FORMING_LIMIT_DIAGRAM
12: MODIFIED_MOHR_COULOMB
13: MUSCHENBORN_SONNE
14: ENHANCED_HILL_STOREN_RICE
15: GENERALIZED_NECKING
16: PLASTIC_STRAIN_SOFTENING
17: PLASTIC_STRAIN_DAMAGE
18: HILL_STOREN_RICE
19: MODIFIED_HILL_STOREN_RICE
20: RELATIVE_THICKNESS
21: MAXIMUM_STRAINING
22: EXTENDED_COCKCROFT_LATHAM
23: TABLE_DRIVEN_LOOKUP
Type: unsigned integer
usr1
User parameter 1.
Type: double
usr2
User parameter 2.
Type: double
usr3
User parameter 3.
Type: double
usr4
User parameter 4.
Type: double
usr5
User parameter 5.
Type: double
usr6
User parameter 6.
Type: double
usr7
User parameter 7.
Type: double
usr8
User parameter 8.
Type: double
usr9
User parameter 9.
Type: double
usr10
User parameter 10.
Type: double
usr11
User parameter 11.
Type: double
usr12
User parameter 12.
Type: double
usr13
User parameter 13.
Type: double
usr14
User parameter 14.
Type: double
usr15
User parameter 15.
Type: double
usr16
User parameter 16.
Type: double
usr17
User parameter 17.
Type: double
usr18
User parameter 18.
Type: double
usr19
User parameter 19.
Type: double
usr20
User parameter 20.
Type: double
usr21
User parameter 21.
Type: double
usr22
User parameter 22.
Type: double
usr23
User parameter 23.
Type: double
usr24
User parameter 24.
Type: double
usr25
User parameter 25.
Type: double
usr26
User parameter 26.
Type: double
usr27
User parameter 27.
Type: double
usr28
User parameter 28.
Type: double
usr29
User parameter 29.
Type: double
usr30
User parameter 30.
Type: double
usr31
User parameter 31.
Type: double
usr32
User parameter 32.
Type: double
V1
The components of vector, v, for AOPT = 3 and 4.
Type: double
V2
The components of vector, v, for AOPT = 3 and 4.
Type: double
V3
The components of vector, v, for AOPT = 3 and 4.
Type: double
VOLEPS
The volumetric strain at failure.
Type: double
VOLFRAC
The volume fraction required to fail before the element is deleted.
Type: double
WEIGHT
The weight of this link/network/phase used when computing total stress.
Type: double
X0
The coefficient of Anagonye and Wang [1999] porosity equation for the leakage area.
Type: double
X1
The coefficient of Anagonye and Wang [1999] porosity equation for the leakage area.
Type: double
X2
The coefficient of the porosity equation of Anagonye and Wang [1999].
Type: double
X3
The coefficient of the porosity equation of Anagonye and Wang [1999].
Type: double
XP
The coordinates of point p for AOPT = 1 for *MAT_ADD_PZELECTRIC.
The coordinates of point, p, for AOPT = 1 and 4 for *MAT_ADD_INELASTICITY.
Type: double
YP
The coordinates of point p for AOPT = 1 for *MAT_ADD_PZELECTRIC.
The coordinates of point, p, for AOPT = 1 and 4 for *MAT_ADD_INELASTICITY.
Type: double
ZP
The coordinates of point p for AOPT = 1 for *MAT_ADD_PZELECTRIC.
The coordinates of point, p, for AOPT = 1 and 4 for *MAT_ADD_INELASTICITY.
Type: double

Version History

2022.1

2022.2 - Added new data names ADD_option, AREAEQ, CON_ID, DDGPR, DDGPR_Funct, DETAN, DETAN_Funct, DEXSB, DEXSB_Funct, DEXSN, DEXSN_Funct, DEXSS, DEXSS_Funct, DGFAD, DGFAD_Funct, DGPR, DGTYP, DLCSB, DLCSN, DLCSS, DRANK, DSB, DSB_Funct, DSCLMRR, DSIGY, DSIGY_Curve, DSIGY_Funct, DSN, DSN_Funct, DSS, DSS_Funct, ETAN, EXSB, EXSN, EXSS, GFAD, LCSB, LCSN, LCSS, MID_array, MOARFL, Number_of_Materials, OPT_DSIGY_curve, OPT_SIGY_curve, PRUL, RANK, SB, SCLMRR, SIGY, SIGY_Curve, SN, and SS. Added a new config value 111.

2023 - Added new config values 401. Added new data names a1, a2, a3, a4, afailb, afailn, afails, afailt, alpha, ascalf, beta, d1, d2, dc, dmgelim, enercrid, entities, epsin, faild, failt, filter, ifmon, ifrcdir, intf1, intf2, irupopt, lcscale, numdata, plim, plugname, qualifier, qualifier1, radiusave, rc, scalrad, timcent, timeelim, timfail, type, usr1, usr2, usr3, usr4, usr5, usr6, usr7, usr8, usr9, usr10, usr11, usr12, usr13, usr14, usr15, usr16, usr17, usr18, usr19, usr20, usr21, usr22, usr23, usr24, usr25, usr26, usr27, usr28, usr29, usr30, usr31, and usr32.