MaterialUtilities Class

class NXOpen.MaterialUtilities

Bases: object

Represents Physical NXOpen.MaterialUtilities class

To obtain an instance of this class, refer to NXOpen.CAE.CaeSession

New in version NX10.0.0.

Methods

Method Description
ConvertStressStrainData Convert stress strain data between the four types EngineeringStressEngineeringStrain, EngineeringStressEngineeringPlasticStrain, TrueStressLogStrain and TrueStressLogPlasticStrain.
ConvertStressStrainYoungsModulusData Convert stress strain data between the four types EngineeringStressEngineeringStrain, EngineeringStressEngineeringPlasticStrain, TrueStressLogStrain and TrueStressLogPlasticStrain.

Enumerations

MaterialUtilitiesStressStrainData Enumeration The stress strain data type

Method Detail

ConvertStressStrainData

MaterialUtilities.ConvertStressStrainData

Convert stress strain data between the four types EngineeringStressEngineeringStrain, EngineeringStressEngineeringPlasticStrain, TrueStressLogStrain and TrueStressLogPlasticStrain.

The output stressStrain data will be the same units as the input stressStrain data. The units of young’s modulus should be consistent with the input stressStrain Data.

The algorithm formula for converting from Engineering Strain to Log ( True ) strain is:

Log ( True ) Strain = ln( 1 + Engineering Strain )

The algorithm formulas for converting from Engineering Stress to True Stress are:

True Stress = Engineer Stress *(1 - Poisson’s Ratio * Engineering Elastic Strain - 0.5 * Engineering Plastic Strain )^(-2) Engineering Elastic Strain = Engineering Stress / Young’s Modulus Engineering Plastic Strain = Engineering Strain - Engineering Elastic Strain

The algorithm formulas for converting from “True stress-log strain” and “True stress-log plastic strain” are: Log Elastic Strain = Log Stress / Young’s Modulus Log Plastic Strain = Log Strain - Log Elastic Strain

Signature ConvertStressStrainData(strainData, stressData, youngsModulus, poissionRatio, inputDataType, outputDataType)

Parameters:
  • strainData (list of float) – the input strain array
  • stressData (list of float) – the input stress array
  • youngsModulus (float) – the input young’s modulus used in converting algorithm
  • poissionRatio (float) – the input poission’s ratio used in converting algorithm
  • inputDataType (NXOpen.MaterialUtilitiesStressStrainData) – the input stress-strain data type
  • outputDataType (NXOpen.MaterialUtilitiesStressStrainData) – the output stress-strain data type
Returns:

a tuple

Return type:

A tuple consisting of (convertedStrainData, convertedStressData) convertedStrainData is a list of float. the output strain array convertedStressData is a list of float. the output stress array

New in version NX10.0.0.

Deprecated since version NX11.0.0: Use NXOpen.MaterialUtilities.ConvertStressStrainYoungsModulusData() instead.

License requirements: None.

ConvertStressStrainYoungsModulusData

MaterialUtilities.ConvertStressStrainYoungsModulusData

Convert stress strain data between the four types EngineeringStressEngineeringStrain, EngineeringStressEngineeringPlasticStrain, TrueStressLogStrain and TrueStressLogPlasticStrain.

The output stressStrain data will be the same units as the input stressStrain data. The units of young’s modulus should be consistent with the input stressStrain Data.

The algorithm formula for converting from Engineering Strain to Log ( True ) strain is:

Log ( True ) Strain = ln( 1 + Engineering Strain )

The algorithm formulas for converting from Engineering Stress to True Stress are:

True Stress = Engineer Stress *(1 - Poisson’s Ratio * Engineering Elastic Strain - 0.5 * Engineering Plastic Strain )^(-2) Engineering Elastic Strain = Engineering Stress / Young’s Modulus Engineering Plastic Strain = Engineering Strain - Engineering Elastic Strain

The algorithm formulas for converting from “True stress-log strain” and “True stress-log plastic strain” are: Log Elastic Strain = Log Stress / Young’s Modulus Log Plastic Strain = Log Strain - Log Elastic Strain

This method also provides updated Youngs Modulus which is in sync with converted stress and strain

Signature ConvertStressStrainYoungsModulusData(strainData, stressData, youngsModulus, poissionRatio, inputDataType, outputDataType)

Parameters:
  • strainData (list of float) – the input strain array
  • stressData (list of float) – the input stress array
  • youngsModulus (float) – the input young’s modulus used in converting algorithm
  • poissionRatio (float) – the input poission’s ratio used in converting algorithm
  • inputDataType (NXOpen.MaterialUtilitiesStressStrainData) – the input stress-strain data type
  • outputDataType (NXOpen.MaterialUtilitiesStressStrainData) – the output stress-strain data type
Returns:

a tuple

Return type:

A tuple consisting of (convertedStrainData, convertedStressData, convertedYoungsModulus) convertedStrainData is a list of float. the output strain array convertedStressData is a list of float. the output stress array convertedYoungsModulus is a float. the output converted Youngs Modulus which is in sync with converted stress and strain

New in version NX11.0.0.

License requirements: None.