The Viscoelastic object specifies dissipative behavior for use with elasticity.
import material mdb.models[name].materials[name].viscoelastic import odbMaterial session.odbs[name].materials[name].viscoelastic
This method creates a Viscoelastic object.
mdb.models[name].materials[name].Viscoelastic session.odbs[name].materials[name].Viscoelastic
Required arguments
A SymbolicConstant specifying the domain definition. Possible values are:
FREQUENCY, specifying a frequency domain. This domain is only available for an Abaqus/Standard analysis.
TIME, specifying a time domain.
A sequence of sequences of Floats specifying the items described below.
Optional arguments
A SymbolicConstant specifying the frequency domain definition. This argument is required only when domain=FREQUENCY. Possible values are FORMULA, TABULAR, PRONY, CREEP_TEST_DATA, and RELAXATION_TEST_DATA. The default value is FORMULA.
A SymbolicConstant specifying the type. This argument is required only when domain=FREQUENCY and frequency=TABULAR. Possible values are ISOTROPIC and TRACTION. The default value is ISOTROPIC.
A SymbolicConstant specifying the preload. This argument is required only when domain=FREQUENCY and frequency=TABULAR. Possible values are NONE, UNIAXIAL, VOLUMETRIC, and UNIAXIAL_VOLUMETRIC. The default value is NONE.
A SymbolicConstant specifying the time domain definition. This argument is required only when domain=TIME. Possible values are PRONY, CREEP_TEST_DATA, RELAXATION_TEST_DATA, and FREQUENCY_DATA. The default value is PRONY.
A Float specifying the allowable average root-mean-square error of the data points in the least-squares fit. The Float values correspond to percentages; for example, 0.01 is 1%. The default value is 0.01.
This argument is valid only when time=CREEP_TEST_DATA, RELAXATION_TEST_DATA or FREQUENCY_DATA; or only when frequency=CREEP_TEST_DATA or RELAXATION_TEST_DATA.
An Int specifying the maximum number of terms
in the Prony series. The maximum value is 13. The default value is 13.
This argument is valid only when time=CREEP_TEST_DATA, RELAXATION_TEST_DATA or FREQUENCY_DATA; or only when frequency=CREEP_TEST_DATA or RELAXATION_TEST_DATA.
A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.
Table data
If frequency=FORMULA, the table data for table specify the following:
Real part of 
.
Imaginary part of .
Value of 
.
Real part of 
. If the material is incompressible, this value is ignored.
Imaginary part of . If the material is incompressible, this value is ignored.
Value of 
. If the material is incompressible, this value is ignored.
Real part of 
.
Imaginary part of 
.
Real part of 
. If the material is incompressible, this value is ignored.
Imaginary part of 
. If the material is incompressible, this value is ignored.
Frequency 
in cycles per time.
Loss modulus.
Storage modulus.
Frequency.
Uniaxial strain.
Normalized loss modulus.
Normalized shear modulus.
Frequency.
Loss modulus.
Storage modulus.
Frequency.
Closure.
, the modulus ratio in the first term in the Prony series expansion of the shear relaxation modulus.
, the modulus ratio in the first term in the Prony series expansion of the bulk relaxation modulus.
, the relaxation time for the first term in the Prony series expansion.
If frequency=TABULAR and type=ISOTROPIC and preload=VOLUMETRIC or preload=UNIAXIAL_VOLUMETRIC the table data for volumetricTable specify the following:
Loss modulus.
Storage modulus.
Frequency.
Volume ratio.
Return value
A Viscoelastic object.
Exceptions
RangeError.
This method modifies the Viscoelastic object.
Required arguments
Optional arguments
The optional arguments to setValues are the same as the arguments to the Viscoelastic method.
Return value
Exceptions
RangeError.
The Viscoelastic object has members with the same names and descriptions as the arguments to the Viscoelastic method.
In addition, the Viscoelastic object can have the following members:
A CombinedTestData object.
A ShearTestData object.
A Trs object.
A VolumetricTestData object.