Material#

The Material commands are used to define the materials in a model.

Create materials#

In Mdb#

class MaterialModel(name: str, description: str = '', stefanBoltzmann: float | None = None, absoluteZero: float | None = None, waveFormulation: SymbolicConstantType = 'NOT_SET', modelType: SymbolicConstantType = 'STANDARD_EXPLICIT', universalGas: float | None = None, copyConstraints: BooleanType = 1, copyConnectors: BooleanType = 1, copyInteractions: BooleanType = 1)[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Notes

This object can be accessed by:

mdb.models[name]

Methods

Material(name[, description, materialIdentifier])

This method creates a Material object.

Material(name: str, description: str = '', materialIdentifier: str = '')[source]#

This method creates a Material object.

Parameters:
name

A String specifying the name of the new material.

description

A String specifying user description of the material. The default value is an empty string.

materialIdentifier

A String specifying material identifier for customer use. The default value is an empty string.

Returns:
A Material object.

Notes

This function can be accessed by:

mdb.models[name].Material

In Odb#

class MaterialOdb(name: str, analysisTitle: str = '', description: str = '', path: str = '')[source]#

The Odb object is the in-memory representation of an output database (ODB) file.

Notes

This object can be accessed by:

import odbAccess
session.odbs[name]

Methods

Material(name[, description, materialIdentifier])

This method creates a Material object.

Material(name: str, description: str = '', materialIdentifier: str = '')[source]#

This method creates a Material object.

Parameters:
name

A String specifying the name of the new material.

description

A String specifying user description of the material. The default value is an empty string.

materialIdentifier

A String specifying material identifier for customer use. The default value is an empty string.

Returns:
A Material object.

Notes

This function can be accessed by:

session.odbs[name].Material

Assign properties to the material#

class Material(name: str, description: str = '', materialIdentifier: str = '')[source]#

A Material object is the object used to specify a material. The Material object stores the various settings that determine how a material behaves. A material is created by combining one or more individual material options and sub options. A particular material option is associated with the Material object through a member. For example: the acousticMedium member may contain an AcousticMedium object. The alternative of having a MaterialOption abstract base class and a container of MaterialOptions was rejected because it would make it more difficult to enforce the fact that one Material object cannot contain two AcousticMedium objects, for example.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name]
import odbMaterial
session.odbs[name].materials[name]

The corresponding analysis keywords are:

  • MATERIAL

Attributes:
acousticMedium: AcousticMedium

An AcousticMedium object.

brittleCracking: BrittleCracking

A BrittleCracking object.

capPlasticity: CapPlasticity

A CapPlasticity object.

castIronPlasticity: CastIronPlasticity

A CastIronPlasticity object.

clayPlasticity: ClayPlasticity

A ClayPlasticity object.

concrete: Concrete

A Concrete object.

concreteDamagedPlasticity: ConcreteDamagedPlasticity

A ConcreteDamagedPlasticity object.

conductivity: Conductivity

A Conductivity object.

creep: Creep

A Creep object.

crushableFoam: CrushableFoam

A CrushableFoam object.

crushStress: CrushStress

A CrushStress object.

ductileDamageInitiation: DamageInitiation

A DamageInitiation object.

fldDamageInitiation: DamageInitiation

A DamageInitiation object.

flsdDamageInitiation: DamageInitiation

A DamageInitiation object.

johnsonCookDamageInitiation: DamageInitiation

A DamageInitiation object.

maxeDamageInitiation: DamageInitiation

A DamageInitiation object.

maxsDamageInitiation: DamageInitiation

A DamageInitiation object.

maxpeDamageInitiation: DamageInitiation

A DamageInitiation object.

maxpsDamageInitiation: DamageInitiation

A DamageInitiation object.

mkDamageInitiation: DamageInitiation

A DamageInitiation object.

msfldDamageInitiation: DamageInitiation

A DamageInitiation object.

quadeDamageInitiation: DamageInitiation

A DamageInitiation object.

quadsDamageInitiation: DamageInitiation

A DamageInitiation object.

shearDamageInitiation: DamageInitiation

A DamageInitiation object.

hashinDamageInitiation: DamageInitiation

A DamageInitiation object.

damping: Damping

A Damping object.

deformationPlasticity: DeformationPlasticity

A DeformationPlasticity object.

density: Density

A Density object.

depvar: Depvar

A Depvar object.

dielectric: Dielectric

A Dielectric object.

diffusivity: Diffusivity

A Diffusivity object.

druckerPrager: DruckerPrager

A DruckerPrager object.

elastic: Elastic

An Elastic object.

electricalConductivity: ElectricalConductivity

An ElectricalConductivity object.

eos: Eos

An Eos object.

expansion: Expansion

An Expansion object.

fluidLeakoff: FluidLeakoff

A FluidLeakoff object.

gapFlow: GapFlow

A GapFlow object.

gasketThicknessBehavior: GasketThicknessBehavior

A GasketThicknessBehavior object.

gasketTransverseShearElastic: GasketTransverseShearElastic

A GasketTransverseShearElastic object.

gasketMembraneElastic: GasketMembraneElastic

A GasketMembraneElastic object.

gel: Gel

A Gel object.

heatGeneration: HeatGeneration

A HeatGeneration object.

hyperelastic: Hyperelastic

A Hyperelastic object.

hyperfoam: Hyperfoam

A Hyperfoam object.

hypoelastic: Hypoelastic

A Hypoelastic object.

inelasticHeatFraction: InelasticHeatFraction

An InelasticHeatFraction object.

jouleHeatFraction: JouleHeatFraction

A JouleHeatFraction object.

latentHeat: LatentHeat

A LatentHeat object.

lowDensityFoam: LowDensityFoam

A LowDensityFoam object.

magneticPermeability: MagneticPermeability

A MagneticPermeability object.

mohrCoulombPlasticity: MohrCoulombPlasticity

A MohrCoulombPlasticity object.

moistureSwelling: MoistureSwelling

A MoistureSwelling object.

mullinsEffect: MullinsEffect

A MullinsEffect object.

permeability: Permeability

A Permeability object.

piezoelectric: Piezoelectric

A Piezoelectric object.

plastic: Plastic

A Plastic object.

poreFluidExpansion: PoreFluidExpansion

A PoreFluidExpansion object.

porousBulkModuli: PorousBulkModuli

A PorousBulkModuli object.

porousElastic: PorousElastic

A PorousElastic object.

porousMetalPlasticity: PorousMetalPlasticity

A PorousMetalPlasticity object.

regularization: Regularization

A Regularization object.

solubility: Solubility

A Solubility object.

sorption: Sorption

A Sorption object.

specificHeat: SpecificHeat

A SpecificHeat object.

swelling: Swelling

A Swelling object.

userDefinedField: UserDefinedField

A UserDefinedField object.

userMaterial: UserMaterial

A UserMaterial object.

userOutputVariables: UserOutputVariables

A UserOutputVariables object.

viscoelastic: Viscoelastic

A Viscoelastic object.

viscosity: Viscosity

A Viscosity object.

viscous: Viscous

A Viscous object.

Methods

AcousticMedium([acousticVolumetricDrag, ...])

This method creates an AcousticMedium object.

BrittleCracking(table[, ...])

This method creates a BrittleCracking object.

CapPlasticity(table[, ...])

This method creates a CapPlasticity object.

CastIronPlasticity(table[, ...])

This method creates a CastIronPlasticity object.

ClayPlasticity(table[, intercept, ...])

This method creates a ClayPlasticity object.

Concrete(table[, temperatureDependency, ...])

This method creates a Concrete object.

ConcreteDamagedPlasticity(table[, ...])

This method creates a ConcreteDamagedPlasticity object.

Conductivity(table[, type, ...])

This method creates a Conductivity object.

Creep(table[, law, temperatureDependency, ...])

This method creates a Creep object.

CrushStress(crushStressTable[, ...])

This method creates a CrushStress object.

CrushableFoam(table[, hardening, ...])

This method creates a CrushableFoam object.

Damping([alpha, beta, composite, structural])

This method creates a Damping object.

DeformationPlasticity(table[, ...])

This method creates a DeformationPlasticity object.

Density(table[, temperatureDependency, ...])

This method creates a Density object.

Depvar([deleteVar, n])

This method creates a Depvar object.

Dielectric(table[, type, ...])

This method creates a Dielectric object.

Diffusivity(table[, type, law, ...])

This method creates a Diffusivity object.

DruckerPrager(table[, shearCriterion, ...])

This method creates a DruckerPrager object.

Elastic(table[, type, noCompression, ...])

This method creates an Elastic object.

ElectricalConductivity(table[, type, ...])

This method creates an ElectricalConductivity object.

Eos([type, temperatureDependency, ...])

This method creates an Eos object.

Expansion([type, userSubroutine, zero, ...])

This method creates an Expansion object.

FluidLeakoff([temperatureDependency, ...])

This method creates a FluidLeakoff object.

GapFlow(table[, kmax, ...])

This method creates a GapFlow object.

GasketMembraneElastic(table[, ...])

This method creates a GasketMembraneElastic object.

GasketThicknessBehavior(table[, ...])

This method creates a GasketThicknessBehavior object.

GasketTransverseShearElastic(table[, ...])

This method creates a GasketTransverseShearElastic object.

Gel(table)

This method creates a Gel object.

Hyperelastic(table[, type, moduliTimeScale, ...])

This method creates a Hyperelastic object.

Hyperfoam([testData, poisson, n, ...])

This method creates a Hyperfoam object.

Hypoelastic(table[, user])

This method creates a Hypoelastic object.

InelasticHeatFraction([fraction])

This method creates an InelasticHeatFraction object.

JouleHeatFraction([fraction])

This method creates a JouleHeatFraction object.

LatentHeat(table)

This method creates a LatentHeat object.

LowDensityFoam([elementRemoval, ...])

This method creates a LowDensityFoam object.

MagneticPermeability(table, table2, table3)

This method creates a MagneticPermeability object.

MohrCoulombPlasticity(table[, ...])

This method creates a MohrCoulombPlasticity object.

MoistureSwelling(table)

This method creates a MoistureSwelling object.

Permeability(specificWeight, ...[, type, ...])

This method creates a Permeability object.

Piezoelectric(table[, type, ...])

This method creates a Piezoelectric object.

Plastic(table[, hardening, rate, dataType, ...])

This method creates a Plastic object.

PoreFluidExpansion(table[, zero, ...])

This method creates a PoreFluidExpansion object.

PorousBulkModuli(table[, temperatureDependency])

This method creates a PorousBulkModuli object.

PorousElastic(table[, shear, ...])

This method creates a PorousElastic object.

PorousMetalPlasticity(table[, ...])

This method creates a PorousMetalPlasticity object.

Regularization([rtol, strainRateRegularization])

This method creates a Regularization object.

Solubility(table[, temperatureDependency, ...])

This method creates a Solubility object.

Sorption(absorptionTable[, lawAbsorption, ...])

This method creates a Sorption object.

SpecificHeat(table[, law, ...])

This method creates a SpecificHeat object.

Swelling(table[, law, ...])

This method creates a Swelling object.

UserMaterial([type, unsymm, ...])

This method creates a UserMaterial object.

UserOutputVariables([n])

This method creates a UserOutputVariables object.

Viscoelastic(domain, table[, frequency, ...])

This method creates a Viscoelastic object.

Viscosity(table[, type, ...])

This method creates a Viscosity object.

Viscous(table[, law, temperatureDependency, ...])

This method creates a Viscous object.

AcousticMedium(acousticVolumetricDrag: BooleanType = 0, temperatureDependencyB: BooleanType = 0, temperatureDependencyV: BooleanType = 0, dependenciesB: int = 0, dependenciesV: int = 0, bulkTable: tuple = (), volumetricTable: tuple = ()) AcousticMedium[source]#

This method creates an AcousticMedium object.

Parameters:
acousticVolumetricDrag

A Boolean specifying whether the volumetricTable data is specified. The default value is OFF.

temperatureDependencyB

A Boolean specifying whether the data in bulkTable depend on temperature. The default value is OFF.

temperatureDependencyV

A Boolean specifying whether the data in volumetricTable depend on temperature. The default value is OFF.

dependenciesB

An Int specifying the number of field variable dependencies for the data in bulkTable. The default value is 0.

dependenciesV

An Int specifying the number of field variable dependencies for the data in volumetricTable. The default value is 0.

bulkTable

A sequence of sequences of Floats specifying the following: - Bulk modulus. - Temperature, if the data depend on temperature. - Value of the first field variable, if the data depend on field variables. - Value of the second field variable. - Etc.

volumetricTable

A sequence of sequences of Floats specifying the following: - Volumetric drag. - Frequency. - Temperature, if the data depend on temperature. - Value of the first field variable, if the data depend on field variables. - Value of the second field variable. - Etc. The default value is an empty sequence.

Returns:
An AcousticMedium object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].AcousticMedium
session.odbs[name].materials[name].AcousticMedium
BrittleCracking(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'STRAIN') BrittleCracking[source]#

This method creates a BrittleCracking object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

type

A SymbolicConstant specifying the type of postcracking behavior. Possible values are STRAIN, DISPLACEMENT, and GFI. The default value is STRAIN.

Returns:
A BrittleCracking object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].BrittleCracking
session.odbs[name].materials[name].BrittleCracking
CapPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) CapPlasticity[source]#

This method creates a CapPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CapPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].CapPlasticity
session.odbs[name].materials[name].CapPlasticity
CastIronPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) CastIronPlasticity[source]#

This method creates a CastIronPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CastIronPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].CastIronPlasticity
session.odbs[name].materials[name].CastIronPlasticity
ClayPlasticity(table: tuple, intercept: float | None = None, hardening: SymbolicConstantType = 'EXPONENTIAL', temperatureDependency: BooleanType = 0, dependencies: int = 0) ClayPlasticity[source]#

This method creates a ClayPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

intercept

None or a Float specifying e1e1, the intercept of the virgin consolidation line with the void ratio axis in a plot of void ratio versus the logarithm of pressure stress. The default value is None.This argument is valid only if *hardening*=EXPONENTIAL.

hardening

A SymbolicConstant specifying the type of hardening/softening definition. Possible values are EXPONENTIAL and TABULAR. The default value is EXPONENTIAL.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A ClayPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].ClayPlasticity
session.odbs[name].materials[name].ClayPlasticity
Concrete(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) Concrete[source]#

This method creates a Concrete object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Concrete object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Concrete
session.odbs[name].materials[name].Concrete
ConcreteDamagedPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) ConcreteDamagedPlasticity[source]#

This method creates a ConcreteDamagedPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A ConcreteDamagedPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].ConcreteDamagedPlasticity
session.odbs[name].materials[name].ConcreteDamagedPlasticity
Conductivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', temperatureDependency: BooleanType = 0, dependencies: int = 0) Conductivity[source]#

This method creates a Conductivity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of conductivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Conductivity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Conductivity
session.odbs[name].materials[name].Conductivity
Creep(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL') Creep[source]#

This method creates a Creep object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

law

A SymbolicConstant specifying the strain-hardening law. Possible values are STRAIN, TIME, HYPERBOLIC_SINE, USER, ANAND, DARVEAUX,DOUBLE_POWER, POWER_LAW, and TIME_POWER_LAW. The default value is STRAIN.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

time

A SymbolicConstant specifying the time interval for relevant laws. Possible values are CREEP and TOTAL. The default value is TOTAL.

Returns:
A Creep object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Creep
session.odbs[name].materials[name].Creep
CrushStress(crushStressTable: tuple[tuple[float, ...]], temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

This method creates a CrushStress object.

Parameters:
crushStressTable

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CrushStress object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].CrushStress
session.odbs[name].materials[name].CrushStress
CrushableFoam(table: tuple, hardening: SymbolicConstantType = 'VOLUMETRIC', temperatureDependency: BooleanType = 0, dependencies: int = 0) CrushableFoam[source]#

This method creates a CrushableFoam object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

hardening

A SymbolicConstant specifying the type of hardening/softening definition. Possible values are VOLUMETRIC and ISOTROPIC. The default value is VOLUMETRIC.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CrushableFoam object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].CrushableFoam
session.odbs[name].materials[name].CrushableFoam
Damping(alpha: float = 0, beta: float = 0, composite: float = 0, structural: float = 0) Damping[source]#

This method creates a Damping object.

Parameters:
alpha

A Float specifying the αRαR factor to create mass proportional damping in direct-integration and explicit dynamics. The default value is 0.0.

beta

A Float specifying the βRβR factor to create stiffness proportional damping in direct-integration and explicit dynamics. The default value is 0.0.

composite

A Float specifying the fraction of critical damping to be used with this material in calculating composite damping factors for the modes (for use in modal dynamics). The default value is 0.0.This argument applies only to Abaqus/Standard analyses.

structural

A Float specifying the structural factor to create material damping in direct-integration and explicit dynamics. The default value is 0.0.

Returns:
A Damping object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Damping
session.odbs[name].materials[name].Damping
DeformationPlasticity(table: tuple, temperatureDependency: BooleanType = 0) DeformationPlasticity[source]#

This method creates a DeformationPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

Returns:
A DeformationPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].DeformationPlasticity
session.odbs[name].materials[name].DeformationPlasticity
Density(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, distributionType: SymbolicConstantType = 'UNIFORM', fieldName: str = '') Density[source]#

This method creates a Density object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

distributionType

A SymbolicConstant specifying how the density is distributed spatially. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

fieldName

A String specifying the name of the AnalyticalField or DiscreteField object associated with this material option. The fieldName argument applies only when *distributionType*=ANALYTICAL_FIELD or *distributionType*=DISCRETE_FIELD. The default value is an empty string.

Returns:
A Density object.
Raises:
RangeError

The table data for this object are: - The mass density. - Temperature, if the data depend on temperature. - Value of the first field variable, if the data depend on field variables. - Value of the second field variable. - Etc.

Depvar(deleteVar: int = 0, n: int = 0) Depvar[source]#

This method creates a Depvar object.

Parameters:
deleteVar

An Int specifying the state variable number controlling the element deletion flag. The default value is 0.This argument applies only to Abaqus/Explicit analyses.

n

An Int specifying the number of solution-dependent state variables required at each integration point. The default value is 0.

Returns:
A Depvar object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Depvar
session.odbs[name].materials[name].Depvar
Dielectric(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) Dielectric[source]#

This method creates a Dielectric object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the dielectric behavior. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

frequencyDependency

A Boolean specifying whether the data depend on frequency. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Dielectric object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Dielectric
session.odbs[name].materials[name].Dielectric
Diffusivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', law: SymbolicConstantType = 'GENERAL', temperatureDependency: BooleanType = 0, dependencies: int = 0) Diffusivity[source]#

This method creates a Diffusivity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of diffusivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

law

A SymbolicConstant specifying the diffusion behavior. Possible values are GENERAL and FICK. The default value is GENERAL.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Diffusivity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Diffusivity
session.odbs[name].materials[name].Diffusivity
DruckerPrager(table: tuple, shearCriterion: SymbolicConstantType = 'LINEAR', eccentricity: float = 0, testData: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) DruckerPrager[source]#

This method creates a DruckerPrager object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

shearCriterion

A SymbolicConstant specifying the yield criterion. Possible values are LINEAR, HYPERBOLIC, and EXPONENTIAL. The default value is LINEAR.This argument applies only to Abaqus/Standard analyses. Only the linear Drucker-Prager model is available in Abaqus/Explicit analyses.

eccentricity

A Float specifying the flow potential eccentricity, ϵϵ, a small positive number that defines the rate at which the hyperbolic flow potential approaches its asymptote. The default value is 0.1.This argument applies only to Abaqus/Standard analyses.

testData

A Boolean specifying whether the material constants for the exponent model are to be computed by Abaqus/Standard from triaxial test data at different levels of confining pressure. The default value is OFF.This argument is valid only if *shearCriterion*=EXPONENTIAL.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A DruckerPrager object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].DruckerPrager
session.odbs[name].materials[name].DruckerPrager
Elastic(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', noCompression: BooleanType = 0, noTension: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, moduli: SymbolicConstantType = 'LONG_TERM') Elastic[source]#

This method creates an Elastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of elasticity data provided. Possible values are:

  • ISOTROPIC

  • ORTHOTROPIC

  • ANISOTROPIC

  • ENGINEERING_CONSTANTS

  • LAMINA

  • TRACTION

  • COUPLED_TRACTION

  • SHORT_FIBER

  • SHEAR

  • BILAMINA

The default value is ISOTROPIC.

noCompression

A Boolean specifying whether compressive stress is allowed. The default value is OFF.

noTension

A Boolean specifying whether tensile stress is allowed. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

moduli

A SymbolicConstant specifying the time-dependence of the elastic material constants. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

Returns:
An Elastic object.
Raises:
RangeError

The table data for this object are: - If **type**=ISOTROPIC, the table data specify the following:

  • The Young’s modulus, E.

  • The Poisson’s ratio, v.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

  • If **type**=SHEAR, the table data specify the following:
    • The shear modulus,G.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=ENGINEERING_CONSTANTS, the table data specify the following:
    • E1.

    • E2.

    • E3.

    • v12.

    • v13.

    • v23.

    • G12.

    • G13.

    • G23.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=LAMINA, the table data specify the following:
    • E1.

    • E2.

    • v12.

    • G12.

    • G13. This shear modulus is needed to define transverse shear behavior in shells.

    • G23. This shear modulus is needed to define transverse shear behavior in shells.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=ORTHOTROPIC, the table data specify the following:
    • D1111.

    • D1122.

    • D2222.

    • D1133.

    • D2233.

    • D3333.

    • D1212.

    • D1313.

    • D2323.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=ANISOTROPIC, the table data specify the following:
    • D1111.

    • D1122.

    • D2222.

    • D1133.

    • D2233.

    • D3333.

    • D1112.

    • D2212.

    • D3312.

    • D1212.

    • D1113.

    • D2213.

    • D3313.

    • D1213.

    • D1313.

    • D1123.

    • D2223.

    • D3323.

    • D1223.

    • D1323.

    • D2323.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=TRACTION, the table data specify the following:
    • EE for warping elements; En⁢n for cohesive elements.

    • G1 for warping elements; Es⁢s for cohesive elements.

    • G2 for warping elements; Et⁢t for cohesive elements.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=SHORT_FIBER, there is no table data.

ElectricalConductivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) ElectricalConductivity[source]#

This method creates an ElectricalConductivity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of electrical conductivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

frequencyDependency

A Boolean specifying whether the data depend on frequency. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
An ElectricalConductivity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].ElectricalConductivity
session.odbs[name].materials[name].ElectricalConductivity
Eos(type: SymbolicConstantType = 'IDEALGAS', temperatureDependency: BooleanType = 0, dependencies: int = 0, detonationEnergy: float = 0, solidTable: tuple = (), gasTable: tuple = (), reactionTable: tuple = (), gasSpecificTable: tuple = (), table: tuple = ()) Eos[source]#

This method creates an Eos object.

Parameters:
type

A SymbolicConstant specifying the equation of state. Possible values are USUP, JWL, IDEALGAS, TABULAR, and IGNITIONANDGROWTH. The default value is IDEALGAS.

temperatureDependency

A Boolean specifying whether the data in gasSpecificTable depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies for the data in gasSpecificTable. The default value is 0.

detonationEnergy

A Float specifying the detonation energy text field. The default value is 0.0.

solidTable

A sequence of sequences of Floats specifying the following: - $A_{s}$. - $B_{s}$. - ${omega}_{s}$. - $R_{1s}$. - $R_{2s}$. The default value is an empty sequence.

gasTable

A sequence of sequences of Floats specifying the following: - $A_{g}$. - $B_{g}$. - ${omega}_{g}$. - $R_{1g}$. - $R_{2g}$. The default value is an empty sequence.

reactionTable

A sequence of sequences of Floats specifying the following: - Initial Pressure, $I$. - Product co-volume, $a$. - Exponent on the unreacted fraction (ignition term), $x$. - First burn rate coefficient, $G_{1}$ - Exponent on the unreacted fraction (growth term), $c$. - Exponent on the reacted fraction (growth term), $d$. - Pressure exponent (growth term), $y$. - Second burn rate coefficient, $G_{2}$. - Exponent on the unreacted fraction (completion term), $e$. - Exponent on the reacted fraction (completion term), $g$. - Pressure exponent (completion term), $z$. - Initial reacted fraction, ${F^{max}}_{ig}$. - Maximum reacted fraction for the growth term, ${F^{max}}_{G1}$. - Minimum reacted fraction, ${F^{min}}_{G2}$. The default value is an empty sequence.

gasSpecificTable

A sequence of sequences of Floats specifying the following: - Specific Heat per unit mass. - Temperature dependent data. - Value of first field variable. - Value of second field variable. - Etc. The default value is an empty sequence.

table

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
Raises:

Notes

This function can be accessed by:

mdb.models[name].materials[name].Eos
session.odbs[name].materials[name].Eos
Expansion(type: SymbolicConstantType = 'ISOTROPIC', userSubroutine: BooleanType = 0, zero: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, table: tuple = ()) Expansion[source]#

This method creates an Expansion object.

Parameters:
type

A SymbolicConstant specifying the type of expansion. Possible values are ISOTROPIC, ORTHOTROPIC, ANISOTROPIC, and SHORT_FIBER. The default value is ISOTROPIC.

userSubroutine

A Boolean specifying whether a user subroutine is used to define the increments of thermal strain. The default value is OFF.

zero

A Float specifying the value of θ0 if the thermal expansion is temperature-dependent or field-variable-dependent. The default value is 0.0.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

table

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.This argument is required only if type is not USER.

Returns:
An Expansion object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Expansion
session.odbs[name].materials[name].Expansion
FluidLeakoff(temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'COEFFICIENTS', table: tuple = ()) FluidLeakoff[source]#

This method creates a FluidLeakoff object.

Parameters:
temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

