TB

TB, Lab, MATID, NTEMP, NPTS, TBOPT, --, 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 Support for Elements in the Material Reference.

Lab

Material model data table type:

AFDM	—	Acoustic frequency-dependent material.
AHYPER	—	Anisotropic hyperelasticity.
ANEL	—	Anisotropic elasticity.
ANISO	—	Generalized Hill anisotropy.
AVIS	—	Anisotropic viscosity.
BB	—	Bergstrom-Boyce.
BH	—	Magnetic field.
CAST	—	Cast iron.
CDM	—	Damage.
CFOAM	—	Crushable foam.
CGCR	—	Crack-growth fracture criterion (CGROW).
CHABOCHE	—	Chaboche nonlinear kinematic hardening using von Mises or Hill plasticity.
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.
CRKI	—	Material criterion for adaptive-crack initiation (ADPCI)
CTE	—	Coefficient of thermal expansion.
CZM	—	Cohesive zone.
DENS	—	Mass Density.
DLST	—	Anisotropic dielectric loss tangent.
DMGE	—	Damage evolution law.
DMGI	—	Damage initiation criteria.
DPER	—	Anisotropic electric permittivity.
EDP	—	Extended Drucker-Prager (for granular materials such as rock, concrete, soil, ceramics and other pressure-dependent materials).
ELASTIC	—	Elasticity.
ELST	—	Anisotropic elastic loss tangent.
EXPE	—	Experimental data.
FCON	—	Fluid conductance data.
FCLI	—	Material strength limits for calculating failure criteria.
FLUID	—	Fluid.
FRIC	—	Coefficient of friction based on Coulomb's Law or user-defined friction.
GASKET	—	Gasket.
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.
HYPER	—	Hyperelasticity material models (Arruda-Boyce, Blatz-Ko, Extended Tube, Gent, Hencky, 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.
MELAS	—	Multilinear elasticity.
MIGR	—	Migration.
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	—	Perforated material for acoustics; equivalent fluid model of perforated media, poroelastic material model, and transfer admittance matrix.
PIEZ	—	Piezoelectric matrix.
PLASTIC	—	Nonlinear plasticity.
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.
RO	—	Ramberg-Osgood.
SDAMP	—	Material damping coefficients.
SHIFT	—	Shift function for viscoelastic materials.
SINT	—	Sintering. Available with the Additive Suite license.
SMA	—	Shape memory alloy for simulating superelasticity, shape memory effect, or shape memory effect with plasticity.
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 (implicit creep) and used with the `UserCreep` subroutine, or when real constant C6 = 100 (explicit creep) and used with the UserCr subroutine.
SWELL	—	Swelling strain function.
TNM	—	Three-network model for viscoplastic materials.
THERM	—	Thermal properties.
USER	—	User-defined material or thermal material model (general-purpose except for incompressible material models) or thermal material model.
WEAR	—	Contact surface wear.
XTAL	—	Crystal plasticity for elasto-viscoplastic crystalline materials.

MATID

Material reference identification number. Valid value is any number n, where 0 < n < 100,000. 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.

TBOPT

Material data table options for the specified material model (Lab).

--

Unused field.

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 predefined via 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
ROOM: Diffusion properties for room acoustics

References:

Defining Acoustic Material Properties in the Acoustic Analysis Guide

Acoustic Frequency-Dependent Materials in the Material Reference

See TBFIELD 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.
USER --: User-defined potential invariant set type.
UNUM --: User-defined invariant set number.
AU01 --: User-defined material parameters.
FB01 --: User-defined fiber directions.

References:

Anisotropic Hyperelasticity (TB,AHYPER) in the Material Reference

Anisotropic Hyperelasticity Model in the Structural Analysis Guide

Subroutine UserHyperAniso (Writing Your Own Anisotropic Hyperelasticity Laws) in the Programmer's Reference

Anisotropic Hyperelasticity in the Theory Reference

ANEL -- Anisotropic Elasticity Specifications

This material model is not supported for use with the coefficient of thermal expansion (TB,CTE). The maximum number of ANEL tables is 1,000,000.

NTEMP:

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

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).

