TB

TB, Lab, MATID, NTEMP, NPTS, TBOPT, EOSOPT, FuncName
Activates a data table for material properties or special element input.

PREP7: Data Tables

Product Restrictions

For a list of elements and the material models they support (Lab value), see Element Support for Material Models in the Element Reference.

For a list of material models and the elements that support them, see Material Model Element Support in the Material Reference.

Lab

Material model data table type:

AFDM	—	Acoustic frequency-dependent material.
AHYPER	—	Anisotropic hyperelasticity.
ANEL	—	Anisotropic elasticity.
BB	—	Bergstrom-Boyce.
BH	—	Magnetic field data.
BISO	—	Bilinear isotropic hardening using von Mises or Hill plasticity.
BKIN	—	Bilinear kinematic hardening using von Mises or Hill plasticity.
CAST	—	Cast iron.
CDM	—	Mullins effect (for isotropic hyperelasticity models).
CGCR	—	Crack-growth fracture criterion (CGROW).
CHABOCHE	—	Chaboche nonlinear kinematic hardening using von Mises or Hill plasticity.
COMP	—	Composite damage (explicit dynamic analysis).
CONCR	—	Concrete element or material data.
CREEP	—	Creep. Pure creep, creep with isotropic hardening plasticity, or creep with kinematic hardening plasticity using both von Mises or Hill potentials.
CTE	—	Secant coefficient of thermal expansion.
CZM	—	Cohesive zone.
DENS	—	Mass Density.
DISCRETE	—	Explicit spring-damper (discrete).
DMGE	—	Damage evolution law.
DMGI	—	Damage initiation criteria.
DP	—	Classic Drucker-Prager plasticity.
DPER	—	Anisotropic electric permittivity.
EDP	—	Extended Drucker-Prager (for granular materials such as rock, concrete, soil, ceramics and other pressure-dependent materials).
ELASTIC	—	Elasticity. For full harmonic analyses, properties can be defined as frequency- or temperature-dependent (TBFIELD).
EOS	—	Equation of state (explicit dynamic analysis).
EVISC	—	Viscoelastic element data (explicit dynamic analysis).
EXPE	—	Experimental data.
FCON	—	Fluid conductance data (explicit dynamic analysis).
FCLI	—	Material strength limits for calculating failure criteria.
FLUID	—	Fluid.
FOAM	—	Foam (explicit dynamic analysis).
FRIC	—	Coefficient of friction based on Coulomb's Law or user-defined friction.
GASKET	—	Gasket.
GCAP	—	Geological cap (explicit dynamic analysis).
GURSON	—	Gurson pressure-dependent plasticity for porous metals.
HFLM	—	Film coefficient data.
HILL	—	Hill anisotropy. When combined with other material options, simulates plasticity, viscoplasticity, and creep -- all with the Hill potential.
HONEY	—	Honeycomb (explicit dynamic analysis).
HYPER	—	Hyperelasticity material models (Arruda-Boyce, Blatz-Ko, Extended Tube, Gent, Mooney-Rivlin [default], Neo-Hookean, Ogden, Ogden Foam, Polynomial Form, Response Function, Yeoh, and user-defined).
INTER	—	Contact interaction.
JOIN	—	Joint (linear and nonlinear elastic stiffness, linear and nonlinear damping, and frictional behavior).
JROCK	—	Jointed rock.
MC	—	Mohr-Coulomb.
MIGR	—	Migration model.
MOONEY	—	Mooney-Rivlin hyperelasticity (explicit dynamic analysis).
MPLANE	—	Microplane.
NLISO	—	Voce isotropic hardening law (or power law) for modeling nonlinear isotropic hardening using von Mises or Hill plasticity.
PELAS	—	Porous elasticity.
PERF	—	Equivalent fluid model of perforated media.
PIEZ	—	Piezoelectric matrix.
PLASTIC	—	Nonlinear plasticity.
PLAW	—	Plasticity laws (explicit dynamic analysis).
PM	—	Porous media. Coupled pore-fluid diffusion and structural model of porous media.
PRONY	—	Prony series constants for viscoelastic materials.
PZRS	—	Piezoresistivity.
RATE	—	Rate-dependent plasticity (viscoplasticity) when combined with the BISO, NLISO or PLASTIC material options, or rate-dependent anisotropic plasticity (anisotropic viscoplasticity) when combined with the HILL and BISO, NLISO or PLASTIC material options. The exponential visco-hardening option includes an explicit function for directly defining static yield stresses of materials. The Anand unified plasticity option requires no combination with other material models.
SDAMP	—	Material damping coefficients.
SHIFT	—	Shift function for viscoelastic materials.
SMA	—	Shape memory alloy for simulating hysteresis superelastic behavior with no performance degradation. Plane stress is not supported.
SOIL	—	Soil models.
STATE	—	User-defined state variables. Valid with TB,USER and used with either the `UserMat` or `UserMatTh` subroutine. Also valid with TB,CREEP (when `TBOPT` = 100) and used with the `UserCreep` subroutine.
SWELL	—	Swelling strain function.
THERM	—	Thermal properties.
UNIAXIAL	—	Uniaxial stress-strain relation associated with the Cast iron material model.
USER	—	User-defined material model (general-purpose except for incompressible material models) or thermal material model.
WEAR	—	Contact surface wear.

MATID

Material reference identification number. Default = 1.

NTEMP

The number of temperatures for which data will be provided (if applicable). Specify temperatures via the TBTEMP command.

NPTS

For most labels where NPTS is defined, the number of data points to be specified for a given temperature. Define data points via the TBDATA or TBPT commands.

EOSOPT

Indicates which equation of state model will be used. Used only for explicit dynamics, and only when Lab = EOS.

1	—	Linear polynomial equation of state
2	—	Gruneisen equation of state
3	—	Tabulated equation of state

FuncName

The name of the function to be used (entered as %tabname%, where tabname is the name of the table created by the Function Tool). Valid only when Lab = JOIN (joint element material) and nonlinear stiffness or damping are specified on the TBOPT field (see "JOIN -- Joint Element Specifications"). The function must be previously defined using the Function Tool. To learn more about how to create a function, see Using the Function Tool in the Basic Analysis Guide.

Data Table Specifications

Following are input requirements (NTEMP, NPTS, and TBOPT values) and links to detailed documentation for each data table type (TB,Lab value):

AFDM -- Acoustic Frequency-Dependent Material Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Acoustic material options:

MAT: Material properties
THIN: Thin layer
RECT: Rectangular cross-section
CIRC: Circular cross-section

References:

Defining Acoustic Material Properties in the Acoustic Analysis Guide.

Acoustic Frequency-Dependent Materials in the Material Reference.

See the TBFIELD command for more information about defining temperature- and/or frequency-dependent properties.

AHYPER -- Anisotropic Hyperelasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 40.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

Anisotropic hyperelastic material options.

POLY --: Polynomial strain energy potential.
EXPO --: Exponential strain energy potential.
AVEC --: Define the A vector.
BVEC --: Define the B vector.
PVOL --: Volumetric potential.

References:

Anisotropic Hyperelasticity in the Material Reference.

Anisotropic Hyperelasticity in the Mechanical APDL Theory Reference

ANEL -- Anisotropic Elasticity Specifications

This material model is not supported for use with the coefficient of thermal expansion (TB,CTE).

NTEMP:

Number of temperatures for which data will be provided. Default = 6. Maximum = 6. NTEMP is not used for explicit dynamic elements.

NPTS:

Not used.

TBOPT:

Anisotropic elastic matrix options.

0 --: Elasticity matrix used as supplied (input in stiffness form).
1 --: Elasticity matrix inverted before use (input in flexibility form). This option is not valid for explicit dynamic elements.

References:

Anisotropic Elasticity in the Material Reference.

Linear Elastic Models in the ANSYS LS-DYNA User's Guide.

BB -- Bergstrom-Boyce Hyperelasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. The maximum must be a value such that (NTEMP x NPTS) <= 1000.

NPTS:

Number of material constants. If TBOPT = ISO, then NPTS = 7. If TBOPT = 1, then NPTS = 1.

TBOPT:

Isochoric or volumetric strain-energy function:

ISO --: Define material constants for isochoric strain energy.
PVOL --: Define material constants for volumetric strain energy.

References:

Bergstrom-Boyce in the Mechanical APDL Theory Reference.

Bergstrom-Boyce Material in the Material Reference.

Bergstrom-Boyce Hyperviscoelastic Material Model in the Structural Analysis Guide.

BH -- Magnetic Field Data Specifications

NTEMP:

Not used.

NPTS:

Number of data points to be specified. Default = 20. Maximum = 500.

TBOPT:

Not used.

References:

Magnetic Materials in the Material Reference.

Additional Guidelines for Defining Regional Material Properties and Real Constants in the Low-Frequency Electromagnetic Analysis Guide.

BISO -- Bilinear Isotropic Hardening Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 6.

NPTS:

Not used.

TBOPT:

Not used.

References:

Bilinear Isotropic Hardening in the Material Reference.

Nonlinear Inelastic Models in the ANSYS LS-DYNA User's Guide.

BKIN -- Bilinear Kinematic Hardening Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 6.

NPTS:

Not used.

TBOPT:

Stress-strain options (not used in an explicit dynamics analysis).

0 --: No stress relaxation with temperature increase (not recommended for nonisothermal problems).
1 --: Rice's hardening rule, which takes into account stress relaxation with increasing temperature (default).

References:

Bilinear Kinematic Hardening in the Material Reference.

Nonlinear Inelastic Models in the ANSYS LS-DYNA User's Guide.

CAST -- Cast Iron Plasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 10.

NPTS:

Not used.

TBOPT:

Defines hardening type.

ISOTROPIC --: Specifies cast iron plasticity with isotropic hardening.

References:

Cast Iron in the Material Reference.

CDM -- Mullins Effect Hyperelasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. The maximum must be a value such that (NTEMP x NPTS) <= 1000.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

Mullins effect option:

PSE2 --: Pseudo-elastic model with modified Ogden-Roxburgh damage function. Requires NPTS = 3.

References:

Mullins Effect in the Mechanical APDL Theory Reference.

Mullins Effect in the Material Reference.

Mullins Effect Material Model in the Structural Analysis Guide.

CGCR -- Crack-Growth Fracture Criterion

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

Fracture criterion option:

LINEAR --: Linear fracture criterion. Valid when NPTS = 3.
BILINEAR --: Bilinear fracture criterion. Valid when NPTS = 4.
BK --: B-K fracture criterion. Valid when NPTS = 3.
MBK --: Modified B-K (Reeder) fracture criterion. Valid when NPTS = 4.
POWERLAW --: Wu's Power Law fracture criterion. Valid when NPTS = 6.
USER --: User-defined fracture criterion. Valid when NPTS = 20.
PSMAX --: Circumferential stress criterion based on when sweeping around the crack tip at a given radius. Valid when NPTS = 1. This option is used in an XFEM-based crack-growth analysis only.
STTMAX --: Maximum circumferential stress criterion. Valid when NPTS = 1. This option is used in an XFEM-based crack-growth analysis only.
RLIN --: Rigid linear evolution law for the decay of stress. Valid when NPTS = 4. This option is used in an XFEM-based crack-growth analysis only.
PARIS --: Paris' Law for fatigue crack growth. Valid when NPTS = 2.

Note: In an XFEM-based crack-growth analysis, the only valid options are PSMAX, STTMAX and RLIN. The PARIS option is valid for XFEM-based fatigue crack-growth analysis only.

References:

Fracture Criteria in the Structural Analysis Guide.

CGROW command in the Command Reference.

CHABOCHE -- Chaboche Nonlinear Kinematic Hardening Specifications

NTEMP:: Number of temperatures for which data will be provided. Default = 1. The maximum value of NTEMP is such that NTEMP x (1 + 2NPTS) = 1000.
NPTS:: Number of kinematic models to be superposed. Default = 1. Maximum = 5.
TBOPT:: Not used.
References:: Nonlinear Kinematic Hardening in the Material Reference.

COMP -- Composite Damage Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Composite Damage Model in the ANSYS LS-DYNA User's Guide.

CONCR -- Concrete Plasticity Specifications

NTEMP:

Number of temperatures for which data will be provided (used only if TBOPT = 0 or 1). Default = 6. Maximum = 6.

NPTS:

Not used.

TBOPT:

Concrete material options.