type

A SymbolicConstant specifying the type of fluid leak-off. Possible values are COEFFICIENTS and USER. The default value is COEFFICIENTS.

table

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
A FluidLeakoff object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].FluidLeakoff
session.odbs[name].materials[name].FluidLeakoff
GapFlow(table: tuple, kmax: float | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'NEWTONIAN') GapFlow[source]#

This method creates a GapFlow object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

kmax

None or a Float specifying the maximum permeability value that should be used. If *kmax*=None, Abaqus assumes that the permeability is not bounded. This value is meaningful only when **type**=NEWTONIAN. The default value is None.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

type

A SymbolicConstant specifying the type of gap flow. Possible values are NEWTONIAN, POWER_LAW, BINGHAM_PLASTIC, and HERSCHEL-BULKLEY. The default value is NEWTONIAN.

Returns:
A GapFlow object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].GapFlow
session.odbs[name].materials[name].GapFlow
GasketMembraneElastic(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) GasketMembraneElastic[source]#

This method creates a GasketMembraneElastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A GasketMembraneElastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].GasketMembraneElastic
session.odbs[name].materials[name].GasketMembraneElastic
GasketThicknessBehavior(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, tensileStiffnessFactor: float | None = None, type: SymbolicConstantType = 'ELASTIC_PLASTIC', unloadingDependencies: int = 0, unloadingTemperatureDependency: BooleanType = 0, variableUnits: SymbolicConstantType = 'STRESS', yieldOnset: float = 0, yieldOnsetMethod: SymbolicConstantType = 'RELATIVE_SLOPE_DROP', unloadingTable: tuple = ()) GasketThicknessBehavior[source]#

This method creates a GasketThicknessBehavior object.

Parameters:
table

A sequence of sequences of Floats specifying loading data. The first sequence must contain only 0. At least two sequences must be specified if **type**=DAMAGE, and at least 3 sequences must be specified if **type**=ELASTIC_PLASTIC. The items in the table data are described below.

temperatureDependency

A Boolean specifying whether the loading data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies included in the definition of the loading data, in addition to temperature. The default value is 0.

tensileStiffnessFactor

A Float specifying the fraction of the initial compressive stiffness that defines the stiffness in tension. The default value is 10–3.

type

A SymbolicConstant specifying a damage elasticity model or an elastic-Plastic model for gasket thickness-direction behavior. Possible values are ELASTIC_PLASTIC and DAMAGE. The default value is ELASTIC_PLASTIC.

unloadingDependencies

An Int specifying the number of field variable dependencies included in the definition of the unloading data, in addition to temperature. The default value is 0.

unloadingTemperatureDependency

A Boolean specifying whether unloading data depends on temperature. The default value is OFF.

variableUnits

A SymbolicConstant specifying the behavior in terms of units of force (or force in unit length) versus closure or pressure versus closure. Possible values are STRESS and FORCE. The default value is STRESS.

yieldOnset

A Float specifying the closure value at which the onset of yield occurs or the relative drop in slope on the loading curve that defines the onset of Plastic deformation (depending on the value of yieldOnsetMethod). The default value is 0.1.

yieldOnsetMethod

A SymbolicConstant specifying the method used to determine yield onset. Possible values are RELATIVE_SLOPE_DROP and CLOSURE_VALUE. The default value is RELATIVE_SLOPE_DROP.

unloadingTable

A sequence of sequences of Floats specifying unloading data. The items in the table data are described below. The default value is an empty sequence.

Returns:
A GasketThicknessBehavior object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].GasketThicknessBehavior
session.odbs[name].materials[name].GasketThicknessBehavior
GasketTransverseShearElastic(table: tuple, variableUnits: SymbolicConstantType = 'STRESS', temperatureDependency: BooleanType = 0, dependencies: int = 0) GasketTransverseShearElastic[source]#

This method creates a GasketTransverseShearElastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

variableUnits

A SymbolicConstant specifying the unit system in which the transverse shear behavior will be defined. Possible values are STRESS and FORCE. The default value is STRESS.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A GasketTransverseShearElastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].GasketTransverseShearElastic
session.odbs[name].materials[name].GasketTransverseShearElastic
Gel(table: tuple) Gel[source]#

This method creates a Gel object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

Returns:
A Gel object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Gel
session.odbs[name].materials[name].Gel
Hyperelastic(table: tuple, type: SymbolicConstantType = 'UNKNOWN', moduliTimeScale: SymbolicConstantType = 'LONG_TERM', temperatureDependency: BooleanType = 0, n: int = 1, beta: SymbolicConstantType | float = 'FITTED_VALUE', testData: BooleanType = 1, compressible: BooleanType = 0, properties: int = 0, deviatoricResponse: SymbolicConstantType = 'UNIAXIAL', volumetricResponse: SymbolicConstantType = 'DEFAULT', poissonRatio: float = 0, materialType: SymbolicConstantType = 'ISOTROPIC', anisotropicType: SymbolicConstantType = 'FUNG_ANISOTROPIC', formulation: SymbolicConstantType = 'STRAIN', behaviorType: SymbolicConstantType = 'INCOMPRESSIBLE', dependencies: int = 0, localDirections: int = 0) Hyperelastic[source]#

This method creates a Hyperelastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below. This argument is valid only if *testData*=OFF.

type

A SymbolicConstant specifying the type of strain energy potential. Possible values are:

  • ARRUDA_BOYCE

  • MARLOW

  • MOONEY_RIVLIN

  • NEO_HOOKE

  • OGDEN

  • POLYNOMIAL

  • REDUCED_POLYNOMIAL

  • USER

  • VAN_DER_WAALS

  • YEOH

  • UNKNOWN

  • VALANIS_LANDEL

The default value is UNKNOWN.

moduliTimeScale

A SymbolicConstant specifying the nature of the time response. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

n

An Int specifying the order of the strain energy potential. The default value is 1.If testData*=ON and **type**=POLYNOMIAL, *n can take only the values 1 or 2.If *testData*=ON and **type**=OGDEN or if *testData*=OFF for either type, 1 ≤n≤≤n≤ 6.If **type**=USER, this argument cannot be used.

beta

The SymbolicConstant FITTED_VALUE or a Float specifying the invariant mixture parameter. This argument is valid only if *testData*=ON and **type**=VAN_DER_WAALS. The default value is FITTED_VALUE.

testData

A Boolean specifying whether test data are supplied. The default value is ON.

compressible

A Boolean specifying whether the hyperelastic material is compressible. This parameter is applicable only to user-defined hyperelastic materials. The default value is OFF.

properties

An Int specifying the number of property values needed as data for the user-defined hyperelastic material. The default value is 0.

deviatoricResponse

A SymbolicConstant specifying which test data to use. Possible values are UNIAXIAL, BIAXIAL, and PLANAR. The default value is UNIAXIAL.

volumetricResponse

A SymbolicConstant specifying the volumetric response. Possible values are DEFAULT, VOLUMETRIC_DATA, POISSON_RATIO, and LATERAL_NOMINAL_STRAIN. The default value is DEFAULT.

poissonRatio

A Float specifying the poisson ratio. This argument is valid only if *volumetricResponse*=POISSON_RATIO. The default value is 0.0.

materialType

A SymbolicConstant specifying the type of material. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.

anisotropicType

A SymbolicConstant specifying the type of strain energy potential. Possible values are FUNG_ANISOTROPIC, FUNG_ORTHOTROPIC, HOLZAPFEL, and USER_DEFINED. The default value is FUNG_ANISOTROPIC.

formulation

A SymbolicConstant specifying the type of formulation. Possible values are STRAIN and INVARIANT. The default value is STRAIN.

behaviorType

A SymbolicConstant specifying the type of anisotropic hyperelastic material behavior. Possible values are INCOMPRESSIBLE and COMPRESSIBLE. The default value is INCOMPRESSIBLE.

dependencies

An Int specifying the number of field variable dependencies for the data in*volumetricTable* . The default value is 0.

localDirections

An Int specifying the number of local directions for the data in*volumetricTable* . The default value is 0.

Returns:
A Hyperelastic object.
Raises:
InvalidNameError
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Hyperelastic
session.odbs[name].materials[name].Hyperelastic
Hyperfoam(testData: BooleanType = 0, poisson: float | None = None, n: int = 1, temperatureDependency: BooleanType = 0, moduli: SymbolicConstantType = 'LONG_TERM', table: tuple = ()) Hyperfoam[source]#

This method creates a Hyperfoam object.

Parameters:
testData

A Boolean specifying whether test data are supplied. The default value is OFF.

poisson

None or a Float specifying the effective Poisson’s ratio, νν, of the material. This argument is valid only when *testData*=ON. The default value is None.

n

An Int specifying the order of the strain energy potential. Possible values are 1 ≤n≤≤n≤ 6. The default value is 1.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

moduli

A SymbolicConstant specifying the time-dependence of the material constants. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

table

A sequence of sequences of Floats specifying the items described below. This argument is valid only when *testData*=OFF. The default value is an empty sequence.

Returns:
A Hyperfoam object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Hyperfoam
session.odbs[name].materials[name].Hyperfoam
Hypoelastic(table: tuple, user: BooleanType = 0) Hypoelastic[source]#

This method creates a Hypoelastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

user

A Boolean specifying that hypoelasticity is defined by user subroutine UHYPEL. The default value is OFF.

Returns:
A Hypoelastic object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Hypoelastic
session.odbs[name].materials[name].Hypoelastic
InelasticHeatFraction(fraction: float = 0) InelasticHeatFraction[source]#

This method creates an InelasticHeatFraction object.

Parameters:
fraction

A Float specifying the fraction of inelastic dissipation rate that appears as a heat flux per unit volume. The fraction may include a unit conversion factor if required. Possible values are 0.0 ≤≤ fraction ≤≤ 1.0. The default value is 0.9.

Returns:
An InelasticHeatFraction object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].InelasticHeatFraction
session.odbs[name].materials[name].InelasticHeatFraction
JouleHeatFraction(fraction: float = 1) JouleHeatFraction[source]#

This method creates a JouleHeatFraction object.

Parameters:
fraction

A Float specifying the fraction of electrical energy released as heat, including any unit conversion factor. The default value is 1.0.

Returns:
A JouleHeatFraction object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].JouleHeatFraction
session.odbs[name].materials[name].JouleHeatFraction
LatentHeat(table: tuple) LatentHeat[source]#

This method creates a LatentHeat object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

Returns:
A LatentHeat object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].LatentHeat
session.odbs[name].materials[name].LatentHeat
LowDensityFoam(elementRemoval: BooleanType = 0, maxAllowablePrincipalStress: float | None = None, extrapolateStressStrainCurve: BooleanType = 0, strainRateType: SymbolicConstantType = 'VOLUMETRIC', mu0: float | None = None, mu1: float = 0, alpha: float = 2) LowDensityFoam[source]#

This method creates a LowDensityFoam object.

Parameters:
elementRemoval

A Boolean specifying whether elements are removed if exceeding maximum principal tensile stress. This argument is valid only when maxAllowablePrincipalStress is defined. The default value is OFF.

maxAllowablePrincipalStress

None or a Float specifying the maximum allowable principal tensile stress. The default value is None.

extrapolateStressStrainCurve

A Boolean specifying whether the stress-strain curve is extrapolated if exceeding maximum strain rate. The default value is OFF.

strainRateType

A SymbolicConstant specifying strain rate measure used for constitutive calculations. Possible values are PRINCIPAL and VOLUMETRIC. The default value is VOLUMETRIC.

mu0

A Float specifying the relaxation coefficient μ0. The default value is 10–4.

mu1

A Float specifying the relaxation coefficient μ1. The default value is 0.5×10–2.

alpha

A Float specifying the relaxation coefficient α. The default value is 2.0.

Returns:
A LowDensityFoam object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].LowDensityFoam
session.odbs[name].materials[name].LowDensityFoam
MagneticPermeability(table: tuple, table2: tuple, table3: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, nonlinearBH: BooleanType = 0) MagneticPermeability[source]#

This method creates a MagneticPermeability object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below in “Table data.” If **type**=ORTHOTROPIC and nonlinearBH=ON, the data specified in the table is for the first direction and table2 and table3 must be specified.

table2

A sequence of sequences of Floats specifying the items described below in “Table data” in the second direction. table2 must be specified only if **type**=ORTHOTROPIC and nonlinearBH=ON.

table3

A sequence of sequences of Floats specifying the items described below in “Table data” in the third direction. table3 must be specified only if **type**=ORTHOTROPIC and nonlinearBH=ON.

type

A SymbolicConstant specifying the type of magnetic permeability. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

frequencyDependency

A Boolean specifying whether the data depend on frequency. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

nonlinearBH

A Boolean specifying whether the magnetic behavior is nonlinear and available in tabular form of magnetic flux density versus magnetic field values. The default value is OFF.

Returns:
A MagneticPermeability object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].MagneticPermeability
session.odbs[name].materials[name].MagneticPermeability
MohrCoulombPlasticity(table: tuple, deviatoricEccentricity: float | None = None, meridionalEccentricity: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, useTensionCutoff: BooleanType = 0) MohrCoulombPlasticity[source]#

This method creates a MohrCoulombPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

deviatoricEccentricity

None or a Float specifying the flow potential eccentricity in the deviatoric plane, e; 1/2 ≤ 1.0. If *deviatoricEccentricity*=None, Abaqus calculates the value using the specified Mohr-Coulomb angle of friction. The default value is None.

meridionalEccentricity

A Float specifying the flow potential eccentricity in the meridional plane, ϵϵ. The default value is 0.1.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

useTensionCutoff

A Boolean specifying whether tension cutoff specification is needed. The default value is OFF.

Returns:
A MohrCoulombPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].MohrCoulombPlasticity
session.odbs[name].materials[name].MohrCoulombPlasticity
MoistureSwelling(table: tuple) MoistureSwelling[source]#

This method creates a MoistureSwelling object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

Returns:
A MoistureSwelling object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].MoistureSwelling
session.odbs[name].materials[name].MoistureSwelling
Permeability(specificWeight: float, inertialDragCoefficient: float, table: tuple, type: SymbolicConstantType = 'ISOTROPIC', temperatureDependency: BooleanType = 0, dependencies: int = 0) Permeability[source]#

This method creates a Permeability object.

Parameters:
specificWeight

A Float specifying the specific weight of the wetting liquid, γwγw.

inertialDragCoefficient

A Float specifying The inertial drag coefficient of the wetting liquid, γwγw.

table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of permeability. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Permeability object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Permeability
session.odbs[name].materials[name].Permeability
Piezoelectric(table: tuple, type: SymbolicConstantType = 'STRESS', temperatureDependency: BooleanType = 0, dependencies: int = 0) Piezoelectric[source]#

This method creates a Piezoelectric object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of material coefficients for the piezoelectric property. Possible values are STRAIN and STRESS. The default value is STRESS.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Piezoelectric object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Piezoelectric
session.odbs[name].materials[name].Piezoelectric
Plastic(table: tuple, hardening: SymbolicConstantType = 'ISOTROPIC', rate: BooleanType = 0, dataType: SymbolicConstantType = 'HALF_CYCLE', strainRangeDependency: BooleanType = 0, numBackstresses: int = 1, temperatureDependency: BooleanType = 0, dependencies: int = 0) Plastic[source]#

This method creates a Plastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

hardening

A SymbolicConstant specifying the type of hardening. Possible values are ISOTROPIC, KINEMATIC, COMBINED, JOHNSON_COOK, and USER. The default value is ISOTROPIC.

rate

A Boolean specifying whether the data depend on rate. The default value is OFF.

dataType

A SymbolicConstant specifying the type of combined hardening. This argument is only valid if *hardening*=COMBINED. Possible values are HALF_CYCLE, PARAMETERS, and STABILIZED. The default value is HALF_CYCLE.

strainRangeDependency

A Boolean specifying whether the data depend on strain range. This argument is only valid if *hardening*=COMBINED and *dataType*=STABILIZED. The default value is OFF.

numBackstresses

An Int specifying the number of backstresses. This argument is only valid if *hardening*=COMBINED. The default value is 1.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Plastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Plastic
session.odbs[name].materials[name].Plastic
PoreFluidExpansion(table: tuple, zero: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) PoreFluidExpansion[source]#

This method creates a PoreFluidExpansion object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

zero

A Float specifying the value of θ0. The default value is 0.0.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A PoreFluidExpansion object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].PoreFluidExpansion
session.odbs[name].materials[name].PoreFluidExpansion
PorousBulkModuli(table: tuple, temperatureDependency: BooleanType = 0) PorousBulkModuli[source]#

This method creates a PorousBulkModuli object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

Returns:
A PorousBulkModuli object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].PorousBulkModuli
session.odbs[name].materials[name].PorousBulkModuli
PorousElastic(table: tuple, shear: SymbolicConstantType = 'POISSON', temperatureDependency: BooleanType = 0, dependencies: int = 0) PorousElastic[source]#

This method creates a PorousElastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

shear

A SymbolicConstant specifying the shear definition form. Possible values are G and POISSON. The default value is POISSON.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A PorousElastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].PorousElastic
session.odbs[name].materials[name].PorousElastic
PorousMetalPlasticity(table: tuple, relativeDensity: float | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0) PorousMetalPlasticity[source]#

This method creates a PorousMetalPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

relativeDensity

None or a Float specifying the initial relative density of the material, r0. The default value is None.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A PorousMetalPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].PorousMetalPlasticity
session.odbs[name].materials[name].PorousMetalPlasticity
Regularization(rtol: float = 0, strainRateRegularization: SymbolicConstantType = 'LOGARITHMIC') Regularization[source]#

This method creates a Regularization object.

Parameters:
rtol

A Float specifying the tolerance to be used for regularizing material data. The default value is 0.03.

strainRateRegularization

A SymbolicConstant specifying the form of regularization of strain-rate-dependent material data. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

Returns:
A Regularization object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Regularization
session.odbs[name].materials[name].Regularization
Solubility(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) Solubility[source]#

This method creates a Solubility object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Solubility object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Solubility
session.odbs[name].materials[name].Solubility
Sorption(absorptionTable: tuple, lawAbsorption: SymbolicConstantType = 'TABULAR', exsorption: BooleanType = 0, lawExsorption: SymbolicConstantType = 'TABULAR', scanning: float = 0, exsorptionTable: tuple = ()) Sorption[source]#

This method creates a Sorption object.

Parameters:
absorptionTable

A sequence of sequences of Floats specifying the items described below.

lawAbsorption

A SymbolicConstant specifying absorption behavior. Possible values are LOG and TABULAR. The default value is TABULAR.

exsorption

A Boolean specifying whether the exsorption data is specified. The default value is OFF.

lawExsorption

A SymbolicConstant specifying exsorption behavior. Possible values are LOG and TABULAR. The default value is TABULAR.

scanning

A Float specifying the slope of the scanning line, (duw/ds)|s. This slope must be positive and larger than the slope of the absorption or exsorption behaviors. The default value is 0.0.

exsorptionTable

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
A Sorption object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Sorption
session.odbs[name].materials[name].Sorption
SpecificHeat(table: tuple, law: SymbolicConstantType = 'CONSTANTVOLUME', temperatureDependency: BooleanType = 0, dependencies: int = 0) SpecificHeat[source]#

This method creates a SpecificHeat object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

law

A SymbolicConstant specifying the specific heat behavior. Possible values are CONSTANTVOLUME and CONSTANTPRESSURE. The default value is CONSTANTVOLUME.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A SpecificHeat object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].SpecificHeat
session.odbs[name].materials[name].SpecificHeat
Swelling(table: tuple, law: SymbolicConstantType = 'INPUT', temperatureDependency: BooleanType = 0, dependencies: int = 0) Swelling[source]#

This method creates a Swelling object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.This argument is valid only when *law*=INPUT.

law

A SymbolicConstant specifying the type of data defining the swelling behavior. Possible values are INPUT and USER. The default value is INPUT.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Swelling object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Swelling
session.odbs[name].materials[name].Swelling
UserMaterial(type: SymbolicConstantType = 'MECHANICAL', unsymm: BooleanType = 0, mechanicalConstants: tuple = (), thermalConstants: tuple = (), effmod: BooleanType = 0, hybridFormulation: SymbolicConstantType = 'INCREMENTAL') UserMaterial[source]#

This method creates a UserMaterial object.

Parameters:
type

A SymbolicConstant specifying the type of material behavior defined by the command. Possible values are MECHANICAL, THERMAL, and THERMOMECHANICAL. The default value is MECHANICAL.

unsymm

A Boolean specifying if the material stiffness matrix, ∂Δσ/∂Δε, is not symmetric or, when a thermal constitutive model is used, if ∂f/∂(∂θ/∂x) is not symmetric. The default value is OFF. This argument is valid only for an Abaqus/Standard analysis.

mechanicalConstants

A sequence of Floats specifying the mechanical constants of the material. This argument is valid only when **type**=MECHANICAL or THERMOMECHANICAL. The default value is an empty sequence.

thermalConstants

A sequence of Floats specifying the thermal constants of the material. This argument is valid only when **type**=THERMAL or THERMOMECHANICAL. The default value is an empty sequence.

effmod

A Boolean specifying if effective bulk modulus and shear modulus are returned by user subroutine VUMAT. The default value is OFF. This argument is valid only in an Abaqus/Explicit analysis.

hybridFormulation

A SymbolicConstant to specify the formulation of the hybrid element with user subroutine UMAT. Possible values are TOTAL, INCREMENTAL, and INCOMPRESSIBLE. The default value is INCREMENTAL. This argument is valid only in an Abaqus/Standard analysis.

Returns:
A UserMaterial object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].UserMaterial
session.odbs[name].materials[name].UserMaterial
UserOutputVariables(n: int = 0) UserOutputVariables[source]#

This method creates a UserOutputVariables object.

Parameters:
n

An Int specifying the number of user-defined variables required at each material point. The default value is 0.

Returns:
A UserOutputVariables object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].UserOutputVariables
session.odbs[name].materials[name].UserOutputVariables
Viscoelastic(domain: SymbolicConstantType, table: tuple, frequency: SymbolicConstantType = 'FORMULA', type: SymbolicConstantType = 'ISOTROPIC', preload: SymbolicConstantType = 'NONE', time: SymbolicConstantType = 'PRONY', errtol: float = 0, nmax: int = 13, volumetricTable: tuple = ()) Viscoelastic[source]#

This method creates a Viscoelastic object.

Parameters:
domain

A SymbolicConstant specifying the domain definition. Possible values are: - FREQUENCY, specifying a frequency domain. This domain is only available for an Abaqus/Standard analysis. - TIME, specifying a time domain.

table

A sequence of sequences of Floats specifying the items described below.

frequency

A SymbolicConstant specifying the frequency domain definition. This argument is required only when *domain*=FREQUENCY. Possible values are FORMULA, TABULAR, PRONY, CREEP_TEST_DATA, and RELAXATION_TEST_DATA. The default value is FORMULA.

type

A SymbolicConstant specifying the type. This argument is required only when *domain*=FREQUENCY and *frequency*=TABULAR. Possible values are ISOTROPIC and TRACTION. The default value is ISOTROPIC.

preload

A SymbolicConstant specifying the preload. This argument is required only when *domain*=FREQUENCY and *frequency*=TABULAR. Possible values are NONE, UNIAXIAL, VOLUMETRIC, and UNIAXIAL_VOLUMETRIC. The default value is NONE.

time

A SymbolicConstant specifying the time domain definition. This argument is required only when *domain*=TIME. Possible values are PRONY, CREEP_TEST_DATA, RELAXATION_TEST_DATA, and FREQUENCY_DATA. The default value is PRONY.

errtol

A Float specifying the allowable average root-mean-square error of the data points in the least-squares fit. The Float values correspond to percentages; for example, 0.01 is 1%. The default value is 0.01.This argument is valid only when *time*=CREEP_TEST_DATA, RELAXATION_TEST_DATA or FREQUENCY_DATA; or only when *frequency*=CREEP_TEST_DATA or RELAXATION_TEST_DATA.

nmax

An Int specifying the maximum number of terms NN in the Prony series. The maximum value is 13. The default value is 13.This argument is valid only when *time*=CREEP_TEST_DATA, RELAXATION_TEST_DATA or FREQUENCY_DATA; or only when *frequency*=CREEP_TEST_DATA or RELAXATION_TEST_DATA.

volumetricTable

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
A Viscoelastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Viscoelastic
session.odbs[name].materials[name].Viscoelastic
Viscosity(table: tuple, type: SymbolicConstantType = 'NEWTONIAN', temperatureDependency: BooleanType = 0, dependencies: int = 0) Viscosity[source]#

This method creates a Viscosity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of viscosity. The default value is NEWTONIAN.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Viscosity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Viscosity
session.odbs[name].materials[name].Viscosity
Viscous(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL') Viscous[source]#

This method creates a Viscous object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

law

A SymbolicConstant specifying the creep law. Possible values are STRAIN, TIME, USER, ANAND, DARVEAUX, DOUBLE_POWER, POWER_LAW, and TIME_POWER_LAW. The default value is STRAIN.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

time

A SymbolicConstant specifying the time interval for relevant laws. Possible values are CREEP and TOTAL. The default value is TOTAL.

Returns:
A Viscous object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Viscous
session.odbs[name].materials[name].Viscous

Object features#

Material#

class Material(name: str, description: str = '', materialIdentifier: str = '')[source]#

A Material object is the object used to specify a material. The Material object stores the various settings that determine how a material behaves. A material is created by combining one or more individual material options and sub options. A particular material option is associated with the Material object through a member. For example: the acousticMedium member may contain an AcousticMedium object. The alternative of having a MaterialOption abstract base class and a container of MaterialOptions was rejected because it would make it more difficult to enforce the fact that one Material object cannot contain two AcousticMedium objects, for example.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name]
import odbMaterial
session.odbs[name].materials[name]

