25.2.25 UHARD

25.2.25 `UHARD`
User subroutine to define the yield surface size and hardening parameters for isotropic plasticity or combined hardening models.

Product: ABAQUS/Standard

References

Overview

User subroutine UHARD:

is called at all material calculation points of elements for which the material definition includes user-defined isotropic hardening or cyclic hardening for metal plasticity;
can be used to define a material's isotropic yield behavior;
can be used to define the size of the yield surface in a combined hardening model;
can include material behavior dependent on field variables or state variables; and
requires, when appropriate, that the values of the derivatives of the yield stress (or yield surface size in combined hardening models) be defined with respect to the strain, strain rate, and temperature.

User subroutine interface

      SUBROUTINE UHARD(SYIELD,HARD,EQPLAS,EQPLASRT,TIME,DTIME,TEMP,
     1     DTEMP,NOEL,NPT,LAYER,KSPT,KSTEP,KINC,CMNAME,NSTATV,
     2     STATEV,NUMFIELDV,PREDEF,DPRED,NUMPROPS,PROPS)
C
      INCLUDE 'ABA_PARAM.INC'
C
      CHARACTER*80 CMNAME
      DIMENSION HARD(3),STATEV(NSTATV),TIME(*),
     $          PREDEF(NUMFIELDV),DPRED(*),PROPS(*)

      user coding to define SYIELD,HARD(1),HARD(2),HARD(3)

      RETURN
      END

Variables to be defined

SYIELD

. Yield stress for isotropic plasticity. Yield surface size for combined hardening.

HARD(1)

Variation of SYIELD with respect to the equivalent plastic strain,

HARD(2)

Variation of SYIELD with respect to the equivalent plastic strain rate, This quantity is not used with the combined hardening model.

HARD(3)

Variation of SYIELD with respect to temperature, This quantity is required only in adiabatic and fully coupled temperature-displacement analyses.

STATEV(NSTATV)

Array containing the user-defined solution-dependent state variables at this point. These are supplied as values at the beginning of the increment or as values updated by other user subroutines (see “User subroutines: overview,” Section 25.1.1) and must be returned as values at the end of the increment.

Variables passed in for information

EQPLAS

Equivalent plastic strain,

EQPLASRT

Equivalent plastic strain rate,

TIME(1)

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

TIME(2)

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

DTIME

Time increment.

TEMP

Temperature at the beginning of the increment.

DTEMP

Increment of temperature.

NOEL

Element number.

NPT

Integration point number.

LAYER

Layer number (for composite shells and layered solids).

KSPT

Section point number within the current layer.

KSTEP

Step number.

KINC

Increment number.

CMNAME

User-specified material name, left justified.

NSTATV

User-specified number of solution-dependent state variables associated with this material (“Allocating space” in “User subroutines: overview,” Section 25.1.1).

NUMFIELDV

Number of field variables.

PREDEF(NUMFIELDV)

Array of interpolated values of predefined field variables at this material point at the start of the increment based on the values read in at the nodes (initial values at the beginning of the analysis and current values during the analysis).

DPRED(NUMFIELDV)

Array of increments of predefined field variables at this material point for this increment; this includes any values updated by user subroutine USDFLD.

NPROPS

Number of hardening properties entered for this user-defined hardening definition.

PROPS(NPROPS)

Array of hardening properties entered for this user-defined hardening definition.