DP --: Drucker-Prager concrete strength parameters.
RCUT --: Rankine tension failure parameter.
DILA --: Drucker-Prager concrete dilatation.
HSD2 --: Drucker-Prager concrete exponential hardening/softening/dilitation (HSD) behavior.
HSD4 --: Drucker-Prager concrete steel reinforcement HSD behavior.
HSD5 --: Drucker-Prager concrete fracture energy HSD behavior.
HSD6 --: Drucker-Prager concrete linear HSD behavior.
FPLANE --: Drucker-Prager concrete joint parameters.
FTCUT --: Drucker-Prager concrete joint tension cutoff.
FORIE --: Drucker-Prager concrete joint orientation.
MW --: Menetrey-Willam constitutive model.
0 or 1 --: General concrete option for element SOLID65.
2 --: Concrete damage model for explicit dynamic elements SOLID164 and SOLID168.

References:

Drucker-Prager Concrete.

Hardening, Softening and Dilatation (HSD) Behavior

Menetrey-Willam.

Concrete Damage Model and SOLID65.

CREEP -- Creep Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum value of NTEMP is such that NTEMP x NPTS = 250 for explicit creep. There is no limit for implicit creep.

NPTS:

Number of data points to be specified for a given temperature. Default = 72 for explicit creep. There is no limit for implicit creep with the USER CREEP option.

TBOPT:

Creep model options.

0 --: (or Blank) Explicit creep option. Creep is defined by constants C₆, C₁₂, and C₆₆, via TBDATA. See Primary Explicit Creep Equation for C6 = 0 through Irradiation Induced Explicit Creep Equation for C66 = 5 for the associated equations. (Applicable to SOLID65.) C₆ = 100 defines the USER CREEP option for explicit creep. You must define the creep law using the subroutine USERCR.F. See the Guide to User-Programmable Features in the Mechanical APDL Programmer's Reference for more information.
1 through 13 --: Implicit creep option. See Table 4.2: Implicit Creep Equations for a list of available equations. Use TBTEMP and TBDATA to define temperature-dependent constants. (Applicable to LINK180 , SHELL181, PLANE182, PLANE183, SOLID185, SOLID186 , SOLID187 , BEAM188, BEAM189, SOLSH190, SHELL208, SHELL209, REINF264, REINF265, SOLID272, SOLID273, SHELL281, SOLID285, PIPE288, PIPE289, and ELBOW290).
100 --: USER CREEP option (applicable to LINK180, SHELL181, PLANE182, PLANE183, SOLID185, SOLID186, SOLID187, BEAM188, BEAM189, SOLSH190, SHELL208, SHELL209, REINF264, REINF265, SOLID272, SOLID273, SHELL281, SOLID285, PIPE288, PIPE289, and ELBOW290). You must define the creep law using the subroutine USERCREEP.F. See the Guide to User-Programmable Features in the Mechanical APDL Programmer's Reference for more information. Use TBTEMP and TBDATA to define temperature-dependent constants. For implicit creep, use with TB,STATE for defining the number of state variables.

References:

Creep in the Material Reference.

Creep in the Structural Analysis Guide.

CTE -- Secant Coefficient of Thermal Expansion Specifications

NTEMP:

No limit.

NPTS:

Not used.

TBOPT:

(blank) --: Enter the secant coefficients of thermal expansion (CTEX,CTEY,CTEZ) (default).
USER --: User-defined thermal strain. For more information, see Subroutine userthstrain (Defining Your Own Thermal Strain) in the Mechanical APDL Programmer's Reference.

References:

Thermal Expansion in the Material Reference.

See also TBFIELD (for defining frequency-dependent, temperature-dependent, and user-defined field-variable-based properties).

CZM -- Cohesive Zone Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

Cohesive zone material options.

EXPO --: Exponential material behavior. Valid for interface elements and contact elements.
BILI --: Bilinear material behavior. Valid for interface elements, contact elements, and in an XFEM-based crack-growth analysis when cohesive behavior on the initial crack is desired.
CBDD --: Bilinear material behavior with linear softening characterized by maximum traction and maximum separation. Valid for contact elements only.
CBDE --: Bilinear material behavior with linear softening characterized by maximum traction and critical energy release rate. Valid for contact elements only.
VREG --: Viscous regularization. Valid for interface elements and contact elements. Also valid in an XFEM-based crack-growth analysis when cohesive behavior is specified for the initial crack.
USER --: User-defined option. Valid for interface elements only.

References:

Cohesive Zone Material (CZM) Model in the Mechanical APDL Theory Reference.

Cohesive Material Law in the Material Reference.

Subroutine userCZM (Defining Your Own Cohesive Zone Material) in the Programmer's Reference.

Crack Growth Simulation, Interface Delamination, and Fatigue Crack Growth in the Fracture Analysis Guide.

XFEM-Based Crack Analysis and Crack-Growth Simulation in the Fracture Analysis Guide.

DENS -- Mass Density Specifications

NTEMP:: Not used.
NPTS:: 1
TBOPT:: Not used.
References:: See the TBFIELD command and User-Defined Field Variables in the Mechanical APDL Material Reference and for more information about defining temperature-dependent and/or user-defined field-variable-based properties.

DISCRETE -- Explicit Spring-Damper (Discrete) Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Explicit spring-damper (discrete) material options.

0 --: Linear elastic spring (translational or rotational elastic spring) (default).
1 --: Linear viscous damper (linear translational or rotational damper)
2 --: Elastoplastic spring (elastoplastic translational or rotational spring with isotropic hardening)
3 --: Nonlinear elastic spring (nonlinear elastic translational or rotational spring with arbitrary force/displacement response moment/rotation dependency)
4 --: Nonlinear viscous damper (nonlinear damping with arbitrary force/velocity response moment/rotational velocity dependency)
5 --: General nonlinear spring (general nonlinear translational or rotational spring with arbitrary loading and unloading definitions)
6 --: Maxwell viscoelastic spring (Maxwell viscoelastic translational or rotational spring)
7 --: Inelastic tension or compression-only spring (inelastic tension or compression only, translational or rotational spring)

References:

Spring-Damper (Discrete) Models in the ANSYS LS-DYNA User's Guide.

DMGE -- Damage Evolution Law Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature. Default = 4 when TBOPT = MPDG

TBOPT:

Damage initiation definition:

1 or MPDG --: Progressive damage evolution based on simple instant material stiffness reduction.
2 or CDM --: Progressive damage evolution based on continuum damage mechanics.

Reference:

Damage Evolution Law in the Material Reference.

DMGI -- Damage Initiation Criteria Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature. Default = 4 when TBOPT = FCRT.

TBOPT:

Damage initiation definition:

1 or FCRT --: Define failure criteria as the damage initiation criteria.

Reference:

Damage Initiation Criteria in the Material Reference.