References:

Anisotropic Elasticity in the Material Reference

ANISO – Generalized Hill Anisotropy Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Generalized Hill Anisotropy in the Material Reference

AVIS -- Anisotropic Viscosity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Anisotropic viscosity matrix options:

0: Viscosity matrix (used as specified).
1: Fluency matrix (converted to viscosity matrix before use).

References:

Anisotropic Viscosity in the Material Reference

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.

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 Theory Reference

Bergstrom-Boyce Material (TB,BB) in the Material Reference

Bergstrom-Boyce Hyperviscoelasticity 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:

BH curve options.

BH or (blank) --: BH curve data (default).
TCF --: Thermal coefficient data for BH curve modification. This option is valid for the following elements: PLANE223, SOLID226, SOLID227, PLANE233, SOLID236, and SOLID237.

References:

Magnetism in the Material Reference

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

CAST -- Cast Iron Plasticity Specifications

NTEMP:

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

NPTS:

Not used.

TBOPT:

Cast iron options:

ISOTROPIC --: Specifies cast iron plasticity with isotropic hardening.
TENSION --: Defines stress-strain relation in tension.
COMPRESSION --: Defines stress-strain relation in compression.
ROUNDING --: Defines tension yield surface rounding factor.

References:

Cast Iron in the Material Reference

CDM -- Damage 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:

Damage option:

PSE2 --: Mullins effect for hyperelasticity models: pseudo-elastic model with a modified Ogden-Roxburgh damage function. Requires NPTS = 3.
MUSER --: Mullins effect for hyperelasticity models: Pseudo-elastic model with a user-defined damage function.
GDMG --: Generalized damage model parameters.
FIB1 --: Damage parameters in fiber direction 1.
FIB2 --: Damage parameters in fiber direction 2.
FIB3 --: Damage parameters in fiber direction 3.
DUCTILE --: Damage-initiation parameters for ductile damage.
EXPDMG --: Exponential damage-evolution parameters for ductile damage.
LINDMG --: Linear damage-evolution parameters for ductile damage.
VREG --: Viscous regularization parameters for ductile damage.

References:

Mullins Effect in the Theory Reference

Mullins Effect (TB,CDM) in the Material Reference

Mullins Effect Model in the Structural Analysis Guide

Subroutine userMullins (Writing Your Own Pseudo-Elastic Mullins Effect Law) in the Programmer's Reference

Regularized Generalized Damage for Fatigue and Thermomechanical Fatigue in the Material Reference

Regularized Anisotropic Damage in the Material Reference

Ductile Damage in the Material Reference

CFOAM -- Crushable Foam Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Crushable foam material option:

YIELD --: Initial yield stress values.
HTYPE --: Hardening evolution type.
MHARD --: Multilinear hardening evolution points.
PPR --: Plastic Poisson’s ratio.

References:

Crushable Foam in the Material Reference

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. Used in an XFEM-based crack-growth analysis only.

STTMAX -- Maximum circumferential stress criterion. Valid when NPTS = 1. Used in an XFEM-based crack-growth analysis only.

RLIN -- Rigid linear evolution law for the decay of stress. Valid when NPTS = 4. Used in an XFEM-based crack-growth analysis only.

PARIS -- Paris' Law for fatigue crack-growth. Valid when NPTS = 2. Used in a SMART- or XFEM-based fatigue crack-growth analysis only.

WALK -- Walker equation for fatigue crack-growth. Valid when NPTS = 3. Used in a SMART-based fatigue crack-growth analysis only.

FORM -- Forman equation for fatigue crack-growth. Valid when NPTS = 3. Used in a SMART-based fatigue crack-growth analysis only.

TFDK -- Tabular fatigue law for fatigue crack-growth. Used in a SMART-based fatigue crack-growth analysis only.