The corresponding analysis keywords are:

  • MATERIAL

Attributes:
acousticMedium: AcousticMedium

An AcousticMedium object.

brittleCracking: BrittleCracking

A BrittleCracking object.

capPlasticity: CapPlasticity

A CapPlasticity object.

castIronPlasticity: CastIronPlasticity

A CastIronPlasticity object.

clayPlasticity: ClayPlasticity

A ClayPlasticity object.

concrete: Concrete

A Concrete object.

concreteDamagedPlasticity: ConcreteDamagedPlasticity

A ConcreteDamagedPlasticity object.

conductivity: Conductivity

A Conductivity object.

creep: Creep

A Creep object.

crushableFoam: CrushableFoam

A CrushableFoam object.

crushStress: CrushStress

A CrushStress object.

ductileDamageInitiation: DamageInitiation

A DamageInitiation object.

fldDamageInitiation: DamageInitiation

A DamageInitiation object.

flsdDamageInitiation: DamageInitiation

A DamageInitiation object.

johnsonCookDamageInitiation: DamageInitiation

A DamageInitiation object.

maxeDamageInitiation: DamageInitiation

A DamageInitiation object.

maxsDamageInitiation: DamageInitiation

A DamageInitiation object.

maxpeDamageInitiation: DamageInitiation

A DamageInitiation object.

maxpsDamageInitiation: DamageInitiation

A DamageInitiation object.

mkDamageInitiation: DamageInitiation

A DamageInitiation object.

msfldDamageInitiation: DamageInitiation

A DamageInitiation object.

quadeDamageInitiation: DamageInitiation

A DamageInitiation object.

quadsDamageInitiation: DamageInitiation

A DamageInitiation object.

shearDamageInitiation: DamageInitiation

A DamageInitiation object.

hashinDamageInitiation: DamageInitiation

A DamageInitiation object.

damping: Damping

A Damping object.

deformationPlasticity: DeformationPlasticity

A DeformationPlasticity object.

density: Density

A Density object.

depvar: Depvar

A Depvar object.

dielectric: Dielectric

A Dielectric object.

diffusivity: Diffusivity

A Diffusivity object.

druckerPrager: DruckerPrager

A DruckerPrager object.

elastic: Elastic

An Elastic object.

electricalConductivity: ElectricalConductivity

An ElectricalConductivity object.

eos: Eos

An Eos object.

expansion: Expansion

An Expansion object.

fluidLeakoff: FluidLeakoff

A FluidLeakoff object.

gapFlow: GapFlow

A GapFlow object.

gasketThicknessBehavior: GasketThicknessBehavior

A GasketThicknessBehavior object.

gasketTransverseShearElastic: GasketTransverseShearElastic

A GasketTransverseShearElastic object.

gasketMembraneElastic: GasketMembraneElastic

A GasketMembraneElastic object.

gel: Gel

A Gel object.

heatGeneration: HeatGeneration

A HeatGeneration object.

hyperelastic: Hyperelastic

A Hyperelastic object.

hyperfoam: Hyperfoam

A Hyperfoam object.

hypoelastic: Hypoelastic

A Hypoelastic object.

inelasticHeatFraction: InelasticHeatFraction

An InelasticHeatFraction object.

jouleHeatFraction: JouleHeatFraction

A JouleHeatFraction object.

latentHeat: LatentHeat

A LatentHeat object.

lowDensityFoam: LowDensityFoam

A LowDensityFoam object.

magneticPermeability: MagneticPermeability

A MagneticPermeability object.

mohrCoulombPlasticity: MohrCoulombPlasticity

A MohrCoulombPlasticity object.

moistureSwelling: MoistureSwelling

A MoistureSwelling object.

mullinsEffect: MullinsEffect

A MullinsEffect object.

permeability: Permeability

A Permeability object.

piezoelectric: Piezoelectric

A Piezoelectric object.

plastic: Plastic

A Plastic object.

poreFluidExpansion: PoreFluidExpansion

A PoreFluidExpansion object.

porousBulkModuli: PorousBulkModuli

A PorousBulkModuli object.

porousElastic: PorousElastic

A PorousElastic object.

porousMetalPlasticity: PorousMetalPlasticity

A PorousMetalPlasticity object.

regularization: Regularization

A Regularization object.

solubility: Solubility

A Solubility object.

sorption: Sorption

A Sorption object.

specificHeat: SpecificHeat

A SpecificHeat object.

swelling: Swelling

A Swelling object.

userDefinedField: UserDefinedField

A UserDefinedField object.

userMaterial: UserMaterial

A UserMaterial object.

userOutputVariables: UserOutputVariables

A UserOutputVariables object.

viscoelastic: Viscoelastic

A Viscoelastic object.

viscosity: Viscosity

A Viscosity object.

viscous: Viscous

A Viscous object.

Methods

AcousticMedium([acousticVolumetricDrag, ...])

This method creates an AcousticMedium object.

BrittleCracking(table[, ...])

This method creates a BrittleCracking object.

CapPlasticity(table[, ...])

This method creates a CapPlasticity object.

CastIronPlasticity(table[, ...])

This method creates a CastIronPlasticity object.

ClayPlasticity(table[, intercept, ...])

This method creates a ClayPlasticity object.

Concrete(table[, temperatureDependency, ...])

This method creates a Concrete object.

ConcreteDamagedPlasticity(table[, ...])

This method creates a ConcreteDamagedPlasticity object.

Conductivity(table[, type, ...])

This method creates a Conductivity object.

Creep(table[, law, temperatureDependency, ...])

This method creates a Creep object.

CrushStress(crushStressTable[, ...])

This method creates a CrushStress object.

CrushableFoam(table[, hardening, ...])

This method creates a CrushableFoam object.

Damping([alpha, beta, composite, structural])

This method creates a Damping object.

DeformationPlasticity(table[, ...])

This method creates a DeformationPlasticity object.

Density(table[, temperatureDependency, ...])

This method creates a Density object.

Depvar([deleteVar, n])

This method creates a Depvar object.

Dielectric(table[, type, ...])

This method creates a Dielectric object.

Diffusivity(table[, type, law, ...])

This method creates a Diffusivity object.

DruckerPrager(table[, shearCriterion, ...])

This method creates a DruckerPrager object.

Elastic(table[, type, noCompression, ...])

This method creates an Elastic object.

ElectricalConductivity(table[, type, ...])

This method creates an ElectricalConductivity object.

Eos([type, temperatureDependency, ...])

This method creates an Eos object.

Expansion([type, userSubroutine, zero, ...])

This method creates an Expansion object.

FluidLeakoff([temperatureDependency, ...])

This method creates a FluidLeakoff object.

GapFlow(table[, kmax, ...])

This method creates a GapFlow object.

GasketMembraneElastic(table[, ...])

This method creates a GasketMembraneElastic object.

GasketThicknessBehavior(table[, ...])

This method creates a GasketThicknessBehavior object.

GasketTransverseShearElastic(table[, ...])

This method creates a GasketTransverseShearElastic object.

Gel(table)

This method creates a Gel object.

Hyperelastic(table[, type, moduliTimeScale, ...])

This method creates a Hyperelastic object.

Hyperfoam([testData, poisson, n, ...])

This method creates a Hyperfoam object.

Hypoelastic(table[, user])

This method creates a Hypoelastic object.

InelasticHeatFraction([fraction])

This method creates an InelasticHeatFraction object.

JouleHeatFraction([fraction])

This method creates a JouleHeatFraction object.

LatentHeat(table)

This method creates a LatentHeat object.

LowDensityFoam([elementRemoval, ...])

This method creates a LowDensityFoam object.

MagneticPermeability(table, table2, table3)

This method creates a MagneticPermeability object.

MohrCoulombPlasticity(table[, ...])

This method creates a MohrCoulombPlasticity object.

MoistureSwelling(table)

This method creates a MoistureSwelling object.

Permeability(specificWeight, ...[, type, ...])

This method creates a Permeability object.

Piezoelectric(table[, type, ...])

This method creates a Piezoelectric object.

Plastic(table[, hardening, rate, dataType, ...])

This method creates a Plastic object.

PoreFluidExpansion(table[, zero, ...])

This method creates a PoreFluidExpansion object.

PorousBulkModuli(table[, temperatureDependency])

This method creates a PorousBulkModuli object.

PorousElastic(table[, shear, ...])

This method creates a PorousElastic object.

PorousMetalPlasticity(table[, ...])

This method creates a PorousMetalPlasticity object.

Regularization([rtol, strainRateRegularization])

This method creates a Regularization object.

Solubility(table[, temperatureDependency, ...])

This method creates a Solubility object.

Sorption(absorptionTable[, lawAbsorption, ...])

This method creates a Sorption object.

SpecificHeat(table[, law, ...])

This method creates a SpecificHeat object.

Swelling(table[, law, ...])

This method creates a Swelling object.

UserMaterial([type, unsymm, ...])

This method creates a UserMaterial object.

UserOutputVariables([n])

This method creates a UserOutputVariables object.

Viscoelastic(domain, table[, frequency, ...])

This method creates a Viscoelastic object.

Viscosity(table[, type, ...])

This method creates a Viscosity object.

Viscous(table[, law, temperatureDependency, ...])

This method creates a Viscous object.

AcousticMedium(acousticVolumetricDrag: BooleanType = 0, temperatureDependencyB: BooleanType = 0, temperatureDependencyV: BooleanType = 0, dependenciesB: int = 0, dependenciesV: int = 0, bulkTable: tuple = (), volumetricTable: tuple = ()) AcousticMedium[source]#

This method creates an AcousticMedium object.

Parameters:
acousticVolumetricDrag

A Boolean specifying whether the volumetricTable data is specified. The default value is OFF.

temperatureDependencyB

A Boolean specifying whether the data in bulkTable depend on temperature. The default value is OFF.

temperatureDependencyV

A Boolean specifying whether the data in volumetricTable depend on temperature. The default value is OFF.

dependenciesB

An Int specifying the number of field variable dependencies for the data in bulkTable. The default value is 0.

dependenciesV

An Int specifying the number of field variable dependencies for the data in volumetricTable. The default value is 0.

bulkTable

A sequence of sequences of Floats specifying the following: - Bulk modulus. - Temperature, if the data depend on temperature. - Value of the first field variable, if the data depend on field variables. - Value of the second field variable. - Etc.

volumetricTable

A sequence of sequences of Floats specifying the following: - Volumetric drag. - Frequency. - Temperature, if the data depend on temperature. - Value of the first field variable, if the data depend on field variables. - Value of the second field variable. - Etc. The default value is an empty sequence.

Returns:
An AcousticMedium object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].AcousticMedium
session.odbs[name].materials[name].AcousticMedium
BrittleCracking(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'STRAIN') BrittleCracking[source]#

This method creates a BrittleCracking object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

type

A SymbolicConstant specifying the type of postcracking behavior. Possible values are STRAIN, DISPLACEMENT, and GFI. The default value is STRAIN.

Returns:
A BrittleCracking object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].BrittleCracking
session.odbs[name].materials[name].BrittleCracking
CapPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) CapPlasticity[source]#

This method creates a CapPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CapPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].CapPlasticity
session.odbs[name].materials[name].CapPlasticity
CastIronPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) CastIronPlasticity[source]#

This method creates a CastIronPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CastIronPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].CastIronPlasticity
session.odbs[name].materials[name].CastIronPlasticity
ClayPlasticity(table: tuple, intercept: float | None = None, hardening: SymbolicConstantType = 'EXPONENTIAL', temperatureDependency: BooleanType = 0, dependencies: int = 0) ClayPlasticity[source]#

This method creates a ClayPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

intercept

None or a Float specifying e1e1, the intercept of the virgin consolidation line with the void ratio axis in a plot of void ratio versus the logarithm of pressure stress. The default value is None.This argument is valid only if *hardening*=EXPONENTIAL.

hardening

A SymbolicConstant specifying the type of hardening/softening definition. Possible values are EXPONENTIAL and TABULAR. The default value is EXPONENTIAL.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A ClayPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].ClayPlasticity
session.odbs[name].materials[name].ClayPlasticity
Concrete(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) Concrete[source]#

This method creates a Concrete object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Concrete object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Concrete
session.odbs[name].materials[name].Concrete
ConcreteDamagedPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) ConcreteDamagedPlasticity[source]#

This method creates a ConcreteDamagedPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A ConcreteDamagedPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].ConcreteDamagedPlasticity
session.odbs[name].materials[name].ConcreteDamagedPlasticity
Conductivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', temperatureDependency: BooleanType = 0, dependencies: int = 0) Conductivity[source]#

This method creates a Conductivity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of conductivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Conductivity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Conductivity
session.odbs[name].materials[name].Conductivity
Creep(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL') Creep[source]#

This method creates a Creep object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

law

A SymbolicConstant specifying the strain-hardening law. Possible values are STRAIN, TIME, HYPERBOLIC_SINE, USER, ANAND, DARVEAUX,DOUBLE_POWER, POWER_LAW, and TIME_POWER_LAW. The default value is STRAIN.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

time

A SymbolicConstant specifying the time interval for relevant laws. Possible values are CREEP and TOTAL. The default value is TOTAL.

Returns:
A Creep object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Creep
session.odbs[name].materials[name].Creep
CrushStress(crushStressTable: tuple[tuple[float, ...]], temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

This method creates a CrushStress object.

Parameters:
crushStressTable

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CrushStress object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].CrushStress
session.odbs[name].materials[name].CrushStress
CrushableFoam(table: tuple, hardening: SymbolicConstantType = 'VOLUMETRIC', temperatureDependency: BooleanType = 0, dependencies: int = 0) CrushableFoam[source]#

This method creates a CrushableFoam object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

hardening

A SymbolicConstant specifying the type of hardening/softening definition. Possible values are VOLUMETRIC and ISOTROPIC. The default value is VOLUMETRIC.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CrushableFoam object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].CrushableFoam
session.odbs[name].materials[name].CrushableFoam
Damping(alpha: float = 0, beta: float = 0, composite: float = 0, structural: float = 0) Damping[source]#

This method creates a Damping object.

Parameters:
alpha

A Float specifying the αRαR factor to create mass proportional damping in direct-integration and explicit dynamics. The default value is 0.0.

beta

A Float specifying the βRβR factor to create stiffness proportional damping in direct-integration and explicit dynamics. The default value is 0.0.

composite

A Float specifying the fraction of critical damping to be used with this material in calculating composite damping factors for the modes (for use in modal dynamics). The default value is 0.0.This argument applies only to Abaqus/Standard analyses.

structural

A Float specifying the structural factor to create material damping in direct-integration and explicit dynamics. The default value is 0.0.

Returns:
A Damping object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Damping
session.odbs[name].materials[name].Damping
DeformationPlasticity(table: tuple, temperatureDependency: BooleanType = 0) DeformationPlasticity[source]#

This method creates a DeformationPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

Returns:
A DeformationPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].DeformationPlasticity
session.odbs[name].materials[name].DeformationPlasticity
Density(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, distributionType: SymbolicConstantType = 'UNIFORM', fieldName: str = '') Density[source]#

This method creates a Density object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

distributionType

A SymbolicConstant specifying how the density is distributed spatially. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

fieldName

A String specifying the name of the AnalyticalField or DiscreteField object associated with this material option. The fieldName argument applies only when *distributionType*=ANALYTICAL_FIELD or *distributionType*=DISCRETE_FIELD. The default value is an empty string.

Returns:
A Density object.
Raises:
RangeError

The table data for this object are: - The mass density. - Temperature, if the data depend on temperature. - Value of the first field variable, if the data depend on field variables. - Value of the second field variable. - Etc.

Depvar(deleteVar: int = 0, n: int = 0) Depvar[source]#

This method creates a Depvar object.

Parameters:
deleteVar

An Int specifying the state variable number controlling the element deletion flag. The default value is 0.This argument applies only to Abaqus/Explicit analyses.

n

An Int specifying the number of solution-dependent state variables required at each integration point. The default value is 0.

Returns:
A Depvar object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Depvar
session.odbs[name].materials[name].Depvar
Dielectric(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) Dielectric[source]#

This method creates a Dielectric object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the dielectric behavior. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

frequencyDependency

A Boolean specifying whether the data depend on frequency. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Dielectric object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Dielectric
session.odbs[name].materials[name].Dielectric
Diffusivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', law: SymbolicConstantType = 'GENERAL', temperatureDependency: BooleanType = 0, dependencies: int = 0) Diffusivity[source]#

This method creates a Diffusivity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of diffusivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

law

A SymbolicConstant specifying the diffusion behavior. Possible values are GENERAL and FICK. The default value is GENERAL.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Diffusivity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Diffusivity
session.odbs[name].materials[name].Diffusivity
DruckerPrager(table: tuple, shearCriterion: SymbolicConstantType = 'LINEAR', eccentricity: float = 0, testData: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) DruckerPrager[source]#

This method creates a DruckerPrager object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

shearCriterion

A SymbolicConstant specifying the yield criterion. Possible values are LINEAR, HYPERBOLIC, and EXPONENTIAL. The default value is LINEAR.This argument applies only to Abaqus/Standard analyses. Only the linear Drucker-Prager model is available in Abaqus/Explicit analyses.

eccentricity

A Float specifying the flow potential eccentricity, ϵϵ, a small positive number that defines the rate at which the hyperbolic flow potential approaches its asymptote. The default value is 0.1.This argument applies only to Abaqus/Standard analyses.

testData

A Boolean specifying whether the material constants for the exponent model are to be computed by Abaqus/Standard from triaxial test data at different levels of confining pressure. The default value is OFF.This argument is valid only if *shearCriterion*=EXPONENTIAL.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A DruckerPrager object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].DruckerPrager
session.odbs[name].materials[name].DruckerPrager
Elastic(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', noCompression: BooleanType = 0, noTension: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, moduli: SymbolicConstantType = 'LONG_TERM') Elastic[source]#

This method creates an Elastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of elasticity data provided. Possible values are:

  • ISOTROPIC

  • ORTHOTROPIC

  • ANISOTROPIC

  • ENGINEERING_CONSTANTS

  • LAMINA

  • TRACTION

  • COUPLED_TRACTION

  • SHORT_FIBER

  • SHEAR

  • BILAMINA

The default value is ISOTROPIC.

noCompression

A Boolean specifying whether compressive stress is allowed. The default value is OFF.

noTension

A Boolean specifying whether tensile stress is allowed. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

moduli

A SymbolicConstant specifying the time-dependence of the elastic material constants. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

Returns:
An Elastic object.
Raises:
RangeError

The table data for this object are: - If **type**=ISOTROPIC, the table data specify the following:

  • The Young’s modulus, E.

  • The Poisson’s ratio, v.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

  • If **type**=SHEAR, the table data specify the following:
    • The shear modulus,G.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=ENGINEERING_CONSTANTS, the table data specify the following:
    • E1.

    • E2.

    • E3.

    • v12.

    • v13.

    • v23.

    • G12.

    • G13.

    • G23.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=LAMINA, the table data specify the following:
    • E1.

    • E2.

    • v12.

    • G12.

    • G13. This shear modulus is needed to define transverse shear behavior in shells.

    • G23. This shear modulus is needed to define transverse shear behavior in shells.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=ORTHOTROPIC, the table data specify the following:
    • D1111.

    • D1122.

    • D2222.

    • D1133.

    • D2233.

    • D3333.

    • D1212.

    • D1313.

    • D2323.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=ANISOTROPIC, the table data specify the following:
    • D1111.

    • D1122.

    • D2222.

    • D1133.

    • D2233.

    • D3333.

    • D1112.

    • D2212.

    • D3312.

    • D1212.

    • D1113.

    • D2213.

    • D3313.

    • D1213.

    • D1313.

    • D1123.

    • D2223.

    • D3323.

    • D1223.

    • D1323.

    • D2323.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=TRACTION, the table data specify the following:
    • EE for warping elements; En⁢n for cohesive elements.

    • G1 for warping elements; Es⁢s for cohesive elements.

    • G2 for warping elements; Et⁢t for cohesive elements.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If **type**=SHORT_FIBER, there is no table data.

ElectricalConductivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) ElectricalConductivity[source]#

This method creates an ElectricalConductivity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of electrical conductivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

frequencyDependency

A Boolean specifying whether the data depend on frequency. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
An ElectricalConductivity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].ElectricalConductivity
session.odbs[name].materials[name].ElectricalConductivity
Eos(type: SymbolicConstantType = 'IDEALGAS', temperatureDependency: BooleanType = 0, dependencies: int = 0, detonationEnergy: float = 0, solidTable: tuple = (), gasTable: tuple = (), reactionTable: tuple = (), gasSpecificTable: tuple = (), table: tuple = ()) Eos[source]#

This method creates an Eos object.

Parameters:
type

A SymbolicConstant specifying the equation of state. Possible values are USUP, JWL, IDEALGAS, TABULAR, and IGNITIONANDGROWTH. The default value is IDEALGAS.

temperatureDependency

A Boolean specifying whether the data in gasSpecificTable depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies for the data in gasSpecificTable. The default value is 0.

detonationEnergy

A Float specifying the detonation energy text field. The default value is 0.0.

solidTable

A sequence of sequences of Floats specifying the following: - $A_{s}$. - $B_{s}$. - ${omega}_{s}$. - $R_{1s}$. - $R_{2s}$. The default value is an empty sequence.

gasTable

A sequence of sequences of Floats specifying the following: - $A_{g}$. - $B_{g}$. - ${omega}_{g}$. - $R_{1g}$. - $R_{2g}$. The default value is an empty sequence.

reactionTable

A sequence of sequences of Floats specifying the following: - Initial Pressure, $I$. - Product co-volume, $a$. - Exponent on the unreacted fraction (ignition term), $x$. - First burn rate coefficient, $G_{1}$ - Exponent on the unreacted fraction (growth term), $c$. - Exponent on the reacted fraction (growth term), $d$. - Pressure exponent (growth term), $y$. - Second burn rate coefficient, $G_{2}$. - Exponent on the unreacted fraction (completion term), $e$. - Exponent on the reacted fraction (completion term), $g$. - Pressure exponent (completion term), $z$. - Initial reacted fraction, ${F^{max}}_{ig}$. - Maximum reacted fraction for the growth term, ${F^{max}}_{G1}$. - Minimum reacted fraction, ${F^{min}}_{G2}$. The default value is an empty sequence.

gasSpecificTable

A sequence of sequences of Floats specifying the following: - Specific Heat per unit mass. - Temperature dependent data. - Value of first field variable. - Value of second field variable. - Etc. The default value is an empty sequence.

table

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
Raises:

Notes

This function can be accessed by:

mdb.models[name].materials[name].Eos
session.odbs[name].materials[name].Eos
Expansion(type: SymbolicConstantType = 'ISOTROPIC', userSubroutine: BooleanType = 0, zero: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, table: tuple = ()) Expansion[source]#

This method creates an Expansion object.

Parameters:
type

A SymbolicConstant specifying the type of expansion. Possible values are ISOTROPIC, ORTHOTROPIC, ANISOTROPIC, and SHORT_FIBER. The default value is ISOTROPIC.

userSubroutine

A Boolean specifying whether a user subroutine is used to define the increments of thermal strain. The default value is OFF.

zero

A Float specifying the value of θ0 if the thermal expansion is temperature-dependent or field-variable-dependent. The default value is 0.0.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

table

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.This argument is required only if type is not USER.

Returns:
An Expansion object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Expansion
session.odbs[name].materials[name].Expansion
FluidLeakoff(temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'COEFFICIENTS', table: tuple = ()) FluidLeakoff[source]#

This method creates a FluidLeakoff object.

Parameters:
temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

type

A SymbolicConstant specifying the type of fluid leak-off. Possible values are COEFFICIENTS and USER. The default value is COEFFICIENTS.

table

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
A FluidLeakoff object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].FluidLeakoff
session.odbs[name].materials[name].FluidLeakoff
GapFlow(table: tuple, kmax: float | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'NEWTONIAN') GapFlow[source]#

This method creates a GapFlow object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

kmax

None or a Float specifying the maximum permeability value that should be used. If *kmax*=None, Abaqus assumes that the permeability is not bounded. This value is meaningful only when **type**=NEWTONIAN. The default value is None.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

type

A SymbolicConstant specifying the type of gap flow. Possible values are NEWTONIAN, POWER_LAW, BINGHAM_PLASTIC, and HERSCHEL-BULKLEY. The default value is NEWTONIAN.

Returns:
A GapFlow object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].GapFlow
session.odbs[name].materials[name].GapFlow
GasketMembraneElastic(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) GasketMembraneElastic[source]#

This method creates a GasketMembraneElastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A GasketMembraneElastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].GasketMembraneElastic
session.odbs[name].materials[name].GasketMembraneElastic
GasketThicknessBehavior(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, tensileStiffnessFactor: float | None = None, type: SymbolicConstantType = 'ELASTIC_PLASTIC', unloadingDependencies: int = 0, unloadingTemperatureDependency: BooleanType = 0, variableUnits: SymbolicConstantType = 'STRESS', yieldOnset: float = 0, yieldOnsetMethod: SymbolicConstantType = 'RELATIVE_SLOPE_DROP', unloadingTable: tuple = ()) GasketThicknessBehavior[source]#

This method creates a GasketThicknessBehavior object.

Parameters:
table

A sequence of sequences of Floats specifying loading data. The first sequence must contain only 0. At least two sequences must be specified if **type**=DAMAGE, and at least 3 sequences must be specified if **type**=ELASTIC_PLASTIC. The items in the table data are described below.

temperatureDependency

A Boolean specifying whether the loading data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies included in the definition of the loading data, in addition to temperature. The default value is 0.

tensileStiffnessFactor

A Float specifying the fraction of the initial compressive stiffness that defines the stiffness in tension. The default value is 10–3.

type

