4.19. Custom Material Models

The following topics about creating your own custom material models are available:

4.19.1. User-Defined Material Model (UserMat)

The user-defined material option (TB,USER) describes input parameters for defining your own material model via the UserMat subroutine, which defines any material type except incompressible materials. The subroutine supports current-technology elements only. For more information, see Subroutine UserMat (Creating Your Own Material Model) in the Programmer's Reference.

Input for the user-defined option is determined by constants which you define. The TB,USER command initializes the constant table. The constants are defined via TBDATA commands (six per command). The number of constants can be any combination of the number of temperatures (NTEMP) and the number of data points per temperature (NPTS), to a maximum of NTEMP x NPTS = 1000.

Define temperatures via TBTEMP commands.

Example 4.29:  Input for a User-Defined Material
TB,USER,1,2,4                    ! Set material 1 as a user-defined
                                 ! material with two temperatures
                                 ! and four data points at each
                                 ! temperature point.
TBTEMP,1.0                       ! First temperature.
TBDATA,1,19e5,0.3,1e3,100,       ! Four material constants for
                                 ! first temperature.
TBTEMP,2.0                       ! Second temperature.
TBDATA,1,21e5,0.3,2e3,100,       ! Four material constants for
                                 ! second temperature.

For information about state variable support, see Using State Variables with the UserMat Subroutine.

4.19.2. User-Defined Thermal Material Model (UserMatTh)

The user-defined thermal material option (TB,USER) describes input parameters for defining your own thermal material model via the UserMatTh subroutine. The subroutine supports current-technology elements only. For more information, see Subroutine UserMatTh (Creating Your Own Thermal Material Model) in the Programmer's Reference.

Input for the user-defined option is determined by constants which you define. The TB,USER command initializes the constant table. The constants are defined via TBDATA commands (six per command). The number of constants can be any combination of the number of temperatures (NTEMP) and the number of data points per temperature (NPTS), to a maximum of NTEMP x NPTS = 1000.

Define temperatures via TBTEMP commands.

Example 4.30:  Input for a User-Defined Thermal Material
TB,USER,1,2,4                    ! Set material 1 as a user-defined
                                 ! material with two temperatures
                                 ! and four data points at each
                                 ! temperature point.
TBTEMP,1.0                       ! First temperature.
TBDATA,1,19e5,0.3,1e3,100,       ! Four material constants for
                                 ! first temperature.
TBTEMP,2.0                       ! Second temperature.
TBDATA,1,21e5,0.3,2e3,100,       ! Four material constants for
                                 ! second temperature.

For information about state variable support, see Using State Variables with the UserMatTh Subroutine.

4.19.3. User-Defined Cohesive Material (UserCZM)

Support is available for creating a user-defined cohesive material (TB,CZM,,,,USER) via the UserCZM subroutine. The subroutine supports interface elements (INTERnnn) only. For more information, see Subroutine userCZM (Defining Your Own Cohesive Zone Material) in the Programmer's Reference.

Input is determined by user-specified constants (TBDATA). Up to six constants can be define per TBDATA command. The number of constants can be any combination of the number of temperatures (NTEMP) and the number of data points per temperature (NPTS), such that NTEMP x NPTS <= 1000.

Example 4.31:  Input for a User-Defined Cohesive Material Law
TB,CZM,1,2,4,USER                ! Set material 1 as a user-defined
                                 !    cohesive material option with two temperatures
                                 !    and four data points at each
                                 !    temperature point.
TBTEMP,1.0                       ! First temperature.
TBDATA,1,19e5,0.3,1e3,100,       ! Four cohesive material constants for
                                 !    first temperature.
TBTEMP,2.0                       ! Second temperature.
TBDATA,1,21e5,0.3,2e3,100,       ! Four cohesive material constants for
                                 !    second temperature.

Contact elements do not support a user-defined cohesive material. However, a similar capability can be achieved by defining your own contact interface behavior via the userinter subroutine. For more information, see Defining Your Own Contact Interaction (USERINTER) in the Contact Technology Guide.

For information about state variable support, see Using State Variables with the UserCZM Subroutine.

4.19.4. Using State Variables with User-Defined Materials

The following topics related to using state variables with subroutines for creating your own custom materials are available:

4.19.4.1. Using State Variables with the UserMat Subroutine

The UserMat subroutine for creating user-defined material models supports state variables. To use them, initialize the constant table (TB,STATE), then define the constants (TBDATA).

Example 4.32:  Initializing the Values of State Variables for a User-Defined Material
TB,STATE,1,,4,                   ! Define material 1, which
                                 ! has four state variables. 
TBDATA,1,C1,C2,C3,C4,            ! Initialize the four state variables.

You can define a maximum of 1000 state variables (NPTS = 1000).

4.19.4.2. Using State Variables with the UserMatTh Subroutine

The UserMatTh subroutine for creating user-defined thermal material models supports state variables. To use them, initialize the constant table (TB,STATE), then define the constants (TBDATA).

Example 4.33:  Initializing the Values of State Variables for a User-Defined Material
TB,STATE,1,,4,                   ! Define material 1, which
                                 ! has four state variables. 
TBDATA,1,C1,C2,C3,C4,            ! Initialize the four state variables.

You can define a maximum of 1000 state variables (NPTS = 1000).

4.19.4.3. Using State Variables with the UserCZM Subroutine

The UserCZM subroutine for creating user-defined CZM models supports state variables. To use them, initialize the constant table (TB,STATE), then define the initial constants (TBDATA).

By default, the initial values of state variables are set to zero.

Example 4.34:  Initializing the Values of State Variables for a User-Defined Cohesive Material Law
TB,STATE,1,,4,            ! Define material 1, which
                          !        has four state variables. 
TBDATA,1,C1,C2,C3,C4,     ! Initialize the four state variables.


Release 18.2 - © ANSYS, Inc. All rights reserved.