DP -- Classic Drucker-Prager Plasticity Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Classic Drucker-Prager in the Material Reference.

DPER -- Anisotropic Electric Permittivity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Permittivity matrix options for PLANE223, SOLID226, and SOLID227:

0 --: Permittivity matrix at constant strain [ε^S] (used as supplied)
1 --: Permittivity matrix at constant stress [ε^T] (converted to [ε^S] form before use)

References:

Anisotropic Electric Permittivity in the Material Reference.

EDP -- Extended Drucker-Prager Plasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 40.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

EDP material options.

LYFUN --: Linear yield function.
PYFUN --: Power law yield function.
HYFUN --: Hyperbolic yield function.
LFPOT --: Linear flow potential function.
PFPOT --: Power law flow potential function.
HFPOT --: Hyperbolic flow potential function.
CYFUN --: Cap yield function.
CFPOT --: Cap flow potential function.

References:

See Extended Drucker-Prager (EDP) in the Material Reference.

ELASTIC -- Elasticity Specifications

NTEMP:

Number of temperatures for which data will be provided.

NPTS:

Number of properties to be defined for the material option. This value is set automatically according to the elasticity option (TBOPT) selected. If TBOPT is not specified, default settings become NPTS = 2 and TBOPT = ISOT.

TBOPT:

Elasticity options:

ISOT --: Isotropic property (EX, NUXY) (default). Setting NPTS = 2 also selects this option automatically.
OELN --: Orthotropic option with minor Poisson's ratio (EX, EY, EZ, GXY, GYZ, GXZ, NUXY, NUYZ, NUXZ). NPTS = 9. Setting NPTS = 9 selects this option automatically. All nine parameters must be set, even for the 2-D case.
OELM --: Orthotropic option with major Poisson's ratio (EX, EY, EZ, GXY, GYZ, GXZ, PRXY, PRYZ, PRXZ). NPTS = 9. All nine parameters must be set, even for the 2-D case.
AELS --: Anisotropic option in stiffness form (D11, D21, D31, D41, D51, D61, D22, D32, D42, D52, D62, D33, D43, ..... D66). NPTS = 21. Setting NPTS = 21 selects this option automatically.
AELF --: Anisotropic option in compliance form (C11, C21, C31, C41, C51, C61, C22, C32, C42, C52, C62, C33, C43, ..... C66). NPTS = 21.
USER --: User-defined linear elastic properties. For more information on the user_tbelastic subroutine, see the Guide to User-Programmable Features in the Mechanical APDL Programmer's Reference.

References:

See the TBFIELD command for more information about defining temperature- and/or frequency-dependent properties.

Full Harmonic Analysis in the Structural Analysis Guide.

EOS -- Equation of State Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Equation of state (explicit dynamic elements only). No default--a specified value is required.

1 --: Johnson-Cook material model - for strain, strain rate, and temperature dependent impact/forming analyses.
2 --: Null material model - for allowing equation of state to be considered without computing deviatoric stresses.
3 --: Zerilli-Armstrong material model - for metal forming processes in which the stress depends on strain, strain rate, and temperature.
4 --: Bamman material model - for metal forming processes with strain rate and temperature dependent plasticity. Does not require an additional equation of state (EOSOPT is not used).
5 --: Steinberg material model - for modeling high strain rate effects in solid elements with failure.

References:

Equation of State Models in the ANSYS LS-DYNA User's Guide.

EVISC -- Viscoelastic Element Data Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Nonlinear Elastic Models in the ANSYS LS-DYNA User's Guide.

EXPE -- Experimental Data Specifications

NTEMP:

Number of temperatures for which data will be provided.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

Experimental data type:

UNITENSION --: Uniaxial tension experimental data.
UNICOMPRESSION --: Uniaxial compression experimental data.
UNIAXIAL --: Uniaxial experimental data (combined uniaxial tension and compression).
BIAXIAL --: Equibiaxial experimental data.
SHEAR --: Pure shear experimental data (also known as planar tension).
SSHEAR --: Simple shear experimental data.
VOLUME --: Volumetric experimental data.
GMODULUS --: Shear modulus experimental data.
KMODULUS --: Bulk modulus experimental data.
EMODULUS --: Tensile modulus experimental data.
NUXY --: Poisson's ratio experimental data.

References:

Experimental Data in the Material Reference.

Experimental Response Functions in the Mechanical APDL Theory Reference

Viscoelastic Material Model Material Reference.

See also the TBFIELD command documentation for information about defining field-dependent experimental data.

FCON -- Fluid Conductance Data Specifications

NTEMP:: Number of temperatures for which data will be provided. Default = 1. Maximum = 20.
NPTS:: Number of data points to be specified for a given temperature. Default = 1. Maximum = 100.
TBOPT:: Not used.
References:: FLUID116 in the Element Reference.

FCLI -- Material Strength Limits Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature. Default = 20 when TBOPT = 1. Default = 9 when TBOPT = 2.

TBOPT:

Material strength limit definition:

1 --: Define stress-strength limits.
2 --: Define strain-strength limits.

References:

Material Strength Limits in the Material Reference.

FLUID -- Fluid Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

Fluid material options:

LIQUID --: Define material constants for a liquid material.
GAS --: Define material constants for a gas material.
PVDATA --: Define pressure-volume data for a fluid material.

References:

Fluids in the Material Reference.

Fluid Material Models in the Mechanical APDL Theory Reference.

FOAM -- Foam Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Foam material options for explicit dynamics elements. No default--a specified value is required.

1 --: Rigid, closed cell, low density polyurethane foam material model.
2 --: Highly compressible urethane foam material model.
3 --: Energy absorbing foam material model.
4 --: Crushable foam material model.

References:

Foam Models in the ANSYS LS-DYNA User's Guide.

FRIC -- Coefficient of Friction Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. No maximum limit.

NTEMP is not used for the following situations:

Isotropic or orthotropic friction defined in terms of field data (TBFIELD command)
User-defined friction (TBOPT = USER)

NPTS:

Number of data points to be specified for user-defined friction (TBOPT = USER). Not used for TBOPT = ISO or TBOPT = ORTHO.

TBOPT:

Friction options:

ISO --: Isotropic friction (one coefficient of friction, MU) (default). This option is valid for all 2-D and 3-D contact elements.
ORTHO --: Orthotropic friction (two coefficients of friction, MU1 and MU2). This option is valid for the following 3-D contact elements: CONTA173, CONTA174, CONTA175, CONTA176, and CONTA177.
EORTHO --: Equivalent orthotropic friction (two coefficients of friction, MU1 and MU2). This option differs from TBOPT=ORTHO only in the way the friction coefficients are interpolated when they are dependent upon the following field variables: sliding distance and/or sliding velocity. In this case, the total magnitude of the field variable is used to do the interpolation.
USER --: User defined friction. This option is valid for all 2-D and 3-D contact elements.

