UMATHT

User subroutine to define a material's thermal behavior.

Warning: The use of this subroutine generally requires considerable expertise. You are cautioned that the implementation of any realistic thermal model requires significant development and testing. Initial testing on models with few elements under a variety of boundary conditions is strongly recommended.

User subroutine UMATHT:

can be used to define the thermal constitutive behavior of the material as well as internal heat generation during heat transfer processes;
will be called at all material calculation points of elements for which the material definition includes a user-defined thermal material behavior;
can be used with the procedures discussed in About Heat Transfer Analysis Procedures;
can use solution-dependent state variables;
must define the internal energy per unit mass and its variation with respect to temperature and to spatial gradients of temperature;
must define the heat flux vector and its variation with respect to temperature and to gradients of temperature;
must update the solution-dependent state variables to their values at the end of the increment;
can be used in conjunction with user subroutine USDFLD to redefine any field variables before they are passed in; and
is described further in User-Defined Thermal Material Behavior.

This page discusses:

Use of Subroutine UMATHT with Coupled Temperature-Displacement and Coupled Thermal-Electrical-Structural Elements
User Subroutine Interface
Variables to Be Defined
Variables That Can Be Updated
Variables Passed in for Information
Example: Using More than One User-Defined Thermal Material Model
Example: Uncoupled Heat Transfer

Use of Subroutine UMATHT with Coupled Temperature-Displacement and Coupled Thermal-Electrical-Structural Elements

User subroutine UMATHT should be used only with reduced-integration or modified coupled temperature-displacement and coupled thermal-electrical-structural elements if the mechanical and thermal fields are not coupled through plastic dissipation. No such restriction exists with fully integrated coupled temperature-displacement and coupled thermal-electrical-structural elements.

User Subroutine Interface

      SUBROUTINE UMATHT(U,DUDT,DUDG,FLUX,DFDT,DFDG,
     1 STATEV,TEMP,DTEMP,DTEMDX,TIME,DTIME,PREDEF,DPRED,
     2 CMNAME,NTGRD,NSTATV,PROPS,NPROPS,COORDS,PNEWDT,
     3 NOEL,NPT,LAYER,KSPT,KSTEP,KINC)
C
      INCLUDE 'ABA_PARAM.INC'
C
      CHARACTER*80 CMNAME
      DIMENSION DUDG(NTGRD),FLUX(NTGRD),DFDT(NTGRD),
     1 DFDG(NTGRD,NTGRD),STATEV(NSTATV),DTEMDX(NTGRD),
     2 TIME(2),PREDEF(1),DPRED(1),PROPS(NPROPS),COORDS(3)


      user coding to define U,DUDT,DUDG,FLUX,DFDT,DFDG,
      and possibly update STATEV, PNEWDT


      RETURN
      END

Variables to Be Defined

U: Internal thermal energy per unit mass, U, at the end of increment. This variable is passed in as the value at the start of the increment and must be updated to its value at the end of the increment.
DUDT: Variation of internal thermal energy per unit mass with respect to temperature, $\partial U / \partial θ$ , evaluated at the end of the increment.
DUDG(NTGRD): Variation of internal thermal energy per unit mass with respect to the spatial gradients of temperature, $\partial U / \partial (\partial θ / \partial x)$ , at the end of the increment. The size of this array depends on the value of NTGRD as defined below. This term is typically zero in classical heat transfer analysis.
FLUX(NTGRD): Heat flux vector, $f$ , at the end of the increment. This variable is passed in with the values at the beginning of the increment and must be updated to the values at the end of the increment.
DFDT(NTGRD): Variation of the heat flux vector with respect to temperature, $\partial f / \partial θ$ , evaluated at the end of the increment.
DFDG(NTGRD,NTGRD): Variation of the heat flux vector with respect to the spatial gradients of temperature, $\partial f / \partial (\partial θ / \partial x)$ , at the end of the increment. The size of this array depends on the value of NTGRD as defined below.

Variables That Can Be Updated

STATEV(NSTATV)

An array containing the solution-dependent state variables.