NG03 -- NASGRO equation v. 3 for fatigue crack-growth. Valid when NPTS = 9. Used in a SMART-based fatigue crack-growth analysis only.

NG04 -- NASGRO equation v. 4 for fatigue crack-growth. Valid when NPTS = 10. Used in a SMART-based fatigue crack-growth analysis only.

KIC -- Critical stress-intensity factor for static crack-growth. Valid when NPTS = 1. Valid in a SMART-based static crack-growth analysis only.

JIC -- Critical J-integral for static crack-growth. Valid when NPTS = 1. Valid in a SMART-based static crack-growth analysis only.

Fatigue crack-closure option. Valid in a SMART-based fatigue crack-growth analysis only, with crack-growth based on Paris’ law or tabular fatigue law.

ELBER – Elber closure function.

SCHIJVE – Schijve closure function.

NEWMAN – Newman closure function.

UPOLY – Polynomial closure function.

References:

Fracture Analysis Guide

CGROW command

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:

(blank) --: Default option for nonlinear kinematic hardening.
TRATE --: Include temperature-rate term in back-stress evolution.
SHDR --: Strain-hardening of dynamic recovery properties. To use this option, TBOPT = TRATE is also required.

References:

Nonlinear Kinematic Hardening in the Material Reference

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.
MSOL --: Material solution option.

References:

Drucker-Prager Concrete in the Material Reference

Hardening, Softening and Dilatation (HSD) Behavior in the Material Reference

Menetrey-Willam in the Material Reference

CREEP -- Creep 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:

Creep model options:

0: Explicit creep option. See Explicit Creep Equations for available equations.
1 through 13 --: Implicit creep option. See Implicit Creep Equations for available equations.
100 --: User-defined creep option (implicit). Define the creep law via the UserCreep subroutine.

References:

Creep Option in the Material Reference

Creep Model in the Structural Analysis Guide

CRKI -- Adaptive Crack-Initiation Specifications

NTEMP:

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

NPTS:

Not used.

TBOPT:

Adaptive crack-initiation options:

PSMAX --: Maximum principal stress (default, and the only valid value).

References:

SMART Method for Crack-Initiation Simulation in the Fracture Analysis Guide

CTE -- 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.
FLUID --: Fluid thermal-expansion coefficient for porous media.
UFSTRAIN --: User-defined free strain in porous media.

References:

Thermal Expansion in the Material Reference

Porous Media Mechanics in the Material Reference

Subroutine userthstrain (Defining Your Own Thermal Strain) in the Programmer's Reference

Free-Strain Rate in the Material Reference

Subroutine userfreestrain (Defining Your Own Free-Strain Increment) in the Programmer's 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.
CEXP --: Exponential material behavior for preventing surface penetration on the cohesive interface. Valid for SMART-based crack-growth only.
CLIN --: Linear material behavior with a penalty slope for preventing surface penetration on the cohesive interface. Valid for SMART-based crack-growth only.
FRIC --: Isotropic Coulomb’s frictional law on the cohesive interface. Valid for SMART-based crack-growth with TBOPT = CLIN or TBOPT = CEXP only.
REXP --: Rigid exponential material behavior on the cohesive interface. Valid for SMART-based crack-growth 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 Theory Reference

Cohesive Material Law in the Material Reference

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

Crack-Initiation and -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

Enhancing Crack Surfaces with Cohesive Zone Elements in the Fracture Analysis Guide

DENS -- Mass Density Specifications

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

DLST -- Anisotropic Dielectric Loss Tangent Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Anisotropic Dielectric Loss Tangent in the Material Reference

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

DPER -- Anisotropic Electric Permittivity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Permittivity matrix options for PLANE222, PLANE223, SOLID225, 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:

Extended Drucker-Prager (EDP) in the Material Reference

