25.2.42 UTRS
User subroutine to define a reduced time shift function for a viscoelastic material.

Product: ABAQUS/Standard  

References

Overview

User subroutine UTRS:

  • can be used to define a temperature-time shift for a time domain viscoelastic analysis;

  • will be called for all material points of elements for which a user-defined shift function is specified to define the time-temperature correspondence as part of the viscoelastic material definition;

  • will be called before user subroutine UMATHT (UMATHT, Section 25.2.31) and/or user subroutine HETVAL (HETVAL, Section 25.2.12) if either or both are to be used with UTRS in a fully coupled temperature-displacement analysis;

  • can use and update solution-dependent state variables; and

  • can be used in conjunction with user subroutine USDFLD to redefine any field variables before they are passed in (see USDFLD, Section 25.2.39).

User subroutine interface

      SUBROUTINE UTRS(SHIFT,TEMP,DTEMP,TIME,DTIME,PREDEF,DPRED,
     1 STATEV,CMNAME,COORDS)
C
      INCLUDE 'ABA_PARAM.INC'
C
      CHARACTER*80 CMNAME
      DIMENSION SHIFT(2),TIME(2),PREDEF(1),DPRED(1),STATEV(1),
     1 COORDS(1)
C

      user coding to define SHIFT(1) and SHIFT(2)

      RETURN
      END

Variable to be defined

SHIFT

An array of length two that defines the shift function, (), at this point. SHIFT(1) defines the shift function at the beginning of the increment, and SHIFT(2) defines the shift function at the end of the increment. ABAQUS/Standard will apply an averaging scheme to these values that assumes that the natural logarithm of the shift function can be approximated by a linear function over the increment.

If either element of SHIFT is found to be less than or equal to zero, the analysis will terminate with an error message.

Variables that can be updated

STATEV

An array containing the solution-dependent state variables at this point. This array will be passed in containing the values of these variables at the start of the increment unless they are updated in user subroutines USDFLD (USDFLD, Section 25.2.39) or UEXPAN (UEXPAN, Section 25.2.20), in which case the updated values are passed in. If any of the solution-dependent state variables are being used in conjunction with the viscoelastic behavior, they must be updated in this subroutine to their values at the end of the increment.

Variables passed in for information

TEMP

Temperature at the end of the increment.

DTEMP

Increment of temperature during the time increment.

PREDEF

An array containing the values of all of the user-specified field variables at this point at the end of the increment (initial values at the beginning of the analysis and current values during the analysis).

DPRED

An array containing the increments of all of the predefined field variables during the time increment.

TIME(1)

Value of step time at the end of the current increment.

TIME(2)

Value of total time at the end of the current increment.

DTIME

Time increment. If this subroutine is called during a procedure such as a static analysis in which the viscoelastic effects will not be taken into account, this variable is passed in as zero.

CMNAME

User-specified material name, left justified.

COORDS

An array containing the coordinates of the material point. These are the current coordinates if geometric nonlinearity is accounted for during the step (see Procedures: overview, Section 6.1.1); otherwise, the array contains the original coordinates of the point.

Example