User Defined Material XML
Materials created by user are saved to UsrDefMaterialDB.xml.
Materials created by user are saved to UsrDefMaterialDB.xml.
The HyperLife Material XML file should be contained within the
<HyperLifeMaterials> root tag, as shown below. The tag has
an attribute: version.
<?xml version="1.0" encoding="UTF-8"?>
<HyperLifeMaterials version="2024.1.0.8-HYLB_3094">
<MATERIAL ID="0" NAME="Sample_Material" MAT_TYPE="steel" REFERENCE="" SOURCE="">
<MATPROPERTY
UNIT="MPA"
ELASTIC_MODULUS="207000"
UTS="600"
YIELD_STRENGTH="250"
POISSONS_RATIO="0.3"
STSGRD_CONSTANT="stsgrdconstants"
STSGRD_aG="0.5"
STSGRD_bG="2700">
</MATPROPERTY>
<SN
N_CRVS="1"
SN_CURVE_TYPE="Ratio"
INPUT_METHOD="slopeintcept2"
STRESSTYPE="FTGMAT_STSTYPE_AMP"
NC="600000.0"
NFL="1000000.0"
XY_SE="0.01">
<CRV
RATIO_MEAN="-1"
SN_FATIGUE_STRENGTH_COEFFICIENT="1208"
SN_FATIGUE_STRENGTH_EXPONENT="-0.13300000000000001"
SN_ENDURANCE_LIMIT="1000000"
SN_FATIGUE_STRENGTH_EXPONENT2="-0.108"
SN_FATIGUE_LIMIT="150"
SN_STANDARD_ERROR="0.29999999999999999">
</CRV>
</SN>
<EN
INPUT_METHOD="estimate"
EN_FATIGUE_STRENGTH_COEFFICIENT="1002.000"
EN_FATIGUE_STRENGTH_EXPONENT="-0.095"
EN_FATIGUE_DUCTILITY_COEFFICIENT="0.35"
EN_FATIGUE_DUCTILITY_EXPONENT="-0.69"
EN_CYCLIC_STRAIN_HARDENING_EXPONENT="0.11"
EN_CYCLIC_STRENGTH_COEFFICIENT="966.000"
EN_REVERSAL_ENDURANCE_LIMIT="2e+8"
EN_STANDARD_ERROR_ELASTIC="0.300"
EN_STANDARD_ERROR_PLASTIC="0.300"
EN_SHEAR_STRENGTH_COEFFICIENT="0.0"
EN_SHEAR_DUCTILITY_COEFFICIENT="0.0"
EN_SHEAR_STRENGTH_EXPONENT="0.0"
EN_SHEAR_DUCTILITY_EXPONENT="0.0"
EN_COEFICIENTFKP="1.2"
EN_COEFICIENTNKP="1.0"
EN_MAX_STRAIN="0.02"
EN_FSPARM="0.3"
EN_BMPARM="1.0"
EN_BERGMANN="1.0">
</EN>
</MATERIAL>
</HyperLifeMaterials>
- Material
- Matproperty
- SN
- EN
- FOS
The Material XML supports materials properties from Stress Life, Strain Life, Seam and Spot welds, Factor of Safety and Crack Growth (saved from HyperLife Crack Growth profile.)
MATERIAL Tag
<MATERIAL ID="0" NAME="Mat_SN(1)" MAT_TYPE="steel" REFERENCE="" SOURCE="" TYPE="">
…
</MATERIAL>
| Element Tag | Valid Values | Comment |
|---|---|---|
| ID |
No default (Integer > 0) |
Material ID |
| NAME | String | Material name |
| MAT_TYPE | steel, aluminium_alloy, other | |
| REFERENCE | String | Reference name |
| SOURCE | String | Source Name |
| TYPE |
stresslife, strainlife, fos |
Fatigue module type, supported for backward compatibility, can be skipped in v2024.1 and onwards |
MATPROPERTY Tag
<MATPROPERTY
UNIT="MPA"
ELASTIC_MODULUS="207000"
UTS="600"
YIELD_STRENGTH="250"
POISSONS_RATIO="0.3"
STSGRD_CONSTANT="stsgrdconstants"
STSGRD_aG="0.5"
STSGRD_bG="2700">
</MATPROPERTY>
| Element Tag | Valid Values | Comment |
|---|---|---|
| UNIT |
MPA (Default) KSI, PSI |
Defines the units of stress values specified |
| ELASTIC_MODULUS | Real > 0.0 | Young's modulus. |
| UTS | Real > 0.0 | Ultimate tensile strength. |
| YIELD_STRENGTH | Real > 0.0 | Yield strength |
| POISSONS_RATIO | -1.0 < Real < 0.5 | Poisson’s ratio |
| STSGRD_CONSTANT | stsgrdconstants | Stress gradient to be enabled in Fatigue module |
| STSGRD_aG | Default = 0.5 (Real) | 𝑎𝐺 value in FKM stress gradient effect. |
| STSGRD_bG | Default = 2700 (Real) | 𝑏𝐺 value in FKM stress gradient effect. |
SN Tag
<SN
N_CRVS="1"
SN_CURVE_TYPE="Ratio"
INPUT_METHOD="slopeintcept2"
STRESSTYPE="FTGMAT_STSTYPE_AMP"
NC="600000.0"
NFL="1000000.0"
XY_SE="0.01">
<CRV
RATIO_MEAN="-1"
SN_FATIGUE_STRENGTH_COEFFICIENT="1208"
SN_FATIGUE_STRENGTH_EXPONENT="-0.13300000000000001"
SN_ENDURANCE_LIMIT="1000000"
SN_FATIGUE_STRENGTH_EXPONENT2="-0.108"
SN_FATIGUE_LIMIT="150"
SN_STANDARD_ERROR="0.29999999999999999">
</CRV>
</SN>
| Element Tag | Valid Values | Comment |
|---|---|---|
| N_CRVS | Default = 1, 2,…,n |
Single or Multiple curves Default = 1, highlights a single SN curve and its properties to follow |
| SN_CURVE_TYPE |
Ratio, Mean, Haigh |
Ratio = Stress Ratio based curves Mean = Mean Stress based curves Haigh = Haigh diagrams based on Life if No. of SN curves = Single, SN_CURVE_TYPE = Ratio/Haigh only. |
| INPUT_METHOD |
estimate (estimate from UTS) point1 (point, 1-segment) point2 (point, 2-segment) slopeintcept1 (Slope-intercept, 1-segment) slopeintcept2 (Slope-intercept, 2-segment) slopetrans1 (Slope-trans, 1-segment) slopetrans2 (Slope-trans, 2-segment) xydata |
Haigh Diagram supports only xydata input method |
| STRESSTYPE |
FTGMAT_STSTYPE_AMP FTGMAT_STSTYPE_RNG |
Defines the interpretation of the defined SN curve. Amplitude / Range |
| NC |
Default = 600000.0 Real > 1000.0 |
Supported for XY Data SN curve / Haigh Fatigue transition point. After this point, fatigue strength is offset by the surface correction factor. Before this point, fatigue strength is proportionally reduced. |
| NFL | Default = 1.0E+8 (Real > 1.0E+5) |
Supported for XY Data SN curve / Haigh Endurance limit. Number of cycles at which damage can be considered zero. |
| XY_SE |
Default = 0.0 (Real > 0.0) |
Supported for XY Data SN curve / Haigh Standard Error of log(Stress) |
| Element Tag | Valid Values | Comment |
|---|---|---|
| CRV | - | Section listing SN properties for the selected curve |
| RATIO_MEAN |
Default = -1 Real |
Stress Ratio of the SN curve |
| SN_FATIGUE_STRENGTH_COEFFICIENT | No default (Real > 0.0) | Fatigue strength coefficient. It is the stress range intercept of the SN curve at 1 cycle on a log-log scale. |
| SN_FATIGUE_STRENGTH_EXPONENT | Real < 0.0 |
The first fatigue strength exponent. The slope of the first segment of the SN curve in log-log scale. |
| SN_ENDURANCE_LIMIT |
No default No default (Real ≥ 1000.0) |
In one-segment SN curve, this is the cycle limit of endurance |
| SN_FATIGUE_STRENGTH_EXPONENT2 | Real < 0.0 |
The second fatigue strength exponent. the slope of the second segment of the SN curve in log-log scale. |
| SN_FATIGUE_LIMIT | Real ≥ 0.0, or blank | Fatigue Limit. No damage occurs if the stress range is less than FL |
| SN_STANDARD_ERROR |
Default = 0.0 (Real ≥ 0.0) |
Standard Error of Log(N). |
| Element Tag | Valid Values | Comment |
|---|---|---|
| CRV | - | Section listing SN properties for the selected curve |
| ID | 1,2….n | SN curve ID from the list of curves |
|
RATIO/LIFE ( for Single SN curve) RATIO/MEAN/LIFE ( for Multiple SN curves) |
Ratio Default = -1 (Real) Mean No Default (Real) Life No Default (Real > 0) |
RATIO = Stress Ratio MEAN = Mean Stress HAIGH = Haigh Diagram |
| NPOINTS | Integer | Number of points in the curve |
| Xi | Real > 0 |
Depending on SN_CURVE_TYPE, Xi values can be one of stress amplitude or stress range, No default |
| Yi | Real > 0 |
Depending on SN_CURVE_TYPE, Yi values can be life (SN_CURVE_TYPE = LIFE) or mean stress (SN_CURVE_TYPE =RATIO or MEAN). No default |
eN Tag
<EN
INPUT_METHOD="slope"
EN_FATIGUE_STRENGTH_COEFFICIENT="1002.000"
EN_FATIGUE_STRENGTH_EXPONENT="-0.095"
EN_FATIGUE_DUCTILITY_COEFFICIENT="0.35"
EN_FATIGUE_DUCTILITY_EXPONENT="-0.69"
EN_CYCLIC_STRAIN_HARDENING_EXPONENT="0.11"
EN_CYCLIC_STRENGTH_COEFFICIENT="966.000"
EN_REVERSAL_ENDURANCE_LIMIT="2e+8"
EN_STANDARD_ERROR_ELASTIC="0.300"
EN_STANDARD_ERROR_PLASTIC="0.300"
EN_SHEAR_STRENGTH_COEFFICIENT="0.0"
EN_SHEAR_DUCTILITY_COEFFICIENT="0.0"
EN_SHEAR_STRENGTH_EXPONENT="0.0"
EN_SHEAR_DUCTILITY_EXPONENT="0.0"
EN_COEFICIENTFKP="1.2"
EN_COEFICIENTNKP="1.0"
EN_MAX_STRAIN="0.02"
EN_FSPARM="0.3"
EN_BMPARM="1.0"
EN_BERGMANN="1.0">
</EN>
| Element Tag | Valid Values | Comment |
|---|---|---|
| INPUT_METHOD |
slope (user defined) estimate (estimate from UTS) |
|
| EN_FATIGUE_STRENGTH_COEFFICIENT |
No default (Real > 0.0) |
Fatigue strength coefficient. |
| EN_FATIGUE_STRENGTH_EXPONENT |
No default (Real < 0.0) |
b, Fatigue strength exponent. |
| EN_FATIGUE_DUCTILITY_COEFFICIENT |
No default (Real < 0.0) |
c, Fatigue ductility exponent. |
| EN_FATIGUE_DUCTILITY_EXPONENT |
No default (Real > 0.0) |
Fatigue ductility coefficient. |
| EN_CYCLIC_STRAIN_HARDENING_EXPONENT |
No default (Real < 0.0) |
np, Fatigue strength exponent. |
| EN_CYCLIC_STRENGTH_COEFFICIENT | No default (Real > 0.0) | Kp, Cyclic strength coefficient. |
| EN_REVERSAL_ENDURANCE_LIMIT |
Default = 2.0E8 (Real > 1.0E5) |
Reversal limit of endurance. One cycle contains two reversals. |
| EN_STANDARD_ERROR_ELASTIC |
Default = 0.0 (Real ≥ 0.0) |
Standard Error of Log (elastic strain). |
| EN_STANDARD_ERROR_PLASTIC |
Default = 0.0 (Real ≥ 0.0) |
Standard Error of Cyclic Stress-Strain curve. |
| EN_SHEAR_STRENGTH_COEFFICIENT |
Default = Blank (Real > 0.0) |
Shear Fatigue Strength coefficient (τ′f) based on amplitude. This value should be one half of the value defined for tfp on the SN continuation line. |
| EN_SHEAR_DUCTILITY_COEFFICIENT |
Default = Blank (Real > 0.0) |
Shear Fatigue Ductility coefficient (γ′f) |
| EN_SHEAR_STRENGTH_EXPONENT |
Default = b𝑏 (Real ≤ 0.0) |
Shear Fatigue Strength exponent (𝑏𝛾) |
| EN_SHEAR_DUCTILITY_EXPONENT |
Default = c𝑐 (Real ≤ 0.0) |
Shear Fatigue Ductility exponent (𝑐𝛾) |
| EN_COEFICIENTFKP |
Default = 1.2 (Real > 0.0) |
Coefficient value |
| EN_COEFICIENTNKP |
Default = 1.0 (Real > 0.0) |
Coefficient value |
| EN_MAX_STRAIN |
Default = 0.02 (Real > 0.0) |
Maximum Strain value for Strain-Life Approach. The default value is 0.02 (corresponds to 2% strain). In multiaxial fatigue analysis, this value is used as maximum allowable strain in the plasticity model. If accumulated strain is greater than this value, HyperLife does not calculate actual damage but assigns a larger value of damage (10.0). In uniaxial fatigue, 10% of this value (0.2% by default) is used as maximum possible strain amplitude. If strain amplitude is greater than 10% of this value, a warning message will be issued. Actual damage is still calculated. |
| EN_FSPARM |
Default = 0.3 (Real ≥ 0.0) |
Constant k for the Fatemi-Socie model. |
| EN_BMPARM | Default = 1.0 (Real ≥ 0.0) |
Constant S for the Brown-Miller model. |
| EN_BERGMANN | Default = 1 |
Constant for Bergmann Model |
FOS Tag
<FOS
FOS_TFLINPUT="Table"
FOS_TABLE_XVALUES="0.0000000e+00;2.9530000e+02"
FOS_TABLE_YVALUES="2.2000000e+02;0.0000000e+00"
FOS_TORSIONAL_FATIGUE_LIMIT="220.0"
FOS_HSS="0.745"
FOS_SHEAR_THRESHOLD="15.0"
FOS_SAFEZONE_ANGLE="25.0">
</FOS>
| Element Tag | Valid Values | Comment |
|---|---|---|
| FOS_TFLINPUT |
Table Real |
Table, Data Entry that defines the intersection points. The X-values represent Hydrostatic Pressure, and Y-values represent Shear. Real, Considers TFL and HSS, FOS_TABLE_XVALUES = “blank” FOS_TABLE_YVALUES = “blank” |
| FOS_TABLE_XVALUES, |
Hydrostatic pressure X1,X2,….Xn |
|
| FOS_TABLE_YVALUES |
Shear Stress Y1,Y2,….Yn |
|
| FOS_TORSIONAL_FATIGUE_LIMIT |
No default (Real > 0.0 or Integer) |
Torsion fatigue limit. A Real or Integer value can be specified. |
| FOS_HSS | No default (Real > 0.0) | Hydrostatic stress sensitivity. |
| FOS_SHEAR_THRESHOLD | Default = 0.0 (Real ≥ 0.0) |
Shear Threshold for the Safe zone. If the microscopic shear stress is lower than this value, it is considered safe. |
| FOS_SAFEZONE_ANGLE |
Default = 0.0 (Real ≥ 0.0) |
Safe zone angle. If the angle of a point in the domain is lower than the Safe zone angle, it is considered safe |