Extended Drucker-Prager Cap 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 2D 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 2D 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.
FIB1 --: Fiber parameters in fiber direction 1.
FIB2 --: Fiber parameters in fiber direction 2.
FIB3 --: Fiber parameters in fiber direction 3.
USER --: User-defined linear elastic properties. For more information on the user_tbelastic subroutine, see the Guide to User-Programmable Features in the Programmer's Reference.

References:

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

Regularized Anisotropic Damage Response in the Material Reference

Full Harmonic Analysis in the Structural Analysis Guide

ELST -- Anisotropic Elastic Loss Tangent Specifications

NTEMP:: Not used.
NPTS:: Not used.
TBOPT:: Not used.
References:: Anisotropic Elastic Loss Tangent in the Material Reference

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 Theory Reference

Viscoelasticity in the Material Reference

See also TBFIELD 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

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 Theory Reference

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 2D and 3D contact elements.
ORTHO --: Orthotropic friction (two coefficients of friction, MU1 and MU2). This option is valid for the following 3D contact elements: CONTA174, CONTA175, and CONTA177.
FORTHO --: Orthotropic friction (two coefficients of friction, MU1 and Mu2) with a friction coordinate system fixed in space. This option is valid for the following 3D contact elements: CONTA174, CONTA175, 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 2D and 3D contact elements.

References:

Contact Friction in the Material Reference

See also TBFIELD 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 in the Material Reference

Gasket Joints Simulation in the Structural Analysis 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 Material Reference

Gurson's Model in the 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

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 Anisotropy in the Material Reference

Hill Yield Criterion in the Material Reference

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 material parameters to be specified for a given temperature. Exceptions are for TBOPT = FOAM, OGDEN, POLY and YEOH, where NPTS is the number of terms in the material model’s energy function.

TBOPT:

Hyperelastic material options.

BOYCE--: Arruda-Boyce model. For NPTS, default = 3 and maximum = 3.
BLATZ --: Blatz-Ko model. For NPTS, default = 1 and maximum = 1.
ETUBE --: Extended tube model. Five constants (NPTS = 5) are required.
EXF1 --: Embedded fiber directions. Three constants (NPTS = 3) define the direction for each fiber. Up to five fibers (NPTS = 15) are allowed.
EX1 --: Embedded fiber strain energy potential. Two constants (NPTS = 2) are used for each fiber corresponding to the defined fiber directions. Undefined values default to zero.
EXA1 --: Embedded fiber compression strain energy potential. Two constants (NPTS = 2) are used for each fiber corresponding to the defined fiber directions. If not defined, the values specified via EX1 are used for both tension and compression.
FOAM --: Hyperfoam (Ogden) model. For NPTS, default = 1 and maximum is the number of terms in the energy function
GENT --: Gent model. For NPTS, default = 3 and maximum = 3.
HENCKY --: Hencky model. For NPTS, default = 2 and maximum = 2.
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.
NEO --: Neo-Hookean model. For NPTS, default = 2 and maximum = 2.
OGDEN --: Ogden model. For NPTS, default = 1 and maximum is the number of terms in the energy function.
POLY --: Polynomial form model. For NPTS, default = 1 and maximum is the number of terms in the energy function.
RESPONSE --: Experimental response function model. For NPTS, default = 0 and maximum is such that NTEMP x NPTS + 2 = 1000.
YEOH --: Yeoh model. For NPTS, default = 1 and maximum is the number of terms in the energy function.
USER --: User-defined hyperelastic model.

References:

Hyperelasticity in the Material Reference

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 2D and 3D 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, or

Coulomb friction coefficient (stiction) for Spherical Joint.

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, or

Elastic slip for Spherical Joint.

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, or

Stick-stiffness for Spherical Joint.

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.
MSOL --: Material solution option.

References:

Jointed Rock in the Material Reference

MC -- Mohr-Coulomb Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

