ansys.mapdl.core.Mapdl.tb#

Mapdl.tb(lab='', matid='', ntemp='', npts='', tbopt='', funcname='', **kwargs)#

Activates a data table for material properties or special element input.

Mechanical APDL Command: TB

Parameters:
labstr

Material model data table type:

matidstr

Material reference identification number. Valid value is any number n, where 0 < n < 100,000. Default = 1.

ntempstr

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

nptsstr

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.

tboptstr

The description of the argument is missing in the Python function. Please, refer to the command documentation for further information.

funcnamestr

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 tbjoinspec ). The function must be predefined via the Function Tool. To learn more about how to create a function, see Using the Function Tool

Notes

Warning

This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.

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

  • 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

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

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

  • 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

  • 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

    Bergstrom-Boyce Material ( TB,BB)

    Bergstrom-Boyce Hyperviscoelasticity Model

  • 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: -

    Additional Guidelines for Defining Regional Material Properties and Real Constants

  • 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

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

  • References: - Mullins Effect

    Mullins Effect ( TB,CDM)

    Mullins Effect Model

    Regularized Anisotropic Damage

  • 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

  • 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 \(equation not available\) 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 <https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/ans_frac/franundcgrowmech.html#eq4f61610d-5010-4a2d-83de-3c60fba4be9f>`_ 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

  • NTEMP : - Number of temperatures for which data will be provided. Default = 1. The maximum value of NTEMP is such that NTEMP x (1 + 2 NPTS ) = 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

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

    • 1 through 13 - Implicit creep option. See for a list of available equations.

    • 100 - USER CREEP option. Define the creep law using the USERCREEP.F subroutine. See the Guide to User-Programmable Features

  • References: - Creep

    Creep Model

    See also Combining Material Models

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

  • References: - SMART Method for Crack-Initiation Simulation

  • NTEMP: - No limit.

  • NPTS: - Not used.

  • TBOPT: - * (blank) - Enter the secant coefficients of thermal expansion (CTEX,CTEY,CTEZ)

(default).

  • 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

  • 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

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

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

    Extended Drucker-Prager Cap

  • 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

  • References: - See tbfield for more information about defining temperature- and/or frequency-dependent properties.

    Regularized Anisotropic Damage

    Full Harmonic Analysis

  • 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 Response Functions

    Viscoelasticity

    See also tbfield for information about defining field-dependent experimental data.

  • 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

  • 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: -

  • 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: -

    Fluid Material Models

  • 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

    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.

  • 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

    Gasket Joints Simulation

  • 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

    Gurson’s Model

  • 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

  • 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

    Hill Yield Criterion

    See also Combining Material Models

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

    • 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

  • 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

    Defining Your Own Contact Interaction ( USERINTER)

  • 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 μ:sub:s, μ:sub: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

  • 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

  • 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

  • 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

  • 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

  • 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

    Equivalent Fluid of Perforated Materials

    Poroelastic Acoustics

    Perforated Material

    Trim Element with Transfer Admittance Matrix

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

  • 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

    Piezoelectric Analysis

  • NTEMP : - Not used.

  • NPTS : - Not used.

  • TBOPT : - * POISSON - Porous elasticity model..

  • References: - Porous Elasticity

  • 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

  • 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

    Piezoresistive Analysis

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

    Viscoplasticity Model

    Rate-Dependent Plasticity

    See also Combining Material Models

  • 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

    Full Harmonic Analysis

    Damping Matrices

  • NTEMP: - Allows one temperature for which data will be provided.

  • NPTS: - Number of material constants to be entered as determined by the `shift function

<https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/ans_mat/evis.html#mat_userdefshift>`_ specified via TBOPT. Not used for TBOPT = PLIN.

  • 3 - for TBOPT = WLF

  • 2 - for TBOPT = TN

  • n, :sub:`f` - for TBOPT = FICT, where n f is the number of partial fictive temperatures

  • 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

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

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

    Swelling Model

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

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

<https://ansyshelp.ansys.com/Views/Secured/corp/v232/en/ans_prog/Z7K4r1e5lcd.html#>`_ ) 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.

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

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

  • References: - Contact Surface Wear

    Contact Surface Wear

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

  • 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

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 Element Support

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.

This command contains some tables and extra information which can be inspected in the original documentation pointed above.