HETVAL

User subroutine to provide internal heat generation in heat transfer analysis.

User subroutine HETVAL:

  • can be used to define a heat flux due to internal heat generation in a material, for example, as might be associated with phase changes occurring during the solution;

  • allows for the dependence of internal heat generation on state variables (such as the fraction of material transformed) that themselves evolve with the solution and are stored as solution-dependent state variables;

  • will be called at all material calculation points for which the material definition contains volumetric heat generation during heat transfer, coupled temperature-displacement, coupled thermal-electrical, or coupled thermal-electrical-structural analysis procedures;

  • can be useful if it is necessary to include a kinetic theory for a phase change associated with latent heat release (for example, in the prediction of crystallization in a polymer casting process);

  • can be used in conjunction with user subroutine USDFLD if it is desired to redefine any field variables before they are passed in; and

  • cannot be used with user subroutine UMATHT.

This page discusses:

See Also
In Other Guides
Uncoupled Heat Transfer Analysis
Fully Coupled Thermal-Stress Analysis
Fully Coupled Thermal-Electrical-Structural Analysis
*HEAT GENERATION
HETVAL

User Subroutine Interface

      SUBROUTINE HETVAL(CMNAME,TEMP,TIME,DTIME,STATEV,FLUX,
     1 PREDEF,DPRED)
C
      INCLUDE 'ABA_PARAM.INC'
C
      CHARACTER*80 CMNAME
C
      DIMENSION TEMP(2),STATEV(*),PREDEF(*),TIME(2),FLUX(2),
     1 DPRED(*)


      user coding to define FLUX and update STATEV


      RETURN
      END

Variables to Be Defined

FLUX(1)

Heat flux, r (thermal energy per time per volume: JT−1L−3), at this material calculation point.

FLUX(2)

Rate of change of heat flux per temperature, ∂⁡r/∂⁡θ. This variable is nonzero only if the heat flux depends on temperature. It is needed to define a correct Jacobian matrix.

Variables That Can Be Updated

STATEV(*)

An array containing the user-defined solution-dependent state variables at this point.

In an uncoupled heat transfer analysis STATEV is passed into subroutine HETVAL as the values of these variables at the beginning of the increment. However, any updating of STATEV in user subroutine USDFLD will be included in the values passed into subroutine HETVAL since this routine is called before HETVAL. In addition, if HETVAL is being used in a fully coupled temperature-displacement or coupled thermal-electrical-structural analysis and user subroutine UEXPAN, user subroutine CREEP, 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 UEXPAN, CREEP, UMAT, or UTRS will be included in the values passed into this routine.

In all cases STATEV should be passed back from user subroutine HETVAL containing the values of the state variables at the end of the current increment.

Variables Passed in for Information

CMNAME

User-specified material name, left justified.

TEMP(1)

Current temperature.

TEMP(2)

Temperature increment.

TIME(1)

Step time at the end of the increment.

TIME(2)

Total time at the end of the increment.

DTIME

Time increment.

PREDEF(*)

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

DPRED(*)

Array of increments of predefined field variables.