Abaqus Keywords Reference Guide  
How to find keyword examples

*VISCOELASTIC
Specify dissipative behavior for use with elasticity.

This option is used to generalize a material's elastic response to include viscoelasticity. The viscoelasticity can be defined as a function of frequency for steady-state small-vibration analyses, as a function of reduced time for time-dependent analyses, or by specifying a creep law for nonlinear viscoelastic analyses.

Products: Abaqus/Standard  Abaqus/Explicit  Abaqus/CAE  

Type: Model data

Level: Model  

Abaqus/CAE: Property module

References:

Required, mutually exclusive parameters: 

FREQUENCY

This parameter applies only to Abaqus/Standard analyses.

Use this parameter to choose the frequency domain definition. In this case the material's long-term elasticity must be defined using the *ELASTIC or the *HYPERELASTIC option.

Set FREQUENCY=CREEP TEST DATA to define the frequency domain response using a Prony series representation of the relaxation moduli, if the Prony series parameters are to be computed from shear and volumetric creep test data.

Set FREQUENCY=FORMULA to define the dissipative material parameters by the power law formulæ.

Set FREQUENCY=PRONY to define the frequency domain response using a Prony series representation of the relaxation moduli by specifying the Prony series parameters.

Set FREQUENCY=RELAXATION TEST DATA to define the frequency domain response using a Prony series representation of the relaxation moduli, if the Prony series parameters are to be computed from shear and volumetric relaxation test data.

Set FREQUENCY=TABULAR to provide tabular definition of the frequency domain response.

NONLINEAR

Include this parameter to define a nonlinear viscoelastic network within the parallel rheological framework.

TIME

Use this parameter to choose the time domain definition. In this case the material's elasticity must be defined using the *ELASTIC, the *HYPERELASTIC, or the *HYPERFOAM option.

Set TIME=CREEP TEST DATA if the Prony series parameters are to be computed by Abaqus from data taken from shear and volumetric creep tests.

Set TIME=FREQUENCY DATA if the Prony series parameters are to be computed by Abaqus from frequency-dependent cyclic test data.

Set TIME=PRONY to define a linear, isotropic, viscoelastic material by giving the parameters of the Prony series representation of the relaxation moduli.

Set TIME=RELAXATION TEST DATA if the Prony series parameters are to be computed by Abaqus from data taken from shear and volumetric relaxation tests.

Required parameters when the NONLINEAR parameter is included: 

LAW

Set LAW=BERGSTROM-BOYCE to choose a Bergstrom-Boyce law.

Set LAW=HYPERB to choose a hyperbolic-sine law.

Set LAW=POWER LAW to choose a power law model.

Set LAW=STRAIN to choose a strain hardening power law.

Set LAW=USER to input the creep law using user subroutine UCREEPNETWORK or user subroutine VUCREEPNETWORK.

NETWORKID

Set this parameter equal to the network id. This number must be greater than or equal to 1 and smaller than or equal to the number of networks. The network ids must consist of consecutive integers.

SRATIO

Set this parameter equal to the stiffness ratio for the network. The sum of the ratios for the networks must be smaller than or equal to 1. If the sum is smaller than 1, an additional elastic network is defined with the value of the stiffness ratio such that the condition is satisfied.

Optional parameters:

DEPENDENCIES

This parameter applies only to Abaqus/Standard analyses and can be used only when the NONLINEAR parameter is included.

Set this parameter equal to the number of field variable dependencies included in the definition of the creep constants in addition to temperature. If this parameter is omitted, it is assumed that the creep constants have no dependencies or depend only on temperature. See “Specifying field variable dependence” in “Material data definition,” Section 21.1.2 of the Abaqus Analysis User's Guide, for more information.

PRELOAD

This parameter applies only to Abaqus/Standard analyses.

This parameter can be used only in conjunction with FREQUENCY=TABULAR to specify the nature of preload used for defining frequency-domain viscoelastic material properties or effective thickness-direction gasket properties.

Set PRELOAD=UNIAXIAL to specify that the frequency-domain viscoelastic material properties correspond to a uniaxial test.

Set PRELOAD=VOLUMETRIC to specify that the frequency-domain viscoelastic material properties correspond to a volumetric test. This setting is not meaningful when used with gasket elements to define effective thickness-direction properties.

PROPERTIES

This parameter applies only to Abaqus/Standard analyses and can be used only when LAW=USER is used.