References:

Contact Friction in the Material Reference.

See also the TBFIELD command for more information about defining a coefficient of friction that is dependent on temperature, time, normal pressure, sliding distance, or sliding relative velocity.

GASKET -- Gasket Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. The maximum number of temperatures specified is such that NTEMP * NPTS < 2000.

NPTS:

Number of data points to be specified for a given temperature. Default = 5 for TBOPT = PARA. Default = 1 for all other values of TBOPT.

TBOPT:

Gasket material options.

PARA --: Gasket material general parameters.

COMP --: Gasket material compression data.

LUNL --: Gasket linear unloading data.

NUNL --: Gasket nonlinear unloading data.
TSS --: Transverse shear data.
TSMS --: Transverse shear and membrane stiffness data. (If selected, this option takes precedence over TSS.)

References:

Gasket Materials in the Material Reference.

Gasket Joints Simulation in the Structural Analysis Guide.

GCAP -- Geological Cap Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Pressure Dependent Plasticity Models in the ANSYS LS-DYNA User's Guide.

GURSON -- Gurson Plasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 40.

NPTS:

Number of data points to be specified for a given temperature.

TBOPT:

GURSON material options.

BASE --: Basic model without nucleation or coalescence (default).
SNNU --: Strain controlled nucleation.
SSNU --: Stress controlled nucleation.
COAL --: Coalescence.

References:

Gurson in the Mechanical APDL Material Reference

Gurson's Model in the Mechanical APDL Theory Reference

HFLM -- Film Coefficient Data Specifications

NTEMP:: Number of temperatures for which data will be provided. Default = 1. Maximum = 20.
NPTS:: Number of data points to be specified for a given temperature. Default = 1. Maximum = 100.
TBOPT:: Not used.
References:: FLUID116 in the Element Reference.

HILL -- Hill Plasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 40.

NPTS:

Not used.

TBOPT:

Hill plasticity option:

(blank) --: Use one set of Hill parameters (default).
PC --: Enter separate Hill parameters for plasticity and creep. This option is valid for material combinations of creep and Chaboche nonlinear kinematic hardening only.

References:

Hill Yield Criterion in the Material Reference.

Also see Material Model Combinations.

HONEY -- Honeycomb Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Foam Models in the ANSYS LS-DYNA User's Guide.

HYPER -- Hyperelasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. The maximum value of NTEMP is such that NTEMP x NPTS = 1000.

NPTS:

Number of data points to be specified for a given temperature, except for TBOPT = MOONEY, where NPTS is the number of parameters in the Mooney-Rivlin model (2 [default], 3, 5, or 9), and TBOPT = RESPONSE, where NPTS is the number of terms in the volumetric strain energy polynomial.

TBOPT:

Hyperelastic material options.

BOYCE--

Arruda-Boyce model. For NPTS, default = 3 and maximum = 3.

References:

Arruda-Boyce Hyperelasticity in the Material Reference.

Arruda-Boyce Hyperelastic Option in the Structural Analysis Guide.

BLATZ --

Blatz-Ko model. For NPTS, default = 1 and maximum = 1.

References:

Blatz-Ko Foam Hyperelasticity in the Material Reference.

Blatz-Ko Hyperelastic Option in the Structural Analysis Guide.

ETUBE --

Extended tube model. Five material constants (NPTS = 5) are required.

References:

Extended Tube Hyperelasticity in the Material Reference.

Extended Tube Model in the Mechanical APDL Theory Reference.

FOAM --

Hyperfoam (Ogden) model. For NPTS, default = 1 and maximum is such that NTEMP x NPTS x 3 = 1000.

References:

Ogden Compressible Foam Hyperelasticity in the Material Reference.

Ogden Compressible Foam Hyperelastic Option in the Structural Analysis Guide.

GENT --

Gent model. For NPTS, default = 3 and maximum = 3.

References:

Gent Hyperelasticity in the Material Reference.

Gent Hyperelastic Option in the Structural Analysis Guide.

MOONEY --

Mooney-Rivlin model (default). You can choose a two-parameter Mooney-Rivlin model with NPTS = 2 (default), or a three-, five-, or nine-parameter model by setting NPTS equal to one of these values.

References:

Mooney-Rivlin Hyperelasticity in the Material Reference.

Mooney-Rivlin Hyperelastic Option in the Structural Analysis Guide.

NEO --

Neo-Hookean model. For NPTS, default = 2 and maximum = 2.

References:

Neo-Hookean Hyperelasticity in the Material Reference.

Neo-Hookean Hyperelastic Option in the Structural Analysis Guide.

OGDEN --

Ogden model. For NPTS, default = 1 and maximum is such that NTEMP x NPTS x 3 = 1000.

References:

Ogden Hyperelasticity in the Material Reference.

Ogden Hyperelastic Option in the Structural Analysis Guide.

POLY --

Polynomial form model. For NPTS, default = 1 and maximum is such that NTEMP x NPTS = 1000.

References:

Polynomial Form Hyperelasticity in the Material Reference.

Polynomial Form Hyperelastic Option in the Structural Analysis Guide.

RESPONSE --

Experimental response function model. For NPTS, default = 0 and maximum is such that NTEMP x NPTS + 2 = 1000.

References:

Response Function Hyperelasticity in the Material Reference.

Response Function Hyperelastic Option (TB,HYPER,,,,RESPONSE) in the Structural Analysis Guide.

Experimental Response Functions in the Mechanical APDL Theory Reference

YEOH --

Yeoh model. For NPTS, default = 1 and maximum is such that NTEMP x NPTS x 2 = 1000.

References:

Yeoh Hyperelasticity in the Material Reference.

Yeoh Hyperelastic Option in the Structural Analysis Guide.

USER --

User-defined hyperelastic model. See the ANSYS Guide to User Programmable Features for details.

References:

User-Defined Hyperelastic Material in the Material Reference.

User-Defined Hyperelastic Option in the Structural Analysis Guide.

INTER -- Contact Interaction Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. No maximum limit. NTEMP is used only for user-defined contact interaction (TBOPT = USER).

NPTS:

Number of data points to be specified. NPTS is used only for user-defined contact interaction (TBOPT = USER).

TBOPT:

Contact interaction options.

The following options are valid only for general contact interactions specified via the GCDEF command:

STANDARD --: Standard unilateral contact (default).
ROUGH --: Rough, no sliding.
NOSEPE --: No separation (sliding permitted).
BONDED --: Bonded contact (no separation, no sliding).
ANOSEP--: No separation (always).
ABOND --: Bonded (always).
IBOND --: Bonded (initial contact).

The following option is valid for all 2-D and 3-D contact elements:

USER --: User-defined contact interaction.

References:

Contact Interaction in the Material Reference.

Defining Your Own Contact Interaction (USERINTER) in the Contact Technology Guide.

JOIN -- Joint Element Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature. NPTS is ignored if TBOPT = STIF or DAMP.

If Coulomb friction is specified, NPTS is used only for TBOPT = MUS1, MUS4, and MUS6.

TBOPT:

Joint element material options.

Linear stiffness behavior:

STIF --: Linear stiffness.

Nonlinear stiffness behavior:

JNSA --: Nonlinear stiffness behavior in all available components of relative motion for the joint element.
JNS1 --: Nonlinear stiffness behavior in local UX direction only.
JNS2 --: Nonlinear stiffness behavior in local UY direction only.
JNS3 --: Nonlinear stiffness behavior in local UZ direction only.
JNS4 --: Nonlinear stiffness behavior in local ROTX direction only.
JNS5 --: Nonlinear stiffness behavior in local ROTY direction only.
JNS6 --: Nonlinear stiffness behavior in local ROTZ direction only.

Linear damping behavior:

DAMP --: Linear damping.

Nonlinear damping behavior:

JNDA --: Nonlinear damping behavior in all available components of relative motion for the joint element.
JND1 --: Nonlinear damping behavior in local UX direction only.
JND2 --: Nonlinear damping behavior in local UY direction only.
JND3 --: Nonlinear damping behavior in local UZ direction only.
JND4 --: Nonlinear damping behavior in local ROTX direction only.
JND5 --: Nonlinear damping behavior in local ROTY direction only.
JND6 --: Nonlinear damping behavior in local ROTZ direction only.

Friction Behavior:

Coulomb friction coefficient -: The values can be specified using either TBDATA (NPTS = 0) or TBPT (NPTS is nonzero).
MUS1 --: Coulomb friction coefficient (stiction) in local UX direction only.
MUS4 --: Coulomb friction coefficient (stiction) in local ROTX direction only.
MUS6 --: Coulomb friction coefficient (stiction) in local ROTZ direction only.
Coulomb friction coefficient - Exponential Law -: Use TBDATA to specify μ_s, μ_d, and c for the exponential law.
EXP1 --: Exponential law for friction in local UX direction only.
EXP4 --: Exponential law for friction in local ROTX direction only.
EXP6 --: Exponential law for friction in local ROTZ direction only.

Elastic slip:

SL1 --: Elastic slip in local UX direction only.
SL4 --: Elastic slip in local ROTX direction only.
SL6 --: Elastic slip in local ROTZ direction only.
TMX1 --: Critical force in local UX direction only.
TMX4 --: Critical moment in local ROTX direction only.
TMX6 --: Critical moment in local ROTZ direction only.

Stick-stiffness:

SK1 --: Stick-stiffness in local UX direction only.
SK4 --: Stick-stiffness in local ROTX direction only.
SK6 --: Stick-stiffness in local ROTZ direction only.

Interference fit force/moment:

FI1 --: Interference fit force in local UX direction only.
FI4 --: Interference fit moment in local ROTX direction only.
FI6 --: Interference fit moment in local ROTZ direction only.

References:

MPC184 Joint in the Material Reference.

JROCK -- Jointed Rock Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

BASE --: Base material parameters.
RCUT --: Base material tension cutoff.
RSC --: Residual strength coupling.
FPLANE --: Joint parameters.
FTCUT --: Joint tension cutoff.
FORIE --: Joint orientation.

References:

Jointed Rock.

MC -- Mohr-Coulomb Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

BASE --: Mohr-Coulomb material parameters.
RCUT --: Tension cutoff.
RSC --: Residual strength coupling.

References:

Mohr-Coulomb.

MIGR -- Migration Model Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Migration model options.

1 --: Atomic (or ion) flux (default).
2 --: Vacancy flux.

References:

Migration Model in the Material Reference.

Electric-Diffusion Analysis, Thermal-Diffusion Analysis, and Structural-Diffusion Analysis in the Coupled-Field Analysis Guide.

Electric-Diffusion Coupling, Thermal-Diffusion Coupling, and Structural-Diffusion Coupling in the Mechanical APDL Theory Reference.

MOONEY -- Mooney-Rivlin Hyperelasticity Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 6. Maximum = 6.

NPTS:

(Not used for explicit dynamic elements.)

TBOPT:

Mooney-Rivlin material option, applicable to explicit dynamic elements PLANE162, SHELL163, SOLID164, and SOLID168.

0 --: Direct input of hyperelastic material constants (default).
1 --: Reserved for future use.
2 --: Material constants to be calculated by the LS-DYNA program from experimental data. This option is only valid for explicit dynamic elements.

References:

Nonlinear Elastic Models in the ANSYS LS-DYNA User's Guide.

MPLANE -- Microplane Specifications

NTEMP:: The number of temperatures for which data will be provided. Default = 1. Maximum is such that NTEMP x NPTS = 1000.
NPTS:: Number of material constants (six total).
TBOPT:: Not used.
References:: Microplane in the Material Reference.

NLISO -- Nonlinear Isotropic Hardening Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 20.

NPTS:

Number of data points to be specified for a given temperature. Default = 4. Maximum = 4.

TBOPT:

Isotropic hardening options.

VOCE --: Voce hardening law (default).
POWER --: Power hardening law.

References:

Nonlinear Isotropic Hardening in the Material Reference.

PERF -- Equivalent Fluid Model of Perforated Media Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Equivalent fluid model options:

JCA: Johnson-Champoux-Allard model
DLB: Delaney-Bazley model
MIKI: Miki model
ZPRO: Complex impedance and propagating constant model
CDV: Complex density and velocity model
YMAT: Transfer admittance matrix model
SGYM: Transfer admittance matrix model of square grid structure
HGYM: Transfer admittance matrix model of hexagonal grid structure

References:

Defining Acoustic Material Properties in the Acoustic Analysis Guide.

