UHARD

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

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.

This page discusses:

User Subroutine Interface
Variables to Be Defined
Variables Passed in for Information

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: $σ^{0}$ . Yield stress for isotropic plasticity. Yield surface size for combined hardening.
HARD(1): Variation of SYIELD with respect to the equivalent plastic strain, $\partial σ^{0} / \partial {\bar{ε}}^{p l} .$
HARD(2): Variation of SYIELD with respect to the equivalent plastic strain rate, $\partial σ^{0} / \partial {\dot{\bar{ε}}}^{p l} .$
HARD(3): Variation of SYIELD with respect to temperature, $\partial σ^{0} / \partial θ .$ This quantity is required only in adiabatic, fully coupled temperature-displacement, and thermal-electrical-structural 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 About User Subroutines and Utilities) and must be returned as values at the end of the increment.

Variables Passed in for Information

EQPLAS: Equivalent plastic strain, ${\bar{ε}}^{p l} .$
EQPLASRT: Equivalent plastic strain rate, ${\dot{\bar{ε}}}^{p l} .$
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 for Solution-Dependent State Variables).
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.