# materialbehaviors

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

`A`- The material parameter a in S-N fatigue equation.
`A1`- The components of vector a for AOPT = 2.
`A2`- The components of vector a for AOPT = 2.
`A3`- The components of vector a for AOPT = 2.
`Ai`- The material parameter a in S-N fatigue equation for the i-th segment.
`activesuppressed`- Returns non-zero if the entity is set inactive, 0 otherwise.
`AOPT`- The material axes option for *MAT_ADD_PZELECTRIC.
`AOPT_SYSTEM`- The absolute value of AOPT is a coordinate system ID.
`ArrayCount`- The s-N Curve Segment Cards. Include one card for each additional S-N curve segment.
`attributesmax`- The number of attributes owned by this entity.
`B`- The material parameter b in S-N fatigue equation.
`BETA`- The material angle in degrees for AOPT = 0 and AOPT = 3.
`Bi`- The material parameter b in S-N fatigue equation for the i-th segment.
`BIAXF`- The reduction factor for regularization for biaxial stress states.
`BIAXF_array`- The reduction factors for regularization at triaxiality = 2/3 (biaxial).
`BP`- The fatigue strength exponent (Basquin's exponent).
`CDARCY`- The coefficient of Darcy's law.
`CDF`- The coefficient of Dupuit-Forchheimer law.
`color`- The 1-64 color of the entity.
`color_rgb`- The RGB color of the entity.
`Config`- The configuration of the entity.
`CP`- The fatigue ductility exponent (Coffin-Manson exponent).
`D1`- The components of vector d for AOPT = 2.
`D2`- The components of vector d for AOPT = 2.
`D11`- The ID of the curve for damage tensor coefficients.
`D12`- The ID of the curve for damage tensor coefficients.
`D14_13`- The ID of the curve for damage tensor coefficients.
`D21`- The ID of the curve for damage tensor coefficients.
`D22`- The ID of the curve for damage tensor coefficients.
`D24_23`- The ID of the curve for damage tensor coefficients.
`D3`- The components of vector d for AOPT = 2.
`D33`- The ID of the curve for damage tensor coefficients.
`D41_31`- The ID of the curve for damage tensor coefficients.
`D42_32`- The ID of the curve for damage tensor coefficients.
`D44`- The ID of the curve for damage tensor coefficients.
`D55`- The ID of the curve for damage tensor coefficients.
`D66`- The ID of the curve for damage tensor coefficients.
`DCRIT`- The damage threshold value (critical damage).
`DCRIT_array`- The damage threshold value (critical damage).
`DCTYP`- The damage composition option for multiple criteria.
`definedentity`- True if the entity is defined, false otherwise.
`DEPS`- The plastic strain increment between evaluation of damage instability and evolution criteria.
`DETYP`- The damage evolution type.
`DINIT`- The damage initialization option.
`DITYP`- The damage initiation type.
`DMGEXP`- The exponent for nonlinear damage accumulation.
`DMGEXP_array`- The exponent for nonlinear damage accumulation.
`DMGTYP`- The GISSMO damage type the following applies. DMGTYP is interpreted digit-wise as follows:
`DTEFLT`- The time period (or inverse of the cutoff frequency) for the lowpass filter applied to the effective strain rate when MXEPS is negative.
`DTMIN`- The minimum time step size at failure.
`DTYP`- The flag for damage behavior for *MAT_ADD_GENERALIZED_DAMAGE.
`DTYPE`- The type of piezoelectric property definition.
`DXX`- The dielectric permittivity matrix.
`DXY`- The dielectric permittivity matrix.
`DXZ`- The dielectric permittivity matrix.
`DYY`- The dielectric permittivity matrix.
`DYZ`- The dielectric permittivity matrix.
`DZZ`- The dielectric permittivity matrix.
`E`- Young's modulus.
`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
`ECRIT_array`- The critical history value (material instability).
`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).
`ECRIT_CURVE_array`- |ECRIT| is a load curve ID defining critical history value vs. triaxiality.
`EFFEPS`- The maximum effective strain at failure, epsilon_eff.
`ELA`- The effective leakage area for blocked fabric.
`ELA_curve`- |ELA| is the load curve ID of the curve defining ELA as a function of time.
`ELAOpt`- The ELA Option.
`EN_option`- The EN option.
`ENGCRT`- The critical energy for nonlocal failure criterion.
`EPSP`- The fatigue ductility coefficient.
`EPSSH`- The tensorial shear strain at failure, gamma_max / 2.
`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.
`EXCL`- The exclusion number.
`FAC`- The optional fabric characteristic parameter.
`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.
`FACOpt`- The FAC option.
`FADEXP`- The exponent for damage-related stress fadeout. Constant fading exponent.
`FADEXP_array`- The exponent for damage-related stress fadeout. Constant fading exponent.
`FADEXP_CURVE`- The exponent for damage-related stress fadeout. |FADEXP| is load curve ID defining element-size dependent fading exponent.
`FADEXP_CURVE_array`- |FADEXP| is load curve ID defining element-size dependent fading exponent.
`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.
`flagforIDAM_DIEM`- The IDAM flag for DIEM.
`flagforQ1`- The flag for Q1.
`FLC`- The optional fabric porous leakage flow coefficient.
`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.
`FLCOpt`- The FLC option.
`FVOPT`- The fabric venting option.
`GPT`- The number of Gauss points used for integration.
`HIS1`- The choice of variable as driving quantity for damage, called 'history value’.
`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.
`HIS2`- The choice of variable as driving quantity for damage, called 'history value'.
`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.
`HIS3`- The choice of variable as driving quantity for damage, called 'history value'.
`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.
`HISVN`- The history variable used to evaluate the 3-D table LCSDG.
`id`- The ID of the entity.
`IDAM`- The flag for damage model.
`IDAM_DIEM`- The flag for damage model.
`IDAM_size`- The size of IDAM.
`IFLG1`- The damage driving quantities.
`IFLG2`- The damage strain coordinate system.
`IFLG3`- The erosion criteria and damage coupling system.
`IMPULSE`- The stress impulse for failure, Kf.
`include`- The ID of the include file the entity is organized in.
`includeid`- The ID of the include file the entity is organized in.
`internalid`- The ID of the entity.
`internalname`- The internal name of the entity.
`INTFAIL`- The number of integration points required for the cohesive element to be deleted.
`KP`- The cyclic strain hardening coefficient.
`LAW`- The inelasticity law.
`LCDLIM`- The load curve ID defining damage limit values as a function of triaxiality.
`LCDLIM_array`- The load curve ID defining damage limit values as a function of triaxiality.
`LCEPS12`- The load curve ID defining in-plane shear strain limit gamma12^c as a function of element size.
`LCEPS13`- The load curve ID defining through-thickness shear strain limit gamma13^c as a function of element size.
`LCEPSMX`- The load curve ID defining in-plane major strain limit epsilon1^c as a function of element size.
`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.
`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.
`LCID_curve`- The S-N fatigue curve ID.
`LCID_eq`- The S-N fatigue curve ID.
`LCID_option`- The S-N fatigue curve ID.
`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.
`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.
`LCKZ`- The load curve giving factor on PERM as a function of z-coordinate.
`LCPGD1`- The curve defining non-linear Darcy's laws along x-directions.
`LCPGD2`- The curve defining non-linear Darcy's laws along y-directions.
`LCPGD3`- The curve defining non-linear Darcy's laws along z-directions.
`LCREG_array`- The load curve ID defining element size dependent regularization factors for history value to failure.
`LCREGD`- The load curve ID or table ID defining element size dependent regularization factors for equivalent plastic strain to failure:
`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).
`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.
`LCSDG_array`- The load curve ID defining corresponding history value to failure vs. triaxiality.
`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).
`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 triaxility (CURVE).
`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.
`LP2BI`- The option to use a bending indicator instead of the Lode parameter.
`LTYPE`- The type of S-N curve.
`MACF`- The material axes change flag for brick elements.
`MID`- The material ID for which the materialbehavior applies.
`MIDFAIL`- The mid-plane failure option for shell elements.
`MIDFAIL_array`- The mid-plane failure option for shell elements.
`MNEPS`- The minimum principal strain at failure, epsilon_min.
`MNPRES`- The minimum pressure at failure, Pmin.
`MODEL`- The model definition within the specified law.
`moduleid`- The module ID of the entity.
`MULT`- The scale factor scaling load curve given by LCID.
`MULTY`- The scale factor scaling load curve given by LCIDY.
`MULTZ`- The scale factor scaling load curve given by LCIDZ.
`MXEPS`- The variable to invoke a failure criterion based on maximum principal strain. Maximum principal strain at failure, epsilon_max.
`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.
`MXPRES`- The maximum pressure at failure, Pmax.
`MXTMP`- The maximum temperature at failure.
`NAHSV`- The number of history variables from damage model which should be stored in standard material history array for postprocessing.
`name`- The name of the entity.
`NCS`- The number of failure conditions to satisfy before failure occurs.
`NDIEMC`- The number of damage initiation and evolution model (DIEM) criteria to be applied.
`NFLOC_array`- The optional local number of failed integration points prior to element deletion.
`NHIS`- The number of history variables as driving quantities (min = 1, max = 3).
`NIELAWS`- The number of inelasticity laws.
`NIELINKS`- The number of links/networks/phases specified by the user.
`NODE1`- The ID of node1.
`NODE2`- The ID of node2.
`NODE3`- The ID of node3.
`NODE4`- The ID of node4.
`NODE5`- The ID of node5.
`NODE6`- The ID of node6.
`NODE7`- The ID of node7.
`NP`- The cyclic strain hardening exponent.
`NSFF`- The number of explicit time step cycles for stress fade-out used in the LCFLD criterion.
`NUMFIP`- The number or percentage of failed integration points prior to element deletion.
`OPT_CARD3`- The optional Card3 flag.
`OPT_CARD4`- The additional Failure Criteria Card.
`OPT_CARD5`- The additional Failure Criteria Card.
`OPT_ECRIT_curve`- The ECRIT flag.
`OPT_ECRIT_curve_array`- The ECRIT curve flag.
`OPT_FADEXP_curve`- The FADEXP flag.
`OPT_FADEXP_curve_array`- The FADEXP curve flag.
`OPT_HIS1_curve`- The HIS1 curve flag.
`OPT_HIS2_curve`- The HIS2 curve flag.
`OPT_HIS3_curve`- The HIS3 curve flag.
`OPT_LCREGD_table`- The LCREGD flag: curve Vs function.
`OPT_LCSDG_funct`- The LCSDG flag: curve Vs function.
`OPT_LCSRS_scale`- The LCREGD flag: scale Vs not scale ECRIT.
`OPT_LCSRS_scale_array`- The LCSRS scale flag.
`OPT_MXEPS_curve`- The MXEPS flag.
`OPT_SIGVM_curve`- The SIGVM flag.
`OPT_STOCHASTIC`- The STOCHASTIC option.
`Option`- The option of the entity.
`outputsuppressed`- Returns non-zero if the entity is set "do not export",
`0`otherwise. `P1`- The damage initiation parameter for *MAT_ADD_DAMAGE_DIEM.
`P1_FLOAT`- The virgin yield stress, sigma0 or Norton creep parameter, A or Norton-Bailey creep parameter, A or Shear decay coefficient, betaG.
`P2`- The damage initiation parameter for *MAT_ADD_DAMAGE_DIEM.
`P3`- The damage initiation parameter for *MAT_ADD_DAMAGE_DIEM.
`P4`- The plane stress option for shell elements for *MAT_ADD_DAMAGE_DIEM.
`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.
`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.
`P7`- The norton-Bailey creep parameter, epsilon0 or Bulk shift coefficient, AK.
`P8`- The norton-Bailey creep parameter, epsilon0 or Bulk shift coefficient, BK.
`PA_PRE`- The initial pressure of pore air.
`PA_RHO`- The initial density of pore air.
`PDDT`- The pre-defined damage tensors.
`PERM`- The permeability.
`PERM_curve`- The load curve ID defining permeability.
`PERM1`- The permeability of pore air along x-direction.
`PERM1_curve`- The curve ID defining permeability coefficient as a function of volume ratio of current volume to volume in the stress free state.
`PERM1_flag`- The PERM1_flag.
`PERM2`- The permeability of pore air along y-direction.
`PERM2_curve`- The curve ID defining permeability coefficient as a function of volume ratio of current volume to volume in the stress free state.
`PERM2_flag`- The PERM2_flag.
`PERM3`- The permeability of pore air along z-direction.
`PERM3_curve`- The curve defining permeability coefficient as a function of volume ratio of current volume to volume in the stress free state.
`PERM3_flag`- The PERM3_flag.
`PID`- The ID of the part for which the materialbehavior applies.
`PMTYP`- The permeability definition type.
`poolid`- The pool number of the entity.
`poolname`- The pool name of the entity.
`PORE`- The porosity, meaning the ratio of pores to total volume.
`PR`- Poisson's ratio.
`PROP`- The name of the property (same as the variable for a material model in keyword card).
`PX11`- The piezoelectric matrix.
`PX12`- The piezoelectric matrix.
`PX13`- The piezoelectric matrix.
`PX22`- The piezoelectric matrix.
`PX23`- The piezoelectric matrix.
`PX33`- The piezoelectric matrix.
`PY11`- The piezoelectric matrix.
`PY12`- The piezoelectric matrix.
`PY13`- The piezoelectric matrix.
`PY22`- The piezoelectric matrix.
`PY23`- The piezoelectric matrix.
`PY33`- The piezoelectric matrix.
`PZ11`- The piezoelectric matrix.
`PZ12`- The piezoelectric matrix.
`PZ13`- The piezoelectric matrix.
`PZ22`- The piezoelectric matrix.
`PZ23`- The piezoelectric matrix.
`PZ33`- The piezoelectric matrix.
`Q1`- The damage evolution parameter.
`Q1_CURVE`- The damage evolution parameter.
`Q1_DAMAGE`- The damage evolution parameter.
`Q1`- The damage evolution parameter.
`Q2`- Set to 1.0 to output information to log files (messag and d3hsp) when an integration point fails.
`Q3`- The damage evolution parameter.
`RADCRT`- The critical radius for nonlocal failure criterion.
`REFSZ`- The reference element size, for which an additional output of damage will be generated for *MAT_ADD_GENERALIZED_DAMAGE.
`ROFLG`- The flag for whether density is specified per unit area or volume.
`SHRF`- The reduction factor for regularization for shear stress states.
`SHRF_array`- The reduction factors for regularization at triaxiality = 0 (shear).
`SIGMAF`- The fatigue strength coefficient.
`SIGP1`- The maximum principal stress at failure, sigma_max.
`SIGTH`- The threshold stress, sigma0.
`SIGVM`- The equivalent stress at failure, sigma_signed_max.
`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.
`SIZFLG`- The flag for method of element size determination.
`SNLIMIT`- SNLIMIT determines the algorithm used when stress is lower than STHRES or than the lowest stress on S-N curve.
`SNTYPE`- The stress type of S-N curve.
`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|
`solver_id`- The solver ID of the entity.
`solverkeyword`- The name of the solver keyword.
`solvername`- The solver name of the entity for entities enabled for name pool, otherwise the internal name of the entity.
`STHRES`- The fatigue threshold if the S-N curve is defined by equation (LCID < 0).
`STHRESi`- The fatigue threshold stress for the i-th segment which acts as the lower stress limit of that segment.
`THEXP`- The constant undrained volumetric thermal expansion coefficient.
`THEXP_curve`- |THEXP| is the ID of a load curve giving thermal expansion coefficient (y-axis) as a function of temperature (x-axis).
`THEXP_flag`- The THEXP_flag.
`THICK`- The thickness of the adhesive layer.
`Type`- The type of the entity.
`V1`- The components of vector, v, for AOPT = 3 and 4.
`V2`- The components of vector, v, for AOPT = 3 and 4.
`V3`- The components of vector, v, for AOPT = 3 and 4.
`VOLEPS`- The volumetric strain at failure.
`VOLFRAC`- The volume fraction required to fail before the element is deleted.
`WEIGHT`- The weight of this link/network/phase used when computing total stress.
`X0`- The coefficient of Anagonye and Wang [1999] porosity equation for the leakage area.
`X1`- The coefficient of Anagonye and Wang [1999] porosity equation for the leakage area.
`X2`- The coefficient of the porosity equation of Anagonye and Wang [1999].
`X3`- The coefficient of the porosity equation of Anagonye and Wang [1999].
`XP`- The coordinates of point p for AOPT = 1 for *MAT_ADD_PZELECTRIC.
`YP`- The coordinates of point p for AOPT = 1 for *MAT_ADD_PZELECTRIC.
`ZP`- The coordinates of point p for AOPT = 1 for *MAT_ADD_PZELECTRIC.

## Version History

2022.1