Equivalent Fluid Model of Perforated Media in the Material Reference .

Equivalent Fluid of Perforated Materials in the Mechanical APDL Theory Reference

See the TBFIELD command for more information about defining temperature and/or frequency-dependent properties.

PIEZ -- Piezoelectric Matrix Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Piezoelectric matrix options.

0 --: Piezoelectric stress matrix [e] (used as supplied)
1 --: Piezoelectric strain matrix [d] (converted to [e] form before use)

References:

Piezoelectricity in the Material Reference.

Piezoelectric Analysis in the Coupled-Field Analysis Guide.

PLASTIC -- Nonlinear Plasticity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Plasticity option:

MISO --

Multilinear isotropic hardening plasticity.

KINH --

Multilinear kinematic hardening plasticity.

The number of points (TBPT commands issued) is limited to 100 for this option.

KSR --

Kinematic static recovery.

ISR --

Isotropic static recovery.

References:

Rate-Independent Plasticity in the Material Reference.

PLAW -- Plasticity Law Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Plasticity options for explicit dynamics elements. No default--a specified value is required.

1 --: Isotropic/kinematic hardening model.
2 --: Strain rate dependent plasticity model used for metal and plastic forming analyses.
3 --: Anisotropic plasticity model (Barlat and Lian).
4 --: Strain rate dependent plasticity model used for superplastic forming analyses.
5 --: Strain rate dependent isotropic plasticity model used for metal and plastic forming analyses.
6 --: Anisotropic plasticity model (Barlat, Lege, and Brem) used for forming processes.
7 --: Fully iterative anisotropic plasticity model for explicit shell elements only.
8 --: Piecewise linear plasticity model for explicit elements only.
9 --: Elastic-plastic hydrodynamic model for explicit elements only.
10 --: Transversely anisotropic FLD (flow limit diagram) model for explicit elements only.
11 --: Modified piecewise linear plasticity model for explicit shell elements only.
12 --: Elastic viscoplastic thermal model for explicit solid and shell elements only.

References:

Nonlinear Inelastic Models in the ANSYS LS-DYNA User's Guide.

Pressure Dependent Plasticity Models in the ANSYS LS-DYNA User's Guide.

PELAS -- Porous Elasticity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

POISSON --: Porous elasticity model..

References:

Porous Elasticity.

PM -- Coupled Pore-Fluid Diffusion and Structural Model of Porous Media Specifications

NTEMP:

The number of temperatures. Default = 1. The maximum must be a value such that (NTEMP x NPTS) <= 1000.

NPTS:

The number of material constants. Default = 4. The maximum must be a value such that (NTEMP x NPTS) <= 1000.

TBOPT:

Porous media options:

PERM --: Permeability
BIOT --: Biot coefficient
SP --: Solid property
FP --: Fluid property
DSAT --: Degree-of-saturation table
RPER --: Relative-permeability table
GRAV --: Gravity magnitude

References:

Porous Media Material Properties in the Mechanical APDL Material Reference.

Porous Media Flow in the Mechanical APDL Theory Reference.

Structural-Pore-Fluid-Diffusion-Thermal Analysis in the Mechanical APDL Coupled-Field Analysis Guide.

Initial Degree of Saturation and Relative Permeability Application in the Mechanical APDL Advanced Analysis Guide.

Also see VM260.

PRONY -- Prony Series Constant Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 100.

Unused for TBOPT = EXPERIMENTAL.

NPTS:

Defines the number of Prony series pairs for TBOPT = SHEAR or TBOPT = BULK. Default = 1. Maximum = 100.

The number of temperatures and Prony pairs specified should be such that NTEMP * 2 * NPTS < 1000.

Unused for TBOPT = INTEGRATION and TBOPT = EXPERIMENTAL.

TBOPT:

Defines the behavior for viscoelasticity.

SHEAR--: Shear Prony series.
BULK --: Bulk Prony series.
INTEGRATION --: Stress update algorithm.
EXPERIMENTAL --: Complex modulus from experimental data.

References:

Viscoelasticity in the Material Reference.

PZRS -- Piezoresistivity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Piezoresistive matrix options

0 --: Piezoresistive stress matrix (used as supplied)
1 --: Piezoresistive strain matrix (used as supplied)

References:

Piezoresistivity in the Material Reference.

Piezoresistive Analysis in the Coupled-Field Analysis Guide.

RATE -- Rate-Dependent Plasticity Specifications

NTEMP:

The number of temperatures for which data will be provided. Default is 1. Maximum is such that NTEMP x NPTS = 1000.

NPTS:

The number of data points to be specified for a given temperature. Default = 2. Maximum is such that NTEMP x NPTS = 1000.

TBOPT:

Rate-dependent viscoplasticity options.

PERZYNA --: Perzyna option (default).
PEIRCE --: Peirce option.
EVH --: Exponential visco-hardening option.
ANAND --: Anand option.

References:

Rate-Dependent Plasticity (Viscoplasticity) in the Material Reference.

Viscoplasticity in the Structural Analysis Guide.

Rate-Dependent Plasticity in the Mechanical APDL Theory Reference.

SDAMP -- Material Damping Coefficient Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of properties to be defined for the material option. Default = 1 for each material damping option (TBOPT) selected.

TBOPT:

Material damping options:

STRU or 1 --: Structural damping coefficient (default).
ALPD or 2--: Rayleigh mass proportional material damping.
BETD or 3--: Rayleigh stiffness proportional material damping.

References:

Material Damping in the Mechanical APDL Material Reference.

Full Harmonic Analysis in the Mechanical APDL Structural Analysis Guide.

Damping Matrices in the Mechanical APDL Theory Reference.

SHIFT -- Shift Function Specifications

NTEMP:

Allows one temperature for which data will be provided.

NPTS:

Number of material constants to be entered as determined by the shift function specified by TBOPT.

3 --: for TBOPT = 1 or WLF
2 --: for TBOPT = 2 or TN
n _f --: for TBOPT = 3 or FICT, where n _f is the number of partial fictive temperatures

TBOPT:

Defines the shift function

1 or WLF --: Williams-Landel-Ferry shift function
2 or TN --: Tool-Narayanaswamy shift function
3 or FICT --: Tool-Narayanaswamy with fictive temperature shift function
100 --: (or USER) User-defined shift function.

References:

Viscoelasticity in the Material Reference.

SMA -- Shape Memory Alloy Specifications