A SymbolicConstant specifying a damage elasticity model or an elastic-Plastic model for gasket thickness-direction behavior. Possible values are ELASTIC_PLASTIC and DAMAGE. The default value is ELASTIC_PLASTIC.

unloadingDependencies

An Int specifying the number of field variable dependencies included in the definition of the unloading data, in addition to temperature. The default value is 0.

unloadingTemperatureDependency

A Boolean specifying whether unloading data depends on temperature. The default value is OFF.

variableUnits

A SymbolicConstant specifying the behavior in terms of units of force (or force in unit length) versus closure or pressure versus closure. Possible values are STRESS and FORCE. The default value is STRESS.

yieldOnset

A Float specifying the closure value at which the onset of yield occurs or the relative drop in slope on the loading curve that defines the onset of Plastic deformation (depending on the value of yieldOnsetMethod). The default value is 0.1.

yieldOnsetMethod

A SymbolicConstant specifying the method used to determine yield onset. Possible values are RELATIVE_SLOPE_DROP and CLOSURE_VALUE. The default value is RELATIVE_SLOPE_DROP.

unloadingTable

A sequence of sequences of Floats specifying unloading data. The items in the table data are described below. The default value is an empty sequence.

Returns:
A GasketThicknessBehavior object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].GasketThicknessBehavior
session.odbs[name].materials[name].GasketThicknessBehavior
GasketTransverseShearElastic(table: tuple, variableUnits: SymbolicConstantType = 'STRESS', temperatureDependency: BooleanType = 0, dependencies: int = 0) GasketTransverseShearElastic[source]#

This method creates a GasketTransverseShearElastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

variableUnits

A SymbolicConstant specifying the unit system in which the transverse shear behavior will be defined. Possible values are STRESS and FORCE. The default value is STRESS.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A GasketTransverseShearElastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].GasketTransverseShearElastic
session.odbs[name].materials[name].GasketTransverseShearElastic
Gel(table: tuple) Gel[source]#

This method creates a Gel object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

Returns:
A Gel object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Gel
session.odbs[name].materials[name].Gel
Hyperelastic(table: tuple, type: SymbolicConstantType = 'UNKNOWN', moduliTimeScale: SymbolicConstantType = 'LONG_TERM', temperatureDependency: BooleanType = 0, n: int = 1, beta: SymbolicConstantType | float = 'FITTED_VALUE', testData: BooleanType = 1, compressible: BooleanType = 0, properties: int = 0, deviatoricResponse: SymbolicConstantType = 'UNIAXIAL', volumetricResponse: SymbolicConstantType = 'DEFAULT', poissonRatio: float = 0, materialType: SymbolicConstantType = 'ISOTROPIC', anisotropicType: SymbolicConstantType = 'FUNG_ANISOTROPIC', formulation: SymbolicConstantType = 'STRAIN', behaviorType: SymbolicConstantType = 'INCOMPRESSIBLE', dependencies: int = 0, localDirections: int = 0) Hyperelastic[source]#

This method creates a Hyperelastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below. This argument is valid only if *testData*=OFF.

type

A SymbolicConstant specifying the type of strain energy potential. Possible values are:

  • ARRUDA_BOYCE

  • MARLOW

  • MOONEY_RIVLIN

  • NEO_HOOKE

  • OGDEN

  • POLYNOMIAL

  • REDUCED_POLYNOMIAL

  • USER

  • VAN_DER_WAALS

  • YEOH

  • UNKNOWN

  • VALANIS_LANDEL

The default value is UNKNOWN.

moduliTimeScale

A SymbolicConstant specifying the nature of the time response. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

n

An Int specifying the order of the strain energy potential. The default value is 1.If testData*=ON and **type**=POLYNOMIAL, *n can take only the values 1 or 2.If *testData*=ON and **type**=OGDEN or if *testData*=OFF for either type, 1 ≤n≤≤n≤ 6.If **type**=USER, this argument cannot be used.

beta

The SymbolicConstant FITTED_VALUE or a Float specifying the invariant mixture parameter. This argument is valid only if *testData*=ON and **type**=VAN_DER_WAALS. The default value is FITTED_VALUE.

testData

A Boolean specifying whether test data are supplied. The default value is ON.

compressible

A Boolean specifying whether the hyperelastic material is compressible. This parameter is applicable only to user-defined hyperelastic materials. The default value is OFF.

properties

An Int specifying the number of property values needed as data for the user-defined hyperelastic material. The default value is 0.

deviatoricResponse

A SymbolicConstant specifying which test data to use. Possible values are UNIAXIAL, BIAXIAL, and PLANAR. The default value is UNIAXIAL.

volumetricResponse

A SymbolicConstant specifying the volumetric response. Possible values are DEFAULT, VOLUMETRIC_DATA, POISSON_RATIO, and LATERAL_NOMINAL_STRAIN. The default value is DEFAULT.

poissonRatio

A Float specifying the poisson ratio. This argument is valid only if *volumetricResponse*=POISSON_RATIO. The default value is 0.0.

materialType

A SymbolicConstant specifying the type of material. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.

anisotropicType

A SymbolicConstant specifying the type of strain energy potential. Possible values are FUNG_ANISOTROPIC, FUNG_ORTHOTROPIC, HOLZAPFEL, and USER_DEFINED. The default value is FUNG_ANISOTROPIC.

formulation

A SymbolicConstant specifying the type of formulation. Possible values are STRAIN and INVARIANT. The default value is STRAIN.

behaviorType

A SymbolicConstant specifying the type of anisotropic hyperelastic material behavior. Possible values are INCOMPRESSIBLE and COMPRESSIBLE. The default value is INCOMPRESSIBLE.

dependencies

An Int specifying the number of field variable dependencies for the data in*volumetricTable* . The default value is 0.

localDirections

An Int specifying the number of local directions for the data in*volumetricTable* . The default value is 0.

Returns:
A Hyperelastic object.
Raises:
InvalidNameError
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Hyperelastic
session.odbs[name].materials[name].Hyperelastic
Hyperfoam(testData: BooleanType = 0, poisson: float | None = None, n: int = 1, temperatureDependency: BooleanType = 0, moduli: SymbolicConstantType = 'LONG_TERM', table: tuple = ()) Hyperfoam[source]#

This method creates a Hyperfoam object.

Parameters:
testData

A Boolean specifying whether test data are supplied. The default value is OFF.

poisson

None or a Float specifying the effective Poisson’s ratio, νν, of the material. This argument is valid only when *testData*=ON. The default value is None.

n

An Int specifying the order of the strain energy potential. Possible values are 1 ≤n≤≤n≤ 6. The default value is 1.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

moduli

A SymbolicConstant specifying the time-dependence of the material constants. Possible values are INSTANTANEOUS and LONG_TERM. The default value is LONG_TERM.

table

A sequence of sequences of Floats specifying the items described below. This argument is valid only when *testData*=OFF. The default value is an empty sequence.

Returns:
A Hyperfoam object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Hyperfoam
session.odbs[name].materials[name].Hyperfoam
Hypoelastic(table: tuple, user: BooleanType = 0) Hypoelastic[source]#

This method creates a Hypoelastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

user

A Boolean specifying that hypoelasticity is defined by user subroutine UHYPEL. The default value is OFF.

Returns:
A Hypoelastic object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Hypoelastic
session.odbs[name].materials[name].Hypoelastic
InelasticHeatFraction(fraction: float = 0) InelasticHeatFraction[source]#

This method creates an InelasticHeatFraction object.

Parameters:
fraction

A Float specifying the fraction of inelastic dissipation rate that appears as a heat flux per unit volume. The fraction may include a unit conversion factor if required. Possible values are 0.0 ≤≤ fraction ≤≤ 1.0. The default value is 0.9.

Returns:
An InelasticHeatFraction object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].InelasticHeatFraction
session.odbs[name].materials[name].InelasticHeatFraction
JouleHeatFraction(fraction: float = 1) JouleHeatFraction[source]#

This method creates a JouleHeatFraction object.

Parameters:
fraction

A Float specifying the fraction of electrical energy released as heat, including any unit conversion factor. The default value is 1.0.

Returns:
A JouleHeatFraction object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].JouleHeatFraction
session.odbs[name].materials[name].JouleHeatFraction
LatentHeat(table: tuple) LatentHeat[source]#

This method creates a LatentHeat object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

Returns:
A LatentHeat object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].LatentHeat
session.odbs[name].materials[name].LatentHeat
LowDensityFoam(elementRemoval: BooleanType = 0, maxAllowablePrincipalStress: float | None = None, extrapolateStressStrainCurve: BooleanType = 0, strainRateType: SymbolicConstantType = 'VOLUMETRIC', mu0: float | None = None, mu1: float = 0, alpha: float = 2) LowDensityFoam[source]#

This method creates a LowDensityFoam object.

Parameters:
elementRemoval

A Boolean specifying whether elements are removed if exceeding maximum principal tensile stress. This argument is valid only when maxAllowablePrincipalStress is defined. The default value is OFF.

maxAllowablePrincipalStress

None or a Float specifying the maximum allowable principal tensile stress. The default value is None.

extrapolateStressStrainCurve

A Boolean specifying whether the stress-strain curve is extrapolated if exceeding maximum strain rate. The default value is OFF.

strainRateType

A SymbolicConstant specifying strain rate measure used for constitutive calculations. Possible values are PRINCIPAL and VOLUMETRIC. The default value is VOLUMETRIC.

mu0

A Float specifying the relaxation coefficient μ0. The default value is 10–4.

mu1

A Float specifying the relaxation coefficient μ1. The default value is 0.5×10–2.

alpha

A Float specifying the relaxation coefficient α. The default value is 2.0.

Returns:
A LowDensityFoam object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].LowDensityFoam
session.odbs[name].materials[name].LowDensityFoam
MagneticPermeability(table: tuple, table2: tuple, table3: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, nonlinearBH: BooleanType = 0) MagneticPermeability[source]#

This method creates a MagneticPermeability object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below in “Table data.” If **type**=ORTHOTROPIC and nonlinearBH=ON, the data specified in the table is for the first direction and table2 and table3 must be specified.

table2

A sequence of sequences of Floats specifying the items described below in “Table data” in the second direction. table2 must be specified only if **type**=ORTHOTROPIC and nonlinearBH=ON.

table3

A sequence of sequences of Floats specifying the items described below in “Table data” in the third direction. table3 must be specified only if **type**=ORTHOTROPIC and nonlinearBH=ON.

type

A SymbolicConstant specifying the type of magnetic permeability. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

frequencyDependency

A Boolean specifying whether the data depend on frequency. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

nonlinearBH

A Boolean specifying whether the magnetic behavior is nonlinear and available in tabular form of magnetic flux density versus magnetic field values. The default value is OFF.

Returns:
A MagneticPermeability object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].MagneticPermeability
session.odbs[name].materials[name].MagneticPermeability
MohrCoulombPlasticity(table: tuple, deviatoricEccentricity: float | None = None, meridionalEccentricity: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, useTensionCutoff: BooleanType = 0) MohrCoulombPlasticity[source]#

This method creates a MohrCoulombPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

deviatoricEccentricity

None or a Float specifying the flow potential eccentricity in the deviatoric plane, e; 1/2 ≤ 1.0. If *deviatoricEccentricity*=None, Abaqus calculates the value using the specified Mohr-Coulomb angle of friction. The default value is None.

meridionalEccentricity

A Float specifying the flow potential eccentricity in the meridional plane, ϵϵ. The default value is 0.1.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

useTensionCutoff

A Boolean specifying whether tension cutoff specification is needed. The default value is OFF.

Returns:
A MohrCoulombPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].MohrCoulombPlasticity
session.odbs[name].materials[name].MohrCoulombPlasticity
MoistureSwelling(table: tuple) MoistureSwelling[source]#

This method creates a MoistureSwelling object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

Returns:
A MoistureSwelling object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].MoistureSwelling
session.odbs[name].materials[name].MoistureSwelling
Permeability(specificWeight: float, inertialDragCoefficient: float, table: tuple, type: SymbolicConstantType = 'ISOTROPIC', temperatureDependency: BooleanType = 0, dependencies: int = 0) Permeability[source]#

This method creates a Permeability object.

Parameters:
specificWeight

A Float specifying the specific weight of the wetting liquid, γwγw.

inertialDragCoefficient

A Float specifying The inertial drag coefficient of the wetting liquid, γwγw.

table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of permeability. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Permeability object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Permeability
session.odbs[name].materials[name].Permeability
Piezoelectric(table: tuple, type: SymbolicConstantType = 'STRESS', temperatureDependency: BooleanType = 0, dependencies: int = 0) Piezoelectric[source]#

This method creates a Piezoelectric object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of material coefficients for the piezoelectric property. Possible values are STRAIN and STRESS. The default value is STRESS.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Piezoelectric object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Piezoelectric
session.odbs[name].materials[name].Piezoelectric
Plastic(table: tuple, hardening: SymbolicConstantType = 'ISOTROPIC', rate: BooleanType = 0, dataType: SymbolicConstantType = 'HALF_CYCLE', strainRangeDependency: BooleanType = 0, numBackstresses: int = 1, temperatureDependency: BooleanType = 0, dependencies: int = 0) Plastic[source]#

This method creates a Plastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

hardening

A SymbolicConstant specifying the type of hardening. Possible values are ISOTROPIC, KINEMATIC, COMBINED, JOHNSON_COOK, and USER. The default value is ISOTROPIC.

rate

A Boolean specifying whether the data depend on rate. The default value is OFF.

dataType

A SymbolicConstant specifying the type of combined hardening. This argument is only valid if *hardening*=COMBINED. Possible values are HALF_CYCLE, PARAMETERS, and STABILIZED. The default value is HALF_CYCLE.

strainRangeDependency

A Boolean specifying whether the data depend on strain range. This argument is only valid if *hardening*=COMBINED and *dataType*=STABILIZED. The default value is OFF.

numBackstresses

An Int specifying the number of backstresses. This argument is only valid if *hardening*=COMBINED. The default value is 1.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Plastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Plastic
session.odbs[name].materials[name].Plastic
PoreFluidExpansion(table: tuple, zero: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0) PoreFluidExpansion[source]#

This method creates a PoreFluidExpansion object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

zero

A Float specifying the value of θ0. The default value is 0.0.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A PoreFluidExpansion object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].PoreFluidExpansion
session.odbs[name].materials[name].PoreFluidExpansion
PorousBulkModuli(table: tuple, temperatureDependency: BooleanType = 0) PorousBulkModuli[source]#

This method creates a PorousBulkModuli object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

Returns:
A PorousBulkModuli object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].PorousBulkModuli
session.odbs[name].materials[name].PorousBulkModuli
PorousElastic(table: tuple, shear: SymbolicConstantType = 'POISSON', temperatureDependency: BooleanType = 0, dependencies: int = 0) PorousElastic[source]#

This method creates a PorousElastic object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

shear

A SymbolicConstant specifying the shear definition form. Possible values are G and POISSON. The default value is POISSON.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A PorousElastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].PorousElastic
session.odbs[name].materials[name].PorousElastic
PorousMetalPlasticity(table: tuple, relativeDensity: float | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0) PorousMetalPlasticity[source]#

This method creates a PorousMetalPlasticity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

relativeDensity

None or a Float specifying the initial relative density of the material, r0. The default value is None.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A PorousMetalPlasticity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].PorousMetalPlasticity
session.odbs[name].materials[name].PorousMetalPlasticity
Regularization(rtol: float = 0, strainRateRegularization: SymbolicConstantType = 'LOGARITHMIC') Regularization[source]#

This method creates a Regularization object.

Parameters:
rtol

A Float specifying the tolerance to be used for regularizing material data. The default value is 0.03.

strainRateRegularization

A SymbolicConstant specifying the form of regularization of strain-rate-dependent material data. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

Returns:
A Regularization object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Regularization
session.odbs[name].materials[name].Regularization
Solubility(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0) Solubility[source]#

This method creates a Solubility object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Solubility object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Solubility
session.odbs[name].materials[name].Solubility
Sorption(absorptionTable: tuple, lawAbsorption: SymbolicConstantType = 'TABULAR', exsorption: BooleanType = 0, lawExsorption: SymbolicConstantType = 'TABULAR', scanning: float = 0, exsorptionTable: tuple = ()) Sorption[source]#

This method creates a Sorption object.

Parameters:
absorptionTable

A sequence of sequences of Floats specifying the items described below.

lawAbsorption

A SymbolicConstant specifying absorption behavior. Possible values are LOG and TABULAR. The default value is TABULAR.

exsorption

A Boolean specifying whether the exsorption data is specified. The default value is OFF.

lawExsorption

A SymbolicConstant specifying exsorption behavior. Possible values are LOG and TABULAR. The default value is TABULAR.

scanning

A Float specifying the slope of the scanning line, (duw/ds)|s. This slope must be positive and larger than the slope of the absorption or exsorption behaviors. The default value is 0.0.

exsorptionTable

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
A Sorption object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Sorption
session.odbs[name].materials[name].Sorption
SpecificHeat(table: tuple, law: SymbolicConstantType = 'CONSTANTVOLUME', temperatureDependency: BooleanType = 0, dependencies: int = 0) SpecificHeat[source]#

This method creates a SpecificHeat object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

law

A SymbolicConstant specifying the specific heat behavior. Possible values are CONSTANTVOLUME and CONSTANTPRESSURE. The default value is CONSTANTVOLUME.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A SpecificHeat object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].SpecificHeat
session.odbs[name].materials[name].SpecificHeat
Swelling(table: tuple, law: SymbolicConstantType = 'INPUT', temperatureDependency: BooleanType = 0, dependencies: int = 0) Swelling[source]#

This method creates a Swelling object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.This argument is valid only when *law*=INPUT.

law

A SymbolicConstant specifying the type of data defining the swelling behavior. Possible values are INPUT and USER. The default value is INPUT.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Swelling object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Swelling
session.odbs[name].materials[name].Swelling
UserMaterial(type: SymbolicConstantType = 'MECHANICAL', unsymm: BooleanType = 0, mechanicalConstants: tuple = (), thermalConstants: tuple = (), effmod: BooleanType = 0, hybridFormulation: SymbolicConstantType = 'INCREMENTAL') UserMaterial[source]#

This method creates a UserMaterial object.

Parameters:
type

A SymbolicConstant specifying the type of material behavior defined by the command. Possible values are MECHANICAL, THERMAL, and THERMOMECHANICAL. The default value is MECHANICAL.

unsymm

A Boolean specifying if the material stiffness matrix, ∂Δσ/∂Δε, is not symmetric or, when a thermal constitutive model is used, if ∂f/∂(∂θ/∂x) is not symmetric. The default value is OFF. This argument is valid only for an Abaqus/Standard analysis.

mechanicalConstants

A sequence of Floats specifying the mechanical constants of the material. This argument is valid only when **type**=MECHANICAL or THERMOMECHANICAL. The default value is an empty sequence.

thermalConstants

A sequence of Floats specifying the thermal constants of the material. This argument is valid only when **type**=THERMAL or THERMOMECHANICAL. The default value is an empty sequence.

effmod

A Boolean specifying if effective bulk modulus and shear modulus are returned by user subroutine VUMAT. The default value is OFF. This argument is valid only in an Abaqus/Explicit analysis.

hybridFormulation

A SymbolicConstant to specify the formulation of the hybrid element with user subroutine UMAT. Possible values are TOTAL, INCREMENTAL, and INCOMPRESSIBLE. The default value is INCREMENTAL. This argument is valid only in an Abaqus/Standard analysis.

Returns:
A UserMaterial object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].UserMaterial
session.odbs[name].materials[name].UserMaterial
UserOutputVariables(n: int = 0) UserOutputVariables[source]#

This method creates a UserOutputVariables object.

Parameters:
n

An Int specifying the number of user-defined variables required at each material point. The default value is 0.

Returns:
A UserOutputVariables object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].UserOutputVariables
session.odbs[name].materials[name].UserOutputVariables
Viscoelastic(domain: SymbolicConstantType, table: tuple, frequency: SymbolicConstantType = 'FORMULA', type: SymbolicConstantType = 'ISOTROPIC', preload: SymbolicConstantType = 'NONE', time: SymbolicConstantType = 'PRONY', errtol: float = 0, nmax: int = 13, volumetricTable: tuple = ()) Viscoelastic[source]#

This method creates a Viscoelastic object.

Parameters:
domain

A SymbolicConstant specifying the domain definition. Possible values are: - FREQUENCY, specifying a frequency domain. This domain is only available for an Abaqus/Standard analysis. - TIME, specifying a time domain.

table

A sequence of sequences of Floats specifying the items described below.

frequency

A SymbolicConstant specifying the frequency domain definition. This argument is required only when *domain*=FREQUENCY. Possible values are FORMULA, TABULAR, PRONY, CREEP_TEST_DATA, and RELAXATION_TEST_DATA. The default value is FORMULA.

type

A SymbolicConstant specifying the type. This argument is required only when *domain*=FREQUENCY and *frequency*=TABULAR. Possible values are ISOTROPIC and TRACTION. The default value is ISOTROPIC.

preload

A SymbolicConstant specifying the preload. This argument is required only when *domain*=FREQUENCY and *frequency*=TABULAR. Possible values are NONE, UNIAXIAL, VOLUMETRIC, and UNIAXIAL_VOLUMETRIC. The default value is NONE.

time

A SymbolicConstant specifying the time domain definition. This argument is required only when *domain*=TIME. Possible values are PRONY, CREEP_TEST_DATA, RELAXATION_TEST_DATA, and FREQUENCY_DATA. The default value is PRONY.

errtol

A Float specifying the allowable average root-mean-square error of the data points in the least-squares fit. The Float values correspond to percentages; for example, 0.01 is 1%. The default value is 0.01.This argument is valid only when *time*=CREEP_TEST_DATA, RELAXATION_TEST_DATA or FREQUENCY_DATA; or only when *frequency*=CREEP_TEST_DATA or RELAXATION_TEST_DATA.

nmax

An Int specifying the maximum number of terms NN in the Prony series. The maximum value is 13. The default value is 13.This argument is valid only when *time*=CREEP_TEST_DATA, RELAXATION_TEST_DATA or FREQUENCY_DATA; or only when *frequency*=CREEP_TEST_DATA or RELAXATION_TEST_DATA.

volumetricTable

A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Returns:
A Viscoelastic object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Viscoelastic
session.odbs[name].materials[name].Viscoelastic
Viscosity(table: tuple, type: SymbolicConstantType = 'NEWTONIAN', temperatureDependency: BooleanType = 0, dependencies: int = 0) Viscosity[source]#

This method creates a Viscosity object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

type

A SymbolicConstant specifying the type of viscosity. The default value is NEWTONIAN.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A Viscosity object.
Raises:
RangeError

Notes

This function can be accessed by:

mdb.models[name].materials[name].Viscosity
session.odbs[name].materials[name].Viscosity
Viscous(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL') Viscous[source]#

This method creates a Viscous object.

Parameters:
table

A sequence of sequences of Floats specifying the items described below.

law

A SymbolicConstant specifying the creep law. Possible values are STRAIN, TIME, USER, ANAND, DARVEAUX, DOUBLE_POWER, POWER_LAW, and TIME_POWER_LAW. The default value is STRAIN.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

time

A SymbolicConstant specifying the time interval for relevant laws. Possible values are CREEP and TOTAL. The default value is TOTAL.

Returns:
A Viscous object.

Notes

This function can be accessed by:

mdb.models[name].materials[name].Viscous
session.odbs[name].materials[name].Viscous
materialsFromOdb(fileName: str)[source]#

This methods creates Material objects by reading an output database. The new materials are placed in the materials repository.

Parameters:
fileName

A String specifying the name of the output database file (including the .odb extension) to be read. This String can also be the full path to the output database file if it is located in another directory.

Returns:
A python:list of Material objects.

Notes

This function can be accessed by:

mdb.models[name].Material
session.odbs[name].Material

Density#

Density#

class Density(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, distributionType: SymbolicConstantType = 'UNIFORM', fieldName: str = '')[source]#

The Density object specifies the material density.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].density
import odbMaterial
session.odbs[name].materials[name].density

The table data for this object are:

  • The mass density.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • DENSITY

Methods

setValues()

This method modifies the Density object.

Elastic#

HyperElastic#

Hyperelastic#
class Hyperelastic(table: tuple, type: SymbolicConstantType = 'UNKNOWN', moduliTimeScale: SymbolicConstantType = 'LONG_TERM', temperatureDependency: BooleanType = 0, n: int = 1, beta: SymbolicConstantType | float = 'FITTED_VALUE', testData: BooleanType = 1, compressible: BooleanType = 0, properties: int = 0, deviatoricResponse: SymbolicConstantType = 'UNIAXIAL', volumetricResponse: SymbolicConstantType = 'DEFAULT', poissonRatio: float = 0, materialType: SymbolicConstantType = 'ISOTROPIC', anisotropicType: SymbolicConstantType = 'FUNG_ANISOTROPIC', formulation: SymbolicConstantType = 'STRAIN', behaviorType: SymbolicConstantType = 'INCOMPRESSIBLE', dependencies: int = 0, localDirections: int = 0)[source]#

The Hyperelastic object specifies elastic properties for approximately incompressible elastomers.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperelastic
import odbMaterial
session.odbs[name].materials[name].hyperelastic

