Hyperelastic object

The Hyperelastic object specifies elastic properties for approximately incompressible elastomers.

The following topics are discussed:

Access

import material
mdb.models[name].materials[name].hyperelastic
import odbMaterial
session.odbs[name].materials[name].hyperelastic

Hyperelastic(...)

This method creates a Hyperelastic object.

Path

mdb.models[name].materials[name].Hyperelastic
session.odbs[name].materials[name].Hyperelastic

Required arguments

table

A sequence of sequences of Floats specifying the items described below. This argument is valid only if testData=OFF.

Optional arguments

type

A SymbolicConstant specifying the type of strain energy potential. Possible values are:

  • ARRUDA_BOYCE

  • MARLOW

  • MOONEY_RIVLIN

  • NEO_HOOKE

  • OGDEN

  • POLYNOMIAL

  • REDUCED_POLYNOMIAL

  • USER

  • VAN_DER_WAALS

  • YEOH

  • UNKNOWN

The default value is UNKNOWN.

moduliTimeScale

A SymbolicConstant specifying the nature of the time response. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

n

An Int specifying the order of the strain energy potential. The default value is 1.

If testData=ON and type=POLYNOMIAL, n can take only the values 1 or 2.

If testData=ON and type=OGDEN or if testData=OFF for either type, 1 n 6.

If type=USER, this argument cannot be used.

beta

The SymbolicConstant FITTED_VALUE or a Float specifying the invariant mixture parameter. This argument is valid only if testData=ON and type=VAN_DER_WAALS. The default value is FITTED_VALUE.

testData

A Boolean specifying whether test data are supplied. The default value is ON.

compressible

A Boolean specifying whether the hyperelastic material is compressible. This parameter is applicable only to user-defined hyperelastic materials. The default value is OFF.

properties

An Int specifying the number of property values needed as data for the user-defined hyperelastic material. The default value is 0.

deviatoricResponse

A SymbolicConstant specifying which test data to use. Possible values are UNIAXIAL, BIAXIAL, and PLANAR. The default value is UNIAXIAL.

volumetricResponse

A SymbolicConstant specifying the volumetric response. Possible values are DEFAULT, VOLUMETRIC_DATA, POISSON_RATIO, and LATERAL_NOMINAL_STRAIN. The default value is DEFAULT.

poissonRatio

A Float specifying the poisson ratio. This argument is valid only if volumetricResponse=POISSON_RATIO. The default value is 0.0.

materialType

A SymbolicConstant specifying the type of material. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.

anisotropicType

A SymbolicConstant specifying the type of strain energy potential. Possible values are FUNG_ANISOTROPIC, FUNG_ORTHOTROPIC, HOLZAPFEL, and USER_DEFINED. The default value is FUNG_ANISOTROPIC.

formulation

A SymbolicConstant specifying the type of formulation. Possible values are STRAIN and INVARIANT. The default value is STRAIN.

behaviorType

A SymbolicConstant specifying the type of anisotropic hyperelastic material behavior. Possible values are INCOMPRESSIBLE and COMPRESSIBLE. The default value is INCOMPRESSIBLE.

dependencies

An Int specifying the number of field variable dependencies for the data involumetricTable . The default value is 0.

localDirections

An Int specifying the number of local directions for the data involumetricTable . The default value is 0.

Table data

If type=ARRUDA_BOYCE, the table data specify the following:

  • μ.

  • λm.

  • D.

  • Temperature, if the data depend on temperature.

If type=MOONEY_RIVLIN, the table data specify the following:

  • C10.

  • C01.

  • D1.

  • Temperature, if the data depend on temperature.

If type=NEO_HOOKE, the table data specify the following:

  • C10.

  • D1.

  • Temperature, if the data depend on temperature.

If type=OGDEN, the table data specify the following for values of n:

  • μi and αi for i from 1 to n.

  • n coefficients Di.

  • Temperature, if the data depend on temperature. Temperature dependence is not allowed for 4 n 6 in an Abaqus/Explicit analysis.

If type=POLYNOMIAL, the table data specify the following for values of n:

  • Cij for each value of (i+j) from 1 to n with i decreasing from (i+j) to zero and j increasing from zero to (i+j).

  • n coefficients Di.

  • Temperature, if the data depend on temperature. Temperature dependence is not allowed for 3 n 6 in an Abaqus/Explicit analysis.

If type=REDUCED_POLYNOMIAL, the table data specify the following for values of n:

  • Ci0 for i from 1 to n.

  • n coefficients Di.

  • Temperature, if the data depend on temperature. Temperature dependence is not allowed for 4 n 6 in an Abaqus/Explicit analysis.

If type=VAN_DER_WAALS, the table data specify the following:

  • μ.

  • λm.

  • a.

  • β.

  • D.

  • Temperature, if the data depend on temperature.

If type=YEOH, the table data specify the following:

  • C10.

  • C20.

  • C30.

  • D1.

  • D2.

  • D3.

  • Temperature, if the data depend on temperature. Temperature dependence is not allowed in an Abaqus/Explicit analysis.

The None object is the default value if testData=ON.

Return value

A Hyperelastic object.

Exceptions

InvalidNameError and RangeError.

setValues(...)

This method modifies the Hyperelastic object.

Required arguments

None.

Optional arguments

The optional arguments to setValues are the same as the arguments to the Hyperelastic method.

Return value

None.

Exceptions

RangeError.

Members

The Hyperelastic object has members with the same names and descriptions as the arguments to the Hyperelastic method.

In addition, the Hyperelastic object can have the following members:

biaxialTestData

A BiaxialTestData object.

planarTestData

A PlanarTestData object.

uniaxialTestData

A UniaxialTestData object.

volumetricTestData

A VolumetricTestData object.

hysteresis

A Hysteresis object.

Corresponding analysis keywords