This method creates a Viscoelastic object.
Path
materialApi.materials()[name].Viscoelastic
Prototype
odb_Viscoelastic&
Viscoelastic(const odb_String& domain,
const odb_SequenceSequenceDouble& table,
const odb_String& frequency,
const odb_String& type,
const odb_String& preload,
const odb_String& time,
double errtol,
int nmax,
const odb_SequenceSequenceDouble& volumetricTable);
Required arguments
- domain
An odb_String 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.
- table
An odb_SequenceSequenceDouble specifying the items described below.
Optional arguments
- frequency
An odb_String 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".
- type
An odb_String 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".
- preload
An odb_String 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".
- time
An odb_String 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".
- errtol
A Double 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".
- nmax
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".
- volumetricTable
An odb_SequenceSequenceDouble 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.
If frequency=TABULAR and type=ISOTROPIC and preload=NONE, or time=FREQUENCY_DATA the table data for table specify the following:
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.
If frequency=TABULAR and type=ISOTROPIC and preload=UNIAXIAL the table data for table specify the following:
Loss modulus.
Storage modulus.
Frequency.
Uniaxial strain.
If frequency=TABULAR and type=TRACTION and preload=NONE the table data for table specify the following:
If frequency=TABULAR and type=TRACTION and preload=UNIAXIAL or preload=UNIAXIAL_VOLUMETRIC the table data for table specify the following:
Loss modulus.
Storage modulus.
Frequency.
Closure.
If time=PRONY or frequency=PRONY, the table data for table specify the following:
, 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.