BASE --: Mohr-Coulomb material parameters.
RCUT --: Tension cutoff.
RSC --: Residual strength coupling.
POTN --: Plastic potential.
FRICTION --: Friction angle scaling.
COHESION --: Cohesion scaling.
TENSION --: Tension strength scaling.
DILATATION --: Dilatancy angle scaling.
MSOL --: Material solution option.

References:

Mohr-Coulomb in the Material Reference

MELAS – Multilinear Elasticity Specifications

NTEMP:: Number of temperatures for which data will be provided.
NPTS:: Number of data points to be specified for a given temperature.
TBOPT:: Not used.
References:: Multilinear Elasticity in the Material Reference.

MIGR – Migration Model Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Migration model options.

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

References:

Migration Model in the Material Reference

Electric-Diffusion Analysis in the Coupled-Field Analysis Guide

Thermal-Diffusion Analysis in the Coupled-Field Analysis Guide

Structural-Diffusion Analysis in the Coupled-Field Analysis Guide

Electric-Diffusion Coupling in the Theory Reference

Thermal-Diffusion Coupling in the Theory Reference

Structural-Diffusion Coupling in the Theory Reference

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:

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

TBOPT:

Microplane model options:

ORTH --: Elastic microplane material with damage model (default).
DPC --: Coupled damage-plasticity microplane model.
NLOCAL --: Nonlocal parameters.

References:

Microplane in the Material Reference

NLISO -- Nonlinear Isotropic Hardening 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. Maximum = 4.

TBOPT:

Isotropic hardening options.

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

References:

Nonlinear Isotropic Hardening in the Material Reference

PERF -- Perforated Material 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

Poroelastic acoustic material:

PORO: Poroelastic material model

Transfer admittance matrix options:

YMAT: General transfer admittance matrix model
SGYM: Transfer admittance matrix model of square grid structure
HGYM: Transfer admittance matrix model of hexagonal grid structure

References:

Perforated Media in the Material Reference

Equivalent Fluid of Perforated Materials in the Theory Reference

Poroelastic Acoustics in the Theory Reference

Perforated Material in the Acoustic Analysis Guide

Trim Element with Transfer Admittance Matrix in the Acoustic Analysis Guide

See TBFIELD 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

PLASTIC -- Nonlinear Plasticity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Plasticity option:

BISO --

Bilinear isotropic hardening plasticity.

BKIN –

Bilinear kinematic hardening plasticity.

MISO –

Multilinear isotropic hardening plasticity.

KINH --

Multilinear kinematic hardening plasticity.

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

KSR2 --

Kinematic static recovery.

ISR --

Isotropic static recovery.

References:

Rate-Independent Plasticity in the Material Reference

PELAS -- Porous Elasticity Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

POISSON --: Porous elasticity model..

References:

Porous Elasticity in the Material Reference

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 Material Reference

Porous Media Flow in the Theory Reference

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

Applying Initial Degree of Saturation and Relative Permeability in the Advanced Analysis Guide

PRONY -- Prony Series Constant Specifications

NTEMP:

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

Unused for TBOPT = EXPERIMENTAL.

NPTS:

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

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 Model in the Structural Analysis Guide

Rate-Dependent Plasticity in the Theory Reference

RO -- Ramberg-Osgood Specifications

NTEMP:: Number of temperatures for which data will be provided. Default = 1.
NPTS:: Number of properties to be defined for the material option: 3 (required).
TBOPT:: Not used.
References:: Ramberg-Osgood Model in the Material 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 Material Reference

Full Harmonic Analysis in the Structural Analysis Guide

Damping Matrices in the 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 via TBOPT. Not used for TBOPT = PLIN.

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

TBOPT:

Shift function:

WLF --: Williams-Landel-Ferry.
TN --: Tool-Narayanaswamy.
FICT --: Tool-Narayanaswamy with fictive temperature.
PLIN --: Piecewise linear.
USER --: User-defined.

References:

Viscoelasticity in the Material Reference

SINT -- Sintering Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Sintering options:

INIT --: Initial conditions: relative density, particle diameter, and grain-size diameter. The initial relative density can alternatively be specified as a location-varying initial state (INISTATE).
PARAM --: Sintering activation temperature and mode specification.
STRESS --: Sintering stress coefficients.
VSCOEF --: Viscosity coefficients. Mutually exclusive with VSTABLE.
VSTABLE --: Table of viscosity values. Mutually exclusive with VSCOEF.
GROWTH --: Grain-growth parameters.
RIEDEL --: Selects the Riedel sintering model (default) and defines the viscous moduli coefficients.
SOVS --: Selects the Skorohold-Olevsky sintering model and defines the viscous moduli coefficients.
ANICONST --: Orthotropic factors to be applied to the viscous bulk and shear moduli. The factors remain constant throughout densification.

References:: Sintering 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 = 7 if TBOPT = SUPE or MEFF, 2 if TBOPT = METE, 6 if TBOPT = METL or METH, and 7 if TBOPT = MEPD.
TBOPT:: Shape memory model option:
SUPE -- Superelasticity option (default).
MEFF -- Shape memory effect option.
METE – Shape memory effect with plasticity option: elastic phase-dependent and thermal expansion.
METL – Shape memory effect with plasticity option: limits of transformation in strain-stress-temperature space.
METH – Shape memory effect with plasticity option: transformation hardening.
MEPD – Shape memory effect with plasticity option: plastic response.
METC – Shape memory effect with plasticity option: tension-compression asymmetry response and hysteresis response.
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.
MSOL --: Material solution option.

References:

Cam-clay in the Material Reference

STATE -- User-Defined State Variable Specifications

When Lab = STATE, state variable specifications affect user-defined material models. 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:: Customizing Material Behavior 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 userswstrain (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 Model in the Structural Analysis Guide

THERM -- Thermal Properties Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Thermal properties:

COND --: Thermal conductivity.
ENTH --: Enthalpy. Enthalpy must be a function of temperature only (see Considerations for Enthalpy).
SPHT --: Specific heat. For porous media, solid-skeleton specific heat.
FLSPHT --: Fluid-specific heat for porous media.

References:

Thermal Properties in the Material Reference

Porous Media Mechanics in the Material Reference

TNM -- Three-Network Model Properties Specifications

NTEMP:

Not used.

NPTS:

Not used.

TBOPT:

Three-network model material options:

NETA --: Network A properties.
NETB --: Network B properties.
NETC --: Network C properties.
FLOW --: Network flow properties.
TDEP --: Temperature-dependence factors.
LOCK --: Chain-locking stretch.
BULK --: Bulk modulus.

References:

Three-Network Model (TB,TNM) 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 and the TBOPT setting. For a detailed list of elements that support TB,USER, see Material Model Support for Elements in the Material Reference..

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 except for thermal elements).

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.

THERM

Invokes the thermal material model (UserMatTh) for a coupled-field analysis using elements SOLID225, SOLID226, and SOLID227 with thermal degrees of freedom. Use this option in a coupled structural-thermal analysis to specify a user-defined thermal material model (UserMatTh) independently of the user-defined structural material model (UserMat).

Invokes the thermal material model (UserMatTh) for thermal elements SOLID278, SOLID279, SOLID291, PLANE292, and PLANE293. For thermal elements, this is the only option (no default).

References:

Customizing Material Behavior 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.
AUTS --: Automatic scaling of wear increment. Must be used in conjunction with one of the wear models (TBOPT = ARCD or USER).
CBCS --: Autoscaling of wear increment over each simulation cycle. Must be used along with one of the wear models (TBOPT = ARCD or USER)..

References:

Contact Surface Wear in the Material Reference

Contact Surface Wear in the Contact Technology Guide

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

XTAL -- Crystal Plasticity Model Specifications

NTEMP:

Unused.

NPTS:

Unused.

TBOPT:

Crystal plasticity material options:

ORIE --: Crystal orientation.
NSLFAM --: Number of slip families.
FORM --: Formulation number.
XPARAM --: Crystal characteristic parameters.
HARD --: Slip system hardness properties.
FLFCC --: Face-centered cubic (FCC) flow parameters.
FLHCP --: Hexagonal closed packed (HCP) flow parameters.
FLBCC --: Body-centered cubic (BCC) flow parameters.

Reference:

Crystal Plasticity in the Material Reference

Notes

TB activates a data table for use by subsequent TBDATA or TBPT commands. The table space is initialized to zero values. Data from this table are used for most 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 Support for Elements in the Material Reference.

For information about linear material property input, see MP.

This command is also valid in SOLUTION.

Considerations for Enthalpy (`TBOPT` = ENTH)

To ensure correct results, you must define enthalpy over a large enough temperature range to span all computed temperatures during the solution. The TB command does not extrapolate enthalpy values beyond the specified temp range like the MP command does.
If both the TB and MP commands are used to specify enthalpy values, enthalpy values defined via the TB command are used and those defined via the MP command are ignored.

Product Restrictions

*Material Model (`Lab`* or `TBOPT`)**^[a]	Description	Available Products
AFDM	Acoustic frequency-dependent material	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
AHYPER	Anisotropic hyperelasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
ANEL	Anisotropic elasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
AVIS	Anisotropic viscosity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
BB	Bergstrom-Boyce	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
BH	Magnetic field	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
BISO (specified as TB,PLASTIC,,,,BISO)	Bilinear isotropic hardening	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
BKIN (specified as TB,PLASTIC,,,,BKIN)	Bilinear kinematic hardening	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CAST	Cast iron	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CDM	Damage	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CFOAM	Crushable foam	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CGCR	Crack-growth	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CHABOCHE	Chaboche nonlinear kinematic hardening	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CONCR	Concrete	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CREEP	Creep	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CTE	Coefficient of thermal expansion	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
CZM	Cohesive zone	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
DLST	Anisotropic dielectric loss tangent	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
DMGE	Damage evolution law	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
DMGI	Damage initiation criteria	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
DPER	Anisotropic electric permittivity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
EDP	Extended Drucker-Prager	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
ELASTIC	Elasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
ELASTIC (`TBOPT` = USER)	Elasticity (user-defined)	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
ELST	Anisotropic elastic loss tangent	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
EXPE	Experimental data	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
FCON	Fluid conductance data	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
FCLI	Material strength limits	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
FLUID	Fluid	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
FRIC	Coefficient of friction	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
GASKET	Gasket	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
GURSON	Gurson pressure-dependent plasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
HFLM	Film coefficient data	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
HILL	Hill anisotropy	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
HYPER	Hyperelasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
HYPER (`TBOPT` = USER)	Hyperelasticity (user-defined)	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
INTER	Contact interaction	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
INTER (`TBOPT` = USER)	Contact interaction (user-defined)	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
ISR (specified as PLASTIC,,,,ISR)	Isotropic static recovery	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
JOIN	Joint	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
JOIN (`TBOPT` = STIF)	Joint (user-defined)	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
JROCK	Jointed rock	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
KINH (specified as PLASTIC,,,,KINH)	Multilinear kinematic hardening plasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
KSR2 (specified as PLASTIC,,,,KSR2)	Kinematic static recovery	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
MC	Mohr-Coulomb	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
MELAS	Multilinear elasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
MIGR	Migration	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
MISO (specified as PLASTIC,,,,MISO)	Multilinear isotropic hardening plasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
MPLANE	Microplane	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
NLISO	Voce isotropic hardening law (power law)	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PELAS	Porous elasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PERF	Perforated material	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PIEZ	Piezoelectric matrix	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PLASTIC	Nonlinear plasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PM	Porous media	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PRONY	Prony series	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
PZRS	Piezoresistivity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
RATE	Rate-dependent plasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
RO	Ramberg-Osgood	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
SDAMP	Material damping coefficients	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
SHIFT	Shift function	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
SINT	Sintering	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
SMA	Shape memory alloy	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
SOIL	Soil models	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
STATE	User-defined state variables	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
SWELL	Swelling	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
THERM	Thermal	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
TNM	Three-network model	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
USER	User-defined	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
WEAR	Contact surface wear	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on
XTAL	Crystal Plasticity	Pro \| Premium \| Enterprise \| PrepPost \| Solver \| AS add-on