Set this parameter equal to the number of property values needed as data in user subroutine UCREEPNETWORK or user subroutine VUCREEPNETWORK. The default is PROPERTIES=0.

TYPE

This parameter cannot be used in conjunction with the NONLINEAR parameter.

Use this parameter to define whether the *VISCOELASTIC option is being used to define continuum material properties or effective thickness-direction gasket properties.

Set TYPE=ISOTROPIC (default, and only option for Abaqus/Explicit) to define continuum material properties. This choice is appropriate when the viscoelasic material model is used for any continuum, structural, or special-purpose elements whose material response is modeled using continuum material properties (examples of such special-purpose elements include modeling cohesive elements with a continuum response—see “Modeling of an adhesive layer of finite thickness” in “Defining the constitutive response of cohesive elements using a continuum approach,” Section 32.5.5 of the Abaqus Analysis User's Guide, or gasket elements with a material response—see “Defining the gasket behavior using a material model,” Section 32.6.5 of the Abaqus Analysis User's Guide). In Abaqus/Explicit this parameter should also be used for the definition of viscoelastic properties for cohesive elements with elastic traction-separation behavior (“Modeling rate-dependent traction-separation behavior in Abaqus/Explicit” in “Defining the constitutive response of cohesive elements using a traction-separation description,” Section 32.5.6 of the Abaqus Analysis User's Guide).

Set TYPE=TRACTION to define effective thickness-direction gasket properties. This option is supported only for gasket elements whose behavior is modeled directly using a gasket behavior model (“Defining the gasket behavior using a material model,” Section 32.6.5 of the Abaqus Analysis User's Guide).

Optional parameters when test data are given to define time domain viscoelasticity with TIME=CREEP TEST DATA, TIME=RELAXATION TEST DATA, or TIME=FREQUENCY DATA or when test data are given to define frequency domain viscoelasticity with FREQUENCY=CREEP TEST DATA or FREQUENCY=RELAXATION TEST DATA: 

ERRTOL

Set this parameter equal to the allowable average root-mean-square error of the data points in the least-squares fit. The default is 0.01 (1%).

NMAX

Set this parameter equal to the maximum number of terms N in the Prony series. Abaqus will perform the least-squares fit from to NMAX until convergence is achieved for the lowest N with respect to ERRTOL. The default and maximum value is 13.

Data line to define continuum material properties for FREQUENCY=FORMULA: 

First (and only) line:

  1. Real part of . 

  2. Imaginary part of .

  3. Value of a.

  4. Real part of .  If the material is incompressible, this value is ignored.

  5. Imaginary part of . If the material is incompressible, this value is ignored.

  6. Value of b. If the material is incompressible, this value is ignored.

Data lines to define continuum material properties for FREQUENCY=TABULAR without the PRELOAD parameter or for TIME=FREQUENCY DATA: 

First line:

  1. Real part of . 

  2. Imaginary part of . 

  3. Real part of .  If the material is incompressible, this value is ignored.

  4. Imaginary part of .   If the material is incompressible, this value is ignored.

  5. Frequency, f, in cycles per time.

Repeat this data line as often as necessary to define the dissipative part of the material behavior.

Data lines to define continuum material properties for FREQUENCY=TABULAR, PRELOAD=UNIAXIAL: 

First line:

  1. Uniaxial loss modulus.

  2. Uniaxial storage modulus.

  3. Frequency, f, in cycles per time.

  4. Uniaxial nominal strain (defines the level of uniaxial preload).

Repeat this data line as often as necessary to define the uniaxial loss and storage moduli as functions of frequency and preload.

Data lines to define continuum material properties for FREQUENCY=TABULAR, PRELOAD=VOLUMETRIC: 

First line:

  1. Bulk loss modulus.

  2. Bulk storage modulus.

  3. Frequency, f, in cycles per time.

  4. Volume ratio, J (current volume/original volume; defines the level of volumetric preload).

Repeat this data line as often as necessary to define the bulk loss and storage moduli as functions of frequency and preload.

Data lines to specify continuum material properties with the Prony series parameters directly using TIME=PRONY or FREQUENCY=PRONY: 

First line:

  1. , the modulus ratio in the first term in the Prony series expansion of the shear relaxation modulus.

  2. , the modulus ratio in the first term in the Prony series expansion of the bulk relaxation modulus.

  3. , the relaxation time for the first term in the Prony series expansion.

Repeat this data line as often as necessary to define the second, third, etc. terms in the Prony series. There is no restriction on the number of terms in the Prony series.

Data lines to define viscoelastic properties for cohesive elements with elastic traction-separation behavior using TIME=PRONY: 

First line:

  1. , the modulus ratio in the first term in the Prony series expansion of the shear traction relaxation modulus.

  2. , the modulus ratio in the first term in the Prony series expansion of the normal traction relaxation modulus.

  3. , the relaxation time for the first term in the Prony series expansion.

Repeat this data line as often as necessary to define the second, third, etc. terms in the Prony series. There is no restriction on the number of terms in the Prony series.

Data lines to define viscoelastic properties for cohesive elements with elastic traction-separation behavior using TIME=FREQUENCY DATA: 

First line:

  1. Real part of . 

  2. Imaginary part of . 

  3. Real part of . 

  4. Imaginary part of . 

  5. Frequency, f, in cycles per time.

Repeat this data line as often as necessary to define the dissipative part of the material behavior.

To specify viscoelastic behavior via test data: 

No data lines are used with this option when either TIME=CREEP TEST DATA or TIME=RELAXATION TEST DATA is specified. The test data are given by the *SHEAR TEST DATA and the *VOLUMETRIC TEST DATA options or by the *COMBINED TEST DATA option.

Data lines to define effective thickness-direction gasket properties for PRELOAD=UNIAXIAL: 

First line:

  1. Effective thickness-direction loss modulus.

  2. Effective thickness-direction storage modulus.

  3. Frequency, f, in cycles per time.

  4. Closure (defines the level of preload).

Repeat this data line as often as necessary to define the effective thickness-direction gasket loss and storage moduli as functions of frequency and preload.

Data lines to define effective thickness-direction gasket properties if PRELOAD=UNIAXIAL is not included: 

First line:

  1. Real part of . , where represents the complex effective thickness direction dynamic stiffness.

  2. Imaginary part of . , where represents the complex effective thickness direction dynamic stiffness.

  3. Frequency, f, in cycles per time.

Repeat this data line as often as necessary to define the normalized effective thickness-direction gasket loss and storage moduli as functions of frequency.

Data lines for LAW=BERGSTROM-BOYCE: 

First line:

  1. Creep parameter, A.

  2. Effective stress exponent, m.

  3. Creep strain exponent, C.

  4. Constant, E, for regularizing the creep strain rate near the undeformed state. The value of E should be non-negative. If this field is left blank, the default value of 0.01 is used.

Subsequent lines (only needed if the DEPENDENCIES parameter has a value greater than four):

  1. Fifth field variable.

  2. Etc., up to eight field variables per line.

Repeat this set of data lines as often as necessary to define the dependence of the creep constants on temperature and other predefined field variables.

Data lines for LAW=HYPERB: 

First line:

  1. A. (Units of T–1.)

  2. B. (Units of F–1L2.)

  3. n.

  4. First field variable.

  5. Second field variable.

  6. Third field variable.

  7. Fourth field variable.

  8. Fifth field variable.

Subsequent lines (only needed if the DEPENDENCIES parameter has a value greater than five):

  1. Sixth field variable.

  2. Etc., up to eight field variables per line.

Repeat this set of data lines as often as necessary to define the dependence of the creep constants on predefined field variables.

Data lines for LAW=POWER LAW: 

First line:

  1. . (Units of FL–2.)

  2. n.

  3. m.

  4. a. The default is 0.0.

  5. . The default is 1.0. (Units of T–1.)

  6. Temperature.

  7. First field variable.

  8. Second field variable.

  9. Etc., up to four field variables.

Subsequent lines (only needed if the DEPENDENCIES parameter has a value greater than four):

  1. Fifth field variable.

  2. Etc., up to eight field variables per line.

Repeat this set of data lines as often as necessary to define the dependence of the creep constants on temperature and other predefined field variables.

Data lines for LAW=STRAIN: 

First line:

  1. A. (Units of FLT.)

  2. n.

  3. m.

  4. Temperature.

  5. First field variable.

  6. Second field variable.

  7. Etc., up to four field variables.

Subsequent lines (only needed if the DEPENDENCIES parameter has a value greater than four):

  1. Fifth field variable.

  2. Etc., up to eight field variables per line.

Repeat this set of data lines as often as necessary to define the dependence of the creep constants on temperature and other predefined field variables.

Data lines for LAW=USER: 

No data lines are needed if the PROPERTIES parameter is omitted or set to 0. Otherwise, first line:

  1. Give the properties, eight per line.

Repeat this data line as often as necessary to define the material properties.