The table data for this object are:

  • If *type*=ARRUDA_BOYCE, the table data specify the following:
    • μ.

    • λm.

    • Temperature, if the data depend on temperature.

  • If *type*=MOONEY_RIVLIN, the table data specify the following:
    • C10.

    • C01.

    • D1.

    • Temperature, if the data depend on temperature.

  • If *type*=NEO_HOOKE, the table data specify the following:
    • C10.

    • D1.

    • Temperature, if the data depend on temperature.

  • If *type*=OGDEN, the table data specify the following for values of nn:
    • μi and αi for ii from 1 to n.

    • nn coefficients Di.

    • Temperature, if the data depend on temperature. Temperature dependence is not allowed for 4 ≤n≤ 6 in an

    Abaqus/Explicit analysis.

  • If *type*=POLYNOMIAL, the table data specify the following for values of nn:
    • CijCi⁢j for each value of (i+j) from 11 to n with ii decreasing from (i+j) to zero and j increasing from

    zero to (i+j). - n coefficients Di. - Temperature, if the data depend on temperature. Temperature dependence is not allowed for 3 ≤n≤ 6 in an Abaqus/Explicit analysis.

  • If *type*=REDUCED_POLYNOMIAL, the table data specify the following for values of nn:
    • Ci⁢0 for ii from 1 to n.

    • n coefficients Di.

    • Temperature, if the data depend on temperature. Temperature dependence is not allowed for 4 ≤n≤ 6 in an

    Abaqus/Explicit analysis.

  • If *type*=VAN_DER_WAALS, the table data specify the following:
    • μ.

    • λm.

    • β.

    • Temperature, if the data depend on temperature.

  • If *type*=YEOH, the table data specify the following:
    • C10.

    • C20.

    • C30.

    • D1.

    • D2.

    • D3.

    • Temperature, if the data depend on temperature. Temperature dependence is not allowed in an Abaqus/Explicit analysis.

The None object is the default value if *testData*=ON.

The corresponding analysis keywords are:

  • HYPERELASTIC

Methods

setValues()

This method modifies the Hyperelastic object.

HyperFoam#
Hyperfoam#
class Hyperfoam(testData: BooleanType = 0, poisson: float | None = None, n: int = 1, temperatureDependency: BooleanType = 0, moduli: SymbolicConstantType = 'LONG_TERM', table: tuple = ())[source]#

The Hyperfoam object specifies elastic properties for a hyperelastic foam.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperfoam
import odbMaterial
session.odbs[name].materials[name].hyperfoam

The table data for this object are: The items in the table data specify the following for values of nn:

  • μi and αi for i from 1 to n.

  • νi.

  • Temperature, if the data depend on temperature. Temperature dependence is not allowed for 4 ≤n≤ 6 in an

Abaqus/Explicit analysis.

The corresponding analysis keywords are:

  • HYPERFOAM

Methods

setValues()

This method modifies the Hyperfoam object.

ViscoElastic#
CombinedTestData#
class CombinedTestData(table: tuple, volinf: float | None = None, shrinf: float | None = None)[source]#

The CombinedTestData object specifies simultaneously the normalized shear and bulk compliances or relaxation moduli as functions of time.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].viscoelastic.combinedTestData
import odbMaterial
session.odbs[name].materials[name].viscoelastic.combinedTestData

The table data for this object are:

If *time*=RELAXATION_TEST_DATA, the table data specify the following:
  • Normalized shear modulus, gR⁢(t) (0≤gR(t)≤1).

  • Normalized volumetric (bulk) modulus, kR⁢(t) (0≤kR(t)≤1).

  • Time t (t>0).

If *time*=CREEP_TEST_DATA, the table data specify the following:
  • Normalized shear compliance, jS(t)(jS(t)≥1).

  • Normalized volumetric (bulk) compliance, jK⁢(t) (jK(t)≥1)

  • Time t (t>0)

The corresponding analysis keywords are:

  • COMBINED TEST DATA

Methods

setValues()

This method modifies the CombinedTestData object.

Hysteresis#
class Hysteresis(table: tuple)[source]#

The Hysteresis object specifies the creep part of the material model for the hysteretic behavior of elastomers.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperelastic.hysteresis
import odbMaterial
session.odbs[name].materials[name].hyperelastic.hysteresis

The table data for this object are:

  • Stress scaling factor.

  • Creep parameter.

  • Effective stress exponent.

  • Creep strain exponent.

The corresponding analysis keywords are:

  • HYSTERESIS

Methods

setValues()

This method modifies the Hysteresis object.

Viscoelastic#
class Viscoelastic(domain: SymbolicConstantType, table: tuple, frequency: SymbolicConstantType = 'FORMULA', type: SymbolicConstantType = 'ISOTROPIC', preload: SymbolicConstantType = 'NONE', time: SymbolicConstantType = 'PRONY', errtol: float = 0, nmax: int = 13, volumetricTable: tuple = ())[source]#

The Viscoelastic object specifies dissipative behavior for use with elasticity.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].viscoelastic
import odbMaterial
session.odbs[name].materials[name].viscoelastic

The table data for this object are:

  • If frequency*=FORMULA, the table data for *table specify the following:
    • Real part of g∗1 (g∗(ω)=g∗1f−a).

    • Imaginary part of g∗1.

    • Value of a.

    • Real part of k∗1 (k∗(ω)=k∗1f−b). If the material is incompressible, this value is ignored.

    • Imaginary part of k1*. If the material is incompressible, this value is ignored.

    • Value of b. If the material is incompressible, this value is ignored.

  • If *frequency*=TABULAR and *type*=ISOTROPIC and *preload*=NONE, or *time*=FREQUENCY_DATA the table data for

table specify the following:
  • Real part of ω⁢g* (ωR(g∗)=Gℓ/G∞).

  • Imaginary part of ω⁢g* (ωI(g*)=1−Gs/G∞).

  • Real part of ω⁢k* (ωR(k∗)=Kℓ/K∞). If the material is incompressible, this value is ignored.

  • Imaginary part of ω⁢k* (ωI(k∗)=1−Ks/K∞). If the material is incompressible, this value is ignored.

  • Frequency f in cycles per time.

  • If frequency*=TABULAR and *type*=ISOTROPIC and *preload*=UNIAXIAL the table data for *table specify the following:
    • Loss modulus.

    • Storage modulus.

    • Frequency.

    • Uniaxial strain.

  • If frequency*=TABULAR and *type*=TRACTION and *preload*=NONE the table data for *table specify the following:
    • Normalized loss modulus.

    • Normalized shear modulus.

    • Frequency.

  • If *frequency*=TABULAR and *type*=TRACTION and *preload*=UNIAXIAL or *preload*=UNIAXIAL_VOLUMETRIC the table

data for table specify the following:
  • Loss modulus.

  • Storage modulus.

  • Frequency.

  • Closure.

  • If time*=PRONY or *frequency*=PRONY, the table data for *table specify the following:
    • g¯1P, the modulus ratio in the first term in the Prony series expansion of the shear relaxation modulus.

    • k¯1P, the modulus ratio in the first term in the Prony series expansion of the bulk relaxation modulus.

    • τ1, the relaxation time for the first term in the Prony series expansion.

  • If *frequency*=TABULAR and *type*=ISOTROPIC and *preload*=VOLUMETRIC or *preload*=UNIAXIAL_VOLUMETRIC the table

data for volumetricTable specify the following:
  • Loss modulus.

  • Storage modulus.

  • Frequency.

  • Volume ratio.

The corresponding analysis keywords are:

  • VISCOELASTIC

Methods

setValues()

This method modifies the Viscoelastic object.

HypoElastic#

Hypoelastic#
class Hypoelastic(table: tuple, user: BooleanType = 0)[source]#

The Hypoelastic object specifies hypoelastic material properties.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hypoelastic
import odbMaterial
session.odbs[name].materials[name].hypoelastic

The table data for this object are:

  • Instantaneous Young’s modulus, E.

  • Instantaneous Poisson’s ratio, ν.

  • First strain invariant, I1.

  • Second strain invariant, I2.

  • Third strain invariant, I3.

The corresponding analysis keywords are:

  • HYPOELASTIC

Methods

setValues()

This method modifies the Hypoelastic object.

Linear#

Elastic#
class Elastic(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', noCompression: BooleanType = 0, noTension: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, moduli: SymbolicConstantType = 'LONG_TERM')[source]#

The Elastic object specifies elastic material properties.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].elastic
import odbMaterial
session.odbs[name].materials[name].elastic

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • The Young’s modulus, E.

    • The Poisson’s ratio, v.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=SHEAR, the table data specify the following:
    • The shear modulus,G.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENGINEERING_CONSTANTS, the table data specify the following:
    • E1.

    • E2.

    • E3.

    • v12.

    • v13.

    • v23.

    • G12.

    • G13.

    • G23.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=LAMINA, the table data specify the following:
    • E1.

    • E2.

    • v12.

    • G12.

    • G13. This shear modulus is needed to define transverse shear behavior in shells.

    • G23. This shear modulus is needed to define transverse shear behavior in shells.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • D1111.

    • D1122.

    • D2222.

    • D1133.

    • D2233.

    • D3333.

    • D1212.

    • D1313.

    • D2323.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • D1111.

    • D1122.

    • D2222.

    • D1133.

    • D2233.

    • D3333.

    • D1112.

    • D2212.

    • D3312.

    • D1212.

    • D1113.

    • D2213.

    • D3313.

    • D1213.

    • D1313.

    • D1123.

    • D2223.

    • D3323.

    • D1223.

    • D1323.

    • D2323.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=TRACTION, the table data specify the following:
    • EE for warping elements; Enn for cohesive elements.

    • G1 for warping elements; Ess for cohesive elements.

    • G2 for warping elements; Ett for cohesive elements.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=SHORT_FIBER, there is no table data.

The corresponding analysis keywords are:

  • ELASTIC

Methods

setValues()

This method modifies the Elastic object.

FailStrain#
class FailStrain(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The FailStrain object defines parameters for strain-based failure measures.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].elastic.failStrain
import odbMaterial
session.odbs[name].materials[name].elastic.failStrain
The table data for this object are:
  • Tensile strain limit in fiber direction, Xεt.

  • Compressive strain limit in fiber direction, Xεc.

  • Tensile strain limit in transverse direction, Yεt.

  • Compressive strain limit in transverse direction, Yεc.

  • Shear strain limit in the X–Y plane, Sε.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • FAIL STRAIN

Methods

setValues()

This method modifies the FailStrain object.

FailStress#
class FailStress(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The FailStress object defines parameters for stress-based failure measures.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].elastic.failStress
import odbMaterial
session.odbs[name].materials[name].elastic.failStress
The table data for this object are:
  • Tensile stress limit in fiber direction, Xt.

  • Compressive stress limit in fiber direction, Xc.

  • Tensile stress limit in transverse direction, Yt.

  • Compressive stress limit in transverse direction, Yc.

  • Shear strength in the X–Y plane, S.

  • Cross product term coefficient, f (-1.0≤f*≤1.0). The default value is zero.

  • Biaxial stress limit, σb⁢i⁢a⁢x.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • FAIL STRESS

Methods

setValues()

This method modifies the FailStress object.

LowDensityFoam#

LowDensityFoam#
class LowDensityFoam(elementRemoval: BooleanType = 0, maxAllowablePrincipalStress: float | None = None, extrapolateStressStrainCurve: BooleanType = 0, strainRateType: SymbolicConstantType = 'VOLUMETRIC', mu0: float | None = None, mu1: float = 0, alpha: float = 2)[source]#

The LowDensityFoam object specifies properties for low-density foam.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].lowDensityFoam
import odbMaterial
session.odbs[name].materials[name].lowDensityFoam

The corresponding analysis keywords are:

  • LOW DENSITY FOAM

Methods

setValues()

This method modifies the LowDensityFoam object.

Porous#

PorousElastic#
class PorousElastic(table: tuple, shear: SymbolicConstantType = 'POISSON', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The PorousElastic object specifies elastic material properties for porous materials.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].porousElastic
import odbMaterial
session.odbs[name].materials[name].porousElastic

The table data for this object are:

  • If *shear*=G, the table data specify the following:
    • The logarithmic bulk modulus, κ. (Dimensionless.)

    • The shear modulus, G.

    • The elastic tensile limit, peltpte⁢l. (This value cannot be negative.)

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *shear*=POISSON, the table data specify the following:
    • The logarithmic bulk modulus, κ. (Dimensionless.)

    • The Poisson’s ratio, ν.

    • The elastic tensile limit, peltpte⁢l. (This value cannot be negative.)

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • POROUS ELASTIC

Methods

setValues()

This method modifies the PorousElastic object.

SuperElastic#

SuperElasticity#
class SuperElasticity(table: tuple, nonassociated: float | None = None)[source]#

The SuperElasticity object specifies a superelastic material model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].superElasticity
import odbMaterial
session.odbs[name].materials[name].superElasticity
The table data for this object are:
  • Young’s Modulus (Martensite).

  • Poisson’s Ratio (Martensite).

  • Transformation Strain.

  • Start of Transformation (Loading).

  • End of Transformation (Loading).

  • Start of Transformation (Unloading).

  • End of Transformation (Unloading).

  • Start of Transformation in Compression (Loading).

  • Reference Temperature.

  • Loading.

  • Unloading.

The corresponding analysis keywords are:

  • SUPERELASTIC

Methods

setValues()

This method modifies the SuperElasticity object.

Eos#

DetonationPoint#

class DetonationPoint(table: tuple)[source]#

A DetonationPoint object specifies a suboption of the Eos object. The DetonationPoint object defines either isotropic linear elastic shear or linear viscous shear behavior for a hydrodynamic material.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].eos.detonationPoint
import odbMaterial
session.odbs[name].materials[name].eos.detonationPoint
The table data for this object are:
  • X value for coordinate of detonation point.

  • Y value for coordinate of detonation point.

  • Z value for coordinate of detonation point.

  • Detonation delay time.

The corresponding analysis keywords are:

  • DETONATION POINT

Methods

setValues()

This method modifies the DetonationPoint object.

Eos#

class Eos(type: SymbolicConstantType = 'IDEALGAS', temperatureDependency: BooleanType = 0, dependencies: int = 0, detonationEnergy: float = 0, solidTable: tuple = (), gasTable: tuple = (), reactionTable: tuple = (), gasSpecificTable: tuple = (), table: tuple = ())[source]#

The Eos object specifies an equation of state model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].eos
import odbMaterial
session.odbs[name].materials[name].eos

The table data for this object are:

  • If *type*=IDEALGAS, the table data represents the following:
    • Gas constant, R.

    • The ambient pressure, pA. If this field is left blank, a default of 0.0 is used.

  • If *type*=JWL, the table data represents the following:
    • Detonation wave speed, Cd.

    • ω. (Dimensionless.)

    • R1. (Dimensionless.)

    • R2. (Dimensionless.)

    • Pre-detonation bulk modulus, Kp⁢d.

    • Detonation energy density, E0.

  • If *type*=USUP, the table data represents the following:
    • c0.

      1. (Dimensionless.)

    • Γ0. (Dimensionless.)

  • If *type*=TABULAR, the table data represents the following:
    • F1.

    • F2.

    • εcvol. (Dimensionless.)

EosCompaction#

class EosCompaction(soundSpeed: float, porosity: float, pressure: float, compactionPressure: float)[source]#

The EosCompaction object specifies material eos compaction.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].eos.eosCompaction
import odbMaterial
session.odbs[name].materials[name].eos.eosCompaction

The corresponding analysis keywords are:

  • EOS COMPACTION

Methods

setValues()

This method modifies the EosCompaction object.

evaluateMaterial#

evaluateMaterial(material: Material, simulationName: str, dataSource: SymbolicConstantType | None = None, strainEnergyPotentials: SymbolicConstantType | None = None, marlowData: SymbolicConstantType | None = None, marlowDataType: SymbolicConstantType | None = None, testDataTypes: SymbolicConstantType | None = None, uniaxialStrainRange: float | None = None, biaxialStrainRange: float | None = None, planarStrainRange: float | None = None, volumeRatioRange: float | None = None, simpleShearStrainRange: float | None = None, viscoDataSource: SymbolicConstantType | None = None, viscoTestDataTypes: SymbolicConstantType | None = None, relaxationTime: float | None = None, creepTime: float | None = None)[source]#

This method evaluates the behavior of a hyperelastic material under standard test conditions.

Parameters:
material

A Material object.

simulationName

A String specifying the name to be used for the material evaluation simulation.

dataSource

A SymbolicConstant specifying whether test data or coefficients should be used for the material definition in the unit element tests. Possible values are TEST_DATA or COEFFICIENTS.

strainEnergyPotentials

A sequence of SymbolicConstants specifying for which material models the material is to be evaluated. Possible values are POLY_N1, POLY_N2, POLY_N3, POLY_N4, POLY_N5, POLY_N6, OGDEN_N1, OGDEN_N2, OGDEN_N3, OGDEN_N4, OGDEN_N5, OGDEN_N6, REDUCED_POLY_N1, REDUCED_POLY_N2, REDUCED_POLY_N3, REDUCED_POLY_N4, REDUCED_POLY_N5, REDUCED_POLY_N6, ARRUDA_BOYCE, VAN_DER_WAALS, YEOH, MOONEY_RIVLIN, and NEO_HOOKE.Note:The options POLY_N3, POLY_N4, POLY_N5, and POLY_N6 are valid only if the material was defined by providing coefficients of the strain energy potential.

marlowData

None or a sequence of SymbolicConstants specifying the types of test data to be included in the material definition of the Marlow material that is being evaluated. Possible values are UNIAXIAL, BIAXIAL, PLANAR, or VOLUMETRIC. The default value is None.

marlowDataType

None or a SymbolicConstant specifying the input data type for the Marlow material model. Possible values are TENSION, COMPRESSION, or BOTH.

testDataTypes

A sequence of SymbolicConstants specifying the types of test data to be included in the material definition of the material being evaluated. Possible values are UNIAXIAL, BIAXIAL, PLANAR, and VOLUMETRIC.

uniaxialStrainRange

A tuple of Floats specifying minimum and maximum nominal strains to be applied in the uniaxial tension test.

biaxialStrainRange

A tuple of Floats specifying the minimum and maximum nominal strains to be applied in the biaxial tension test.

planarStrainRange

A tuple of Floats specifying the minimum and maximum nominal strains to be applied in the planar test. The planar test is equivalent to a pure shear test.

volumeRatioRange

A tuple of Floats specifying the minimum and maximum compressive volume ratio.

simpleShearStrainRange

A tuple of Floats specifying the minimum and maximum nominal strains to be applied in the simple shear test.

viscoDataSource

None or a SymbolicConstant specifying whether test data or coefficients should be used for the viscoelastic material definition in the element tests. Possible values are TEST_DATA or COEFFICIENTS. The default value is None.

viscoTestDataTypes

None or a sequence of SymbolicConstants specifying the types of test data to be included in the material definition of the viscoelastic material being evaluated. Possible values are UNIAXIAL, BIAXIAL, PLANAR, or VOLUMETRIC. The default value is None.

relaxationTime

None or a Float specifying the time period for the stress relaxation response mode. The default value is None.

creepTime

None or a Float specifying the time period for the creep response mode. The default value is None.

Raises:
  • If dataSource*=TEST_DATA :obj:`and` *strainEnergyPotentials contains POLY_N3, POLY_N4,
POLY_N5, or POLY_N6:

MaterialEvaluationError: POLY_N3, POLY_N4, POLY_N5, or POLY_N6not allowed for

*dataSource*=TEST_DATA.
  • If the material evaluation failed:

    MaterialEvaluationError: material evaluation failed, see*path to data file*.

  • If the material type of the material to be evaluated is not hyperelastic:

    MaterialEvaluationError: Material evaluation is currentlysupported only for

hyperelastic materials.

Notes

This function can be accessed by:

evaluateMaterial

Gap#

GapConductance#

class GapConductance(pressureDependency: BooleanType = 0, dependencies: int = 0, table: tuple = ())[source]#

The GapConductance object specifies conductive heat transfer between closely adjacent (or contacting) surfaces.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gapConductance
import odbMaterial
session.odbs[name].materials[name].gapConductance
The table data for this object are:
  • Gap Conductance or Cohesive Separation.

  • Gap Clearance, Gap Pressure (if optional parameter pressureDependency is used), or Closure, c (for coupled temperature-displacement gasket elements).

  • Average Temperature if the data depend on temperature.

  • Mass Flow Rate per unit area if the data depend on the average mass flow rate.

  • Value of the first field variable if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • GAP CONDUCTANCE

Methods

setValues()

This method modifies the GapConductance object.

GapConvection#

class GapConvection(type: str, table: tuple = (), temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The GapConvection object specifies the Nusselt number (Nu) to calculate the convective coefficient for heat transfer between the gap flow and both the top and bottom surfaces of a coupled temperature-pore pressure cohesive element.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gapConvection
import odbMaterial
session.odbs[name].materials[name].gapConvection

The table data for this object are: For *type*=TABULAR the table data specify the following:

  • Nusselt number (Nu)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • GAP CONVECTION

Methods

setValues()

This method modifies the GapConvection object.

GapFlow#

class GapFlow(table: tuple, kmax: float | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'NEWTONIAN')[source]#

The GapFlow object specifies tangential flow constitutive parameters for pore pressure cohesive elements.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gapFlow
import odbMaterial
session.odbs[name].materials[name].gapFlow

The table data for this object are:

  • If *type*=NEWTONIAN the table data specify the following:
    • Pore viscosity.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=POWER_LAW the table data specify the following:
    • Consistency.

    • Exponent.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=BINGHAM_PLASTIC the table data specify the following:
    • Consistency.

    • Yield stress.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=HERSCHEL-BULKLEY the table data specify the following:
    • Consistency.

    • Exponent.

    • Yield stress.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • GAP FLOW

Methods

setValues()

This method modifies the GapFlow object.

GapRadiation#

class GapRadiation(mainSurfaceEmissivity: float, secondarySurfaceEmissivity: float, table: tuple)[source]#

The GapRadiation object specifies radiative heat transfer between closely adjacent surfaces.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gapRadiation
import odbMaterial
session.odbs[name].materials[name].gapRadiation
The table data for this object are:
  • Effective view factor.

  • Gap clearance.

  • Repeat this data line as often as necessary to define the dependence of the view factor on gap clearance.

The corresponding analysis keywords are:

  • GAP RADIATION

Methods

setValues()

This method modifies the GapRadiation object.

Gasket#

ContactArea#

class ContactArea(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

A ContactArea object specifies a suboption of gasket thickness behavior when *variableUnits*=FORCE on the GasketThicknessBehavior object. The ContactArea object defines the contact area or contact width versus closure curves to output an average pressure through variable CS11.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gasketThicknessBehavior.contactArea
import odbMaterial
session.odbs[name].materials[name].gasketThicknessBehavior.contactArea
The table data for this object are:
  • Contact area or width; this value must be positive.

  • Closure; this value must be positive.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • GASKET CONTACT AREA

Methods

setValues()

This method modifies the ContactArea object.

GasketMembraneElastic#

class GasketMembraneElastic(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The GasketMembraneElastic object defines the elastic parameters for the membrane shear behavior of a gasket.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gasketMembraneElastic
import odbMaterial
session.odbs[name].materials[name].gasketMembraneElastic
The table data for this object are:
  • Young’s modulus, E.

  • Poisson’s ratio, ν.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • GASKET ELASTICITY

Methods

setValues()

This method modifies the GasketMembraneElastic object.

GasketThicknessBehavior#

class GasketThicknessBehavior(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, tensileStiffnessFactor: float | None = None, type: SymbolicConstantType = 'ELASTIC_PLASTIC', unloadingDependencies: int = 0, unloadingTemperatureDependency: BooleanType = 0, variableUnits: SymbolicConstantType = 'STRESS', yieldOnset: float = 0, yieldOnsetMethod: SymbolicConstantType = 'RELATIVE_SLOPE_DROP', unloadingTable: tuple = ())[source]#

The GasketThicknessBehavior object defines the behavior in the thickness direction for a gasket.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gasketThicknessBehavior
import odbMaterial
session.odbs[name].materials[name].gasketThicknessBehavior

The table data for this object are:

  • If *variableUnits*=STRESS, the loading table data specify the following:
    • Pressure; this value must be positive.

    • Closure; this value must be positive.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *variableUnits*=FORCE, the loading table data specify the following:
    • Force or force per unit length; this value must be positive.

    • Closure; this value must be positive.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If variableUnits*=STRESS and *type*=ELASTIC_PLASTIC, the *unloadingTable data specify the following:
    • Pressure; this value must be positive.

    • Closure; this value must be positive.

    • Plastic closure; this value must be positive.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If variableUnits*=FORCE and *type*=ELASTIC_PLASTIC, the *unloadingTable data specify the following:
    • Pressure; this value must be positive.

    • Closure; this value must be positive.

    • Plastic closure; this value must be positive.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If variableUnits*=STRESS and *type*=DAMAGE, the *unloadingTable data specify the following:
    • Pressure; this value must be positive.

    • Closure; this value must be positive.

    • Maximum closure reached while loading the gasket; this value must be positive.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If variableUnits*=FORCE and *type*=DAMAGE, the *unloadingTable data specify the following:
    • Force or force per unit length; this value must be positive.

    • Closure; this value must be positive.

    • Maximum closure reached while loading the gasket; this value must be positive.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • GASKET THICKNESS BEHAVIOR

Methods

setValues()

This method modifies the GasketThicknessBehavior object.

GasketTransverseShearElastic#

class GasketTransverseShearElastic(table: tuple, variableUnits: SymbolicConstantType = 'STRESS', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The GasketTransverseShearElastic object defines the elastic parameters for the transverse shear behavior of a gasket.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gasketTransverseShearElastic
import odbMaterial
session.odbs[name].materials[name].gasketTransverseShearElastic

The table data for this object are:

  • Shear stiffness. (This value cannot be negative.)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • GASKET ELASTICITY

Methods

setValues()

This method modifies the GasketTransverseShearElastic object.

Multiscale#

MeanFieldHomogenization#

class MeanFieldHomogenization(angleSubdivision: int | None = None, formulation: SymbolicConstantType = 'MT', isotropization: SymbolicConstantType = 'ALLISO', uniformMatrixStrain: SymbolicConstantType = 'NO')[source]#

The MeanFieldHomogenization object specifies the multiscale material definition.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].meanFieldHomogenization
import odbMaterial
session.odbs[name].materials[name].meanFieldHomogenization

The corresponding analysis keywords are:

  • MEAN FIELD HOMOGENIZATION

Methods

setValues()

This method modifies the MeanFieldHomogenization object.

MeanFieldInclusion#

class MeanFieldInclusion(name: str, table: tuple, material: str = '', isotropizationCoefficient: float | None = None, volumeFractionType: SymbolicConstantType = 'UNIFORM', volumeFractionFieldName: str = '', aspectRatioType: SymbolicConstantType = 'UNIFORM', aspectRatioFieldName: str = '', orientationTensorType: SymbolicConstantType = 'UNIFORM', orientationTensorFieldName: str = '', shape: SymbolicConstantType = 'SPHERE', direction: SymbolicConstantType | None = None, strainConcentrationTensor: tuple = (), temperatureGradientConcentrationTensor: tuple = ())[source]#

The MeanFieldInclusion object specifies the inclusion type multiscale material property.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].constituents[name]
import odbMaterial
session.odbs[name].materials[name].constituents[name]

The table data for this object are:

  • Volume fraction.

  • Aspect ratio.

  • Components of the direction vector defined in the local coordinate system when *direction*=FIXED. Components of the second-order orientation tensor in the local coordinate system when *direction*=ORIENTATION_TENSOR.

  • Etc.

The corresponding analysis keywords are:

  • CONSTITUENT

Methods

setValues()

This method modifies the MeanFieldInclusion object.

MeanFieldMatrix#

class MeanFieldMatrix(name: str, material: str = '', isotropizationCoefficient: float | None = None)[source]#

The MeanFieldMatrix object specifies the matrix property.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].constituents[name]
import odbMaterial
session.odbs[name].materials[name].constituents[name]

The corresponding analysis keywords are:

  • CONSTITUENT

Methods

setValues()

This method modifies the MeanFieldMatrix object.

MeanFieldVoid#

class MeanFieldVoid(name: str, table: tuple, material: str = '', isotropizationCoefficient: float | None = None, volumeFractionType: SymbolicConstantType = 'UNIFORM', volumeFractionFieldName: str = '', aspectRatioType: SymbolicConstantType = 'UNIFORM', aspectRatioFieldName: str = '', orientationTensorType: SymbolicConstantType = 'UNIFORM', orientationTensorFieldName: str = '', shape: SymbolicConstantType = 'SPHERE', direction: SymbolicConstantType | None = None, strainConcentrationTensor: tuple = (), temperatureGradientConcentrationTensor: tuple = ())[source]#

The MeanFieldVoid object specifies the void inclusion property.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].constituents[name]
import odbMaterial
session.odbs[name].materials[name].constituents[name]