^[a]TB,Lab value or TB,Lab,,,,TBOPT value.

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

TB

Data Table Specifications

AFDM -- Acoustic Frequency-Dependent Material Specifications

AHYPER -- Anisotropic Hyperelasticity Specifications

ANEL -- Anisotropic Elasticity Specifications

ANISO – Generalized Hill Anisotropy Specifications

AVIS -- Anisotropic Viscosity Specifications

BB -- Bergstrom-Boyce Hyperelasticity Specifications

BH -- Magnetic Field Data Specifications

CAST -- Cast Iron Plasticity Specifications

CDM -- Damage Specifications

CFOAM -- Crushable Foam Specifications

CGCR -- Crack-Growth Fracture Criterion

CHABOCHE -- Chaboche Nonlinear Kinematic Hardening Specifications

CONCR -- Concrete Plasticity Specifications

CREEP -- Creep Specifications

CRKI -- Adaptive Crack-Initiation Specifications

CTE -- Coefficient of Thermal Expansion Specifications

CZM -- Cohesive Zone Specifications

DENS -- Mass Density Specifications

DLST -- Anisotropic Dielectric Loss Tangent Specifications

DMGE -- Damage Evolution Law Specifications

DMGI -- Damage Initiation Criteria Specifications

DPER -- Anisotropic Electric Permittivity Specifications

EDP -- Extended Drucker-Prager Plasticity Specifications

ELASTIC -- Elasticity Specifications

ELST -- Anisotropic Elastic Loss Tangent Specifications

EXPE -- Experimental Data Specifications

FCON -- Fluid Conductance Data Specifications

FCLI -- Material Strength Limits Specifications

FLUID -- Fluid Specifications

FRIC -- Coefficient of Friction Specifications

GASKET -- Gasket Specifications

GURSON -- Gurson Plasticity Specifications

HFLM -- Film Coefficient Data Specifications

HILL -- Hill Plasticity Specifications

HYPER -- Hyperelasticity Specifications

INTER -- Contact Interaction Specifications

JOIN -- Joint Element Specifications

JROCK -- Jointed Rock Specifications

MC -- Mohr-Coulomb Specifications

MELAS – Multilinear Elasticity Specifications

MIGR – Migration Model Specifications

MPLANE -- Microplane Specifications

NLISO -- Nonlinear Isotropic Hardening Specifications

PERF -- Perforated Material Specifications

PIEZ -- Piezoelectric Matrix Specifications

PLASTIC -- Nonlinear Plasticity Specifications

PELAS -- Porous Elasticity Specifications

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

PRONY -- Prony Series Constant Specifications

PZRS -- Piezoresistivity Specifications

RATE -- Rate-Dependent Plasticity Specifications

RO -- Ramberg-Osgood Specifications

SDAMP -- Material Damping Coefficient Specifications

SHIFT -- Shift Function Specifications

SINT -- Sintering Specifications

SMA -- Shape Memory Alloy Specifications

SOIL -- Soil Specifications

STATE -- User-Defined State Variable Specifications

SWELL -- Swelling Specifications

THERM -- Thermal Properties Specifications

TNM -- Three-Network Model Properties Specifications

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

WEAR -- Contact Surface Wear Specifications

XTAL -- Crystal Plasticity Model Specifications

Notes

Considerations for Enthalpy (TBOPT = ENTH)

Product Restrictions

Menu Paths

Considerations for Enthalpy (`TBOPT` = ENTH)