In an uncoupled heat transfer analysis STATEV is passed into UMATHT with the values of these variables at the beginning of the increment. However, any changes in STATEV made in user subroutine USDFLD will be included in the values passed into UMATHT, since USDFLD is called before UMATHT. In addition, if UMATHT is being used in a fully coupled temperature-displacement or coupled thermal-electrical-structural analysis and user subroutine CREEP, user subroutine UEXPAN, user subroutine UMAT, or user subroutine UTRS is used to define the mechanical behavior of the material, those routines are called before this routine; therefore, any updating of STATEV done in CREEP, UEXPAN, UMAT, or UTRS will be included in the values passed into UMATHT.

In all cases STATEV should be passed back from UMATHT as the values of the state variables at the end of the current increment.

PNEWDT

Ratio of suggested new time increment to the time increment being used (DTIME, see below). This variable allows you to provide input to the automatic time incrementation algorithms in Abaqus/Standard (if automatic time incrementation is chosen).

PNEWDT is set to a large value before each call to UMATHT.

If PNEWDT is redefined to be less than 1.0, Abaqus/Standard must abandon the time increment and attempt it again with a smaller time increment. The suggested new time increment provided to the automatic time integration algorithms is PNEWDT × DTIME, where the PNEWDT used is the minimum value for all calls to user subroutines that allow redefinition of PNEWDT for this iteration.

If PNEWDT is given a value that is greater than 1.0 for all calls to user subroutines for this iteration and the increment converges in this iteration, Abaqus/Standard may increase the time increment. The suggested new time increment provided to the automatic time integration algorithms is PNEWDT × DTIME, where the PNEWDT used is the minimum value for all calls to user subroutines for this iteration.

If automatic time incrementation is not selected in the analysis procedure, values of PNEWDT that are greater than 1.0 will be ignored and values of PNEWDT that are less than 1.0 will cause the job to terminate.

Variables Passed in for Information

TEMP: Temperature at the start of the increment.
DTEMP: Increment of temperature.
DTEMDX(NTGRD): Current values of the spatial gradients of temperature, $\partial θ / \partial x .$
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.
PREDEF: Array of interpolated values of predefined field variables at this point at the start of the increment, based on the values read in at the nodes.
DPRED: Array of increments of predefined field variables.
CMNAME: User-defined material name, left justified.
NTGRD: Number of spatial gradients of temperature.
NSTATV: Number of solution-dependent state variables associated with this material type (defined as described in Allocating Space for Solution-Dependent State Variables).
PROPS(NPROPS): User-specified array of material constants associated with this user material.
NPROPS: User-defined number of material constants associated with this user material.
COORDS: An array containing the coordinates of this point. These are the current coordinates in a fully coupled temperature-displacement or coupled thermal-electrical-structural analysis if geometric nonlinearity is accounted for during the step (see Defining an Analysis); otherwise, the array contains the original coordinates of the point.
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.

Example: Using More than One User-Defined Thermal Material Model

To use more than one user-defined thermal material model, the variable CMNAME can be tested for different material names inside user subroutine UMATHT, as illustrated below:

IF (CMNAME(1:4) .EQ. 'MAT1') THEN
   CALL UMATHT_MAT1(argument_list)
ELSE IF(CMNAME(1:4) .EQ. 'MAT2') THEN
    CALL UMATHT_MAT2(argument_list)
END IF

UMATHT_MAT1 and UMATHT_MAT2 are the actual user material subroutines containing the constitutive material models for each material MAT1 and MAT2, respectively. Subroutine UMATHT merely acts as a directory here. The argument list can be the same as that used in subroutine UMATHT.

Example: Uncoupled Heat Transfer

As a simple example of the coding of user subroutine UMATHT, consider uncoupled heat transfer analysis in a material. The equations for this case are developed here, and the corresponding UMATHT is given. This problem can also be solved by specifying thermal conductivity, specific heat, density, and internal heat generation directly.

First, the equations for an uncoupled heat transfer analysis are outlined.

The basic energy balance is

\int_{V} ρ \dot{U} d V = \int_{S} q d S + \int_{V} r d V,

where V is the volume of solid material with surface area S, $ρ$ is the density of the material, $\dot{U}$ is the material time rate of the internal thermal energy, q is the heat flux per unit area of the body flowing into the body, and r is the heat supplied externally into the body per unit volume.

A heat flux vector $f$ is defined such that

q = - f \cdot n,

where $n$ is the unit outward normal to the surface S. Introducing the above relation into the energy balance equation and using the divergence theorem, the following relation is obtained:

\int_{V} ρ \dot{U} d V = - \int_{V} \frac{\partial}{\partial x} \cdot f d V + \int_{V} r d V .

The corresponding weak form is given by

\int_{V} δ θ ρ \dot{U} d V - \int_{V} δ g \cdot f d V = \int_{V} δ θ r d V + \int_{S} δ θ q d S,

where

g = \frac{\partial θ}{\partial x}

is the temperature gradient and $δ θ$ is an arbitrary variational field satisfying the essential boundary conditions.

Introducing the backward difference integration algorithm:

{\dot{U}}_{t + Δ t} = (U_{t + Δ t} - U_{t}) (1 / Δ t),

the weak form of the energy balance equation becomes

\frac{1}{Δ t} \int_{v} δ θ ρ (U_{t + Δ t} - U_{t}) d V = \int_{V} δ g \cdot f d V + \int_{V} δ θ r d V + \int_{S} δ θ q d S .

This nonlinear system is solved using Newton's method.

In the above equations the thermal constitutive behavior of the material is given by

U = U (θ, t, \partial θ / \partial x, s^{i}, \dots) U = U (θ, g, t, s^{i}, \dots)

and

f = f (θ, t, \partial θ / \partial x, s^{i}, \dots), f = f (θ, g, t, s^{i}, \dots),

where $s^{i}$ are state variables.

The Jacobian for Newton's method is given by (after dropping the subscripts $t + Δ t$ on U)

\begin{matrix} \frac{1}{Δ t} \int_{V} δ θ ρ \frac{\partial U}{\partial θ} d θ d V & + \frac{1}{Δ t} \int_{V} δ θ ρ \frac{\partial U}{\partial g} \cdot d g d V \\ - \int_{V} δ g \cdot \frac{\partial f}{\partial θ} d θ d V - \int_{V} δ g \cdot \frac{\partial f}{\partial g} \cdot d g d V \\ - \int_{V} δ θ \frac{\partial r}{\partial θ} d θ d V - \int_{S} δ θ \frac{\partial q}{\partial θ} d θ d S . \end{matrix}

The thermal constitutive behavior for this example is now defined. We assume a constant specific heat for the material. The heat conduction in the material is assumed to be governed by Fourier's law.

The internal thermal energy per unit mass is defined as

U = U (θ),

with

\frac{\partial U}{\partial θ} = c,

where c is the specific heat of the material and

\frac{\partial U}{\partial g} = 0.

Fourier's law for heat conduction is given as

f = - k \cdot g,

where $k$ is the thermal conductivity matrix and $x$ is position, so that

\frac{\partial f}{\partial g} = - k

and

\frac{\partial f}{\partial θ} = - \frac{\partial k}{\partial θ} \cdot g .

The assumption of conductivity without any temperature dependence implies that

\frac{\partial f}{\partial θ} = 0.

No state variables are needed for this material, so the allocation of space for them is not necessary.

A thermal user material definition can be used to read in the two constants for our simple case, namely the specific heat, c, and the coefficient of thermal conductivity, k, so that

PROPS(1) = k,

PROPS(2) = c .

      SUBROUTINE UMATHT(U,DUDT,DUDG,FLUX,DFDT,DFDG,
     1 STATEV,TEMP,DTEMP,DTEMDX,TIME,DTIME,PREDEF,DPRED,
     2 CMNAME,NTGRD,NSTATV,PROPS,NPROPS,COORDS,PNEWDT,
     3 NOEL,NPT,LAYER,KSPT,KSTEP,KINC)
C
      INCLUDE 'ABA_PARAM.INC'
C
      CHARACTER*80 CMNAME
      DIMENSION DUDG(NTGRD),FLUX(NTGRD),DFDT(NTGRD),
     1 DFDG(NTGRD,NTGRD),STATEV(NSTATV),DTEMDX(NTGRD),
     2 TIME(2),PREDEF(1),DPRED(1),PROPS(NPROPS),COORDS(3)
C
      COND = PROPS(1)
      SPECHT = PROPS(2)
C
      DUDT = SPECHT
      DU = DUDT*DTEMP
      U = U+DU
C
      DO I=1, NTGRD
         FLUX(I) = −COND*DTEMDX(I)
         DFDG(I,I) = −COND
      END DO
C
      RETURN
      END