The table data for this object are:

  • Volume fraction.

  • Aspect ratio.

  • Components of the direction vector defined in the local coordinate system when *direction*=FIXED. Components of the second-order orientation tensor in the local coordinate system when *direction*=ORIENTATION_TENSOR.

  • Etc.

The corresponding analysis keywords are:

  • CONSTITUENT

Methods

setValues()

This method modifies the MeanFieldVoid object.

Others#

Acoustic#

AcousticMedium#
class AcousticMedium(acousticVolumetricDrag: BooleanType = 0, temperatureDependencyB: BooleanType = 0, temperatureDependencyV: BooleanType = 0, dependenciesB: int = 0, dependenciesV: int = 0, bulkTable: tuple = (), volumetricTable: tuple = ())[source]#

The AcousticMedium object specifies the acoustic properties of a material.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].acousticMedium
import odbMaterial
session.odbs[name].materials[name].acousticMedium

The corresponding analysis keywords are:

  • ACOUSTIC MEDIUM

Methods

setValues()

This method modifies the AcousticMedium object.

Electromagnetic#

Dielectric#
class Dielectric(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Dielectric object specifies dielectric material properties.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].dielectric
import odbMaterial
session.odbs[name].materials[name].dielectric

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • Dielectric constant.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • Dφ11.

    • Dφ2φ.

    • Dφ3φ.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • Dφ11.

    • Dφ12.

    • Dφ22.

    • Dφ13.

    • Dφ23.

    • Dφ33.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • DIELECTRIC

Methods

setValues()

This method modifies the Dielectric object.

ElectricalConductivity#
class ElectricalConductivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ElectricalConductivity object specifies electrical conductivity.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].electricalConductivity
import odbMaterial
session.odbs[name].materials[name].electricalConductivity

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • Electrical conductivity.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • σE1E.

    • σE2E.

    • σE3E.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • σ11E.

    • σ12E.

    • σE2E.

    • σE3E.

    • σE3E.

    • σE3E.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • ELECTRICAL CONDUCTIVITY

Methods

setValues()

This method modifies the ElectricalConductivity object.

MagneticPermeability#
class MagneticPermeability(table: tuple, table2: tuple, table3: tuple, type: SymbolicConstantType = 'ISOTROPIC', frequencyDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, nonlinearBH: BooleanType = 0)[source]#

The MagneticPermeability object specifies magnetic permeability.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].magneticPermeability
import odbMaterial
session.odbs[name].materials[name].magneticPermeability

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • Magnetic permeability.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ISOTROPIC, and *nonlinearBH*=TRUE, the table data specify the following:
    • Magntitude of the magnetic flux density vector.

    • Magnitude of the magnetic field vector.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • μ11E.

    • μ22E.

    • μ33E.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, and *nonlinearBH*=TRUE, the table data specify the following:
    • Magntitude of the magnetic flux density vector in the first direction.

    • Magnitude of the magnetic field vector in the second direction.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • μ11E.

    • μ12E.

    • μ22E.

    • μ13E.

    • μ23E.

    • μ33E.

    • Frequency, if the data depend on frequency.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • MAGNETIC PERMEABILITY

Methods

setValues()

This method modifies the MagneticPermeability object.

Piezoelectric#
class Piezoelectric(table: tuple, type: SymbolicConstantType = 'STRESS', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Piezoelectric object specifies piezoelectric material properties.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].piezoelectric
import odbMaterial
session.odbs[name].materials[name].piezoelectric

The table data for this object are:

  • If *type*=STRESS, the table data specify the following:
    • e1 11φ.

    • e1 22φ.

    • e1 33φ.

    • e1 12φ.

    • e1 13φ.

    • e1 23φ.

    • e2 11φ.

    • e2 22φ.

    • e2 33φ.

    • e2 12φ.

    • e2 13φ.

    • e2 23φ.

    • e3 11φ.

    • e3 22φ.

    • e3 33φ.

    • e3 12φ.

    • e3 13φ.

    • e3 23φ.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=STRAIN, the table data specify the following:
    • d1 11φ.

    • d1 22φ.

    • d1 33φ.

    • d1 12φ.

    • d1 13φ.

    • d1 23φ.

    • d2 11φ.

    • d2 22φ.

    • d2 33φ.

    • d2 12φ.

    • d2 13φ.

    • d2 23φ.

    • d3 11φ.

    • d3 22φ.

    • d3 33φ.

    • d3 13φ.

    • d3 23φ.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • PIEZOELECTRIC

Methods

setValues()

This method modifies the Piezoelectric object.

HeatTransfer#

Conductivity#
class Conductivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Conductivity object specifies thermal conductivity.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].conductivity
import odbMaterial
session.odbs[name].materials[name].conductivity

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • Conductivity, k.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • k11.

    • k22.

    • k33.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • k11.

    • k12.

    • k22.

    • k13.

    • k23.

    • k33.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CONDUCTIVITY

Methods

setValues()

This method modifies the Conductivity object.

HeatGeneration#
class HeatGeneration[source]#

The HeatGeneration object includes volumetric heat generation in heat transfer analyses.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].heatGeneration
import odbMaterial
session.odbs[name].materials[name].heatGeneration

The corresponding analysis keywords are:

  • HEAT GENERATION

InelasticHeatFraction#
class InelasticHeatFraction(fraction: float = 0)[source]#

The InelasticHeatFraction object defines the fraction of the rate of inelastic dissipation that appears as a heat source.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].inelasticHeatFraction
import odbMaterial
session.odbs[name].materials[name].inelasticHeatFraction

The corresponding analysis keywords are:

  • INELASTIC HEAT FRACTION

Methods

setValues()

This method modifies the InelasticHeatFraction object.

JouleHeatFraction#
class JouleHeatFraction(fraction: float = 1)[source]#

The JouleHeatFraction object defines the fraction of electric energy released as heat.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].jouleHeatFraction
import odbMaterial
session.odbs[name].materials[name].jouleHeatFraction

The corresponding analysis keywords are:

  • JOULE HEAT FRACTION

Methods

setValues()

This method modifies the JouleHeatFraction object.

LatentHeat#
class LatentHeat(table: tuple)[source]#

The LatentHeat object specifies a material’s latent heat.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].latentHeat
import odbMaterial
session.odbs[name].materials[name].latentHeat

The table data for this object are:

  • Latent heat per unit mass.

  • Solidus temperature.

  • Liquidus temperature.

The corresponding analysis keywords are:

  • LATENT HEAT

Methods

setValues()

This method modifies the LatentHeat object.

SpecificHeat#
class SpecificHeat(table: tuple, law: SymbolicConstantType = 'CONSTANTVOLUME', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The SpecificHeat object specifies a material’s specific heat.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].specificHeat
import odbMaterial
session.odbs[name].materials[name].specificHeat

The table data for this object are:

  • Specific heat per unit mass.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • SPECIFIC HEAT

Methods

setValues()

This method modifies the SpecificHeat object.

Hydrodynamic#

MassDiffusion#

Diffusivity#
class Diffusivity(table: tuple, type: SymbolicConstantType = 'ISOTROPIC', law: SymbolicConstantType = 'GENERAL', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Diffusivity object specifies mass diffusivity.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].diffusivity
import odbMaterial
session.odbs[name].materials[name].diffusivity

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • Diffusivity, D.

    • Concentration, c.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • D11.

    • D22.

    • D33.

    • Concentration, c.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • D11.

    • D12.

    • D22.

    • D13.

    • D23.

    • D33.

    • Concentration, c.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • DIFFUSIVITY

Methods

setValues()

This method modifies the Diffusivity object.

PressureEffect#
class PressureEffect(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The PressureEffect object defines equivalent pressure stress driven mass diffusion.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].diffusivity.pressureEffect
import odbMaterial
session.odbs[name].materials[name].diffusivity.pressureEffect

The table data for this object are:

  • Pressure stress factor, κp.

  • Concentration.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • KAPPA

Methods

setValues()

This method modifies the PressureEffect object.

Solubility#
class Solubility(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Solubility object specifies solubility.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].solubility
import odbMaterial
session.odbs[name].materials[name].solubility

The table data for this object are:

  • Solubility.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • SOLUBILITY

Methods

setValues()

This method modifies the Solubility object.

SoretEffect#
class SoretEffect(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The SoretEffect object defines temperature gradient driven mass diffusion.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].diffusivity.soretEffect
import odbMaterial
session.odbs[name].materials[name].diffusivity.soretEffect

The table data for this object are:

  • Soret effect factor, κs.

  • Concentration.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • KAPPA

Methods

setValues()

This method modifies the SoretEffect object.

Mechanical#

Damping#
class Damping(alpha: float = 0, beta: float = 0, composite: float = 0, structural: float = 0)[source]#

The Damping object specifies material damping.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].damping
import odbMaterial
session.odbs[name].materials[name].damping

The corresponding analysis keywords are:

  • DAMPING

Methods

setValues()

This method modifies the Damping object.

Expansion#
class Expansion(type: SymbolicConstantType = 'ISOTROPIC', userSubroutine: BooleanType = 0, zero: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, table: tuple = ())[source]#

The Expansion object specifies thermal expansion.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].expansion
import odbMaterial
session.odbs[name].materials[name].expansion

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • α in Abaqus/Standard or Abaqus/Explicit analysis.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • α11.

    • α22.

    • α33.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • α11.

    • α22.

    • α33. (Not used for plane stress case.)

    • α12.

    • α13.

    • α23.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=SHORT_FIBER, there is no table data.

The corresponding analysis keywords are:

  • EXPANSION

Methods

setValues()

This method modifies the Expansion object.

PoreFluidExpansion#
class PoreFluidExpansion(table: tuple, zero: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The PoreFluidExpansion object specifies the thermal expansion coefficient for a hydraulic fluid.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].poreFluidExpansion
import odbMaterial
session.odbs[name].materials[name].poreFluidExpansion

The table data for this object are:

  • Mean coefficient of thermal expansion, α.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • EXPANSION

Methods

setValues()

This method modifies the PoreFluidExpansion object.

Viscosity#
Trs#
class Trs(definition: SymbolicConstantType = 'WLF', table: tuple = ())[source]#

The Trs object defines the temperature-time shift for time history viscoelastic analysis.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].viscoelastic.trs
mdb.models[name].materials[name].viscosity.trs
import odbMaterial
session.odbs[name].materials[name].viscoelastic.trs
session.odbs[name].materials[name].viscosity.trs

The table data for this object are:

  • Reference temperature, θ0θ0.

  • Calibration constant, C1C1.

  • Calibration constant, C2C2.

The corresponding analysis keywords are:

  • TRS

Methods

setValues()

This method modifies the Trs object.

Viscosity#
class Viscosity(table: tuple, type: SymbolicConstantType = 'NEWTONIAN', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Viscosity object specifies mechanical viscosity.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].viscosity
import odbMaterial
session.odbs[name].materials[name].viscosity

The table data for this object are:

  • If *type*=NEWTONIAN, the table data specify the following:

    • Viscosity, k.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • VISCOSITY

Methods

setValues()

This method modifies the Viscosity object.

PoreFluidFlow#

FluidLeakoff#
class FluidLeakoff(temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'COEFFICIENTS', table: tuple = ())[source]#

The FluidLeakoff object specifies leak-off coefficients for pore pressure cohesive elements.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].fluidLeakoff
import odbMaterial
session.odbs[name].materials[name].fluidLeakoff

The table data for this object are: The table data specify the following:

  • Fluid leak-off coefficient at top element surface.

  • Fluid leak-off coefficient at bottom element surface.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • FLUID LEAKOFF

Methods

setValues()

This method modifies the FluidLeakoff object.

Gel#
class Gel(table: tuple)[source]#

The Gel object defines a swelling gel.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].gel
import odbMaterial
session.odbs[name].materials[name].gel

The table data for this object are:

  • Radius of gel particles when completely dry, radry.

  • Fully swollen radius of gel particles, raf.

  • Number of gel particles per unit volume, ka.

  • Relaxation time constant for long-term swelling of gel particles, τ1.

The corresponding analysis keywords are:

  • GEL

Methods

setValues()

This method modifies the Gel object.

MoistureSwelling#
MoistureSwelling#
class MoistureSwelling(table: tuple)[source]#

The MoistureSwelling object defines moisture-driven swelling.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].moistureSwelling
import odbMaterial
session.odbs[name].materials[name].moistureSwelling

The table data for this object are:

  • Volumetric moisture swelling strain, εm⁢s.

  • Saturation, s. This value must lie in the range 0≤s≤1.0.

The corresponding analysis keywords are:

  • MOISTURE SWELLING

Methods

setValues()

This method modifies the MoistureSwelling object.

Permeability#
Permeability#
class Permeability(specificWeight: float, inertialDragCoefficient: float, table: tuple, type: SymbolicConstantType = 'ISOTROPIC', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Permeability object defines permeability for pore fluid flow.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].permeability
import odbMaterial
session.odbs[name].materials[name].permeability

The table data for this object are:

  • If *type*=ISOTROPIC, the table data specify the following:
    • Void ratio, e.

    • Temperature, if the data depend on temperature.

  • If *type*=ORTHOTROPIC, the table data specify the following:
    • k11.

    • k22.

    • k33.

    • Void ratio, e.

    • Temperature, if the data depend on temperature.

  • If *type*=ANISOTROPIC, the table data specify the following:
    • k11.

    • k12.

    • k22.

    • k13.

    • k23.

    • k33.

    • Void ratio, e.

    • Temperature, if the data depend on temperature.

The corresponding analysis keywords are:

  • PERMEABILITY

Methods

setValues()

This method modifies the Permeability object.

SaturationDependence#
class SaturationDependence(table: tuple)[source]#

The SaturationDependence object specifies the dependence of the permeability of a material on the saturation of the wetting liquid.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].permeability.saturationDependence
import odbMaterial
session.odbs[name].materials[name].permeability.saturationDependence

The table data for this object are:

  • ks. (Dimensionless.)

  • Saturation, s. (Dimensionless.)

The corresponding analysis keywords are:

  • PERMEABILITY

Methods

setValues()

This method modifies the SaturationDependence object.

VelocityDependence#
class VelocityDependence(table: tuple)[source]#

The VelocityDependence object specifies the dependence of the permeability of a material on the velocity of fluid flow.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].permeability.velocityDependence
import odbMaterial
session.odbs[name].materials[name].permeability.velocityDependence

The table data for this object are:

  • β. Only β> 0.0 is allowed.

  • Void ratio, ee.

The corresponding analysis keywords are:

  • PERMEABILITY

Methods

setValues()

This method modifies the VelocityDependence object.

PorousBulkModuli#
class PorousBulkModuli(table: tuple, temperatureDependency: BooleanType = 0)[source]#

The PorousBulkModuli object defines bulk moduli for soils and rocks.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].porousBulkModuli
import odbMaterial
session.odbs[name].materials[name].porousBulkModuli

The table data for this object are:

  • Bulk modulus of solid grains.

  • Bulk modulus of permeating fluid.

  • Temperature, if the data depend on temperature.

The corresponding analysis keywords are:

  • POROUS BULK MODULI

Methods

setValues()

This method modifies the PorousBulkModuli object.

Sorption#
class Sorption(absorptionTable: tuple, lawAbsorption: SymbolicConstantType = 'TABULAR', exsorption: BooleanType = 0, lawExsorption: SymbolicConstantType = 'TABULAR', scanning: float = 0, exsorptionTable: tuple = ())[source]#

The Sorption object defines absorption and exsorption behaviors of a partially saturated porous medium in the analysis of coupled wetting liquid flow and porous medium stress.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].sorption
import odbMaterial
session.odbs[name].materials[name].sorption

The table data for this object are:

  • If lawAbsorption*=TABULAR or *lawExsorption*=TABULAR, the *absorptionTable and exsorptionTable data respectively specify the following:

    • Pore pressure, uw.

    • Saturation, s.

  • If lawAbsorption*=LOG or *lawExsorption*=LOG, the *absorptionTable and exsorptionTable data respectively specify the following:

    • s0.

    • s1.

The corresponding analysis keywords are:

  • SORPTION

Methods

setValues()

This method modifies the Sorption object.

User#

Depvar#
class Depvar(deleteVar: int = 0, n: int = 0)[source]#

The Depvar object specifies solution-dependent state variables.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].depvar
import odbMaterial
session.odbs[name].materials[name].depvar

The corresponding analysis keywords are:

  • DEPVAR

Methods

setValues()

This method modifies the Depvar object.

UserDefinedField#
class UserDefinedField[source]#

The UserDefinedField object redefines field variables at a material point.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].userDefinedField
import odbMaterial
session.odbs[name].materials[name].userDefinedField

The corresponding analysis keywords are:

  • USER DEFINED FIELD

UserMaterial#
class UserMaterial(type: SymbolicConstantType = 'MECHANICAL', unsymm: BooleanType = 0, mechanicalConstants: tuple = (), thermalConstants: tuple = (), effmod: BooleanType = 0, hybridFormulation: SymbolicConstantType = 'INCREMENTAL')[source]#

The UserMaterial object defines material constants for use in subroutines UMAT, UMATHT, or VUMAT.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].userMaterial
import odbMaterial
session.odbs[name].materials[name].userMaterial

The corresponding analysis keywords are:

  • USER MATERIAL

Methods

setValues()

This method modifies the UserMaterial object.

UserOutputVariables#
class UserOutputVariables(n: int = 0)[source]#

The UserOutputVariables object specifies the number of user-defined output variables.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].userOutputVariables
import odbMaterial
session.odbs[name].materials[name].userOutputVariables

The corresponding analysis keywords are:

  • USER OUTPUT VARIABLES

Methods

setValues()

This method modifies the UserOutputVariables object.

Plastic#

Concrete#

BrittleCracking#
class BrittleCracking(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'STRAIN')[source]#

The BrittleCracking object specifies cracking and postcracking properties for the brittle cracking material model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].brittleCracking
import odbMaterial
session.odbs[name].materials[name].brittleCracking

The table data for this object are:

  • If *type*=STRAIN the table data specify the following:
    • Remaining direct stress after cracking.

    • Direct cracking strain.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT the table data specify the following:
    • Remaining direct stress after cracking.

    • Direct cracking displacement.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=GFI the table data specify the following:
    • Failure stress.

    • Mode I fracture energy.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • BRITTLE CRACKING

Methods

setValues()

This method modifies the BrittleCracking object.

BrittleFailure#
class BrittleFailure(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, failureCriteria: SymbolicConstantType = 'UNIDIRECTIONAL')[source]#

The BrittleFailure object specifies the brittle failure of the material.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].brittleCracking.brittleFailure
import odbMaterial
session.odbs[name].materials[name].brittleCracking.brittleFailure

The table data for this object are:

The corresponding analysis keywords are:

  • BRITTLE FAILURE

Methods

setValues()

This method modifies the BrittleFailure object.

BrittleShear#
class BrittleShear(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, type: SymbolicConstantType = 'RETENTION_FACTOR')[source]#

The BrittleShear object specifies the postcracking shear behavior of a material used in a brittle cracking model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].brittleCracking.brittleShear
import odbMaterial
session.odbs[name].materials[name].brittleCracking.brittleShear

The table data for this object are:

  • If *type*=RETENTION_FACTOR the table data specify the following:
    • Shear retention factor.

    • Crack opening strain.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=POWER_LAW the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • BRITTLE SHEAR

Methods

setValues()

This method modifies the BrittleShear object.