NTEMP:: Number of temperatures for which data will be provided. Default = 1.
NPTS:: Number of data points to be specified for a given temperature. Default = 6 if TBOPT = SUPE, or 7 otherwise.
TBOPT:: Shape memory model option:
SUPE -- Superelasticity option (default).
MEFF -- Memory-effect option.
Because the material tangent stiffness matrix is generally unsymmetric, convergence problems typically occur when TBOPT = MEFF and the (default) full Newton-Raphson option (NROPT,FULL) is in effect; therefore, use the unsymmetric Newton-Raphson option (NROPT,UNSYM) when TBOPT = MEFF.
Reference:: Shape Memory Alloy (SMA) in the Material Reference.

SOIL -- Soil Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

CAMCLAY --: Modified Cam-clay material model.

References:

Cam-clay.

STATE -- User-Defined State Variable Specifications

When Lab = STATE is applied to user-defined materials, the state variable specifications affect either the UserMat (user-defined material) or UserMatTh (user-defined thermal material) subroutine, as appropriate. The subroutine in use depends on the element type used when Lab = USER is specified.

NTEMP:: Not used.
NPTS:: Number of state variables.
TBOPT:: Not used.
References:: Using State Variables with User-Defined Materials in the Material Reference.

SWELL -- Swelling Specifications

NTEMP:

Number of temperatures for which data will be provided. The maximum value of NTEMP is such that NTEMP x NPTS = 1000

NPTS:

Number of data points to be specified for a given temperature. The maximum value of NPTS is such that NPTS x NTEMP = 1000.

TBOPT:

Swelling model options:

LINEAR --: Linear swelling function.
EXPT --: Exponential swelling function.
USER --: User-defined swelling function. Define the swelling function via subroutine usersw (described in the Programmer's Reference). Define temperature-dependent constants via the TBTEMP and TBDATA commands. For solution-dependent variables, define the number of variables via the TB,STATE command.

References:

Swelling in the Material Reference.

Swelling in the Structural Analysis Guide.

THERM -- Thermal Properties Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Thermal properties:

COND --: Thermal conductivity.

SPHT --: Specific heat.

References:

Thermal Properties in the Material Reference.

UNIAXIAL -- Uniaxial Stress-Strain Relation Specifications

NTEMP:

Number of temperatures for which data will be provided. Default = 1. Maximum = 10.

NPTS:

Number of data points to be specified for a given temperature. Default = 20. Maximum = 20.

TBOPT:

Defines stress-strain relationship for cast iron plasticity.

TENSION --: Defines stress-strain relation in tension
COMPRESSION --: Defines stress-strain relation in compression.

References:

Cast Iron in the Material Reference.

USER -- User-Defined Material Model or Thermal Material Model Specifications

When Lab = USER, the TB command activates either the UserMat (user-defined material) or the UserMatTh (user-defined thermal material) subroutine automatically. The subroutine activated depends on the element type used.

NTEMP:

Number of temperatures for which data will be provided. Default = 1.

NPTS:

Number of data points to be specified for a given temperature. Default = 48.

TBOPT:

User-defined material model ( UserMat ) or thermal material model ( UserMatTh ) options:

NONLINEAR: Nonlinear iterations are applied (default).
LINEAR: Nonlinear iterations are not applied. This option is ignored if there is any other nonlinearity involved, such as contact, geometric nonlinearity, etc.
MXUP: This option indicates a UserMat material model to be used with mixed u-P element formulation for material exhibiting incompressible or nearly incompressible behavior.

References:

User-Defined Material Model (UserMat) in the Material Reference.

Subroutine UserMat (Creating Your Own Material Model) in the Programmer's Reference.

Subroutine UserMatTh (Creating Your Own Thermal Material Model) in the Programmer's Reference.

WEAR -- Contact Surface Wear Specifications

NTEMP:

Number of temperatures for which data will be provided.

NPTS:

Number of data points to be specified for the wear option. This value is set automatically based on the selected wear option (TBOPT). If TBOPT is not specified, the default becomes NPTS = 5 and TBOPT = ARCD.

TBOPT:

Wear model options:

ARCD --: Archard wear model (default).
USER --: User-defined wear model.

References:

Contact Surface Wear in the Material Reference.

See also the TBFIELD command for more information on defining temperature and/or time-dependent properties.

Notes

TB activates a data table to be used with subsequent TBDATA or TBPT commands. The table space is initialized to zero values. Data from this table are used for certain nonlinear material descriptions as well as for special input for some elements.

For a list of elements supporting each material model (Lab value), see Material Model Element Support in the Material Reference.

For a description of data table input required for explicit dynamic materials, see Material Models in the ANSYS LS-DYNA User's Guide.

For information about linear material property input, see the MP command.

This command is also valid in SOLUTION.

Product Restrictions

Command Option Lab	Available Products
AFDM	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
AHYPER	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
ANEL	Pro \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
BB	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
BH	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
BISO	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
BKIN	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
BB	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CAST	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CDM	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CGCR	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CHABOCHE	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
COMP	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CONCR	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
CREEP	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CTE	Pro \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
CZM	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CNDE	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
CNDM	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
DISCRETE	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
DMGE	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
DMGI	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
DP	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
DPER	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
EDP	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
ELASTIC	Pro \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
ELASTIC (`TBOPT` = USER)	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
EOS	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
EVISC	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
EXPE	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
FCON	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
FCLI	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
FLUID	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
FOAM	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
FRIC	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
GASKET	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
GCAP	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
HFLM	Pro \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
HILL	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
HONEY	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
HYPER	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
HYPER (`TBOPT` = USER)	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
INTER	Pro \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
INTER (`TBOPT` = USER)	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
JOIN	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
JOIN (`TBOPT` = STIF)	Pro \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
JROCK	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
MC	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
MOONEY	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
MPLANE	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
NLISO	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
PELAS	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
PERF	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
PIEZ	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
PLASTIC	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
PLAW	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
PRONY	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
PZRS	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
RATE	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
SDAMP	– \| Premium \| Enterprise \| Ent PP \| Ent Solver \| –
SHIFT	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
SMA	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
SOIL	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
STATE	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
SWELL	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
UNIAXIAL	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
USER	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –
WEAR	– \| – \| Enterprise \| Ent PP \| Ent Solver \| –

Menu Paths

Main Menu>Preprocessor>Loads>Load Step Opts>Other>Change Mat Props>Material Models

Main Menu>Preprocessor>Material Props>Material Models

Main Menu>Solution>Load Step Opts>Other>Change Mat Props>Material Models