Concrete#
class Concrete(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Concrete object defines concrete properties beyond the elastic range.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concrete
import odbMaterial
session.odbs[name].materials[name].concrete

The table data for this object are:

  • Absolute value of compressive stress.

  • Absolute value of Plastic strain.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CONCRETE

Methods

setValues()

This method modifies the Concrete object.

ConcreteCompressionDamage#
class ConcreteCompressionDamage(table: tuple, tensionRecovery: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ConcreteCompressionDamage object specifies hardening for the concrete damaged plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concreteDamagedPlasticity.concreteCompressionDamage
import odbMaterial
session.odbs[name].materials[name].concreteDamagedPlasticity.concreteCompressionDamage

The table data for this object are:

  • Compressive damage variable, dc.

  • Plastic (crushing) strain, ϵci⁢n.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CONCRETE COMPRESSION DAMAGE

Methods

setValues()

This method modifies the ConcreteCompressionDamage object.

ConcreteCompressionHardening#
class ConcreteCompressionHardening(table: tuple, rate: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ConcreteCompressionHardening object specifies hardening for the concrete damaged plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concreteDamagedPlasticity.concreteCompressionHardening
import odbMaterial
session.odbs[name].materials[name].concreteDamagedPlasticity.concreteCompressionHardening

The table data for this object are:

  • Yield stress in compression, σcσc.

  • Plastic (crushing) strain, ϵinc

  • Plastic (crushing) strain rate, ϵinc

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CONCRETE COMPRESSION HARDENING

Methods

setValues()

This method modifies the ConcreteCompressionHardening object.

ConcreteDamagedPlasticity#
class ConcreteDamagedPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ConcreteDamagedPlasticity object specifies the concrete damaged plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concreteDamagedPlasticity
import odbMaterial
session.odbs[name].materials[name].concreteDamagedPlasticity

The table data for this object are:

  • Dilation angle, ψ (in degrees) in the p–q plane.

  • Flow potential eccentricity, ϵ. The default value is 0.1.

  • σb0/σt0σb⁢0/σt⁢0, the ratio of initial equibiaxial compressive yield stress to initial uniaxial compressive yield stress. The default value is 1.16.

  • Kc, the ratio of the second stress invariant on the tensile meridian, to that on the compressive meridian, at initial yield for any given value of the pressure invariant p such that the maximum principal stress is negative. The default value is 2/3.

  • Viscosity parameter, μ, used for the viscoplastic regularization of the concrete constitutive equations in an Abaqus/Standard analysis. This parameter is ignored in an Abaqus/Explicit analysis. The default value is 0.0.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CONCRETE DAMAGED PLASTICITY

Methods

setValues()

This method modifies the ConcreteDamagedPlasticity object.

ConcreteTensionDamage#
class ConcreteTensionDamage(table: tuple, compressionRecovery: float = 1, type: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ConcreteTensionDamage object specifies hardening for the concrete damaged plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concreteDamagedPlasticity.concreteTensionDamage
import odbMaterial
session.odbs[name].materials[name].concreteDamagedPlasticity.concreteTensionDamage

The table data for this object are:

  • If *type*=STRAIN, the table data specify the following:
    • Tensile damage variable, dt.

    • Direct cracking strain, ϵtc⁢k.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, the table data specify the following:
    • Tensile damage variable, dt.

    • Direct cracking displacement, utc⁢k.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CONCRETE TENSION DAMAGE

Methods

setValues()

This method modifies the ConcreteTensionDamage object.

ConcreteTensionStiffening#
class ConcreteTensionStiffening(table: tuple, rate: BooleanType = 0, type: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ConcreteTensionStiffening object specifies hardening for the concrete damaged plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concreteDamagedPlasticity.concreteTensionStiffening
import odbMaterial
session.odbs[name].materials[name].concreteDamagedPlasticity.concreteTensionStiffening

The table data for this object are:

  • If *type*=STRAIN, the table data specify the following:
    • Remaining direct stress after cracking, σt.

    • Direct cracking strain, ϵckt.

    • Direct cracking strain rate, ˙ϵckt.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, the table data specify the following:
    • Remaining direct stress after cracking, σt.

    • Direct cracking displacement, uckt.

    • Direct cracking displacement rate, ˙uckt

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=GFI, the table data specify the following:
    • Failure stress, σt0σt⁢0.

    • Fracture energy, Gf.

    • Direct cracking displacement rate, ˙uckt.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CONCRETE TENSION STIFFENING

Methods

setValues()

This method modifies the ConcreteTensionStiffening object.

FailureRatios#
class FailureRatios(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The FailureRatios object specifies the shape of the failure surface for a Concrete model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concrete.failureRatios
import odbMaterial
session.odbs[name].materials[name].concrete.failureRatios

The table data for this object are:

  • Ratio of the ultimate biaxial compressive stress to the uniaxial compressive ultimate stress. The default value is 1.16.

  • Absolute value of the ratio of the uniaxial tensile stress at failure to the uniaxial compressive stress at failure. The default value is 0.09.

  • Ratio of the magnitude of a principal component of Plastic strain at ultimate stress in biaxial compression to the Plastic strain at ultimate stress in uniaxial compression. The default value is 1.28.

  • Ratio of the tensile principal stress value at shear in plane stress, when the other nonzero principal stress component is at the ultimate compressive stress value, to the tensile cracking stress under uniaxial tension. The default value is 1/3.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • FAILURE RATIOS

Methods

setValues()

This method modifies the FailureRatios object.

ShearRetention#
class ShearRetention(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ShearRetention object defines the reduction of the shear modulus associated with crack surfaces in a Concrete model as a function of the tensile strain across the crack.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concrete.shearRetention
import odbMaterial
session.odbs[name].materials[name].concrete.shearRetention

The table data for this object are:

  • ϱclose for dry concrete. The default value is 1.0.

  • εmax for dry concrete. The default value is a very large number (full shear retention).

  • ϱclose for wet concrete. The default value is 1.0.

  • εmax for wet concrete. The default value is a very large number (full shear retention).

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • SHEAR RETENTION

Methods

setValues()

This method modifies the ShearRetention object.

TensionStiffening#
class TensionStiffening(table: tuple, type: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The TensionStiffening object defines the retained tensile stress normal to a crack in a Concrete model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].concrete.tensionStiffening
import odbMaterial
session.odbs[name].materials[name].concrete.tensionStiffening

The table data for this object are:

  • If *type*=STRAIN, the table data specify the following:
    • Fraction of remaining stress to stress at cracking.

    • Absolute value of the direct strain minus the direct strain at cracking.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, the table data specify the following:
    • Displacement, u0u0, at which a linear loss of strength after cracking gives zero stress.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • TENSION STIFFENING

Methods

setValues()

This method modifies the TensionStiffening object.

Creep#

Creep#
class Creep(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL')[source]#

The Creep object defines a creep law.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].creep
import odbMaterial
session.odbs[name].materials[name].creep

The table data for this object are:

  • If *law*=STRAIN or *law*=TIME, the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=HYPERBOLIC_SINE, the table data specify the following:
    • △⁢H, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=ANAND, the table data specify the following:
    • s1.

    • QR.

    A. - ξ. - m. - A0. - ˆS. - n. - a. - S2. - S3. - A1. - A2. - A3. - A4.

  • If *law*=DARVEAUX, the table data specify the following:
    • Css.

    • QR.

    • α.

    • ϵT.

  • If *law*=DOUBLE_POWER, the table data specify the following:
    • A1.

    • B1.

    • C1.

    • A2.

    • B2.

    • C2.

    • σ0.

  • If *law*=POWER_LAW or *law*=TIME_POWER_LAW, the table data specify the following:
    • q0.

    • ∙ε0•.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CREEP

Methods

setValues()

This method modifies the Creep object.

CriticalStateClay#

ClayHardening#
class ClayHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ClayHardening object specifies hardening for the clay plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].clayPlasticity.clayHardening
import odbMaterial
session.odbs[name].materials[name].clayPlasticity.clayHardening

The table data for this object are:

  • The hydrostatic pressure stress at yield, pc.

  • The absolute value of the corresponding volumetric Plastic strain.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CLAY HARDENING

Methods

setValues()

This method modifies the ClayHardening object.

ClayPlasticity#
class ClayPlasticity(table: tuple, intercept: float | None = None, hardening: SymbolicConstantType = 'EXPONENTIAL', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The ClayPlasticity object specifies the extended Cam-clay plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].clayPlasticity
import odbMaterial
session.odbs[name].materials[name].clayPlasticity

The table data for this object are:

  • If *hardening*=EXPONENTIAL, the table data specify the following:
    • Logarithmic Plastic bulk modulus, λ (dimensionless).

    • Stress ratio at critical state, M.

    • The initial yield surface size, a0.

    • ββ, the parameter defining the size of the yield surface on the “wet” side of critical state.

    • KK, the ratio of the flow stress in triaxial tension to the flow stress in triaxial compression. 0.778≤K≤1.0. If the default value of 0.0 is accepted, a value of 1.0 is assumed.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *hardening*=TABULAR, the table data specify the following:
    • Stress ratio at critical state, M.

    • The initial volumetric Plastic strain, ε_vol^pl∣0, corresponding to pc|0according to the [ClayHardening](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-c-clayhardeningpyc.htm?ContextScope=all) definition.

    • ββ, the parameter defining the size of the yield surface on the “wet” side of critical state.

    • KK, the ratio of the flow stress in triaxial tension to the flow stress in triaxial compression. 0.778≤K≤1.0.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CLAY PLASTICITY

Methods

setValues()

This method modifies the ClayPlasticity object.

CrushableFoam#

CrushableFoam#
class CrushableFoam(table: tuple, hardening: SymbolicConstantType = 'VOLUMETRIC', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CrushableFoam object specifies the crushable foam plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].crushableFoam
import odbMaterial
session.odbs[name].materials[name].crushableFoam

The table data for this object are:

  • If *hardening*=VOLUMETRIC, the table data specify the following:
    • Ratio, k, of initial yield stress in uniaxial compression, σc0, to initial yield stress in hydrostatic compression, p0cpc0; 0.0 <k< 3.0.

    • Ratio, kt, of yield stress in hydrostatic tension, pt, to initial yield stress in hydrostatic compression, pc0. The default value is 1.0.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *hardening*=ISOTROPIC, the table data specify the following:
    • Ratio, k, of initial yield stress in uniaxial compression, σ0cσc0, to initial yield stress in hydrostatic compression, p00; 0.0 ≤k≤ 3.0.

    • Plastic Poisson’s ratio.νpνp; -1≤νp≤0.5.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CRUSHABLE FOAM

Methods

setValues()

This method modifies the CrushableFoam object.

CrushStress#

CrushStress#
class CrushStress(crushStressTable: tuple[tuple[float, ...]], temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CrushStress object specifies the crush stress of a material.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].crushStress
import odbMaterial
session.odbs[name].materials[name].crushStress

The table data for this object are:

  • Scaling factor.

  • Relative velocity.

The corresponding analysis keywords are:

  • CRUSH STRESS

Attributes:
crushStressTable: tuple[tuple[float, …]]

A sequence of sequences of Floats specifying the items described below.

temperatureDependency: Boolean

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies: int

An Int specifying the number of field variable dependencies. The default value is 0.

crushStressVelocityFactor: CrushStressVelocityFactor

A CrushStressVelocityFactor object.

Methods

setValues([crushStressTable, ...])

This method creates a CrushStress object.

CrushStressVelocityFactor#
class CrushStressVelocityFactor(crushStressVelocityFactorTable: tuple[tuple[float, ...]])[source]#

The CrushStressVelocityFactor object defines how the approach velocity at a crushing interface influences a material’s resistance to crushing.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].crushStress.crushStressVelocityFactor
import odbMaterial
session.odbs[name].materials[name].crushStress.crushStressVelocityFactor

The table data for this object are:

  • Scaling factor.

  • Relative velocity.

The corresponding analysis keywords are:

  • CRUSH STRESS VELOCITY FACTOR

Attributes:
crushStressVelocityFactorTable: tuple[tuple[float, …]]

A sequence of sequences of Floats specifying the items described below.

Methods

setValues([crushStressVelocityFactorTable])

This method creates a CrushStressVelocityFactor object.

CrushableFoamHardening#
class CrushableFoamHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CrushableFoamHardening object specifies hardening for the crushable foam plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].crushableFoam.crushableFoamHardening
import odbMaterial
session.odbs[name].materials[name].crushableFoam.crushableFoamHardening

The table data for this object are:

  • The yield stress in uniaxial compression, σcσc.

  • The absolute value of the corresponding Plastic strain.(The first tabular value entered must always be zero.)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CRUSHABLE FOAM HARDENING

Methods

setValues()

This method modifies the CrushableFoamHardening object.

DruckerPrager#

Extended#
DruckerPrager#
class DruckerPrager(table: tuple, shearCriterion: SymbolicConstantType = 'LINEAR', eccentricity: float = 0, testData: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The DruckerPrager object specifies the extended Drucker-Prager plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].druckerPrager
import odbMaterial
session.odbs[name].materials[name].druckerPrager

The table data for this object are:

  • If *shearCriterion*=LINEAR (the only option allowed in an Abaqus/Explicit analysis), the table data specify the following:
    • Material angle of friction, β, in the p–t plane. Give the value in degrees.

    • K, the ratio of the flow stress in triaxial tension to the flow stress in triaxial compression. 0.778≤K≤1.0.

      If the default value of 0.0 is accepted, a value of 1.0 is assumed.

    • Dilation angle, ψ, in the p–t plane. Give the value in degrees.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *shearCriterion*=HYPERBOLIC, the table data specify the following:
    • Material angle of friction, β, at high confining pressure in the p–q plane. Give the value in degrees.

    • Initial hydrostatic tension strength, pt|0.

    • Dilation angle, ψ, at high confining pressure in the p–q plane. Give the value in degrees.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *shearCriterion*=EXPONENTIAL, the table data specify the following:
    • Dilation angle, ψ, at high confining pressure in the p–q plane. Give the value in degrees.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • DRUCKER PRAGER

Methods

setValues()

This method modifies the DruckerPrager object.

DruckerPragerCreep#
class DruckerPragerCreep(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The DruckerPragerCreep object specifies creep for Drucker-Prager plasticity models.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].druckerPrager.druckerPragerCreep
import odbMaterial
session.odbs[name].materials[name].druckerPrager.druckerPragerCreep

The table data for this object are:

  • If *law*=TIME or *law*=STRAIN, the table data specify the following:
    • AA. (Units of F-nL2nT−1−m.)

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=SINGHM, the table data specify the following:
      1. (Units of T−1.)

    • α. (Units of F−1L2.)

    • t1. (Units of T.)

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • DRUCKER PRAGER CREEP

Methods

setValues()

This method modifies the DruckerPragerCreep object.

DruckerPragerHardening#
class DruckerPragerHardening(table: tuple, type: SymbolicConstantType = 'COMPRESSION', rate: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The DruckerPragerHardening object specifies hardening for Drucker-Prager plasticity models.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].druckerPrager.druckerPragerHardening
import odbMaterial
session.odbs[name].materials[name].druckerPrager.druckerPragerHardening

The table data for this object are:

  • Yield stress.

  • Absolute value of the corresponding Plastic strain. (The first tabular value entered must always be zero.)

  • Equivalent Plastic strain rate, ˙¯εpl, for which this hardening curve applies.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • DRUCKER PRAGER HARDENING

Methods

setValues()

This method modifies the DruckerPragerHardening object.

TriaxialTestData#
class TriaxialTestData(table: tuple, a: float | None = None, b: float | None = None, pt: float | None = None)[source]#

The TriaxialTestData object provides triaxial test data.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].druckerPrager.triaxialTestData
import odbMaterial
session.odbs[name].materials[name].druckerPrager.triaxialTestData

The table data for this object are:

  • Sign and magnitude of confining stress, σ1=σ2.

  • Sign and magnitude of the stress in loading direction, σ3.

The corresponding analysis keywords are:

  • TRIAXIAL TEST DATA

Methods

setValues()

This method modifies the TriaxialTestData object.

ModifiedCap#
CapCreepCohesion#
class CapCreepCohesion(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL')[source]#

The CapCreepCohesion object specifies a cap creep model and material properties.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].capPlasticity.capCreepCohesion
import odbMaterial
session.odbs[name].materials[name].capPlasticity.capCreepCohesion

The table data for this object are:

  • If *law*=STRAIN or *law*=TIME, the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=SINGHM, the table data specify the following:
    • α.

    • t1.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=POWER_LAW or *law*=TIME_POWER_LAW, the table data specify the following:
    • q0.

    • ε0.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CAP CREEP

Methods

setValues()

This method modifies the CapCreepCohesion object.

CapCreepConsolidation#
class CapCreepConsolidation(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL')[source]#

The CapCreepConsolidation object specifies a cap creep model and material properties.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].capPlasticity.capCreepConsolidation
import odbMaterial
session.odbs[name].materials[name].capPlasticity.capCreepConsolidation

The table data for this object are:

  • If *law*=STRAIN or *law*=TIME, the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=SINGHM, the table data specify the following:
    • α.

    • t1.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=POWER_LAW or *law*=TIME_POWER_LAW, the table data specify the following:
    • q0.

    • .ε0.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • CAP CREEP

Methods

setValues()

This method modifies the CapCreepConsolidation object.

CapHardening#
class CapHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CapHardening object specifies Drucker-Prager/Cap plasticity hardening.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].capPlasticity.capHardening
import odbMaterial
session.odbs[name].materials[name].capPlasticity.capHardening

The table data for this object are:

  • Hydrostatic pressure yield stress.

  • Absolute value of the corresponding volumetric inelastic strain.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CAP HARDENING

Methods

setValues()

This method modifies the CapHardening object.

CapPlasticity#
class CapPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CapPlasticity object specifies the modified Drucker-Prager/Cap plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].capPlasticity
import odbMaterial
session.odbs[name].materials[name].capPlasticity

The table data for this object are:

  • Material cohesion, d, in the p–t plane (Abaqus/Standard) or in the p–q plane (Abaqus/Explicit).

  • Material angle of friction, β, in the p–t plane (Abaqus/Standard) or in the p–q plane (Abaqus/Explicit). Give the value in degrees.

  • Cap eccentricity parameter, RR. Its value must be greater than zero (typically 0.0 <R< 1.0).

  • Initial cap yield surface position, ε_vol^pl|0.

  • Transition surface radius parameter, αα. The default value is 0.0 (i.e., no transition surface).

  • (Not used in Abaqus/Explicit) K, the ratio of the flow stress in triaxial tension to the flow stress in triaxial compression. Possible values are 0.778 ≤K≤ 1.0. If the default value of 0.0 is accepted, Abaqus/Standard assumes K= 1.0.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CAP PLASTICITY

Methods

setValues()

This method modifies the CapPlasticity object.

Metal#

Annealing#
AnnealTemperature#
class AnnealTemperature(table: tuple, dependencies: int = 0)[source]#

The AnnealTemperature object specifies the material annealing temperature.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].Plastic.annealTemperature
import odbMaterial
session.odbs[name].materials[name].Plastic.annealTemperature

The table data for this object are:

  • The annealing temperature, θθ.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • ANNEAL TEMPERATURE

Methods

setValues()

This method modifies the AnnealTemperature object.

CastIron#
CastIronCompressionHardening#
class CastIronCompressionHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CastIronCompressionHardening object specifies hardening for the Cast- Iron plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].castIronPlasticity.castIronCompressionHardening
import odbMaterial
session.odbs[name].materials[name].castIronPlasticity.castIronCompressionHardening

The table data for this object are:

  • Yield stress in compression, σcσc.

  • The absolute value of the corresponding Plastic strain.(The first tabular value entered must always be zero.)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CAST IRON COMPRESSION HARDENING

Methods

setValues()

This method modifies the CastIronCompressionHardening object.

CastIronPlasticity#
class CastIronPlasticity(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CastIronPlasticity object specifies the Cast Iron plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].castIronPlasticity
import odbMaterial
session.odbs[name].materials[name].castIronPlasticity

The table data for this object are:

  • Plastic Poisson’s ratio, νp⁢l (dimensionless).

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CAST IRON PLASTICITY

Methods

setValues()

This method modifies the CastIronPlasticity object.

CastIronTensionHardening#
class CastIronTensionHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The CastIronTensionHardening object specifies hardening for the Cast- Iron plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].castIronPlasticity.castIronTensionHardening
import odbMaterial
session.odbs[name].materials[name].castIronPlasticity.castIronTensionHardening

The table data for this object are:

  • Yield stress in uniaxial tension, σt.

  • The absolute value of the corresponding Plastic strain.(The first tabular value entered must always be zero.)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CAST IRON TENSION HARDENING

Methods

setValues()

This method modifies the CastIronTensionHardening object.

Cyclic#
CycledPlastic#
class CycledPlastic(table: tuple, temperatureDependency: BooleanType = 0)[source]#

The CycledPlastic object specifies cycled yield stress data for the ORNL constitutive model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].Plastic.cycledPlastic
import odbMaterial
session.odbs[name].materials[name].Plastic.cycledPlastic

The table data for this object are:

  • Yield stress.

  • Plastic strain.

  • Temperature, if the data depend on temperature.

The corresponding analysis keywords are:

  • CYCLED PLASTIC

Methods

setValues()

This method modifies the CycledPlastic object.

CyclicHardening#
class CyclicHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0, parameters: BooleanType = 0)[source]#

The CyclicHardening object defines the evolution of the elastic domain for the nonlinear isotropic/kinematic hardening model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].Plastic.cyclicHardening
import odbMaterial
session.odbs[name].materials[name].Plastic.cyclicHardening

The table data for this object are:

  • Equivalent stress.

  • Q∞Q(only if *parameters*=ON).

  • Hardening parameter (only if *parameters*=ON).

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • CYCLIC HARDENING

Methods

setValues()

This method modifies the CyclicHardening object.

Deformation#
DeformationPlasticity#
class DeformationPlasticity(table: tuple, temperatureDependency: BooleanType = 0)[source]#

The DeformationPlasticity object specifies the deformation plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].deformationPlasticity
import odbMaterial
session.odbs[name].materials[name].deformationPlasticity

The table data for this object are:

  • Young’s modulus, E.

  • Poisson’s ratio, ν.

  • Yield stress, σ0.

  • Exponent, n.

  • Yield offset, α.

  • Temperature, if the data depend on temperature.

The corresponding analysis keywords are:

  • DEFORMATION PLASTICITY

Methods

setValues()

This method modifies the DeformationPlasticity object.

ORNL#
Ornl#
class Ornl(a: float = 0, h: float | None = None, reset: BooleanType = 0)[source]#

The Ornl object specifies the constitutive model developed by Oak Ridge National Laboratory.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].creep.ornl
mdb.models[name].materials[name].Plastic.ornl
import odbMaterial
session.odbs[name].materials[name].creep.ornl
session.odbs[name].materials[name].Plastic.ornl

The corresponding analysis keywords are:

  • ORNL

Methods

setValues()

This method modifies the Ornl object.

Porous#
PorousFailureCriteria#
class PorousFailureCriteria(fraction: float = 1, criticalFraction: float = 1)[source]#

The PorousFailureCriteria object specifies the material failure criteria for a porous metal.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].porousMetalPlasticity.porousFailureCriteria
import odbMaterial
session.odbs[name].materials[name].porousMetalPlasticity.porousFailureCriteria

The corresponding analysis keywords are:

  • POROUS FAILURE CRITERIA

Methods

setValues()

This method modifies the PorousFailureCriteria object.

PorousMetalPlasticity#
class PorousMetalPlasticity(table: tuple, relativeDensity: float | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The PorousMetalPlasticity object specifies a porous metal plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].porousMetalPlasticity
import odbMaterial
session.odbs[name].materials[name].porousMetalPlasticity

The table data for this object are:

  • q1.

  • q2.

  • q3.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • POROUS METAL PLASTICITY

Methods

setValues()

This method modifies the PorousMetalPlasticity object.

VoidNucleation#
class VoidNucleation(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The VoidNucleation object defines the nucleation of voids in a porous material.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].porousMetalPlasticity.voidNucleation
import odbMaterial
session.odbs[name].materials[name].porousMetalPlasticity.voidNucleation

The table data for this object are:

  • εN, the mean value of the nucleation-strain normal distribution.

  • sN, the standard deviation of the nucleation-strain normal distribution.

  • fN, the volume fraction of nucleating voids.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • VOID NUCLEATION

Methods

setValues()

This method modifies the VoidNucleation object.

RateDependent#
RateDependent#
class RateDependent(table: tuple, type: SymbolicConstantType = 'POWER_LAW', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The RateDependent object defines a rate-dependent viscoplastic model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].crushableFoam.rateDependent
mdb.models[name].materials[name].druckerPrager.rateDependent
mdb.models[name].materials[name].Plastic.rateDependent
import odbMaterial
session.odbs[name].materials[name].crushableFoam.rateDependent
session.odbs[name].materials[name].druckerPrager.rateDependent
session.odbs[name].materials[name].Plastic.rateDependent

The table data for this object are:

  • If *type*=POWER_LAW, the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=YIELD_RATIO, the table data specify the following:
    • Yield stress ratio, R=¯σ/σ0.

    • Equivalent Plastic strain rate, ˙¯εpl.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=JOHNSON_COOK, the table data specify the following:
    • ˙ε0.

The corresponding analysis keywords are:

  • RATE DEPENDENT

Methods

setValues()

This method modifies the RateDependent object.

TwoLayerViscoPlasticity#
Viscous#
class Viscous(table: tuple, law: SymbolicConstantType = 'STRAIN', temperatureDependency: BooleanType = 0, dependencies: int = 0, time: SymbolicConstantType = 'TOTAL')[source]#

The Viscous object specifies the viscous properties for a two-layer viscoplastic material model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].viscous
import odbMaterial
session.odbs[name].materials[name].viscous

The table data for this object are:

  • If *law*=STRAIN or *law*=TIME, the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=USER, the table data specify the following:
    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *law*=ANAND, the table data specify the following:
    • s1.

    • QR.

    • ξ.

    • A00.

    • ˆs.

    • S2.

    • S3.

    • A1.

    • A2.

    • A3.

    • A4.

  • If *law*=DARVEAUX, the table data specify the following:
    • Css.

    • QR.

    • α.

    • ϵT.

  • If *law*=DOUBLE_POWER, the table data specify the following:
    • A1.

    • B1.

    • C1.

    • A2.

    • B2.

    • C2.

    • σ0.

  • If *law*=POWER_LAW or *law*=TIME_POWER_LAW, the table data specify the following:
    • q0.

    • ∙ε0.⁢

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • VISCOUS

Methods

setValues()

This method modifies the Viscous object.

MohrCoulomb#

MohrCoulombHardening#
class MohrCoulombHardening(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The MohrCoulombHardening object specifies hardening for the Mohr-Coulomb plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].mohrCoulombPlasticity.mohrCoulombHardening
import odbMaterial
session.odbs[name].materials[name].mohrCoulombPlasticity.mohrCoulombHardening

The table data for this object are:

  • Cohesion yield stress.

  • The absolute value of the corresponding Plastic strain.(The first tabular value entered must always be zero.)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • MOHR COULOMB HARDENING

Methods

setValues()

This method modifies the MohrCoulombHardening object.

MohrCoulombPlasticity#
class MohrCoulombPlasticity(table: tuple, deviatoricEccentricity: float | None = None, meridionalEccentricity: float = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, useTensionCutoff: BooleanType = 0)[source]#

The MohrCoulombPlasticity object specifies the extended Mohr-Coulomb plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].mohrCoulombPlasticity
import odbMaterial
session.odbs[name].materials[name].mohrCoulombPlasticity

The table data for this object are:

  • Friction angle (given in degrees), ϕ, at high confining pressure in the p–Rm⁢c⁢q plane.

  • Dilation angle, ψ, at high confining pressure in the p–Rm⁢w⁢q plane.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • MOHR COULOMB

Methods

setValues()

This method modifies the MohrCoulombPlasticity object.

TensionCutOff#
class TensionCutOff(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The TensionCutOff object specifies tension cutoff for different material models for example the Mohr-Coulomb plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].mohrCoulombPlasticity.tensionCutOff
import odbMaterial
session.odbs[name].materials[name].mohrCoulombPlasticity.tensionCutOff

The table data for this object are:

  • Tension cutoff stress.

  • The value of the corresponding tensile Plastic strain.(The first tabular value entered must always be zero.)

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • TENSION CUTOFF

Methods

setValues()

This method modifies the TensionCutOff object.

Plastic#

class Plastic(table: tuple, hardening: SymbolicConstantType = 'ISOTROPIC', rate: BooleanType = 0, dataType: SymbolicConstantType = 'HALF_CYCLE', strainRangeDependency: BooleanType = 0, numBackstresses: int = 1, temperatureDependency: BooleanType = 0, dependencies: int = 0, extrapolation: SymbolicConstantType = 'CONSTANT')[source]#

The Plastic object specifies a metal plasticity model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].Plastic
import odbMaterial
session.odbs[name].materials[name].Plastic

The table data for this object are:

  • If *hardening*=ISOTROPIC, or if *hardening*=COMBINED and *dataType*=HALF_CYCLE, the table data specify the following:
    • Yield stress.

    • Plastic strain.

    • Equivalent Plastic strain rate, ε¯˙p⁢l.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *hardening*=COMBINED and *dataType*=STABILIZED, the table data specify the following:
    • Yield stress.

    • Plastic strain.

    • Strain range, if the data depend on strain range.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *hardening*=COMBINED and *dataType*=PARAMETERS, the table data specify the following:
    • Yield stress at zero Plastic strain.

    • The first kinematic hardening parameter, C1.

    • The first kinematic hardening parameter, γ1.

    • If applicable, the second kinematic hardening parameter, C2.

    • If applicable, the second kinematic hardening parameter, γ2.

    • Etc.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *hardening*=KINEMATIC, the table data specify the following:
    • Yield stress.

    • Plastic strain.

    • Temperature, if the data depend on temperature.

  • If *hardening*=JOHNSON_COOK, the table data specify the following:
    • Melting temperature.

    • Transition temperature.

  • If *hardening*=USER, the table data specify the following:
    • Hardening properties.

The corresponding analysis keywords are:

  • PLASTIC

Methods

setValues()

This method modifies the Plastic object.

Potential#

class Potential(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Potential object defines an anisotropic yield/creep model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].creep.potential
mdb.models[name].materials[name].Plastic.potential
mdb.models[name].materials[name].viscous.potential
import odbMaterial
session.odbs[name].materials[name].creep.potential
session.odbs[name].materials[name].Plastic.potential
session.odbs[name].materials[name].viscous.potential

The table data for this object are:

  • R11.

  • R22.

  • R33.

  • R12.

  • R13.

  • R23.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • POTENTIAL

Methods

setValues()

This method modifies the Potential object.

SuperElastic#

SuperElasticHardening#
class SuperElasticHardening(table: tuple)[source]#

The SuperElasticHardening object specifies the dependence of the yield stress on the total strain to define the piecewise linear hardening of a martensite material model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].superElasticity.SuperElasticHardening
import odbMaterial
session.odbs[name].materials[name].superElasticity.SuperElasticHardening

The table data for this object are:

  • Yield Stress.

  • Total Strain.

The corresponding analysis keywords are:

  • SUPERELASTIC HARDENING

Methods

setValues()

This method modifies the SuperElasticHardening object.

SuperElasticHardeningModifications#
class SuperElasticHardeningModifications(table: tuple)[source]#

The SuperElasticHardeningModifications object specifies the variation of the transformation stress levels of a material model.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].superElasticity.SuperElasticHardening
import odbMaterial
session.odbs[name].materials[name].superElasticity.SuperElasticHardening

The table data for this object are:

  • Start of Transformation (Loading).

  • End of Transformation (Loading).

  • Start of Transformation (Unloading).

  • End of Transformation (Unloading).

  • Plastic Strain.

The corresponding analysis keywords are:

  • SUPERELASTIC HARDENING MODIFICATIONS

Methods

setValues()

This method modifies the SuperElasticHardeningModifications object.

Swelling#

Swelling#
class Swelling(table: tuple, law: SymbolicConstantType = 'INPUT', temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Swelling object specifies time-dependent volumetric swelling for a material.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].swelling
import odbMaterial
session.odbs[name].materials[name].swelling

The table data for this object are:

  • Volumetric swelling strain rate.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • SWELLING

Methods

setValues()

This method modifies the Swelling object.

TensileFailure#

class TensileFailure[source]#

The TensileFailure object specifies the material tensile failure.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].Plastic.tensileFailure
mdb.models[name].materials[name].eos.tensileFailure
import odbMaterial
session.odbs[name].materials[name].Plastic.tensileFailure
session.odbs[name].materials[name].eos.tensileFailure

The table data for this object are:

  • The Hydrostatic cutoff stress (positive in tension).

  • Temperature, if the data depend on temperature.

  • Value of the first field variable if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

The corresponding analysis keywords are:

  • TENSILE FAILURE

Methods

setValues()

This method modifies the TensileFailure object.

tensileFailure(table[, dependencies, ...])

This method creates a tensileFailure object.

ProgressiveDamageFailure#

DamageEvolution#

class DamageEvolution(type: SymbolicConstantType, table: tuple, degradation: SymbolicConstantType = 'MAXIMUM', temperatureDependency: BooleanType = 0, dependencies: int = 0, mixedModeBehavior: SymbolicConstantType = 'MODE_INDEPENDENT', modeMixRatio: SymbolicConstantType = 'ENERGY', power: float | None = None, softening: SymbolicConstantType = 'LINEAR')[source]#

The DamageEvolution object specifies material properties to define the evolution of damage.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].ductileDamageInitiation.damageEvolution
mdb.models[name].materials[name].fldDamageInitiation.damageEvolution
mdb.models[name].materials[name].flsdDamageInitiation.damageEvolution
mdb.models[name].materials[name].hashinDamageInitiation.damageEvolution
mdb.models[name].materials[name].johnsonCookDamageInitiation.damageEvolution
mdb.models[name].materials[name].maxeDamageInitiation.damageEvolution
mdb.models[name].materials[name].maxpeDamageInitiation.damageEvolution
mdb.models[name].materials[name].maxpsDamageInitiation.damageEvolution
mdb.models[name].materials[name].maxsDamageInitiation.damageEvolution
mdb.models[name].materials[name].mkDamageInitiation.damageEvolution
mdb.models[name].materials[name].msfldDamageInitiation.damageEvolution
mdb.models[name].materials[name].quadeDamageInitiation.damageEvolution
mdb.models[name].materials[name].quadsDamageInitiation.damageEvolution
mdb.models[name].materials[name].shearDamageInitiation.damageEvolution
import odbMaterial
session.odbs[name].materials[name].ductileDamageInitiation.damageEvolution
session.odbs[name].materials[name].fldDamageInitiation.damageEvolution
session.odbs[name].materials[name].flsdDamageInitiation.damageEvolution
session.odbs[name].materials[name].hashinDamageInitiation.damageEvolution
session.odbs[name].materials[name].johnsonCookDamageInitiation.damageEvolution
session.odbs[name].materials[name].maxeDamageInitiation.damageEvolution
session.odbs[name].materials[name].maxpeDamageInitiation.damageEvolution
session.odbs[name].materials[name].maxpsDamageInitiation.damageEvolution
session.odbs[name].materials[name].maxsDamageInitiation.damageEvolution
session.odbs[name].materials[name].mkDamageInitiation.damageEvolution
session.odbs[name].materials[name].msfldDamageInitiation.damageEvolution
session.odbs[name].materials[name].quadeDamageInitiation.damageEvolution
session.odbs[name].materials[name].quadsDamageInitiation.damageEvolution
session.odbs[name].materials[name].shearDamageInitiation.damageEvolution

The table data for this object are:

  • If *type*=DISPLACEMENT, and *softening*=LINEAR, and *mixedModeBehavior*=MODE_INDEPENDENT, the table data specify the following:
    • Equivalent total or Plastic displacement at failure, measured from the time of damage initiation.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENERGY, and *softening*=LINEAR, and *mixedModeBehavior*=MODE_INDEPENDENT, the table data specify the following:
    • Fracture energy.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, and *softening*=LINEAR, and *mixedModeBehavior*=TABULAR, the table data specify the following:
    • Total displacement at failure, measured from the time of damage initiation.

    • Appropriate mode mix ratio.

    • Appropriate mode mix ratio (if relevant, for three-dimensional problems with anisotropic shear behavior).

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENERGY, and *softening*=LINEAR, and *mixedModeBehavior*=TABULAR, the table data specify the following:
    • Fracture energy.

    • Appropriate mode mix ratio.

    • Appropriate mode mix ratio (if relevant, for three-dimensional problems with anisotropic shear behavior).

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, and *softening*=EXPONENTIAL, and *mixedModeBehavior*=MODE_INDEPENDENT, the table data specify the following:
    • Equivalent total or Plastic displacement at failure, measured from the time of damage initiation.

    • Exponential law parameter.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENERGY, and *softening*=EXPONENTIAL, and *mixedModeBehavior*=MODE_INDEPENDENT, the table data specify the following:
    • Fracture energy.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, and *softening*=EXPONENTIAL, and *mixedModeBehavior*=TABULAR, the table data specify the following:
    • Total displacement at failure, measured from the time of damage initiation.

    • Exponential law parameter.

    • Appropriate mode mix ratio.

    • Appropriate mode mix ratio (if relevant, for three-dimensional problems with anisotropic shear behavior).

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENERGY, and *softening*=EXPONENTIAL, and *mixedModeBehavior*=TABULAR, the table data specify the following:
    • Fracture energy.

    • Appropriate mode mix ratio.

    • Appropriate mode mix ratio (if relevant, for three-dimensional problems with anisotropic shear behavior).

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, and *softening*=TABULAR, and *mixedModeBehavior*=MODE_INDEPENDENT, the table data specify the following:
    • Damage variable.

    • Equivalent total or Plastic displacement, measured from the time of damage initiation.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=DISPLACEMENT, and *softening*=TABULAR, and *mixedModeBehavior*=TABULAR, the table data specify the following:
    • Damage variable.

    • Equivalent total or Plastic displacement, measured from the time of damage initiation.

    • Appropriate mode mix ratio.

    • Appropriate mode mix ratio (if relevant, for three-dimensional problems with anisotropic shear behavior).

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENERGY, and *softening*=LINEAR or EXPONENTIAL, and *mixedModeBehavior*=POWER_LAW or BK, the table data specify the following:
    • Normal mode fracture energy.

    • Shear mode fracture energy for failure in the first shear direction.

    • Shear mode fracture energy for failure in the second shear direction.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If *type*=ENERGY, *softening*=LINEAR and constructor for [DamageInitiation](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-c-damageinitiationpyc.htm?ContextScope=all)=HashinDamageInitiation the table data specify the following:
    • Fiber tensile fracture energy.

    • Fiber compressive fracture energy.

    • Matrix tensile fracture energy.

    • Matrix compressive fracture energy.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • DAMAGE EVOLUTION

Methods

setValues()

This method modifies the DamageEvolution object.

DamageInitiation#

class DamageInitiation[source]#

The DamageInitiation object specifies material properties to define the initiation of damage.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].ductileDamageInitiation
mdb.models[name].materials[name].fldDamageInitiation
mdb.models[name].materials[name].flsdDamageInitiation
mdb.models[name].materials[name].hashinDamageInitiation
mdb.models[name].materials[name].johnsonCookDamageInitiation
mdb.models[name].materials[name].maxeDamageInitiation
mdb.models[name].materials[name].maxpeDamageInitiation
mdb.models[name].materials[name].maxpsDamageInitiation
mdb.models[name].materials[name].maxsDamageInitiation
mdb.models[name].materials[name].mkDamageInitiation
mdb.models[name].materials[name].msfldDamageInitiation
mdb.models[name].materials[name].quadeDamageInitiation
mdb.models[name].materials[name].quadsDamageInitiation
mdb.models[name].materials[name].shearDamageInitiation
import odbMaterial
session.odbs[name].materials[name].ductileDamageInitiation
session.odbs[name].materials[name].fldDamageInitiation
session.odbs[name].materials[name].flsdDamageInitiation
session.odbs[name].materials[name].hashinDamageInitiation
session.odbs[name].materials[name].johnsonCookDamageInitiation
session.odbs[name].materials[name].maxeDamageInitiation
session.odbs[name].materials[name].maxpeDamageInitiation
session.odbs[name].materials[name].maxpsDamageInitiation
session.odbs[name].materials[name].maxsDamageInitiation
session.odbs[name].materials[name].mkDamageInitiation
session.odbs[name].materials[name].msfldDamageInitiation
session.odbs[name].materials[name].quadeDamageInitiation
session.odbs[name].materials[name].quadsDamageInitiation
session.odbs[name].materials[name].shearDamageInitiation

The table data for this object are:

  • If constructor is DuctileDamageInitiation, the table data specify the following:
    • Equivalent fracture strain at damage initiation.

    • Stress triaxiality.

    • Strain rate.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is FldDamageInitiation, the table data specify the following:
    • Major principal strain at damage initiation.

    • Minor principal strain.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor FlsdDamageInitiation, the table data specify the following:
    • Major principal stress at damage initiation.

    • Minor principal stress.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is JohnsonCookDamageInitiation, the table data specify the following:
    • Johnson-Cook failure parameter D1.

    • Johnson-Cook failure parameter D2.

    • Johnson-Cook failure parameter D3.

    • Johnson-Cook failure parameter D4.

    • Johnson-Cook failure parameter D5.

    • Melting temperature.

    • Transition temperature.

    • Reference strain rate.

  • If constructor MkDamageInitiation, the table data specify the following:
    • Flaw size relative to nominal thickness of the section.

    • Angle (in degrees) with respect to the 1-direction of the local material orientation.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is MsfldDamageInitiation and *definition*=MSFLD, the table data specify the following:
    • Nominal strain at damage initiation in a normal-only mode.

    • Equivalent Plastic strain at initiation of localized necking.

    • Ratio of minor to major principal strains.

    • Equivalent Plastic strain rate.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is MsfldDamageInitiation and *definition*=FLD, the table data specify the following:
    • Major principal strain at initiation of localized necking.

    • Equivalent Plastic strain at initiation of localized necking.

    • Ratio of minor to major principal strains.

    • Equivalent Plastic strain rate.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is QuadeDamageInitiation or MaxeDamageInitiation, the table data specify the following:
    • Nominal strain at damage initiation in a normal-only mode.

    • Nominal strain at damage initiation in a shear-only mode that involves separation only along the first shear direction.

    • Nominal strain at damage initiation in a shear-only mode that involves separation only along the second shear direction.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is QuadsDamageInitiation or MaxsDamageInitiation, the table data specify the following:
    • Nominal strain at damage initiation in a normal-only mode.

    • Nominal strain at damage initiation in a shear-only mode that involves separation only along the first shear direction.

    • Nominal strain at damage initiation in a shear-only mode that involves separation only along the second shear direction.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is MaxpeDamageInitiation, the table data specify the following:
    • Maximum principal strain at damage initiation.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is MaxpsDamageInitiation, the table data specify the following:
    • Maximum principal stress at damage initiation.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is ShearDamageInitiation, the table data specify the following:
    • Equivalent fracture strain at damage initiation.

    • Shear stress ratio.

    • Strain rate.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • If constructor is HashinDamageInitiation, the table data specify the following:
    • Fiber tensile strength.

    • Fiber compressive strength.

    • Matrix tensile strength.

    • Matrix compressive strength.

    • Longitudinal shear strength.

    • Transverse shear strength.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

The corresponding analysis keywords are:

  • DAMAGE INITIATION

Attributes:
damageEvolution
damageStabilization
table

Methods

DuctileDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

FldDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

FlsdDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

HashinDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

JohnsonCookDamageInitiation(table[, ...])

This method creates a DamageInitiation object.

MaxeDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

MaxpeDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

MaxpsDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

MaxsDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

MkDamageInitiation(table[, definition, feq, ...])

This method creates a DamageInitiation object.

MsfldDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

QuadeDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

QuadsDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

ShearDamageInitiation(table[, definition, ...])

This method creates a DamageInitiation object.

setValues()

This method modifies the DamageInitiation object.

DamageStabilization#

class DamageStabilization(fiberTensileCoeff: float, fiberCompressiveCoeff: float, matrixTensileCoeff: float, matrixCompressiveCoeff: float)[source]#

The DamageStabilization object specifies the viscosity coefficients for the damage model for fiber-reinforced materials.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].ductileDamageInitiation.damageStabilization
mdb.models[name].materials[name].fldDamageInitiation.damageStabilization
mdb.models[name].materials[name].flsdDamageInitiation.damageStabilization
mdb.models[name].materials[name].hashinDamageInitiation.damageStabilization
mdb.models[name].materials[name].johnsonCookDamageInitiation.damageStabilization
mdb.models[name].materials[name].maxeDamageInitiation.damageStabilization
mdb.models[name].materials[name].maxpeDamageInitiation.damageStabilization
mdb.models[name].materials[name].maxpsDamageInitiation.damageStabilization
mdb.models[name].materials[name].maxsDamageInitiation.damageStabilization
mdb.models[name].materials[name].mkDamageInitiation.damageStabilization
mdb.models[name].materials[name].msfldDamageInitiation.damageStabilization
mdb.models[name].materials[name].quadeDamageInitiation.damageStabilization
mdb.models[name].materials[name].quadsDamageInitiation.damageStabilization
mdb.models[name].materials[name].shearDamageInitiation.damageStabilization
import odbMaterial
session.odbs[name].materials[name].ductileDamageInitiation.damageStabilization
session.odbs[name].materials[name].fldDamageInitiation.damageStabilization
session.odbs[name].materials[name].flsdDamageInitiation.damageStabilization
session.odbs[name].materials[name].hashinDamageInitiation.damageStabilization
session.odbs[name].materials[name].johnsonCookDamageInitiation.damageStabilization
session.odbs[name].materials[name].maxeDamageInitiation.damageStabilization
session.odbs[name].materials[name].maxpeDamageInitiation.damageStabilization
session.odbs[name].materials[name].maxpsDamageInitiation.damageStabilization
session.odbs[name].materials[name].maxsDamageInitiation.damageStabilization
session.odbs[name].materials[name].mkDamageInitiation.damageStabilization
session.odbs[name].materials[name].msfldDamageInitiation.damageStabilization
session.odbs[name].materials[name].quadeDamageInitiation.damageStabilization
session.odbs[name].materials[name].quadsDamageInitiation.damageStabilization
session.odbs[name].materials[name].shearDamageInitiation.damageStabilization

The corresponding analysis keywords are:

  • DAMAGE STABILIZATION

Methods

setValues()

This method modifies the DamageStabilization object.

DamageStabilizationCohesive#

class DamageStabilizationCohesive(cohesiveCoeff: float | None = None)[source]#

The DamageStabilizationCohesive object specifies the viscosity coefficients for the damage model for surface-based cohesive behavior or enriched cohesive behavior.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].ductileDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].fldDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].flsdDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].hashinDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].johnsonCookDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].maxeDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].maxpeDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].maxpsDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].maxsDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].mkDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].msfldDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].quadeDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].quadsDamageInitiation.damageStabilizationCohesive
mdb.models[name].materials[name].shearDamageInitiation.damageStabilizationCohesive
import odbMaterial
session.odbs[name].materials[name].ductileDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].fldDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].flsdDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].hashinDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].johnsonCookDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].maxeDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].maxpeDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].maxpsDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].maxsDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].mkDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].msfldDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].quadeDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].quadsDamageInitiation.damageStabilizationCohesive
session.odbs[name].materials[name].shearDamageInitiation.damageStabilizationCohesive

The corresponding analysis keywords are:

  • DAMAGE STABILIZATION

Methods

setValues()

This method modifies the DamageStabilizationCohesive object.

Ratios#

class Ratios(table: tuple, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The Ratios object specifies ratios that define anisotropic swelling.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].moistureSwelling.ratios
mdb.models[name].materials[name].swelling.ratios
import odbMaterial
session.odbs[name].materials[name].moistureSwelling.ratios
session.odbs[name].materials[name].swelling.ratios

The table data for this object are:
    - r11.
    - r22.
    - r33.
    - Temperature, if the data depend on temperature.
    - Value of the first field variable, if the data depend on field variables.
    - Value of the second field variable.
    - Etc.

The corresponding analysis keywords are:

  • RATIOS

Methods

setValues()

This method modifies the Ratios object.

Regularization#

class Regularization(rtol: float = 0, strainRateRegularization: SymbolicConstantType = 'LOGARITHMIC')[source]#

The Regularization object defines the tolerance to be used for regularizing material data.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].regularization
import odbMaterial
session.odbs[name].materials[name].regularization

The corresponding analysis keywords are:

  • DASHPOT

Methods

setValues()

This method modifies the Regularization object.

TestData#

BiaxialTestData#

class BiaxialTestData(table: tuple, smoothing: int | None = None, lateralNominalStrain: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The BiaxialTestData object provides equibiaxial test data (compression and/or tension).

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperelastic.biaxialTestData
mdb.models[name].materials[name].hyperfoam.biaxialTestData
mdb.models[name].materials[name].mullinsEffect.biaxialTests[i]
import odbMaterial
session.odbs[name].materials[name].hyperelastic.biaxialTestData
session.odbs[name].materials[name].hyperfoam.biaxialTestData
session.odbs[name].materials[name].mullinsEffect.biaxialTests[i]

The corresponding analysis keywords are:

  • BIAXIAL TEST DATA

Methods

setValues()

This method modifies the BiaxialTestData object.

BiaxialTestDataArray#

class BiaxialTestDataArray(iterable=(), /)[source]#

Methods

findAt

MullinsEffect#

class MullinsEffect[source]#

The MullinsEffect specifies properties for mullins data.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].mullinsEffect
import odbMaterial
session.odbs[name].materials[name].mullinsEffect

PlanarTestData#

class PlanarTestData(table: tuple, smoothing: int | None = None, lateralNominalStrain: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The PlanarTestData object specifies planar test (or pure shear) data (compression and/or tension).

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperelastic.planarTestData
mdb.models[name].materials[name].hyperfoam.planarTestData
mdb.models[name].materials[name].mullinsEffect.planarTests[i]
import odbMaterial
session.odbs[name].materials[name].hyperelastic.planarTestData
session.odbs[name].materials[name].hyperfoam.planarTestData
session.odbs[name].materials[name].mullinsEffect.planarTests[i]

The table data for this object are:

  • For a hyperelastic material model, the table data specify the following:
    • Nominal stress, TS.

    • Nominal strain in the direction of loading, ϵS.

  • For a hyperfoam material model, the table data specify the following:
    • Nominal stress, TL.

    • Nominal strain in the direction of loading, ϵp.

    • Nominal transverse strain, ϵ3. The default value is 0.

The corresponding analysis keywords are:

  • PLANAR TEST DATA

Methods

setValues()

This method modifies the PlanarTestData object.

PlanarTestDataArray#

class PlanarTestDataArray(iterable=(), /)[source]#

Methods

findAt

ShearTestData#

class ShearTestData(table: tuple, shrinf: float | None = None)[source]#

The ShearTestData object specifies the normalized shear creep compliance or relaxation modulus as a function of time.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].viscoelastic.shearTestData
import odbMaterial
session.odbs[name].materials[name].viscoelastic.shearTestData

The corresponding analysis keywords are:

  • SHEAR TEST DATA

Methods

setValues()

This method modifies the ShearTestData object.

SimpleShearTestData#

class SimpleShearTestData(table: tuple)[source]#

The SimpleShearTestData object provides simple shear test data.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperfoam.simpleShearTestData
import odbMaterial
session.odbs[name].materials[name].hyperfoam.simpleShearTestData

The table data for this object are:

  • Nominal shear stress, TS.

  • Nominal shear strain, γ.

  • Nominal transverse stress, TT (normal to edge with shear stress). This stress value is optional.

The corresponding analysis keywords are:

  • SIMPLE SHEAR TEST DATA

Methods

setValues()

This method modifies the SimpleShearTestData object.

UniaxialTestData#

class UniaxialTestData(table: tuple, smoothing: int | None = None, lateralNominalStrain: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The UniaxialTestData object provides uniaxial test data (compression and/or tension).

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperelastic.uniaxialTestData
mdb.models[name].materials[name].hyperfoam.uniaxialTestData
mdb.models[name].materials[name].lowDensityFoam.uniaxialCompressionTestData
mdb.models[name].materials[name].lowDensityFoam.uniaxialTensionTestData
mdb.models[name].materials[name].mullinsEffect.uniaxialTests[i]
import odbMaterial
session.odbs[name].materials[name].hyperelastic.uniaxialTestData
session.odbs[name].materials[name].hyperfoam.uniaxialTestData
session.odbs[name].materials[name].lowDensityFoam.uniaxialCompressionTestData
session.odbs[name].materials[name].lowDensityFoam.uniaxialTensionTestData
session.odbs[name].materials[name].mullinsEffect.uniaxialTests[i]

The table data for this object are:

  • For a hyperelastic material model, the table data specify the following:
    • Nominal stress, TU.

    • Nominal strain, ϵU.

  • For a hyperfoam material model, the table data specify the following:
    • Nominal stress, TL.

    • Nominal strain, ϵU.

    • Nominal lateral strain, ϵ2=ϵ3. The default value is 0.

  • For a low-density foam material model, the table data specify the following:
    • Nominal stress, TU.

    • Nominal strain, ϵU.

    • Nominal strain rate, ϵU˙.

The corresponding analysis keywords are:

  • UNIAXIAL TEST DATA

Methods

setValues()

This method modifies the UniaxialTestData object.

UniaxialTestDataArray#

class UniaxialTestDataArray(iterable=(), /)[source]#

Methods

findAt

VolumetricTestData#

class VolumetricTestData(table: tuple, volinf: float | None = None, smoothing: int | None = None, temperatureDependency: BooleanType = 0, dependencies: int = 0)[source]#

The VolumetricTestData object provides volumetric test data.

Notes

This object can be accessed by:

import material
mdb.models[name].materials[name].hyperelastic.volumetricTestData
mdb.models[name].materials[name].hyperfoam.volumetricTestData
mdb.models[name].materials[name].viscoelastic.volumetricTestData
import odbMaterial
session.odbs[name].materials[name].hyperelastic.volumetricTestData
session.odbs[name].materials[name].hyperfoam.volumetricTestData
session.odbs[name].materials[name].viscoelastic.volumetricTestData

The table data for this object are:

  • For a hyperelastic or hyperfoam material model, the table data specify the following:
    • Pressure, p.

    • Volume ratio, J (current volume/original volume).

  • For a viscoelastic material model, the values depend on the value of the time member of the [Viscoelastic](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-c-viscoelasticpyc.htm?ContextScope=all) object.
    • If *time*=RELAXATION_TEST_DATA, the table data specify the following:
      • Normalized volumetric (bulk) modulus kR(t),(0≤kR(t)≤1).

      • Time t (t>0).

    • If *time*=CREEP_TEST_DATA, the table data specify the following:
      • Normalized volumetric (bulk) compliance jK(t),(jK(t)≥1).

      • Time t (t>0).

The corresponding analysis keywords are:

  • VOLUMETRIC TEST DATA

Methods

setValues()

This method modifies the VolumetricTestData object.