Material

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

Create materials

In Mdb

class MaterialModel(
name,
description='',
stefanBoltzmann=None,
absoluteZero=None,
waveFormulation=NOT_SET,
modelType=STANDARD_EXPLICIT,
universalGas=None,
copyConstraints=1,
copyConnectors=1,
copyInteractions=1,
)[source]

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

rootAssembly

An Assembly object.

Public Methods:

Material(name[, description, materialIdentifier])

This method creates a Material object.

Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.


Member Details:

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

This method creates a Material object.

Note

This function can be accessed by:

mdb.models[name].Material
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.

Return type:

Material

In Odb

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

Bases: OdbBase

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

Note

This object can be accessed by:

import odbAccess
session.odbs[name]

Public Data Attributes:

Inherited from OdbBase

isReadOnly

A Boolean specifying whether the output database was opened with read-only access.

amplitudes

A repository of Amplitude objects.

filters

A repository of Filter objects.

rootAssembly

An OdbAssembly object.

jobData

A JobData object.

parts

A repository of OdbPart objects.

materials

A repository of Material objects.

steps

A repository of OdbStep objects.

sections

A repository of Section objects.

sectionCategories

A repository of SectionCategory objects.

sectorDefinition

A SectorDefinition object.

userData

A UserData object.

customData

A RepositorySupport object.

profiles

A repository of Profile objects.

Public Methods:

Material(name[, description, materialIdentifier])

This method creates a Material object.

Inherited from OdbBase

__init__(name[, analysisTitle, description, ...])

This method creates a new Odb object.

close()

This method closes an output database.

getFrame(frameValue[, match])

This method returns the frame at the specified time, frequency, or mode.

save()

This method saves output to an output database (.odb ) file.

update()

This method is used to update an Odb object in memory while an Abaqus analysis writes data to the associated output database.


Member Details:

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

This method creates a Material object.

Note

This function can be accessed by:

session.odbs[name].Material
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.

Return type:

Material

Assign properties to the material

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

Bases: MaterialBase

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.

Note

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

Public Data Attributes:

Inherited from MaterialBase

acousticMedium

An AcousticMedium object.

brittleCracking

A BrittleCracking object.

capPlasticity

A CapPlasticity object.

castIronPlasticity

A CastIronPlasticity object.

clayPlasticity

A ClayPlasticity object.

concrete

A Concrete object.

concreteDamagedPlasticity

A ConcreteDamagedPlasticity object.

conductivity

A Conductivity object.

creep

A Creep object.

crushableFoam

A CrushableFoam object.

crushStress

A CrushStress object

ductileDamageInitiation

A DamageInitiation object.

fldDamageInitiation

A DamageInitiation object.

flsdDamageInitiation

A DamageInitiation object.

johnsonCookDamageInitiation

A DamageInitiation object.

maxeDamageInitiation

A DamageInitiation object.

maxsDamageInitiation

A DamageInitiation object.

maxpeDamageInitiation

A DamageInitiation object.

maxpsDamageInitiation

A DamageInitiation object.

mkDamageInitiation

A DamageInitiation object.

msfldDamageInitiation

A DamageInitiation object.

quadeDamageInitiation

A DamageInitiation object.

quadsDamageInitiation

A DamageInitiation object.

shearDamageInitiation

A DamageInitiation object.

hashinDamageInitiation

A DamageInitiation object.

damping

A Damping object.

deformationPlasticity

A DeformationPlasticity object.

density

A Density object.

depvar

A Depvar object.

dielectric

A Dielectric object.

diffusivity

A Diffusivity object.

druckerPrager

A DruckerPrager object.

elastic

An Elastic object.

electricalConductivity

An ElectricalConductivity object.

eos

An Eos object.

expansion

An Expansion object.

fluidLeakoff

A FluidLeakoff object.

gapFlow

A GapFlow object.

gasketThicknessBehavior

A GasketThicknessBehavior object.

gasketTransverseShearElastic

A GasketTransverseShearElastic object.

gasketMembraneElastic

A GasketMembraneElastic object.

gel

A Gel object.

heatGeneration

A HeatGeneration object.

hyperelastic

A Hyperelastic object.

hyperfoam

A Hyperfoam object.

hypoelastic

A Hypoelastic object.

inelasticHeatFraction

An InelasticHeatFraction object.

jouleHeatFraction

A JouleHeatFraction object.

latentHeat

A LatentHeat object.

lowDensityFoam

A LowDensityFoam object.

magneticPermeability

A MagneticPermeability object.

mohrCoulombPlasticity

A MohrCoulombPlasticity object.

moistureSwelling

A MoistureSwelling object.

mullinsEffect

A MullinsEffect object.

permeability

A Permeability object.

piezoelectric

A Piezoelectric object.

plastic

A Plastic object.

plasticityCorrection

A PlasticityCorrection object.

poreFluidExpansion

A PoreFluidExpansion object.

porousBulkModuli

A PorousBulkModuli object.

porousElastic

A PorousElastic object.

porousMetalPlasticity

A PorousMetalPlasticity object.

regularization

A Regularization object.

solubility

A Solubility object.

sorption

A Sorption object.

specificHeat

A SpecificHeat object.

swelling

A Swelling object.

userDefinedField

A UserDefinedField object.

userMaterial

A UserMaterial object.

userOutputVariables

A UserOutputVariables object.

viscoelastic

A Viscoelastic object.

viscosity

A Viscosity object.

viscous

A Viscous object.

meanFieldHomogenization

A MeanFieldHomogenization object.

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

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

This method creates a CrushableFoam object.

CrushStress(crushStressTable[, ...])

This method creates a CrushStress 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.

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

This method creates a PlasticityCorrection 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.

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.

JohnsonCookDamageInitiation(table[, ...])

This method creates A DamageInitiation object.

MaxeDamageInitiation(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.

MaxpeDamageInitiation(table[, definition, ...])

This method creates A DamageInitiation object.

MaxpsDamageInitiation(table[, definition, ...])

This method creates A DamageInitiation object.

ShearDamageInitiation(table[, definition, ...])

This method creates A DamageInitiation object.

HashinDamageInitiation(table[, definition, ...])

This method creates A DamageInitiation object.

MeanFieldHomogenization([angleSubdivision, ...])

This method creates a MeanFieldHomogenization object.

GapConductance([pressureDependency, ...])

This method creates a GapConductance object.

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

This method creates a GapConvection object.

GapRadiation(masterSurfaceEmissivity, ...)

This method creates a GapRadiation object.

Inherited from MaterialBase

__init__(name[, description, materialIdentifier])

This method creates a Material object.

materialsFromOdb(fileName)

This methods creates Material objects by reading an output database.


Member Details:

AcousticMedium(
acousticVolumetricDrag=0,
temperatureDependencyB=0,
temperatureDependencyV=0,
dependenciesB=0,
dependenciesV=0,
bulkTable=(),
volumetricTable=(),
)[source]

This method creates an AcousticMedium object.

Note

This function can be accessed by:

mdb.models[name].materials[name].AcousticMedium
session.odbs[name].materials[name].AcousticMedium
Parameters:
acousticVolumetricDrag=0

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

temperatureDependencyB=0

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

temperatureDependencyV=0

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

dependenciesB=0

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

dependenciesV=0

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.

Return type:

AcousticMedium

Raises:

RangeError

BrittleCracking(table, temperatureDependency=0, dependencies=0, type=STRAIN)[source]

This method creates a BrittleCracking object.

Note

This function can be accessed by:

mdb.models[name].materials[name].BrittleCracking
session.odbs[name].materials[name].BrittleCracking
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

type=STRAIN

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

Returns:

A BrittleCracking object.

Return type:

BrittleCracking

CapPlasticity(table, temperatureDependency=0, dependencies=0)[source]

This method creates a CapPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].CapPlasticity
session.odbs[name].materials[name].CapPlasticity
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A CapPlasticity object.

Return type:

CapPlasticity

Raises:

RangeError

CastIronPlasticity(table, temperatureDependency=0, dependencies=0)[source]

This method creates a CastIronPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].CastIronPlasticity
session.odbs[name].materials[name].CastIronPlasticity
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A CastIronPlasticity object.

Return type:

CastIronPlasticity

Raises:

RangeError

ClayPlasticity(
table,
intercept=None,
hardening=EXPONENTIAL,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a ClayPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].ClayPlasticity
session.odbs[name].materials[name].ClayPlasticity
Parameters:
table

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

intercept=None

None or a Float specifying \(e_1\), 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=EXPONENTIAL

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A ClayPlasticity object.

Return type:

ClayPlasticity

Raises:

RangeError

Concrete(table, temperatureDependency=0, dependencies=0)[source]

This method creates a Concrete object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Concrete
session.odbs[name].materials[name].Concrete
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Concrete object.

Return type:

Concrete

Raises:

RangeError

ConcreteDamagedPlasticity(table, temperatureDependency=0, dependencies=0)[source]

This method creates a ConcreteDamagedPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].ConcreteDamagedPlasticity
session.odbs[name].materials[name].ConcreteDamagedPlasticity
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A ConcreteDamagedPlasticity object.

Return type:

ConcreteDamagedPlasticity

Raises:

RangeError

Conductivity(table, type=ISOTROPIC, temperatureDependency=0, dependencies=0)[source]

This method creates a Conductivity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Conductivity
session.odbs[name].materials[name].Conductivity
Parameters:
table

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

type=ISOTROPIC

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Conductivity object.

Return type:

Conductivity

Raises:

RangeError

Creep(table, law=STRAIN, temperatureDependency=0, dependencies=0, time=TOTAL)[source]

This method creates a Creep object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Creep
session.odbs[name].materials[name].Creep
Parameters:
table

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

law=STRAIN

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.

Added in version 2020: The options ANAND, DARVEAUX, DOUBLE_POWER, POWER_LAW, and TIME_POWER_LAW were added.

temperatureDependency=0

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

dependencies=0

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

time=TOTAL

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

Returns:

A Creep object.

Return type:

Creep

Raises:

RangeError

CrushStress(crushStressTable, temperatureDependency=0, dependencies=0)[source]

This method creates a CrushStress object.

Note

This function can be accessed by:

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

Added in version 2022: The CrushStress method was added.

Parameters:
crushStressTable

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A CrushStress object.

CrushableFoam(
table,
hardening=VOLUMETRIC,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a CrushableFoam object.

Note

This function can be accessed by:

mdb.models[name].materials[name].CrushableFoam
session.odbs[name].materials[name].CrushableFoam
Parameters:
table

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

hardening=VOLUMETRIC

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A CrushableFoam object.

Return type:

CrushableFoam

Raises:

RangeError

Damping(alpha=0, beta=0, composite=0, structural=0)[source]

This method creates a Damping object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Damping
session.odbs[name].materials[name].Damping
Parameters:
alpha=0

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=0

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=0

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=0

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.

Return type:

Damping

Raises:

RangeError

DeformationPlasticity(table, temperatureDependency=0)[source]

This method creates a DeformationPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].DeformationPlasticity
session.odbs[name].materials[name].DeformationPlasticity
Parameters:
table

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

temperatureDependency=0

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

Returns:

A DeformationPlasticity object.

Return type:

DeformationPlasticity

Raises:

RangeError

Density(
table,
temperatureDependency=0,
dependencies=0,
distributionType=UNIFORM,
fieldName='',
)[source]

This method creates a Density object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Density
session.odbs[name].materials[name].Density
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

distributionType=UNIFORM

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.

Return type:

Density

Raises:

RangeError

Depvar(deleteVar=0, n=0)[source]

This method creates a Depvar object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Depvar
session.odbs[name].materials[name].Depvar
Parameters:
deleteVar=0

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=0

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

Returns:

A Depvar object.

Return type:

Depvar

Raises:

RangeError

Dielectric(
table,
type=ISOTROPIC,
frequencyDependency=0,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a Dielectric object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Dielectric
session.odbs[name].materials[name].Dielectric
Parameters:
table

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

type=ISOTROPIC

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

frequencyDependency=0

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Dielectric object.

Return type:

Dielectric

Diffusivity(
table,
type=ISOTROPIC,
law=GENERAL,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a Diffusivity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Diffusivity
session.odbs[name].materials[name].Diffusivity
Parameters:
table

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

type=ISOTROPIC

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

law=GENERAL

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Diffusivity object.

Return type:

Diffusivity

Raises:

RangeError

DruckerPrager(
table,
shearCriterion=LINEAR,
eccentricity=0,
testData=0,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a DruckerPrager object.

Note

This function can be accessed by:

mdb.models[name].materials[name].DruckerPrager
session.odbs[name].materials[name].DruckerPrager
Parameters:
table

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

shearCriterion=LINEAR

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=0

A Float specifying the flow potential eccentricity, \(\epsilon\), 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=0

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=0

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

dependencies=0

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

Returns:

A DruckerPrager object.

Return type:

DruckerPrager

Raises:

RangeError

DuctileDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].DuctileDamageInitiation
session.odbs[name].materials[name].DuctileDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

Elastic(
table,
type=ISOTROPIC,
noCompression=0,
noTension=0,
temperatureDependency=0,
dependencies=0,
moduli=LONG_TERM,
)[source]

This method creates an Elastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Elastic
session.odbs[name].materials[name].Elastic
Parameters:
table

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

type=ISOTROPIC

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.

Added in version 2022: The option BILAMINA was added.

noCompression=0

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

noTension=0

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

temperatureDependency=0

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

dependencies=0

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

moduli=LONG_TERM

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.

Return type:

Elastic

Raises:

RangeError

ElectricalConductivity(
table,
type=ISOTROPIC,
frequencyDependency=0,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates an ElectricalConductivity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].ElectricalConductivity
session.odbs[name].materials[name].ElectricalConductivity
Parameters:
table

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

type=ISOTROPIC

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

frequencyDependency=0

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

temperatureDependency=0

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

dependencies=0

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

Returns:

An ElectricalConductivity object.

Return type:

ElectricalConductivity

Raises:

RangeError

Eos(
type=IDEALGAS,
temperatureDependency=0,
dependencies=0,
detonationEnergy=0,
solidTable=(),
gasTable=(),
reactionTable=(),
gasSpecificTable=(),
table=(),
)[source]

This method creates an Eos object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Eos
session.odbs[name].materials[name].Eos
Parameters:
type=IDEALGAS

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

temperatureDependency=0

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

dependencies=0

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

detonationEnergy=0

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.

Expansion(
type=ISOTROPIC,
userSubroutine=0,
zero=0,
temperatureDependency=0,
dependencies=0,
table=(),
)[source]

This method creates an Expansion object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Expansion
session.odbs[name].materials[name].Expansion
Parameters:
type=ISOTROPIC

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

userSubroutine=0

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

zero=0

A Float specifying the value of :math:` heta_0` if the thermal expansion is temperature-dependent or field-variable-dependent. The default value is 0.0.

temperatureDependency=0

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

dependencies=0

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.

Return type:

Expansion

Raises:

RangeError

FldDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].FldDamageInitiation
session.odbs[name].materials[name].FldDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

FlsdDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].FlsdDamageInitiation
session.odbs[name].materials[name].FlsdDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

FluidLeakoff(
temperatureDependency=0,
dependencies=0,
type=COEFFICIENTS,
table=(),
)[source]

This method creates a FluidLeakoff object.

Note

This function can be accessed by:

mdb.models[name].materials[name].FluidLeakoff
session.odbs[name].materials[name].FluidLeakoff
Parameters:
temperatureDependency=0

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

dependencies=0

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

type=COEFFICIENTS

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.

Return type:

FluidLeakoff

GapConductance(pressureDependency=0, dependencies=0, table=())[source]

This method creates a GapConductance object.

Note

This function can be accessed by:

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

Added in version 2021: The GapConductance method was added.

Parameters:
pressureDependency=0

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

dependencies=0

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.

Returns:

A GapConductance object.

GapConvection(type, table=(), temperatureDependency=0, dependencies=0)[source]

This method creates a GapConvection object.

Note

This function can be accessed by:

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

Added in version 2021: The GapConvection method was added.

Parameters:
type

An odb_String specifying the type of gap convection. Possible values are FLUX, TEMPERATURE, and TABULAR. The default value is FLUX.

table=()

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A GapConvection object.

GapFlow(
table,
kmax=None,
temperatureDependency=0,
dependencies=0,
type=NEWTONIAN,
)[source]

This method creates a GapFlow object.

Note

This function can be accessed by:

mdb.models[name].materials[name].GapFlow
session.odbs[name].materials[name].GapFlow
Parameters:
table

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

kmax=None

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=0

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

dependencies=0

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

type=NEWTONIAN

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

Added in version 2020: The options BINGHAM_PLASTIC and HERSCHEL-BULKLEY were added.

Returns:

A GapFlow object.

Return type:

GapFlow

GapRadiation(masterSurfaceEmissivity, slaveSurfaceEmissivity, table)[source]

This method creates a GapRadiation object.

Note

This function can be accessed by:

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

Added in version 2021: The GapRadiation method was added.

Parameters:
masterSurfaceEmissivity

A Float specifying the Emissivity of master surface.ϵA

slaveSurfaceEmissivity

A Float specifying the Emissivity of the slave surfaceϵB.

table

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

Returns:

A Gapradiation object.

GasketMembraneElastic(table, temperatureDependency=0, dependencies=0)[source]

This method creates a GasketMembraneElastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].GasketMembraneElastic
session.odbs[name].materials[name].GasketMembraneElastic
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A GasketMembraneElastic object.

Return type:

GasketMembraneElastic

Raises:

RangeError

GasketThicknessBehavior(
table,
temperatureDependency=0,
dependencies=0,
tensileStiffnessFactor=None,
type=ELASTIC_PLASTIC,
unloadingDependencies=0,
unloadingTemperatureDependency=0,
variableUnits=STRESS,
yieldOnset=0,
yieldOnsetMethod=RELATIVE_SLOPE_DROP,
unloadingTable=(),
)[source]

This method creates a GasketThicknessBehavior object.

Note

This function can be accessed by:

mdb.models[name].materials[name].GasketThicknessBehavior
session.odbs[name].materials[name].GasketThicknessBehavior
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=0

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

dependencies=0

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=None

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

type=ELASTIC_PLASTIC

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=0

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=0

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

variableUnits=STRESS

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=0

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=RELATIVE_SLOPE_DROP

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.

Return type:

GasketThicknessBehavior

Raises:

RangeError

GasketTransverseShearElastic(
table,
variableUnits=STRESS,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a GasketTransverseShearElastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].GasketTransverseShearElastic
session.odbs[name].materials[name].GasketTransverseShearElastic
Parameters:
table

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

variableUnits=STRESS

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=0

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

dependencies=0

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

Returns:

A GasketTransverseShearElastic object.

Return type:

GasketTransverseShearElastic

Raises:

RangeError

Gel(table)[source]

This method creates a Gel object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Gel
session.odbs[name].materials[name].Gel
Parameters:
table

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

Returns:

A Gel object.

Return type:

Gel

HashinDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].HashinDamageInitiation
session.odbs[name].materials[name].HashinDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

Hyperelastic(
table,
type=UNKNOWN,
moduliTimeScale=LONG_TERM,
temperatureDependency=0,
n=1,
beta=FITTED_VALUE,
testData=1,
compressible=0,
properties=0,
deviatoricResponse=UNIAXIAL,
volumetricResponse=DEFAULT,
poissonRatio=0,
materialType=ISOTROPIC,
anisotropicType=FUNG_ANISOTROPIC,
formulation=STRAIN,
behaviorType=INCOMPRESSIBLE,
dependencies=0,
localDirections=0,
)[source]

This method creates a Hyperelastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Hyperelastic
session.odbs[name].materials[name].Hyperelastic
Parameters:
table

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

type=UNKNOWN

A SymbolicConstant specifying the type of strain energy potential. Possible values are:ARRUDA_BOYCEMARLOWMOONEY_RIVLINNEO_HOOKEOGDENPOLYNOMIALREDUCED_POLYNOMIALUSERVAN_DER_WAALSYEOHUNKNOWNThe default value is UNKNOWN.

moduliTimeScale=LONG_TERM

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

temperatureDependency=0

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

n=1

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=FITTED_VALUE

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=1

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

compressible=0

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=0

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

deviatoricResponse=UNIAXIAL

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

volumetricResponse=DEFAULT

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

poissonRatio=0

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

materialType=ISOTROPIC

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

anisotropicType=FUNG_ANISOTROPIC

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=STRAIN

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

behaviorType=INCOMPRESSIBLE

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

dependencies=0

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

localDirections=0

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

Returns:

A Hyperelastic object.

Return type:

Hyperelastic

Raises:
  • InvalidNameError

  • RangeError

Hyperfoam(
testData=0,
poisson=None,
n=1,
temperatureDependency=0,
moduli=LONG_TERM,
table=(),
)[source]

This method creates a Hyperfoam object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Hyperfoam
session.odbs[name].materials[name].Hyperfoam
Parameters:
testData=0

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

poisson=None

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=1

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

temperatureDependency=0

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

moduli=LONG_TERM

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.

Return type:

Hyperfoam

Raises:

RangeError

Hypoelastic(table, user=0)[source]

This method creates a Hypoelastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Hypoelastic
session.odbs[name].materials[name].Hypoelastic
Parameters:
table

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

user=0

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

Returns:

A Hypoelastic object.

Return type:

Hypoelastic

InelasticHeatFraction(fraction=0)[source]

This method creates an InelasticHeatFraction object.

Note

This function can be accessed by:

mdb.models[name].materials[name].InelasticHeatFraction
session.odbs[name].materials[name].InelasticHeatFraction
Parameters:
fraction=0

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.

Return type:

InelasticHeatFraction

Raises:

RangeError

JohnsonCookDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].JohnsonCookDamageInitiation
session.odbs[name].materials[name].JohnsonCookDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

JouleHeatFraction(fraction=1)[source]

This method creates a JouleHeatFraction object.

Note

This function can be accessed by:

mdb.models[name].materials[name].JouleHeatFraction
session.odbs[name].materials[name].JouleHeatFraction
Parameters:
fraction=1

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.

Return type:

JouleHeatFraction

Raises:

RangeError

LatentHeat(table)[source]

This method creates a LatentHeat object.

Note

This function can be accessed by:

mdb.models[name].materials[name].LatentHeat
session.odbs[name].materials[name].LatentHeat
Parameters:
table

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

Returns:

A LatentHeat object.

Return type:

LatentHeat

Raises:

RangeError

LowDensityFoam(
elementRemoval=0,
maxAllowablePrincipalStress=None,
extrapolateStressStrainCurve=0,
strainRateType=VOLUMETRIC,
mu0=None,
mu1=0,
alpha=2,
)[source]

This method creates a LowDensityFoam object.

Note

This function can be accessed by:

mdb.models[name].materials[name].LowDensityFoam
session.odbs[name].materials[name].LowDensityFoam
Parameters:
elementRemoval=0

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

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

extrapolateStressStrainCurve=0

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

strainRateType=VOLUMETRIC

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

mu0=None

A Float specifying the relaxation coefficient μ0. The default value is 10⁻⁴.

mu1=0

A Float specifying the relaxation coefficient μ1. The default value is 0.5x10⁻².

alpha=2

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

Returns:

A LowDensityFoam object.

Return type:

LowDensityFoam

Raises:

RangeError

MagneticPermeability(
table,
table2,
table3,
type=ISOTROPIC,
frequencyDependency=0,
temperatureDependency=0,
dependencies=0,
nonlinearBH=0,
)[source]

This method creates a MagneticPermeability object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MagneticPermeability
session.odbs[name].materials[name].MagneticPermeability
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=ISOTROPIC

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

frequencyDependency=0

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

temperatureDependency=0

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

dependencies=0

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

nonlinearBH=0

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.

Return type:

MagneticPermeability

Raises:

RangeError

MaxeDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxeDamageInitiation
session.odbs[name].materials[name].MaxeDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxpeDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxpeDamageInitiation
session.odbs[name].materials[name].MaxpeDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxpsDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxpsDamageInitiation
session.odbs[name].materials[name].MaxpsDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxsDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxsDamageInitiation
session.odbs[name].materials[name].MaxsDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MeanFieldHomogenization(
angleSubdivision=None,
formulation=MT,
isotropization=ALLISO,
uniformMatrixStrain=NO,
)[source]

This method creates a MeanFieldHomogenization object.

Note

This function can be accessed by:

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

Added in version 2018: The MeanFieldHomogenization method was added.

Parameters:
angleSubdivision=None

An Int specifying the number of angle increments used for the discretization of the orientation space.

formulation=MT

A SymbolicConstant specifying the type of homogenization model. Possible values are MT, REUSS, VOIGT, INVERSED_MT, BALANCED, and UNSPECIFIED. The default value is MT.

isotropization=ALLISO

A SymbolicConstant specifying the type of isotropization method. Possible values are ALLISO, EISO, and PISO. The default value is ALLISO.

uniformMatrixStrain=NO

A SymbolicConstant specifying whether the average strain in the matrix is uniform across all pseudo-grains. Possible values are NO and YES. The default value is NO.

Returns:

A MeanFieldHomogenization object.

Raises:

RangeError

MkDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MkDamageInitiation
session.odbs[name].materials[name].MkDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MohrCoulombPlasticity(
table,
deviatoricEccentricity=None,
meridionalEccentricity=0,
temperatureDependency=0,
dependencies=0,
useTensionCutoff=0,
)[source]

This method creates a MohrCoulombPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MohrCoulombPlasticity
session.odbs[name].materials[name].MohrCoulombPlasticity
Parameters:
table

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

deviatoricEccentricity=None

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

meridionalEccentricity=0

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

temperatureDependency=0

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

dependencies=0

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

useTensionCutoff=0

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

Returns:

A MohrCoulombPlasticity object.

Return type:

MohrCoulombPlasticity

Raises:

RangeError

MoistureSwelling(table)[source]

This method creates a MoistureSwelling object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MoistureSwelling
session.odbs[name].materials[name].MoistureSwelling
Parameters:
table

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

Returns:

A MoistureSwelling object.

Return type:

MoistureSwelling

MsfldDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MsfldDamageInitiation
session.odbs[name].materials[name].MsfldDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

Permeability(
specificWeight,
inertialDragCoefficient,
table,
type=ISOTROPIC,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a Permeability object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Permeability
session.odbs[name].materials[name].Permeability
Parameters:
specificWeight

A Float specifying the specific weight of the wetting liquid, \(\gamma_w\).

inertialDragCoefficient

A Float specifying The inertial drag coefficient of the wetting liquid, \(\gamma_w\).

table

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

type=ISOTROPIC

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Permeability object.

Return type:

Permeability

Raises:

RangeError

Piezoelectric(table, type=STRESS, temperatureDependency=0, dependencies=0)[source]

This method creates a Piezoelectric object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Piezoelectric
session.odbs[name].materials[name].Piezoelectric
Parameters:
table

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

type=STRESS

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Piezoelectric object.

Return type:

Piezoelectric

Plastic(
table,
hardening=ISOTROPIC,
rate=0,
dataType=HALF_CYCLE,
strainRangeDependency=0,
numBackstresses=1,
temperatureDependency=0,
dependencies=0,
extrapolation=CONSTANT,
)[source]

This method creates a Plastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Plastic
session.odbs[name].materials[name].Plastic
Parameters:
table

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

hardening=ISOTROPIC

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

rate=0

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

dataType=HALF_CYCLE

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=0

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=1

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

temperatureDependency=0

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

dependencies=0

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

extrapolation=CONSTANT

A SymbolicConstant specifying the extrapolation method for the yield stress with respect to the equivalent plastic strain. This argument is valid only if hardening=ISOTROPIC. Possible values are CONSTANT and LINEAR . The default value is CONSTANT.

Added in version 2022: The extrapolation argument was added.

Returns:

A Plastic object.

Return type:

Plastic

Raises:

RangeError

PlasticityCorrection(type, table, temperatureDependency=0, dependencies=0)[source]

This method creates a PlasticityCorrection object.

Note

This function can be accessed by:

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

Added in version 2023: The PlasticityCorrection method was added.

Parameters:
type

Set type=RAMBERG_OSGOOD to specify the Ramberg-Osgood relationship. Set type=TABULAR to specify the tabular form.

table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A PlasticCorrection object.

Return type:

PlasticityCorrection

Raises:

RangeError

PoreFluidExpansion(table, zero=0, temperatureDependency=0, dependencies=0)[source]

This method creates a PoreFluidExpansion object.

Note

This function can be accessed by:

mdb.models[name].materials[name].PoreFluidExpansion
session.odbs[name].materials[name].PoreFluidExpansion
Parameters:
table

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

zero=0

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A PoreFluidExpansion object.

Return type:

PoreFluidExpansion

Raises:

RangeError

PorousBulkModuli(table, temperatureDependency=0)[source]

This method creates a PorousBulkModuli object.

Note

This function can be accessed by:

mdb.models[name].materials[name].PorousBulkModuli
session.odbs[name].materials[name].PorousBulkModuli
Parameters:
table

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

temperatureDependency=0

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

Returns:

A PorousBulkModuli object.

Return type:

PorousBulkModuli

PorousElastic(table, shear=POISSON, temperatureDependency=0, dependencies=0)[source]

This method creates a PorousElastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].PorousElastic
session.odbs[name].materials[name].PorousElastic
Parameters:
table

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

shear=POISSON

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A PorousElastic object.

Return type:

PorousElastic

Raises:

RangeError

PorousMetalPlasticity(
table,
relativeDensity=None,
temperatureDependency=0,
dependencies=0,
)[source]

This method creates a PorousMetalPlasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].PorousMetalPlasticity
session.odbs[name].materials[name].PorousMetalPlasticity
Parameters:
table

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

relativeDensity=None

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A PorousMetalPlasticity object.

Return type:

PorousMetalPlasticity

Raises:

RangeError

QuadeDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].QuadeDamageInitiation
session.odbs[name].materials[name].QuadeDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

QuadsDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].QuadsDamageInitiation
session.odbs[name].materials[name].QuadsDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

Regularization(rtol=0, strainRateRegularization=LOGARITHMIC)[source]

This method creates a Regularization object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Regularization
session.odbs[name].materials[name].Regularization
Parameters:
rtol=0

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

strainRateRegularization=LOGARITHMIC

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.

Return type:

Regularization

Raises:

RangeError

ShearDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].ShearDamageInitiation
session.odbs[name].materials[name].ShearDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

Solubility(table, temperatureDependency=0, dependencies=0)[source]

This method creates a Solubility object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Solubility
session.odbs[name].materials[name].Solubility
Parameters:
table

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Solubility object.

Return type:

Solubility

Raises:

RangeError

Sorption(
absorptionTable,
lawAbsorption=TABULAR,
exsorption=0,
lawExsorption=TABULAR,
scanning=0,
exsorptionTable=(),
)[source]

This method creates a Sorption object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Sorption
session.odbs[name].materials[name].Sorption
Parameters:
absorptionTable

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

lawAbsorption=TABULAR

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

exsorption=0

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

lawExsorption=TABULAR

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

scanning=0

A Float specifying the slope of the scanning line, \(\left.\left(d u_{w} / d s\right)\right|_{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.

Return type:

Sorption

Raises:

RangeError

SpecificHeat(table, law=CONSTANTVOLUME, temperatureDependency=0, dependencies=0)[source]

This method creates a SpecificHeat object.

Note

This function can be accessed by:

mdb.models[name].materials[name].SpecificHeat
session.odbs[name].materials[name].SpecificHeat
Parameters:
table

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

law=CONSTANTVOLUME

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A SpecificHeat object.

Return type:

SpecificHeat

Raises:

RangeError

Swelling(table, law=INPUT, temperatureDependency=0, dependencies=0)[source]

This method creates a Swelling object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Swelling
session.odbs[name].materials[name].Swelling
Parameters:
table

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

law=INPUT

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Swelling object.

Return type:

Swelling

Raises:

RangeError

UserMaterial(
type=MECHANICAL,
unsymm=0,
mechanicalConstants=(),
thermalConstants=(),
effmod=0,
hybridFormulation=INCREMENTAL,
)[source]

This method creates a UserMaterial object.

Note

This function can be accessed by:

mdb.models[name].materials[name].UserMaterial
session.odbs[name].materials[name].UserMaterial
Parameters:
type=MECHANICAL

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=0

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=0

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=INCREMENTAL

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.

Return type:

UserMaterial

Raises:

RangeError

UserOutputVariables(n=0)[source]

This method creates a UserOutputVariables object.

Note

This function can be accessed by:

mdb.models[name].materials[name].UserOutputVariables
session.odbs[name].materials[name].UserOutputVariables
Parameters:
n=0

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

Returns:

A UserOutputVariables object.

Return type:

UserOutputVariables

Raises:

RangeError

Viscoelastic(
domain,
table,
frequency=FORMULA,
type=ISOTROPIC,
preload=NONE,
time=PRONY,
errtol=0,
nmax=13,
volumetricTable=(),
)[source]

This method creates a Viscoelastic object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Viscoelastic
session.odbs[name].materials[name].Viscoelastic
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=FORMULA

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=ISOTROPIC

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=NONE

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=PRONY

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=0

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=13

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.

Return type:

Viscoelastic

Raises:

RangeError

Viscosity(table, type=NEWTONIAN, temperatureDependency=0, dependencies=0)[source]

This method creates a Viscosity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Viscosity
session.odbs[name].materials[name].Viscosity
Parameters:
table

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

type=NEWTONIAN

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

temperatureDependency=0

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

dependencies=0

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

Returns:

A Viscosity object.

Return type:

Viscosity

Raises:

RangeError

Viscous(table, law=STRAIN, temperatureDependency=0, dependencies=0, time=TOTAL)[source]

This method creates a Viscous object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Viscous
session.odbs[name].materials[name].Viscous
Parameters:
table

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

law=STRAIN

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.

Added in version 2020: The options ANAND, DARVEAUX, DOUBLE_POWER, POWER_LAW, and TIME_POWER_LAW were added.

temperatureDependency=0

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

dependencies=0

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

time=TOTAL

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

Returns:

A Viscous object.

Return type:

Viscous

Other Classes

class AcousticMedium(
acousticVolumetricDrag=0,
temperatureDependencyB=0,
temperatureDependencyV=0,
dependenciesB=0,
dependenciesV=0,
bulkTable=(),
volumetricTable=(),
)[source]

Bases: object

The AcousticMedium object specifies the acoustic properties of a material.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the AcousticMedium object.

Raises:

RangeError

class Density(
table,
temperatureDependency=0,
dependencies=0,
distributionType=UNIFORM,
fieldName='',
)[source]

Bases: object

The Density object specifies the material density.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Density object.

Raises:

RangeError

class BiaxialTestData(
table,
smoothing=None,
lateralNominalStrain=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The BiaxialTestData object provides equibiaxial test data (compression and/or tension).

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the BiaxialTestData object.

class Hyperfoam(
testData=0,
poisson=None,
n=1,
temperatureDependency=0,
moduli=LONG_TERM,
table=(),
)[source]

Bases: object

The Hyperfoam object specifies elastic properties for a hyperelastic foam.

Note

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:

  • \(\mu_i\) and \(\alpha_i\) for \(i\) from 1 to \(n\).

  • :math:nu_i`.

  • Temperature, if the data depend on temperature. Temperature dependence is not allowed for \(4\le n\le 6\) in an Abaqus/Explicit analysis.

The corresponding analysis keywords are:

  • HYPERFOAM

Member Details:

biaxialTestData : --is-rst--:py:class:`~abaqus.Material.TestData.BiaxialTestData.BiaxialTestData` = <abaqus.Material.TestData.BiaxialTestData.BiaxialTestData object>[source]

A BiaxialTestData object.

planarTestData : --is-rst--:py:class:`~abaqus.Material.TestData.PlanarTestData.PlanarTestData` = <abaqus.Material.TestData.PlanarTestData.PlanarTestData object>[source]

A PlanarTestData object.

setValues(*args, **kwargs)[source]

This method modifies the Hyperfoam object.

Raises:

RangeError

simpleShearTestData : --is-rst--:py:class:`~abaqus.Material.TestData.SimpleShearTestData.SimpleShearTestData` = <abaqus.Material.TestData.SimpleShearTestData.SimpleShearTestData object>[source]

A SimpleShearTestData object.

uniaxialTestData : --is-rst--:py:class:`~abaqus.Material.TestData.UniaxialTestData.UniaxialTestData` = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

volumetricTestData : --is-rst--:py:class:`~abaqus.Material.TestData.VolumetricTestData.VolumetricTestData` = <abaqus.Material.TestData.VolumetricTestData.VolumetricTestData object>[source]

A VolumetricTestData object.

class PlanarTestData(
table,
smoothing=None,
lateralNominalStrain=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The PlanarTestData object specifies planar test (or pure shear) data (compression and/or tension).

Note

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, \(T_{S}\)

    • Nominal strain in the direction of loading, \(\epsilon_{S}\).

  • For a hyperfoam material model, the table data specify the following:

    • Nominal stress, \(T_{L}\).

    • Nominal strain in the direction of loading, \(\epsilon_{p}\).

    • Nominal transverse strain, \(\epsilon_{3}\). The default value is 0 .

The corresponding analysis keywords are:

  • PLANAR TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the PlanarTestData object.

class SimpleShearTestData(table)[source]

Bases: object

The SimpleShearTestData object provides simple shear test data.

Note

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, \(T_{S}\).

  • Nominal shear strain, \(\gamma\)

  • Nominal transverse stress, \(T_{T}\) (normal to edge with shear stress). This stress value is optional.

The corresponding analysis keywords are:

  • SIMPLE SHEAR TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SimpleShearTestData object.

class UniaxialTestData(
table,
smoothing=None,
lateralNominalStrain=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The UniaxialTestData object provides uniaxial test data (compression and/or tension).

Note

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, \(T_{U}\).

    • Nominal strain, \(\epsilon_{U}\).

  • For a hyperfoam material model, the table data specify the following:

    • Nominal stress, \(T_{L}\).

    • Nominal strain, \(\epsilon_{U}\).

    • Nominal lateral strain, \(\epsilon_{2}=\epsilon_{3}\). The default value is 0 .

  • For a low-density foam material model, the table data specify the following:

    • Nominal stress, \(T_{U}\).

    • Nominal strain, \(\epsilon_{U}\).

    • Nominal strain rate, \(\dot{\epsilon_{U}}\).

The corresponding analysis keywords are:

  • UNIAXIAL TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the UniaxialTestData object.

class VolumetricTestData(
table,
volinf=None,
smoothing=None,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The VolumetricTestData object provides volumetric test data.

Note

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

    • If time = RELAXATION_TEST_DATA, the table data specify the following:

      • Normalized volumetric (bulk) modulus \(k_{R}(t), \quad\left(0 \leq k_{R}(t) \leq 1\right)\)

      • Time \(t (t>0)\).

    • If time = CREEP_TEST_DATA, the table data specify the following:

      • Normalized volumetric (bulk) compliance \(j_{K}(t), \quad\left(j_{K}(t) \geq 1\right)\).

      • Time \(t(t>0)\)

The corresponding analysis keywords are:

  • VOLUMETRIC TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the VolumetricTestData object.

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

Bases: object

The Hyperelastic object specifies elastic properties for approximately incompressible elastomers.

Note

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:

    • \(\mu\).

    • \(\lambda_{m}\).

    • \(D\).

    • Temperature, if the data depend on temperature.

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

    • \(C_{10}\)

    • \(C_{01}\).

    • \(D_{1}\).

    • Temperature, if the data depend on temperature.

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

    • \(C_{10}\)

    • \(D_{1}\).

    • Temperature, if the data depend on temperature.

  • If type = OGDEN, the table data specify the following for values of nn:

    • \(\mu_{i}\) and \(\alpha_{i}\) for \(i\) from 1 to \(n\).

    • \(n\) coefficients \(D_{i}\).

    • Temperature, if the data depend on temperature. Temperature dependence is not allowed for \(4 \leq n \leq 6\) in an Abaqus/Explicit analysis.

  • If type = POLYNOMIAL, the table data specify the following for values of nn:

    • \(C_{i j}\) for each value of \((i+j)\) from 1 to \(n\) with \(i\) decreasing from \((i+j)\) to zero and \(j\) increasing from zero to \((i+j)\).

    • \(n\) coefficients \(D_{i}\)

    • Temperature, if the data depend on temperature. Temperature dependence is not allowed for \(3 \leq n \leq 6\) in an Abaqus/Explicit analysis.

  • If type = REDUCED_POLYNOMIAL, the table data specify the following for values of nn:

    • \(C_{i 0}\) for \(i\) from 1 to \(n\).

    • \(n\) coefficients \(D_{i}\)

    • Temperature, if the data depend on temperature. Temperature dependence is not allowed for \(4 \leq n \leq 6\) in an Abaqus/Explicit analysis.

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

    • \(\mu\).

    • \(\lambda_{m}\).

    • \(a\).

    • \(\beta\).

    • \(D\).

    • Temperature, if the data depend on temperature.

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

    • \(C_{10}\)

    • \(C_{20}\)

    • \(C_{30}\)

    • \(D_{1}\).

    • \(D_{2}\)

    • \(D_{3}\).

    • 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

Member Details:

biaxialTestData : --is-rst--:py:class:`~abaqus.Material.TestData.BiaxialTestData.BiaxialTestData` = <abaqus.Material.TestData.BiaxialTestData.BiaxialTestData object>[source]

A BiaxialTestData object.

hysteresis : --is-rst--:py:class:`~abaqus.Material.Elastic.HyperElastic.ViscoElastic.Hysteresis.Hysteresis` = <abaqus.Material.Elastic.HyperElastic.ViscoElastic.Hysteresis.Hysteresis object>[source]

A Hysteresis object.

planarTestData : --is-rst--:py:class:`~abaqus.Material.TestData.PlanarTestData.PlanarTestData` = <abaqus.Material.TestData.PlanarTestData.PlanarTestData object>[source]

A PlanarTestData object.

setValues(*args, **kwargs)[source]

This method modifies the Hyperelastic object.

Raises:

RangeError

uniaxialTestData : --is-rst--:py:class:`~abaqus.Material.TestData.UniaxialTestData.UniaxialTestData` = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

volumetricTestData : --is-rst--:py:class:`~abaqus.Material.TestData.VolumetricTestData.VolumetricTestData` = <abaqus.Material.TestData.VolumetricTestData.VolumetricTestData object>[source]

A VolumetricTestData object.

class Hysteresis(table)[source]

Bases: object

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

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Hysteresis object.

Raises:

RangeError

class CombinedTestData(table, volinf=None, shrinf=None)[source]

Bases: object

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

Note

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, \(g_R(t)\) (\(0\le g_R(t)\le 1\)).

  • Normalized volumetric (bulk) modulus, \(k_R(t)\) (\(0\le k_R(t)\le 1\)).

  • Time \(t\) (\(t>0\)).

If time = CREEP_TEST_DATA, the table data specify the following:

  • Normalized shear compliance, \(j_S(t)\) (\(j_S(t)\ge 1\)).

  • Normalized volumetric (bulk) compliance, \(j_K(t)\) (\(j_K(t)\ge 1\)).

  • Time \(t\) (\(t>0\)).

The corresponding analysis keywords are:

  • COMBINED TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CombinedTestData object.

class ShearTestData(table, shrinf=None)[source]

Bases: object

The ShearTestData object specifies the normalized shear creep compliance or relaxation modulus as a function of time.

Note

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 table data for this object are:

  • If time = RELAXATION_TEST_DATA, the table data specify the following:

    • Normalized shear relaxation modulus \(g_{R}(t)\). \(\left(0 \leq g_{R}(t) \leq 1\right)\)

    • Time \(t (t>0)\).

  • If time = CREEP_TEST_DATA, the table data specify the following:

    • Normalized shear compliance \(j_{S}(t)\). \(\left(j_{S}(t) \geq 1\right)\).

    • Time \(t (t>0)\).

The corresponding analysis keywords are:

  • SHEAR TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ShearTestData object.

class Trs(definition=WLF, table=())[source]

Bases: object

The Trs object defines the temperature-time shift for time history viscoelastic analysis.

Note

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, \(\theta_{0}\).

  • Calibration constant, \(C_{1}\).

  • Calibration constant, \(C_{2}\).

The corresponding analysis keywords are:

  • TRS

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Trs object.

class Viscoelastic(
domain,
table,
frequency=FORMULA,
type=ISOTROPIC,
preload=NONE,
time=PRONY,
errtol=0,
nmax=13,
volumetricTable=(),
)[source]

Bases: object

The Viscoelastic object specifies dissipative behavior for use with elasticity.

Note

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}^{*}\left(g^{*}(\omega)=g_{1}^{*} f^{-a}\right)\)

    • Imaginary part of \(g_{1}^{*}\).

    • Value of \(a\).

    • Real part of \(k_{1}^{*}\left(k^{*}(\omega)=k_{1}^{*} f^{-b}\right)\). If the material is incompressible, this value is ignored.

    • Imaginary part of \(k_{1}^{*}\). 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 \(\omega g^{*}\left(\omega \Re\left(g^{*}\right)=G_{\ell} / G_{\infty}\right)\).

    • Imaginary part of \(\omega g^{*}\left(\omega \mathfrak{J}\left(g^{*}\right)=1-G_{s} / G_{\infty}\right)\)

    • Real part of \(\omega k^{*}\left(\omega \mathfrak{R}\left(k^{*}\right)=\mathrm{K}_{\ell} / \mathrm{K}_{\infty}\right)\). If the material is incompressible, this value is ignored.

    • Imaginary part of \(\omega k^{*}\left(\omega \mathfrak{I}\left(k^{*}\right)=1-\mathrm{K}_{s} / \mathrm{K}_{\infty}\right)\). 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:

    • \(\bar{g}_{1}^{P}\), the modulus ratio in the first term in the Prony series expansion of the shear relaxation modulus.

    • \(\bar{k}_{1}^{P}\), the modulus ratio in the first term in the Prony series expansion of the bulk relaxation modulus.

    • \(\tau_{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

Member Details:

combinedTestData : --is-rst--:py:class:`~abaqus.Material.Elastic.HyperElastic.ViscoElastic.CombinedTestData.CombinedTestData` = <abaqus.Material.Elastic.HyperElastic.ViscoElastic.CombinedTestData.CombinedTestData object>[source]

A CombinedTestData object.

setValues(*args, **kwargs)[source]

This method modifies the Viscoelastic object.

Raises:

RangeError

shearTestData : --is-rst--:py:class:`~abaqus.Material.TestData.ShearTestData.ShearTestData` = <abaqus.Material.TestData.ShearTestData.ShearTestData object>[source]

A ShearTestData object.

trs : --is-rst--:py:class:`~abaqus.Material.Mechanical.Viscosity.Trs.Trs` = <abaqus.Material.Mechanical.Viscosity.Trs.Trs object>[source]

A Trs object.

volumetricTestData : --is-rst--:py:class:`~abaqus.Material.TestData.VolumetricTestData.VolumetricTestData` = <abaqus.Material.TestData.VolumetricTestData.VolumetricTestData object>[source]

A VolumetricTestData object.

class Hypoelastic(table, user=0)[source]

Bases: object

The Hypoelastic object specifies hypoelastic material properties.

Note

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, \(\nu\).

  • First strain invariant, \(I_1\).

  • Second strain invariant, \(I_2\).

  • Third strain invariant, \(I_3\).

The corresponding analysis keywords are:

  • HYPOELASTIC

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Hypoelastic object.

class Elastic(
table,
type=ISOTROPIC,
noCompression=0,
noTension=0,
temperatureDependency=0,
dependencies=0,
moduli=LONG_TERM,
)[source]

Bases: object

The Elastic object specifies elastic material properties.

Note

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, \(\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.

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

    • \(E_{1}\).

    • \(E_{2}\).

    • \(E_{3}\).

    • \(\nu_{12}\).

    • \(\nu_{13}\).

    • \(\nu_{23}\).

    • \(G_{12}\).

    • \(G_{13}\).

    • \(G_{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 = LAMINA, the table data specify the following:

    • \(E_{1}\).

    • \(E_{2}\).

    • \(\nu_{12}\).

    • \(G_{12}\).

    • \(G_{13}\). This shear modulus is needed to define transverse shear behavior in shells.

    • \(G_{23}\). 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:

    • \(D_{1111}\)

    • \(D_{1122}\)

    • \(D_{2222}\)

    • \(D_{1133}\)

    • \(D_{2233}\)

    • \(D_{3333}\)

    • \(D_{1212}\)

    • \(D_{1313}\)

    • \(D_{2323}\)

    • 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_{1111}\).

    • \(D_{1122}\).

    • \(D_{2222}\).

    • \(D_{1133}\).

    • \(D_{2233}\).

    • \(D_{3333}\).

    • \(D_{1112}\).

    • \(D_{2212}\).

    • \(D_{3312}\).

    • \(D_{1212}\).

    • \(D_{1113}\).

    • \(D_{2213}\).

    • \(D_{3313}\).

    • \(D_{1213}\).

    • \(D_{1313}\).

    • \(D_{1123}\).

    • \(D_{2223}\).

    • \(D_{3323}\).

    • \(D_{1223}\).

    • \(D_{1323}\).

    • \(D_{2323}\).

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

    • \(E\) for warping elements; \(E_{nn}\) for cohesive elements.

    • \(G_1\) for warping elements; \(E_{ss}\) for cohesive elements.

    • \(G_2\) for warping elements; \(E_{tt}\) 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 = BILAMINA, the table data specify the following:

    • \(E_{n n}\).

    • \(E_{s s}\).

    • \(E_{t t}\).

    • \(E_{n s}\).

    • \(E_{n t}\).

    • \(E_{s 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.

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

The corresponding analysis keywords are:

  • ELASTIC

Member Details:

failStrain : --is-rst--:py:class:`~abaqus.Material.Elastic.Linear.FailStrain.FailStrain` = <abaqus.Material.Elastic.Linear.FailStrain.FailStrain object>[source]

A FailStrain object.

failStress : --is-rst--:py:class:`~abaqus.Material.Elastic.Linear.FailStress.FailStress` = <abaqus.Material.Elastic.Linear.FailStress.FailStress object>[source]

A FailStress object.

setValues(*args, **kwargs)[source]

This method modifies the Elastic object.

Raises:

RangeError

class FailStrain(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The FailStrain object defines parameters for strain-based failure measures.

Note

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_{\varepsilon t}\).

  • Compressive strain limit in fiber direction, \(X_{\varepsilon c}\).

  • Tensile strain limit in transverse direction, \(Y_{\varepsilon t}\),

  • Compressive strain limit in transverse direction, \(Y_{\varepsilon c}\).

  • Shear strain limit in the \(X - Y\) plane, \(S_{\varepsilon}\).

  • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the FailStrain object.

Raises:

RangeError

class FailStress(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The FailStress object defines parameters for stress-based failure measures.

Note

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, \(X_{t}\).

  • Compressive stress limit in fiber direction, \(X_{c}\).

  • Tensile stress limit in transverse direction, \(Y_{t}\)

  • Compressive stress limit in transverse direction, \(Y_{c}\).

  • Shear strength in the \(X - Y\) plane, \(S\).

  • Cross product term coefficient, \(f^{*} (-1.0 \leq f^{*} \leq 1.0)\). The default value is zero.

  • Biaxial stress limit, \(\sigma_{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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the FailStress object.

Raises:

RangeError

class LowDensityFoam(
elementRemoval=0,
maxAllowablePrincipalStress=None,
extrapolateStressStrainCurve=0,
strainRateType=VOLUMETRIC,
mu0=None,
mu1=0,
alpha=2,
)[source]

Bases: object

The LowDensityFoam object specifies properties for low-density foam.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the LowDensityFoam object.

Raises:

RangeError

uniaxialCompressionTestData : --is-rst--:py:class:`~abaqus.Material.TestData.UniaxialTestData.UniaxialTestData` = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

uniaxialTensionTestData : --is-rst--:py:class:`~abaqus.Material.TestData.UniaxialTestData.UniaxialTestData` = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

class PorousElastic(table, shear=POISSON, temperatureDependency=0, dependencies=0)[source]

Bases: object

The PorousElastic object specifies elastic material properties for porous materials.

Note

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, \(\kappa\). (Dimensionless.)

    • The shear modulus, \(G\).

    • The elastic tensile limit, \(p_{t}^{e 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, \(\kappa\). (Dimensionless.)

    • The Poisson’s ratio, \(\nu\).

    • The elastic tensile limit, \(p_{t}^{e 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the PorousElastic object.

Raises:

RangeError

class SuperElasticHardening(table)[source]

Bases: object

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.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SuperElasticHardening object.

Raises:

RangeError

class SuperElasticHardeningModifications(table)[source]

Bases: object

The SuperElasticHardeningModifications object specifies the variation of the transformation stress levels of a material model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SuperElasticHardeningModifications object.

Raises:

RangeError

class SuperElasticity(table, nonassociated=None)[source]

Bases: object

The SuperElasticity object specifies a superelastic material model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SuperElasticity object.

Raises:

RangeError

superElasticHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.SuperElastic.SuperElasticHardening.SuperElasticHardening` = <abaqus.Material.Plastic.SuperElastic.SuperElasticHardening.SuperElasticHardening object>[source]

A [SuperElasticHardening object](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-c-superelastichardeningpyc.htm?ContextScope=all#simaker-c-superelastichardeningpyc).

superElasticHardeningModifications : --is-rst--:py:class:`~abaqus.Material.Plastic.SuperElastic.SuperElasticHardeningModifications.SuperElasticHardeningModifications` = <abaqus.Material.Plastic.SuperElastic.SuperElasticHardeningModifications.SuperElasticHardeningModifications object>[source]

A [SuperElasticHardeningModifications object](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-c-superelastichardeningmodificationpyc.htm?ContextScope=all#simaker-c-superelastichardeningmodificationpyc).

class Dielectric(
table,
type=ISOTROPIC,
frequencyDependency=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The Dielectric object specifies dielectric material properties.

Note

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}^{\varphi}\)

    • \(D_{22}^{\varphi}\).

    • \(D_{33}^{\varphi}\)

    • 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}^{\varphi}\)

    • \(D_{12}^{\varphi}\)

    • \(D_{22}^{\varphi}\)

    • \(D_{13}^{\varphi}\)

    • \(D_{23}^{\varphi}\)

    • \(D_{33}^{\varphi}\)

    • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Dielectric object.

class ElectricalConductivity(
table,
type=ISOTROPIC,
frequencyDependency=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The ElectricalConductivity object specifies electrical conductivity.

Note

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:

    • \(\sigma_{11}^{E}\).

    • \(\sigma_{22}^{E}\).

    • \(\sigma_{33}^{E}\).

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

    • \(\sigma_{11}^{E}\).

    • \(\sigma_{12}^{E}\).

    • \(\sigma_{22}^{E}\).

    • \(\sigma_{13}^{E}\).

    • \(\sigma_{23}^{E}\).

    • \(\sigma_{33}^{E}\).

    • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ElectricalConductivity object.

Raises:

RangeError

class MagneticPermeability(
table,
table2,
table3,
type=ISOTROPIC,
frequencyDependency=0,
temperatureDependency=0,
dependencies=0,
nonlinearBH=0,
)[source]

Bases: object

The MagneticPermeability object specifies magnetic permeability.

Note

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:

    • \(\mu_{11}^{E}\).

    • \(\mu_{22}^{E}\).

    • \(\mu_{33}^{E}\).

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

    • \(\mu_{11}^{E}\).

    • \(\mu_{12}^{E}\).

    • \(\mu_{22}^{E}\).

    • \(\mu_{13}^{E}\).

    • \(\mu_{23}^{E}\).

    • \(\mu_{33}^{E}\).

    • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the MagneticPermeability object.

Raises:

RangeError

class Piezoelectric(table, type=STRESS, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Piezoelectric object specifies piezoelectric material properties.

Note

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:

    • \(e_{111}^{\varphi}\).

    • \(e_{122}^{\varphi}\).

    • \(e_{133}^{\varphi}\).

    • \(e_{112}^{\varphi}\).

    • \(e_{113}^{\varphi}\).

    • \(e_{123}^{\varphi}\).

    • \(e_{211}^{\varphi}\).

    • \(e_{222}^{\varphi}\).

    • \(e_{233}^{\varphi}\).

    • \(e_{212}^{\varphi}\).

    • \(e_{213}^{\varphi}\).

    • \(e_{223}^{\varphi}\).

    • \(e_{311}^{\varphi}\).

    • \(e_{322}^{\varphi}\).

    • \(e_{333}^{\varphi}\).

    • \(e_{312}^{\varphi}\).

    • \(e_{313}^{\varphi}\).

    • \(e_{323}^{\varphi}\).

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

    • \(d_{111}^{\varphi}\).

    • \(d_{122}^{\varphi}\).

    • \(d_{133}^{\varphi}\).

    • \(d_{112}^{\varphi}\).

    • \(d_{113}^{\varphi}\).

    • \(d_{123}^{\varphi}\).

    • \(d_{211}^{\varphi}\).

    • \(d_{222}^{\varphi}\).

    • \(d_{233}^{\varphi}\).

    • \(d_{212}^{\varphi}\).

    • \(d_{213}^{\varphi}\).

    • \(d_{223}^{\varphi}\).

    • \(d_{311}^{\varphi}\).

    • \(d_{322}^{\varphi}\).

    • \(d_{333}^{\varphi}\).

    • \(d_{313}^{\varphi}\).

    • \(d_{323}^{\varphi}\).

    • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Piezoelectric object.

class DetonationPoint(table)[source]

Bases: object

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.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DetonationPoint object.

class Eos(
type=IDEALGAS,
temperatureDependency=0,
dependencies=0,
detonationEnergy=0,
solidTable=(),
gasTable=(),
reactionTable=(),
gasSpecificTable=(),
table=(),
)[source]

Bases: object

The Eos object specifies an equation of state model.

Note

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, \(p_{A}\). 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, \(C_{d}\).

    • \(A\).

    • \(B\).

    • \(\omega\). (Dimensionless.)

    • \(R_{1}\). (Dimensionless.)

    • \(R_{2}\). (Dimensionless.)

    • Pre-detonation bulk modulus, \(K_{p d}\).

    • Detonation energy density, \(E_{0}\).

  • If type = USUP, the table data represents the following:

    • \(C_{0}\)

    • \(\boldsymbol{S}\). (Dimensionless.)

    • \(\Gamma_{0}\). (Dimensionless.)

  • If type = TABULAR, the table data represents the following:

    • \(F_{1}\)

    • \(F_{2}\)

    • \(\varepsilon_{v o l}^{c}\). (Dimensionless.)

Member Details:

class EosCompaction(soundSpeed, porosity, pressure, compactionPressure)[source]

Bases: object

The EosCompaction object specifies material eos compaction.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the EosCompaction object.

Raises:

RangeError

class GapConductance(pressureDependency=0, dependencies=0, table=())[source]

Bases: object

The GapConductance object specifies conductive heat transfer between closely adjacent (or contacting) surfaces.

Note

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

Added in version 2021: The GapConductance class was added.

Member Details:

setValues()[source]

This method modifies the GapConductance object.

class GapConvection(type, table=(), temperatureDependency=0, dependencies=0)[source]

Bases: object

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.

Note

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

Added in version 2021: The GapConvection class was added.

Member Details:

setValues()[source]

This method modifies the GapConvection object.

class GapFlow(table, kmax=None, temperatureDependency=0, dependencies=0, type=NEWTONIAN)[source]

Bases: object

The GapFlow object specifies tangential flow constitutive parameters for pore pressure cohesive elements.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the GapFlow object.

class GapRadiation(masterSurfaceEmissivity, slaveSurfaceEmissivity, table)[source]

Bases: object

The GapRadiation object specifies radiative heat transfer between closely adjacent surfaces.

Note

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

Added in version 2021: The GapRadiation class was added.

Member Details:

setValues()[source]

This method modifies the GapRadiation object.

class ContactArea(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

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.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ContactArea object.

class GasketMembraneElastic(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The GasketMembraneElastic object defines the elastic parameters for the membrane shear behavior of a gasket.

Note

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, \(\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:

  • GASKET ELASTICITY

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the GasketMembraneElastic object.

Raises:

RangeError

class GasketThicknessBehavior(
table,
temperatureDependency=0,
dependencies=0,
tensileStiffnessFactor=None,
type=ELASTIC_PLASTIC,
unloadingDependencies=0,
unloadingTemperatureDependency=0,
variableUnits=STRESS,
yieldOnset=0,
yieldOnsetMethod=RELATIVE_SLOPE_DROP,
unloadingTable=(),
)[source]

Bases: object

The GasketThicknessBehavior object defines the behavior in the thickness direction for a gasket.

Note

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

Member Details:

contactArea : --is-rst--:py:class:`~abaqus.Material.Gasket.ContactArea.ContactArea` = <abaqus.Material.Gasket.ContactArea.ContactArea object>[source]

A ContactArea object.

setValues(*args, **kwargs)[source]

This method modifies the GasketThicknessBehavior object.

Raises:

RangeError

class GasketTransverseShearElastic(
table,
variableUnits=STRESS,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The GasketTransverseShearElastic object defines the elastic parameters for the transverse shear behavior of a gasket.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the GasketTransverseShearElastic object.

Raises:

RangeError

class Conductivity(table, type=ISOTROPIC, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Conductivity object specifies thermal conductivity.

Note

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:

    • \(k_{11}\)

    • \(k_{22}\).

    • \(k_{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:

    • \(k_{11}\).

    • \(k_{12}\).

    • \(k_{22}\).

    • \(k_{13}\).

    • \(k_{23}\).

    • \(k_{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.

The corresponding analysis keywords are:

  • CONDUCTIVITY

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Conductivity object.

Raises:

RangeError

class HeatGeneration[source]

Bases: object

The HeatGeneration object includes volumetric heat generation in heat transfer analyses.

Note

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

Member Details:

class InelasticHeatFraction(fraction=0)[source]

Bases: object

The InelasticHeatFraction object defines the fraction of the rate of inelastic dissipation that appears as a heat source.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the InelasticHeatFraction object.

Raises:

RangeError

class JouleHeatFraction(fraction=1)[source]

Bases: object

The JouleHeatFraction object defines the fraction of electric energy released as heat.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the JouleHeatFraction object.

Raises:

RangeError

class LatentHeat(table)[source]

Bases: object

The LatentHeat object specifies a material’s latent heat.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the LatentHeat object.

Raises:

RangeError

class SpecificHeat(table, law=CONSTANTVOLUME, temperatureDependency=0, dependencies=0)[source]

Bases: object

The SpecificHeat object specifies a material’s specific heat.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SpecificHeat object.

Raises:

RangeError

class Diffusivity(table, type=ISOTROPIC, law=GENERAL, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Diffusivity object specifies mass diffusivity.

Note

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:

    • \(D_{11}\).

    • \(D_{22}\).

    • \(D_{33}\).

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

    • \(D_{11}\).

    • \(D_{12}\).

    • \(D_{22}\).

    • \(D_{13}\).

    • \(D_{23}\).

    • \(D_{33}\).

    • 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

Member Details:

pressureEffect : --is-rst--:py:class:`~abaqus.Material.MassDiffusion.PressureEffect.PressureEffect` = <abaqus.Material.MassDiffusion.PressureEffect.PressureEffect object>[source]

A PressureEffect object.

setValues(*args, **kwargs)[source]

This method modifies the Diffusivity object.

Raises:

RangeError

soretEffect : --is-rst--:py:class:`~abaqus.Material.MassDiffusion.SoretEffect.SoretEffect` = <abaqus.Material.MassDiffusion.SoretEffect.SoretEffect object>[source]

A SoretEffect object.

class PressureEffect(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The PressureEffect object defines equivalent pressure stress driven mass diffusion.

Note

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, \(\kappa_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the PressureEffect object.

Raises:

RangeError

class SoretEffect(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The SoretEffect object defines temperature gradient driven mass diffusion.

Note

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, \(\kappa_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SoretEffect object.

Raises:

RangeError

class Solubility(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Solubility object specifies solubility.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Solubility object.

Raises:

RangeError

class BrittleCracking(table, temperatureDependency=0, dependencies=0, type=STRAIN)[source]

Bases: object

The BrittleCracking object specifies cracking and postcracking properties for the brittle cracking material model.

Note

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

Member Details:

brittleFailure : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.BrittleFailure.BrittleFailure` = <abaqus.Material.Plastic.Concrete.BrittleFailure.BrittleFailure object>[source]

A BrittleFailure object.

brittleShear : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.BrittleShear.BrittleShear` = <abaqus.Material.Plastic.Concrete.BrittleShear.BrittleShear object>[source]

A BrittleShear object.

setValues(*args, **kwargs)[source]

This method modifies the BrittleCracking object.

class CapPlasticity(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CapPlasticity object specifies the modified Drucker-Prager/Cap plasticity model.

Note

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, \(\beta\), in the \(p-t\) plane (Abaqus/Standard) or in the \(p-q\) plane (Abaqus/Explicit). Give the value in degrees.

  • Cap eccentricity parameter, \(R\). Its value must be greater than zero (typically \(0.0<R<1.0)\).

  • Initial cap yield surface position, \(\left.\varepsilon_{v o l}^{p l}\right|_{0}\)

  • Transition surface radius parameter, \(\alpha\). The default value is \(0.0\) (i.e., no transition surface). 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

Member Details:

capCreepCohesion : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapCreepCohesion.CapCreepCohesion` = <abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapCreepCohesion.CapCreepCohesion object>[source]

A CapCreepCohesion object.

capCreepConsolidation : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapCreepConsolidation.CapCreepConsolidation` = <abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapCreepConsolidation.CapCreepConsolidation object>[source]

A CapCreepConsolidation object.

capHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapHardening.CapHardening` = <abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapHardening.CapHardening object>[source]

A CapHardening object.

setValues(*args, **kwargs)[source]

This method modifies the CapPlasticity object.

Raises:

RangeError

class CastIronPlasticity(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CastIronPlasticity object specifies the Cast Iron plasticity model.

Note

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, \(\nu_{pl}\) (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

Member Details:

castIronCompressionHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.CastIron.CastIronCompressionHardening.CastIronCompressionHardening` = <abaqus.Material.Plastic.Metal.CastIron.CastIronCompressionHardening.CastIronCompressionHardening object>[source]

A CastIronCompressionHardening object.

castIronTensionHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.CastIron.CastIronTensionHardening.CastIronTensionHardening` = <abaqus.Material.Plastic.Metal.CastIron.CastIronTensionHardening.CastIronTensionHardening object>[source]

A CastIronTensionHardening object.

setValues(*args, **kwargs)[source]

This method modifies the CastIronPlasticity object.

Raises:

RangeError

class ClayPlasticity(
table,
intercept=None,
hardening=EXPONENTIAL,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The ClayPlasticity object specifies the extended Cam-clay plasticity model.

Note

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, \(\lambda\) (dimensionless).

    • Stress ratio at critical state, \(M\).

    • The initial yield surface size, \(a_{0}\).

    • \(\beta\), the parameter defining the size of the yield surface on the “wet” side of critical state.

    • \(K\), the ratio of the flow stress in triaxial tension to the flow stress in triaxial compression. \(0.778 \leq K \leq 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, \(\left.\varepsilon_{\mathrm{vol}}^{p l}\right|_{0}\), corresponding to \(\left.p_{c}\right|_{0}\) according to the ClayHardening definition.

    • \(\beta\), the parameter defining the size of the yield surface on the “wet” side of critical state.

    • \(K\), the ratio of the flow stress in triaxial tension to the flow stress in triaxial compression. \(0.778 \leq K \leq 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

Member Details:

clayHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.CriticalStateClay.ClayHardening.ClayHardening` = <abaqus.Material.Plastic.CriticalStateClay.ClayHardening.ClayHardening object>[source]

A ClayHardening object.

setValues(*args, **kwargs)[source]

This method modifies the ClayPlasticity object.

Raises:

RangeError

class Concrete(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Concrete object defines concrete properties beyond the elastic range.

Note

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

Member Details:

failureRatios : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.FailureRatios.FailureRatios` = <abaqus.Material.Plastic.Concrete.FailureRatios.FailureRatios object>[source]

A FailureRatios object.

setValues(*args, **kwargs)[source]

This method modifies the Concrete object.

Raises:

RangeError

shearRetention : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.ShearRetention.ShearRetention` = <abaqus.Material.Plastic.Concrete.ShearRetention.ShearRetention object>[source]

A ShearRetention object.

tensionStiffening : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.TensionStiffening.TensionStiffening` = <abaqus.Material.Plastic.Concrete.TensionStiffening.TensionStiffening object>[source]

A TensionStiffening object.

class ConcreteDamagedPlasticity(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The ConcreteDamagedPlasticity object specifies the concrete damaged plasticity model.

Note

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, \(\psi\) (in degrees) in the \(p - q\) plane.

  • Flow potential eccentricity, \(\epsilon\). The default value is 0.1.

  • \(\sigma_{b 0} / \sigma_{t 0}\), the ratio of initial equibiaxial compressive yield stress to initial uniaxial compressive yield stress. The default value is 1.16. stress is negative. The default value is 2/3. default value is 0.0.

  • \(K_c\), 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, \(\mu\), 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

Member Details:

concreteCompressionDamage : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.ConcreteCompressionDamage.ConcreteCompressionDamage` = <abaqus.Material.Plastic.Concrete.ConcreteCompressionDamage.ConcreteCompressionDamage object>[source]

A ConcreteCompressionDamage object.

concreteCompressionHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.ConcreteCompressionHardening.ConcreteCompressionHardening` = <abaqus.Material.Plastic.Concrete.ConcreteCompressionHardening.ConcreteCompressionHardening object>[source]

A ConcreteCompressionHardening object.

concreteTensionDamage : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.ConcreteTensionDamage.ConcreteTensionDamage` = <abaqus.Material.Plastic.Concrete.ConcreteTensionDamage.ConcreteTensionDamage object>[source]

A ConcreteTensionDamage object.

concreteTensionStiffening : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.ConcreteTensionStiffening.ConcreteTensionStiffening` = <abaqus.Material.Plastic.Concrete.ConcreteTensionStiffening.ConcreteTensionStiffening object>[source]

A ConcreteTensionStiffening object.

setValues(*args, **kwargs)[source]

This method modifies the ConcreteDamagedPlasticity object.

Raises:

RangeError

class Creep(table, law=STRAIN, temperatureDependency=0, dependencies=0, time=TOTAL)[source]

Bases: object

The Creep object defines a creep law.

Note

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:

    • \(A\).

    • \(n\).

    • \(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 = HYPERBOLIC_SINE, the table data specify the following:

    • \(A\).

    • \(B\).

    • \(n\).

    • \(\triangle H\), if the data depend on temperature.

    • \(R\)

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

    • \(s_{1}\).

    • \(\frac{Q}{R}\).

    • \(A\).

    • \(\xi\).

    • \(m\).

    • \(A_{0}\).

    • \(\widehat{S}\)

    • \(n\).

    • \(a\).

    • \(S_{2}\).

    • \(S_{3}\).

    • \(A_{1}\).

    • \(A_{2}\).

    • \(A_{3}\).

    • \(A_{4}\).

  • If law = DARVEAUX, the table data specify the following:

    • \(C_{s s}\).

    • \(\frac{Q}{R}\).

    • \(\alpha\).

    • \(n\).

    • \(\epsilon_{T}\).

    • \(B\).

  • If law = DOUBLE_POWER, the table data specify the following:

    • \(A_{1}\).

    • \(B_{1}\).

    • \(C_{1}\).

    • \(A_{2}\).

    • \(B_{2}\).

    • \(C_{2}\).

    • \(\sigma_{0}\).

  • If law = POWER_LAW or law = TIME_POWER_LAW, the table data specify the following:

    • \(q_{0}\)

    • \(n\).

    • \(m\).

    • \(\varepsilon_{0}^{\bullet}\).

    • 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

Member Details:

ornl : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.ORNL.Ornl.Ornl` = <abaqus.Material.Plastic.Metal.ORNL.Ornl.Ornl object>[source]

An Ornl object.

potential : --is-rst--:py:class:`~abaqus.Material.Plastic.Potential.Potential` = <abaqus.Material.Plastic.Potential.Potential object>[source]

A Potential object.

setValues(*args, **kwargs)[source]

This method modifies the Creep object.

Raises:

RangeError

class CrushStress(crushStressTable, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CrushStress object specifies the crush stress of a material.

Note

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

Added in version 2022: The CrushStress class was added.

Member Details:

crushStressTable : --is-rst--:py:class:`~typing.Sequence`\ \[:py:class:`~typing.Sequence`\ \[:py:class:`float`]][source]

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

crushStressVelocityFactor : --is-rst--:py:class:`~abaqus.Material.Plastic.CrushStress.CrushStressVelocityFactor.CrushStressVelocityFactor` = <abaqus.Material.Plastic.CrushStress.CrushStressVelocityFactor.CrushStressVelocityFactor object>[source]

A CrushStressVelocityFactor object.

dependencies : --is-rst--:py:class:`int` = 0[source]
setValues(crushStressTable=((),), temperatureDependency=0, dependencies=0)[source]

This method creates a CrushStress object.

Note

This function can be accessed by:

mdb.models[name].materials[name].CrushStress
session.odbs[name].materials[name].CrushStress
Parameters:
crushStressTable=((),)

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

temperatureDependency=0

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

dependencies=0

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

temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

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

class CrushableFoam(table, hardening=VOLUMETRIC, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CrushableFoam object specifies the crushable foam plasticity model.

Note

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, \(\sigma_{c}^{0}\), to initial yield stress in hydrostatic compression, \(p_{c}^{0} ; 0.0<k<3.0\).

    • Ratio, \(k_{t}\), of yield stress in hydrostatic tension, \(p_{t}\), to initial yield stress in hydrostatic compression, \(p_{c}^{0}\). 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, \(\sigma_{c}^{0}\), to initial yield stress in hydrostatic compression, \(p_{c}^{0}\); \(0.0 \leq k \leq 3.0\)

    • Plastic Poisson’s ratio. \(\nu_{p} ;-1 \leq \nu_{p} \leq 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

Member Details:

crushableFoamHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.CrushableFoam.CrushableFoamHardening.CrushableFoamHardening` = <abaqus.Material.Plastic.CrushableFoam.CrushableFoamHardening.CrushableFoamHardening object>[source]

A CrushableFoamHardening object.

rateDependent : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.RateDependent.RateDependent.RateDependent` = <abaqus.Material.Plastic.Metal.RateDependent.RateDependent.RateDependent object>[source]

A RateDependent object.

setValues(*args, **kwargs)[source]

This method modifies the CrushableFoam object.

Raises:

RangeError

class DamageInitiation[source]

Bases: object

The DamageInitiation object specifies material properties to define the initiation of damage.

Note

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

Member Details:

DamageEvolution(
type,
table,
degradation=MAXIMUM,
temperatureDependency=0,
dependencies=0,
mixedModeBehavior=MODE_INDEPENDENT,
modeMixRatio=ENERGY,
power=None,
softening=LINEAR,
)[source]

This method creates a DamageEvolution object.

Note

This function can be accessed by:

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.DamageEvolutione].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
session.odbs[name].materials[name].ductileDamageInitiation.DamageEvolution
session.odbs[name].materials[name].fldDamageInitiation.DamageEvolution
session.odbs[name].materials[name].flsdDamageInitiation.DamageEvolution.DamageEvolutioname].materials[name].hashinDamageInitiation.DamageEvolution.DamageEvolutioname].materials[name].johnsonCookDamageInitiation.DamageEvolution.DamageEvolutioname].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.DamageEvolutioname].materials[name].quadeDamageInitiation.DamageEvolution.DamageEvolutioname].materials[name].quadsDamageInitiation.DamageEvolution
session.odbs[name].materials[name].shearDamageInitiation.DamageEvolution
Parameters:
type

A SymbolicConstant specifying the type of damage evolution. Possible values are DISPLACEMENT and ENERGY.

table

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

degradation=MAXIMUM

A SymbolicConstant specifying the degradation. Possible values are MAXIMUM and MULTIPLICATIVE. The default value is MAXIMUM.

temperatureDependency=0

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

dependencies=0

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

mixedModeBehavior=MODE_INDEPENDENT

A SymbolicConstant specifying the mixed mode behavior. Possible values are MODE_INDEPENDENT, TABULAR, POWER_LAW, and BK. The default value is MODE_INDEPENDENT.

modeMixRatio=ENERGY

A SymbolicConstant specifying the mode mix ratio. Possible values are ENERGY and TRACTION. The default value is ENERGY.

power=None

None or a Float specifying the exponent in the power law or the Benzeggagh-Kenane criterion that defines the variation of fracture energy with mode mix for cohesive elements. The default value is None.

softening=LINEAR

A SymbolicConstant specifying the softening. Possible values are LINEAR, EXPONENTIAL, and TABULAR. The default value is LINEAR.

Returns:

A DamageEvolution object.

Return type:

DamageEvolution

Raises:

RangeError

DamageStabilizationCohesive(cohesiveCoeff=None)[source]

This method creates a DamageStabilizationCohesive object.

Note

This function can be accessed by:

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
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
Parameters:
cohesiveCoeff=None

None or a Float specifying the viscosity coefficient. The default value is None.

Returns:

A DamageStabilizationCohesive object.

Return type:

DamageStabilizationCohesive

Raises:

RangeError

DuctileDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
lodeDependency=0,
accumulationPower=0.0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].DuctileDamageInitiation
session.odbs[name].materials[name].DuctileDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

lodeDependency=0

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

accumulationPower=0.0

A Float specifying the value of the power coefficient, N. The default value is 0.0.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

FldDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].FldDamageInitiation
session.odbs[name].materials[name].FldDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

FlsdDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].FlsdDamageInitiation
session.odbs[name].materials[name].FlsdDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

HashinDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].HashinDamageInitiation
session.odbs[name].materials[name].HashinDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

HosfordCoulombDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
accumulationPower=0.0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].HosfordCoulombDamageInitiation
session.odbs[name].materials[name].HosfordCoulombDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

accumulationPower=0.0

A Float specifying the value of the power coefficient, N. The default value is 0.0.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

JohnsonCookDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].JohnsonCookDamageInitiation
session.odbs[name].materials[name].JohnsonCookDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

LaRC05DamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].LaRC05DamageInitiation
session.odbs[name].materials[name].LaRC05DamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxeDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxeDamageInitiation
session.odbs[name].materials[name].MaxeDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxpeDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxpeDamageInitiation
session.odbs[name].materials[name].MaxpeDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxpsDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxpsDamageInitiation
session.odbs[name].materials[name].MaxpsDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MaxsDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MaxsDamageInitiation
session.odbs[name].materials[name].MaxsDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MkDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MkDamageInitiation
session.odbs[name].materials[name].MkDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

MsfldDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].MsfldDamageInitiation
session.odbs[name].materials[name].MsfldDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

QuadeDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].QuadeDamageInitiation
session.odbs[name].materials[name].QuadeDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

QuadsDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
position=CENTROID,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].QuadsDamageInitiation
session.odbs[name].materials[name].QuadsDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

position=CENTROID

An SymbolicConstant specifying the damage initiation position. Possible values are CENTROID, CRACKTIP and COMBINED. The default value is CENTROID.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

ShearDamageInitiation(
table,
definition=MSFLD,
feq=10,
fnn=10,
fnt=10,
frequency=1,
ks=0,
numberImperfections=4,
temperatureDependency=0,
dependencies=0,
alpha=0,
omega=1,
tolerance=0,
direction=NMORI,
)[source]

This method creates A DamageInitiation object.

Note

This function can be accessed by:

mdb.models[name].materials[name].ShearDamageInitiation
session.odbs[name].materials[name].ShearDamageInitiation
Parameters:
table

A sequence of sequences of Floats specifying the items described in the “Table data” section.

definition=MSFLD

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

feq=10

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn=10

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt=10

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency=1

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks=0

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections=4

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

temperatureDependency=0

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

dependencies=0

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

alpha=0

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

omega=1

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

tolerance=0

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

direction=NMORI

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

Returns:

A DamageInitiation object.

Return type:

DamageInitiation

Raises:

RangeError

alpha : --is-rst--:py:class:`float` = 0[source]

A Float specifying the value of the coefficient that will multiply the shear contribution to the Hashin’s fiber initiation criterion. The default value is 0.0.

damageEvolution : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageEvolution.DamageEvolution` | :py:obj:`None` = None[source]

A DamageEvolution object.

damageStabilization : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageStabilization.DamageStabilization` | :py:obj:`None` = None[source]

A DamageStabilization object.

damageStabilizationCohesive : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageStabilizationCohesive.DamageStabilizationCohesive` = <abaqus.Material.ProgressiveDamageFailure.DamageStabilizationCohesive.DamageStabilizationCohesive object>[source]

A DamageStabilizationCohesive object.

definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MSFLD'[source]

A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

dependencies : --is-rst--:py:class:`int` = 0[source]

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

direction : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'NMORI'[source]

A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

feq : --is-rst--:py:class:`float` = 10[source]

A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

fnn : --is-rst--:py:class:`float` = 10[source]

A Float specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.

fnt : --is-rst--:py:class:`float` = 10[source]

A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

frequency : --is-rst--:py:class:`int` = 1[source]

An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.

ks : --is-rst--:py:class:`float` = 0[source]

A Float specifying the value of Ks. The default value is 0.0.

numberImperfections : --is-rst--:py:class:`int` = 4[source]

An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.

omega : --is-rst--:py:class:`float` = 1[source]

A Float specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.

setValues(*args, **kwargs)[source]

This method modifies the DamageInitiation object.

table : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A tuple of tuples of Floats specifying the items described in the “Table data” section.

temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

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

tolerance : --is-rst--:py:class:`float` = 0[source]

A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

class Damping(alpha=0, beta=0, composite=0, structural=0)[source]

Bases: object

The Damping object specifies material damping.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Damping object.

Raises:

RangeError

class DeformationPlasticity(table, temperatureDependency=0)[source]

Bases: object

The DeformationPlasticity object specifies the deformation plasticity model.

Note

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, \(\nu\).

  • Yield stress, \(\sigma^{0}\)

  • Exponent, \(n\).

  • Yield offset, \(\alpha\).

  • Temperature, if the data depend on temperature.

The corresponding analysis keywords are:

  • DEFORMATION PLASTICITY

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DeformationPlasticity object.

Raises:

RangeError

class Depvar(deleteVar=0, n=0)[source]

Bases: object

The Depvar object specifies solution-dependent state variables.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Depvar object.

Raises:

RangeError

class DruckerPrager(
table,
shearCriterion=LINEAR,
eccentricity=0,
testData=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The DruckerPrager object specifies the extended Drucker-Prager plasticity model.

Note

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, \(\beta\), 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 \leq K \leq 1.0\). If the default value of \(0.0\) is accepted, a value of \(1.0\) is assumed.

    • Dilation angle, \(\psi\), 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, \(\beta\), at high confining pressure in the \(p-q\) plane. Give the value in degrees.

    • Initial hydrostatic tension strength, \(\left.p_{t}\right|_{0}\).

    • Dilation angle, \(\psi\), 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, \(\psi\), 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

Member Details:

druckerPragerCreep : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.Extended.DruckerPragerCreep.DruckerPragerCreep` = <abaqus.Material.Plastic.DruckerPrager.Extended.DruckerPragerCreep.DruckerPragerCreep object>[source]

A DruckerPragerCreep object.

druckerPragerHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.Extended.DruckerPragerHardening.DruckerPragerHardening` = <abaqus.Material.Plastic.DruckerPrager.Extended.DruckerPragerHardening.DruckerPragerHardening object>[source]

A DruckerPragerHardening object.

rateDependent : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.RateDependent.RateDependent.RateDependent` = <abaqus.Material.Plastic.Metal.RateDependent.RateDependent.RateDependent object>[source]

A RateDependent object.

setValues(*args, **kwargs)[source]

This method modifies the DruckerPrager object.

Raises:

RangeError

triaxialTestData : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.Extended.TriaxialTestData.TriaxialTestData` = <abaqus.Material.Plastic.DruckerPrager.Extended.TriaxialTestData.TriaxialTestData object>[source]

A TriaxialTestData object.

class Expansion(
type=ISOTROPIC,
userSubroutine=0,
zero=0,
temperatureDependency=0,
dependencies=0,
table=(),
)[source]

Bases: object

The Expansion object specifies thermal expansion.

Note

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:

    • \(\alpha\) 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:

    • \(\alpha_{11}\).

    • \(\alpha_{22}\).

    • \(\alpha_{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:

    • \(\alpha_{11}\).

    • \(\alpha_{22}\).

    • \(\alpha_{33}\). (Not used for plane stress case.)

    • \(\alpha_{12}\).

    • \(\alpha_{13}\).

    • \(\alpha_{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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Expansion object.

Raises:

RangeError

class FluidLeakoff(temperatureDependency=0, dependencies=0, type=COEFFICIENTS, table=())[source]

Bases: object

The FluidLeakoff object specifies leak-off coefficients for pore pressure cohesive elements.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the FluidLeakoff object.

class Gel(table)[source]

Bases: object

The Gel object defines a swelling gel.

Note

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, \(r_{a}^{\mathrm{dry}}\).

  • Fully swollen radius of gel particles, \(r_{a}^{f}\).

  • Number of gel particles per unit volume, \(k_{a}\).

  • Relaxation time constant for long-term swelling of gel particles, \(\tau_{1}\).

The corresponding analysis keywords are:

  • GEL

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Gel object.

class MaterialBase(name, description='', materialIdentifier='')[source]

Bases: object

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.

Note

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

Member Details:

acousticMedium : --is-rst--:py:class:`~abaqus.Material.Acoustic.AcousticMedium.AcousticMedium` = <abaqus.Material.Acoustic.AcousticMedium.AcousticMedium object>[source]

An AcousticMedium object.

brittleCracking : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.BrittleCracking.BrittleCracking` = <abaqus.Material.Plastic.Concrete.BrittleCracking.BrittleCracking object>[source]

A BrittleCracking object.

capPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapPlasticity.CapPlasticity` = <abaqus.Material.Plastic.DruckerPrager.ModifiedCap.CapPlasticity.CapPlasticity object>[source]

A CapPlasticity object.

castIronPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.CastIron.CastIronPlasticity.CastIronPlasticity` = <abaqus.Material.Plastic.Metal.CastIron.CastIronPlasticity.CastIronPlasticity object>[source]

A CastIronPlasticity object.

clayPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.CriticalStateClay.ClayPlasticity.ClayPlasticity` = <abaqus.Material.Plastic.CriticalStateClay.ClayPlasticity.ClayPlasticity object>[source]

A ClayPlasticity object.

concrete : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.Concrete.Concrete` = <abaqus.Material.Plastic.Concrete.Concrete.Concrete object>[source]

A Concrete object.

concreteDamagedPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.Concrete.ConcreteDamagedPlasticity.ConcreteDamagedPlasticity` = <abaqus.Material.Plastic.Concrete.ConcreteDamagedPlasticity.ConcreteDamagedPlasticity object>[source]

A ConcreteDamagedPlasticity object.

conductivity : --is-rst--:py:class:`~abaqus.Material.HeatTransfer.Conductivity.Conductivity` = <abaqus.Material.HeatTransfer.Conductivity.Conductivity object>[source]

A Conductivity object.

creep : --is-rst--:py:class:`~abaqus.Material.Plastic.Creep.Creep.Creep` = <abaqus.Material.Plastic.Creep.Creep.Creep object>[source]

A Creep object.

crushStress : --is-rst--:py:class:`~abaqus.Material.Plastic.CrushStress.CrushStress.CrushStress` = <abaqus.Material.Plastic.CrushStress.CrushStress.CrushStress object>[source]

A CrushStress object

Added in version 2022: The crushStress attribute was added.

crushableFoam : --is-rst--:py:class:`~abaqus.Material.Plastic.CrushableFoam.CrushableFoam.CrushableFoam` = <abaqus.Material.Plastic.CrushableFoam.CrushableFoam.CrushableFoam object>[source]

A CrushableFoam object.

damping : --is-rst--:py:class:`~abaqus.Material.Mechanical.Damping.Damping` = <abaqus.Material.Mechanical.Damping.Damping object>[source]

A Damping object.

deformationPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Deformation.DeformationPlasticity.DeformationPlasticity` = <abaqus.Material.Plastic.Metal.Deformation.DeformationPlasticity.DeformationPlasticity object>[source]

A DeformationPlasticity object.

density : --is-rst--:py:class:`~abaqus.Material.Density.Density.Density` = <abaqus.Material.Density.Density.Density object>[source]

A Density object.

depvar : --is-rst--:py:class:`~abaqus.Material.User.Depvar.Depvar` = <abaqus.Material.User.Depvar.Depvar object>[source]

A Depvar object.

dielectric : --is-rst--:py:class:`~abaqus.Material.Electromagnetic.Dielectric.Dielectric` = <abaqus.Material.Electromagnetic.Dielectric.Dielectric object>[source]

A Dielectric object.

diffusivity : --is-rst--:py:class:`~abaqus.Material.MassDiffusion.Diffusivity.Diffusivity` = <abaqus.Material.MassDiffusion.Diffusivity.Diffusivity object>[source]

A Diffusivity object.

druckerPrager : --is-rst--:py:class:`~abaqus.Material.Plastic.DruckerPrager.Extended.DruckerPrager.DruckerPrager` = <abaqus.Material.Plastic.DruckerPrager.Extended.DruckerPrager.DruckerPrager object>[source]

A DruckerPrager object.

ductileDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

elastic : --is-rst--:py:class:`~abaqus.Material.Elastic.Linear.Elastic.Elastic` = <abaqus.Material.Elastic.Linear.Elastic.Elastic object>[source]

An Elastic object.

electricalConductivity : --is-rst--:py:class:`~abaqus.Material.Electromagnetic.ElectricalConductivity.ElectricalConductivity` = <abaqus.Material.Electromagnetic.ElectricalConductivity.ElectricalConductivity object>[source]

An ElectricalConductivity object.

eos : --is-rst--:py:class:`~abaqus.Material.Eos.Eos.Eos` = <abaqus.Material.Eos.Eos.Eos object>[source]

An Eos object.

expansion : --is-rst--:py:class:`~abaqus.Material.Mechanical.Expansion.Expansion` = <abaqus.Material.Mechanical.Expansion.Expansion object>[source]

An Expansion object.

fldDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

flsdDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

fluidLeakoff : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.FluidLeakoff.FluidLeakoff` = <abaqus.Material.PoreFluidFlow.FluidLeakoff.FluidLeakoff object>[source]

A FluidLeakoff object.

gapFlow : --is-rst--:py:class:`~abaqus.Material.Gap.GapFlow.GapFlow` = <abaqus.Material.Gap.GapFlow.GapFlow object>[source]

A GapFlow object.

gasketMembraneElastic : --is-rst--:py:class:`~abaqus.Material.Gasket.GasketMembraneElastic.GasketMembraneElastic` = <abaqus.Material.Gasket.GasketMembraneElastic.GasketMembraneElastic object>[source]

A GasketMembraneElastic object.

gasketThicknessBehavior : --is-rst--:py:class:`~abaqus.Material.Gasket.GasketThicknessBehavior.GasketThicknessBehavior` = <abaqus.Material.Gasket.GasketThicknessBehavior.GasketThicknessBehavior object>[source]

A GasketThicknessBehavior object.

gasketTransverseShearElastic : --is-rst--:py:class:`~abaqus.Material.Gasket.GasketTransverseShearElastic.GasketTransverseShearElastic` = <abaqus.Material.Gasket.GasketTransverseShearElastic.GasketTransverseShearElastic object>[source]

A GasketTransverseShearElastic object.

gel : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.Gel.Gel` = <abaqus.Material.PoreFluidFlow.Gel.Gel object>[source]

A Gel object.

hashinDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

heatGeneration : --is-rst--:py:class:`~abaqus.Material.HeatTransfer.HeatGeneration.HeatGeneration` = <abaqus.Material.HeatTransfer.HeatGeneration.HeatGeneration object>[source]

A HeatGeneration object.

hyperelastic : --is-rst--:py:class:`~abaqus.Material.Elastic.HyperElastic.Hyperelastic.Hyperelastic` = <abaqus.Material.Elastic.HyperElastic.Hyperelastic.Hyperelastic object>[source]

A Hyperelastic object.

hyperfoam : --is-rst--:py:class:`~abaqus.Material.Elastic.HyperElastic.HyperFoam.Hyperfoam.Hyperfoam` = <abaqus.Material.Elastic.HyperElastic.HyperFoam.Hyperfoam.Hyperfoam object>[source]

A Hyperfoam object.

hypoelastic : --is-rst--:py:class:`~abaqus.Material.Elastic.HypoElastic.Hypoelastic.Hypoelastic` = <abaqus.Material.Elastic.HypoElastic.Hypoelastic.Hypoelastic object>[source]

A Hypoelastic object.

inelasticHeatFraction : --is-rst--:py:class:`~abaqus.Material.HeatTransfer.InelasticHeatFraction.InelasticHeatFraction` = <abaqus.Material.HeatTransfer.InelasticHeatFraction.InelasticHeatFraction object>[source]

An InelasticHeatFraction object.

johnsonCookDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

jouleHeatFraction : --is-rst--:py:class:`~abaqus.Material.HeatTransfer.JouleHeatFraction.JouleHeatFraction` = <abaqus.Material.HeatTransfer.JouleHeatFraction.JouleHeatFraction object>[source]

A JouleHeatFraction object.

latentHeat : --is-rst--:py:class:`~abaqus.Material.HeatTransfer.LatentHeat.LatentHeat` = <abaqus.Material.HeatTransfer.LatentHeat.LatentHeat object>[source]

A LatentHeat object.

lowDensityFoam : --is-rst--:py:class:`~abaqus.Material.Elastic.LowDensityFoam.LowDensityFoam.LowDensityFoam` = <abaqus.Material.Elastic.LowDensityFoam.LowDensityFoam.LowDensityFoam object>[source]

A LowDensityFoam object.

magneticPermeability : --is-rst--:py:class:`~abaqus.Material.Electromagnetic.MagneticPermeability.MagneticPermeability` = <abaqus.Material.Electromagnetic.MagneticPermeability.MagneticPermeability object>[source]

A MagneticPermeability object.

materialsFromOdb(fileName)[source]

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

Note

This function can be accessed by:

mdb.models[name].Material
session.odbs[name].Material
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 list of Material objects.

Return type:

list[Material]

maxeDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

maxpeDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

maxpsDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

maxsDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

meanFieldHomogenization : --is-rst--:py:class:`~abaqus.Material.Multiscale.MeanFieldHomogenization.MeanFieldHomogenization` = <abaqus.Material.Multiscale.MeanFieldHomogenization.MeanFieldHomogenization object>[source]

A MeanFieldHomogenization object.

Added in version 2018: The meanFieldHomogenization attribute was added.

mkDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

mohrCoulombPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.MohrCoulomb.MohrCoulombPlasticity.MohrCoulombPlasticity` = <abaqus.Material.Plastic.MohrCoulomb.MohrCoulombPlasticity.MohrCoulombPlasticity object>[source]

A MohrCoulombPlasticity object.

moistureSwelling : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.MoistureSwelling.MoistureSwelling.MoistureSwelling` = <abaqus.Material.PoreFluidFlow.MoistureSwelling.MoistureSwelling.MoistureSwelling object>[source]

A MoistureSwelling object.

msfldDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

mullinsEffect : --is-rst--:py:class:`~abaqus.Material.TestData.MullinsEffect.MullinsEffect` = <abaqus.Material.TestData.MullinsEffect.MullinsEffect object>[source]

A MullinsEffect object.

permeability : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.Permeability.Permeability.Permeability` = <abaqus.Material.PoreFluidFlow.Permeability.Permeability.Permeability object>[source]

A Permeability object.

piezoelectric : --is-rst--:py:class:`~abaqus.Material.Electromagnetic.Piezoelectric.Piezoelectric` = <abaqus.Material.Electromagnetic.Piezoelectric.Piezoelectric object>[source]

A Piezoelectric object.

plastic : --is-rst--:py:class:`~abaqus.Material.Plastic.Plastic.Plastic` = <abaqus.Material.Plastic.Plastic.Plastic object>[source]

A Plastic object.

plasticityCorrection : --is-rst--:py:class:`~abaqus.Material.Plastic.PlasticityCorrection.PlasticityCorrection` = <abaqus.Material.Plastic.PlasticityCorrection.PlasticityCorrection object>[source]

A PlasticityCorrection object.

poreFluidExpansion : --is-rst--:py:class:`~abaqus.Material.Mechanical.PoreFluidExpansion.PoreFluidExpansion` = <abaqus.Material.Mechanical.PoreFluidExpansion.PoreFluidExpansion object>[source]

A PoreFluidExpansion object.

porousBulkModuli : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.PorousBulkModuli.PorousBulkModuli` = <abaqus.Material.PoreFluidFlow.PorousBulkModuli.PorousBulkModuli object>[source]

A PorousBulkModuli object.

porousElastic : --is-rst--:py:class:`~abaqus.Material.Elastic.Porous.PorousElastic.PorousElastic` = <abaqus.Material.Elastic.Porous.PorousElastic.PorousElastic object>[source]

A PorousElastic object.

porousMetalPlasticity : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Porous.PorousMetalPlasticity.PorousMetalPlasticity` = <abaqus.Material.Plastic.Metal.Porous.PorousMetalPlasticity.PorousMetalPlasticity object>[source]

A PorousMetalPlasticity object.

quadeDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

quadsDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

regularization : --is-rst--:py:class:`~abaqus.Material.Regularization.Regularization` = <abaqus.Material.Regularization.Regularization object>[source]

A Regularization object.

shearDamageInitiation : --is-rst--:py:class:`~abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation` = <abaqus.Material.ProgressiveDamageFailure.DamageInitiation.DamageInitiation object>[source]

A DamageInitiation object.

solubility : --is-rst--:py:class:`~abaqus.Material.MassDiffusion.Solubility.Solubility` = <abaqus.Material.MassDiffusion.Solubility.Solubility object>[source]

A Solubility object.

sorption : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.Sorption.Sorption` = <abaqus.Material.PoreFluidFlow.Sorption.Sorption object>[source]

A Sorption object.

specificHeat : --is-rst--:py:class:`~abaqus.Material.HeatTransfer.SpecificHeat.SpecificHeat` = <abaqus.Material.HeatTransfer.SpecificHeat.SpecificHeat object>[source]

A SpecificHeat object.

swelling : --is-rst--:py:class:`~abaqus.Material.Plastic.Swelling.Swelling.Swelling` = <abaqus.Material.Plastic.Swelling.Swelling.Swelling object>[source]

A Swelling object.

userDefinedField : --is-rst--:py:class:`~abaqus.Material.User.UserDefinedField.UserDefinedField` = <abaqus.Material.User.UserDefinedField.UserDefinedField object>[source]

A UserDefinedField object.

userMaterial : --is-rst--:py:class:`~abaqus.Material.User.UserMaterial.UserMaterial` = <abaqus.Material.User.UserMaterial.UserMaterial object>[source]

A UserMaterial object.

userOutputVariables : --is-rst--:py:class:`~abaqus.Material.User.UserOutputVariables.UserOutputVariables` = <abaqus.Material.User.UserOutputVariables.UserOutputVariables object>[source]

A UserOutputVariables object.

viscoelastic : --is-rst--:py:class:`~abaqus.Material.Elastic.HyperElastic.ViscoElastic.Viscoelastic.Viscoelastic` = <abaqus.Material.Elastic.HyperElastic.ViscoElastic.Viscoelastic.Viscoelastic object>[source]

A Viscoelastic object.

viscosity : --is-rst--:py:class:`~abaqus.Material.Mechanical.Viscosity.Viscosity.Viscosity` = <abaqus.Material.Mechanical.Viscosity.Viscosity.Viscosity object>[source]

A Viscosity object.

viscous : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.TwoLayerViscoPlasticity.Viscous.Viscous` = <abaqus.Material.Plastic.Metal.TwoLayerViscoPlasticity.Viscous.Viscous object>[source]

A Viscous object.

class MeanFieldHomogenization(
angleSubdivision=None,
formulation=MT,
isotropization=ALLISO,
uniformMatrixStrain=NO,
)[source]

Bases: object

The MeanFieldHomogenization object specifies the multiscale material definition.

Note

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

Added in version 2018: The MeanFieldHomogenization class was added.

Member Details:

MeanFieldInclusion(
name,
table,
material='',
isotropizationCoefficient=None,
volumeFractionType=UNIFORM,
volumeFractionFieldName='',
aspectRatioType=UNIFORM,
aspectRatioFieldName='',
orientationTensorType=UNIFORM,
orientationTensorFieldName='',
shape=SPHERE,
direction=None,
strainConcentrationTensor=(),
temperatureGradientConcentrationTensor=(),
)[source]

This method creates a MeanFieldInclusion object.

Note

This function can be accessed by:

mdb.models[name].materials[name].meanFieldHomogenization.MeanFieldInclusion
session.odbs[name].materials[name].meanFieldHomogenization.MeanFieldInclusion
Parameters:
name

A String specifying the constituent repository key.

table

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

material=''

A String specifying the name of the material.

isotropizationCoefficient=None

A Float specifying the factor used for scaling the Plastic strain of the constituent when calculating the isotropic part of the tangent.

volumeFractionType=UNIFORM

A SymbolicConstant specifying the type of volume fraction. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

volumeFractionFieldName=''

A String specifying the name of the AnalyticalField object or DiscreteField object.

aspectRatioType=UNIFORM

A SymbolicConstant specifying the type of aspect ratio. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

aspectRatioFieldName=''

A String specifying the name of the AnalyticalField object or DiscreteField object.

orientationTensorType=UNIFORM

A SymbolicConstant specifying the type of orientation tensor. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

orientationTensorFieldName=''

A String specifying the name of the AnalyticalField object or DiscreteField object.

shape=SPHERE

A SymbolicConstant specifying the type of inclusion shapes. Possible values are SPHERE, PROLATE, OBLATE, CYLINDER, PENNY, and ELLIPTIC_CYLINDER. The default value is SPHERE.

direction=None

A SymbolicConstant specifying the type of inclusion direction. Possible values are FIXED, RANDOM3D, and ORIENTATION_TENSOR.

strainConcentrationTensor=()

A sequence of Floats defining the 36 components of the strain concentration tensor.

temperatureGradientConcentrationTensor=()

A sequence of Floats defining the 9 components of the temperature gradient concentration tensor.

Returns:

A MeanFieldInclusion object.

Raises:

RangeError

MeanFieldMatrix(name, material='', isotropizationCoefficient=None)[source]

This method creates a MeanFieldMatrix object.

Note

This function can be accessed by:

mdb.models[name].materials[name].meanFieldHomogenization.MeanFieldMatrix
session.odbs[name].materials[name].meanFieldHomogenization.MeanFieldMatrix
Parameters:
name

A String specifying the constituent repository key.

material=''

A String specifying the name of the material.

isotropizationCoefficient=None

A Float specifying the factor used for scaling the Plastic strain of the constituent when calculating the isotropic part of the tangent.

Returns:

A MeanFieldMatrix object.

Raises:

RangeError

MeanFieldVoid(
name,
table,
material='',
isotropizationCoefficient=None,
volumeFractionType=UNIFORM,
volumeFractionFieldName='',
aspectRatioType=UNIFORM,
aspectRatioFieldName='',
orientationTensorType=UNIFORM,
orientationTensorFieldName='',
shape=SPHERE,
direction=None,
strainConcentrationTensor=(),
temperatureGradientConcentrationTensor=(),
)[source]

This method creates a MeanFieldVoid object.

Note

This function can be accessed by:

mdb.models[name].materials[name].meanFieldHomogenization.MeanFieldVoid
session.odbs[name].materials[name].meanFieldHomogenization.MeanFieldVoid
Parameters:
name

A String specifying the constituent repository key.

table

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

material=''

A String specifying the name of the material.

isotropizationCoefficient=None

A Float specifying the factor used for scaling the Plastic strain of the constituent when calculating the isotropic part of the tangent.

volumeFractionType=UNIFORM

A SymbolicConstant specifying the type of volume fraction. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

volumeFractionFieldName=''

A String specifying the name of the AnalyticalField object or DiscreteField object.

aspectRatioType=UNIFORM

A SymbolicConstant specifying the type of aspect ratio. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

aspectRatioFieldName=''

A String specifying the name of the AnalyticalField object or DiscreteField object.

orientationTensorType=UNIFORM

A SymbolicConstant specifying the type of orientation tensor. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

orientationTensorFieldName=''

A String specifying the name of the AnalyticalField object or DiscreteField object.

shape=SPHERE

A SymbolicConstant specifying the type of inclusion shapes. Possible values are SPHERE, PROLATE, OBLATE, CYLINDER, PENNY, and ELLIPTIC_CYLINDER. The default value is SPHERE.

direction=None

A SymbolicConstant specifying the type of inclusion direction. Possible values are FIXED, RANDOM3D, and ORIENTATION_TENSOR.

strainConcentrationTensor=()

A sequence of Floats defining the 36 components of the strain concentration tensor.

temperatureGradientConcentrationTensor=()

A sequence of Floats defining the 9 components of the temperature gradient concentration tensor.

Returns:

A MeanFieldVoid object.

Raises:

RangeError

setValues()[source]

This method modifies the MeanFieldHomogenization object.

Raises:

RangeError

class MohrCoulombPlasticity(
table,
deviatoricEccentricity=None,
meridionalEccentricity=0,
temperatureDependency=0,
dependencies=0,
useTensionCutoff=0,
)[source]

Bases: object

The MohrCoulombPlasticity object specifies the extended Mohr-Coulomb plasticity model.

Note

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), \(\phi\), at high confining pressure in the \(p-R_{m c} q\) plane.

  • Dilation angle, \(\psi\), at high confining pressure in the \(p-R_{m 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

Member Details:

mohrCoulombHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.MohrCoulomb.MohrCoulombHardening.MohrCoulombHardening` = <abaqus.Material.Plastic.MohrCoulomb.MohrCoulombHardening.MohrCoulombHardening object>[source]

A MohrCoulombHardening object.

setValues(*args, **kwargs)[source]

This method modifies the MohrCoulombPlasticity object.

Raises:

RangeError

tensionCutOff : --is-rst--:py:class:`~abaqus.Material.Plastic.MohrCoulomb.TensionCutOff.TensionCutOff` = <abaqus.Material.Plastic.MohrCoulomb.TensionCutOff.TensionCutOff object>[source]

A TensionCutOff object.

class MoistureSwelling(table)[source]

Bases: object

The MoistureSwelling object defines moisture-driven swelling.

Note

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, \(\varepsilon^{m s}\).

  • Saturation, \(s\). This value must lie in the range \(0.0 \leq s \leq 1.0\).

The corresponding analysis keywords are:

  • MOISTURE SWELLING

Member Details:

ratios : --is-rst--:py:class:`~abaqus.Material.Ratios.Ratios` = <abaqus.Material.Ratios.Ratios object>[source]

A Ratios object.

setValues(*args, **kwargs)[source]

This method modifies the MoistureSwelling object.

class Permeability(
specificWeight,
inertialDragCoefficient,
table,
type=ISOTROPIC,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The Permeability object defines permeability for pore fluid flow.

Note

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:

    • \(k\).

    • Void ratio, \(e\).

    • Temperature, if the data depend on temperature.

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

    • \(k_{11}\).

    • \(k_{22}\).

    • \(k_{33}\).

    • Void ratio, \(e\).

    • Temperature, if the data depend on temperature.

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

    • \(k_{11}\).

    • \(k_{12}\).

    • \(k_{22}\).

    • \(k_{13}\).

    • \(k_{23}\).

    • \(k_{33}\).

    • Void ratio, \(e\).

    • Temperature, if the data depend on temperature.

The corresponding analysis keywords are:

  • PERMEABILITY

Member Details:

saturationDependence : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.Permeability.SaturationDependence.SaturationDependence` = <abaqus.Material.PoreFluidFlow.Permeability.SaturationDependence.SaturationDependence object>[source]

A SaturationDependence object specifying the dependence of the permeability of a material on the saturation of the wetting liquid.

setValues(*args, **kwargs)[source]

This method modifies the Permeability object.

Raises:

RangeError

velocityDependence : --is-rst--:py:class:`~abaqus.Material.PoreFluidFlow.Permeability.VelocityDependence.VelocityDependence` = <abaqus.Material.PoreFluidFlow.Permeability.VelocityDependence.VelocityDependence object>[source]

A VelocityDependence object specifying the dependence of the permeability of a material on the velocity of fluid flow.

class Plastic(
table,
hardening=ISOTROPIC,
rate=0,
dataType=HALF_CYCLE,
strainRangeDependency=0,
numBackstresses=1,
temperatureDependency=0,
dependencies=0,
extrapolation=CONSTANT,
)[source]

Bases: object

The Plastic object specifies a metal plasticity model.

Note

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, \(\dot{\bar{\varepsilon}} 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, \(C_{1}\).

    • The first kinematic hardening parameter, \(\gamma_{1}\).

    • If applicable, the second kinematic hardening parameter, \(C_{2}\).

    • If applicable, the second kinematic hardening parameter, \(\gamma_{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:

    • \(A\).

    • \(B\).

    • \(\mathrm{n}\).

    • \(\mathrm{m}\).

    • Melting temperature.

    • Transition temperature.

  • If hardening = USER, the table data specify the following:

    • Hardening properties.

The corresponding analysis keywords are:

  • PLASTIC

Member Details:

annealTemperature : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Annealing.AnnealTemperature.AnnealTemperature` = <abaqus.Material.Plastic.Metal.Annealing.AnnealTemperature.AnnealTemperature object>[source]

An AnnealTemperature object.

cycledPlastic : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Cyclic.CycledPlastic.CycledPlastic` = <abaqus.Material.Plastic.Metal.Cyclic.CycledPlastic.CycledPlastic object>[source]

A CycledPlastic object.

cyclicHardening : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Cyclic.CyclicHardening.CyclicHardening` = <abaqus.Material.Plastic.Metal.Cyclic.CyclicHardening.CyclicHardening object>[source]

A CyclicHardening object.

ornl : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.ORNL.Ornl.Ornl` = <abaqus.Material.Plastic.Metal.ORNL.Ornl.Ornl object>[source]

An Ornl object.

potential : --is-rst--:py:class:`~abaqus.Material.Plastic.Potential.Potential` = <abaqus.Material.Plastic.Potential.Potential object>[source]

A Potential object.

rateDependent : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.RateDependent.RateDependent.RateDependent` = <abaqus.Material.Plastic.Metal.RateDependent.RateDependent.RateDependent object>[source]

A RateDependent object.

setValues(*args, **kwargs)[source]

This method modifies the Plastic object.

Raises:

RangeError

tensileFailure : --is-rst--:py:class:`~abaqus.Material.Plastic.TensileFailure.TensileFailure` = <abaqus.Material.Plastic.TensileFailure.TensileFailure object>[source]

A TensileFailure object.

class PlasticityCorrection(type, table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The PlasticityCorrection object specifies the elastic-plastic response of the material with linear elasticity.

Note

This object can be accessed by:

import material
mdb.models[name].materials[name].plasticityCorrection

The table data for this object are:

  • If type=RAMBERG_OSGOOD, the table specifies the following:

    • \(K\).

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

  • If type=TABULAR, the table specifies the following:

    • Yield stress.

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

  • PLASTICITY CORRECTION

Added in version 2023: The PlasticityCorrection class was added.

Member Details:

dependencies : --is-rst--:py:class:`int` = 0[source]

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

setValues(*args, **kwargs)[source]

This method modifies the PlasticityCorrection object.

Raises:

RangeError

table : --is-rst--:py:class:`~typing.Sequence`\ \[:py:class:`~typing.Sequence`\ \[:py:class:`float`]][source]

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

temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

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

type : --is-rst--:py:data:`~typing.Literal`\ \[``RAMBERG_OSGOOD``, ``TABULAR``][source]

Set type=RAMBERG_OSGOOD to specify the Ramberg-Osgood relationship. Set type=TABULAR to specify the tabular form.

class PoreFluidExpansion(table, zero=0, temperatureDependency=0, dependencies=0)[source]

Bases: object

The PoreFluidExpansion object specifies the thermal expansion coefficient for a hydraulic fluid.

Note

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, \(\theta_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:

  • EXPANSION

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the PoreFluidExpansion object.

Raises:

RangeError

class PorousBulkModuli(table, temperatureDependency=0)[source]

Bases: object

The PorousBulkModuli object defines bulk moduli for soils and rocks.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the PorousBulkModuli object.

class PorousMetalPlasticity(
table,
relativeDensity=None,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The PorousMetalPlasticity object specifies a porous metal plasticity model.

Note

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:

  • \(q_1\).

  • \(q_2\).

  • \(q_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:

  • POROUS METAL PLASTICITY

Member Details:

porousFailureCriteria : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Porous.PorousFailureCriteria.PorousFailureCriteria` = <abaqus.Material.Plastic.Metal.Porous.PorousFailureCriteria.PorousFailureCriteria object>[source]

A PorousFailureCriteria object.

setValues(*args, **kwargs)[source]

This method modifies the PorousMetalPlasticity object.

Raises:

RangeError

voidNucleation : --is-rst--:py:class:`~abaqus.Material.Plastic.Metal.Porous.VoidNucleation.VoidNucleation` = <abaqus.Material.Plastic.Metal.Porous.VoidNucleation.VoidNucleation object>[source]

A VoidNucleation object.

class Regularization(rtol=0, strainRateRegularization=LOGARITHMIC)[source]

Bases: object

The Regularization object defines the tolerance to be used for regularizing material data.

Note

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

Member Details:

rtol : --is-rst--:py:class:`float` = 0[source]

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

setValues(*args, **kwargs)[source]

This method modifies the Regularization object.

Raises:

RangeError

strainRateRegularization : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'LOGARITHMIC'[source]

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

class Sorption(
absorptionTable,
lawAbsorption=TABULAR,
exsorption=0,
lawExsorption=TABULAR,
scanning=0,
exsorptionTable=(),
)[source]

Bases: object

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.

Note

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, \(u_{w}\).

    • Saturation, \(\boldsymbol{S}\).

  • If lawAbsorption = LOG or lawExsorption = LOG, the absorptionTable and exsorptionTable data respectively specify the following:

    • \(A\).

    • \(B\).

    • \(\boldsymbol{s}_{0}\).

    • \(\boldsymbol{s}_{1}\).

The corresponding analysis keywords are:

  • SORPTION

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Sorption object.

Raises:

RangeError

class Swelling(table, law=INPUT, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Swelling object specifies time-dependent volumetric swelling for a material.

Note

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

Member Details:

ratios : --is-rst--:py:class:`~abaqus.Material.Ratios.Ratios` = <abaqus.Material.Ratios.Ratios object>[source]

A Ratios object.

setValues(*args, **kwargs)[source]

This method modifies the Swelling object.

Raises:

RangeError

class UserMaterial(
type=MECHANICAL,
unsymm=0,
mechanicalConstants=(),
thermalConstants=(),
effmod=0,
hybridFormulation=INCREMENTAL,
)[source]

Bases: object

The UserMaterial object defines material constants for use in subroutines UMAT, UMATHT, or VUMAT.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the UserMaterial object.

Raises:

RangeError

class UserOutputVariables(n=0)[source]

Bases: object

The UserOutputVariables object specifies the number of user-defined output variables.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the UserOutputVariables object.

Raises:

RangeError

class Viscosity(table, type=NEWTONIAN, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Viscosity object specifies mechanical viscosity.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Viscosity object.

Raises:

RangeError

trs : --is-rst--:py:class:`~abaqus.Material.Mechanical.Viscosity.Trs.Trs` = <abaqus.Material.Mechanical.Viscosity.Trs.Trs object>[source]

A Trs object.

class Viscous(table, law=STRAIN, temperatureDependency=0, dependencies=0, time=TOTAL)[source]

Bases: object

The Viscous object specifies the viscous properties for a two-layer viscoplastic material model.

Note

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:

    • \(A\).

    • \(n\).

    • \(m\).

    • \(f\).

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

    • \(f\).

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

    • \(s_{1}\).

    • \(\frac{Q}{R}\).

    • \(A\).

    • \(\xi\).

    • \(m\).

    • \(A_{0}\).

    • \(\hat{s}\).

    • \(n\).

    • \(a\).

    • \(S_{2}\).

    • \(S_{3}\).

    • \(A_{1}\).

    • \(A_{2}\).

    • \(A_{3}\).

    • \(A_{4}\).

    • \(f\).

  • If law = DARVEAUX, the table data specify the following:

    • \(C_{s s}\).

    • \(\frac{Q}{R}\).

    • \(\alpha\).

    • \(n\).

    • \(\epsilon_{T}\).

    • \(B\).

    • \(f\).

  • If law = DOUBLE_POWER, the table data specify the following:

    • \(A_{1}\).

    • \(B_{1}\).

    • \(C_{1}\).

    • \(A_{2}\).

    • \(B_{2}\).

    • \(C_{2}\).

    • \(\sigma_{0}\).

    • \(f\).

  • If law = POWER_LAW or law = TIME_POWER_LAW, the table data specify the following:

    • \(q_{0}\).

    • \(n\).

    • \(m\).

    • \(\varepsilon_{0}\).

    • \(f\).

    • 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

Member Details:

potential : --is-rst--:py:class:`~abaqus.Material.Plastic.Potential.Potential` = <abaqus.Material.Plastic.Potential.Potential object>[source]

A Potential object.

setValues(*args, **kwargs)[source]

This method modifies the Viscous object.

class MullinsEffect[source]

Bases: object

The MullinsEffect specifies properties for mullins data.

Note

This object can be accessed by:

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

Member Details:

biaxialTests : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Material.TestData.BiaxialTestData.BiaxialTestData`] = [][source]

A BiaxialTestDataArray object.

definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'CONSTANTS'[source]

A SymbolicConstant specifying the method of specifying the data. Possible values are USER, CONSTANTS, and TEST_DATA. The default value is CONSTANTS.

dependencies : --is-rst--:py:class:`int` = 0[source]

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

planarTests : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Material.TestData.PlanarTestData.PlanarTestData`] = [][source]

A PlanarTestDataArray object.

properties : --is-rst--:py:class:`int` = 0[source]

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

table : --is-rst--:py:class:`tuple` = ()[source]

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

temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

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

uniaxialTests : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Material.TestData.UniaxialTestData.UniaxialTestData`] = [][source]

A UniaxialTestDataArray object.

class UserDefinedField[source]

Bases: object

The UserDefinedField object redefines field variables at a material point.

Note

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

Member Details:

class MeanFieldInclusion(
name,
table,
material='',
isotropizationCoefficient=None,
volumeFractionType=UNIFORM,
volumeFractionFieldName='',
aspectRatioType=UNIFORM,
aspectRatioFieldName='',
orientationTensorType=UNIFORM,
orientationTensorFieldName='',
shape=SPHERE,
direction=None,
strainConcentrationTensor=(),
temperatureGradientConcentrationTensor=(),
)[source]

Bases: object

The MeanFieldInclusion object specifies the inclusion type multiscale material property.

Note

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

Added in version 2018: The MeanFieldInclusion class was added.

Member Details:

setValues()[source]

This method modifies the MeanFieldInclusion object.

Raises:

RangeError

class MeanFieldMatrix(name, material='', isotropizationCoefficient=None)[source]

Bases: object

The MeanFieldMatrix object specifies the matrix property.

Note

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

Added in version 2018: The MeanFieldMatrix class was added.

Member Details:

setValues()[source]

This method modifies the MeanFieldMatrix object.

Raises:

RangeError

class MeanFieldVoid(
name,
table,
material='',
isotropizationCoefficient=None,
volumeFractionType=UNIFORM,
volumeFractionFieldName='',
aspectRatioType=UNIFORM,
aspectRatioFieldName='',
orientationTensorType=UNIFORM,
orientationTensorFieldName='',
shape=SPHERE,
direction=None,
strainConcentrationTensor=(),
temperatureGradientConcentrationTensor=(),
)[source]

Bases: object

The MeanFieldVoid object specifies the void inclusion property.

Note

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

Added in version 2018: The MeanFieldMatrix class was added.

Member Details:

setValues()[source]

This method modifies the MeanFieldVoid object.

Raises:

RangeError

class BrittleFailure(
table,
temperatureDependency=0,
dependencies=0,
failureCriteria=UNIDIRECTIONAL,
)[source]

Bases: object

The BrittleFailure object specifies the brittle failure of the material.

Note

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:

  • If parent BrittleCracking member type = STRAIN the table data specify the following:

    • Direct cracking failure 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 parent BrittleCracking member type = DISPLACEMENT or type = GFI the table data specify the following:

    • Direct cracking failure 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.

The corresponding analysis keywords are:

  • BRITTLE FAILURE

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the BrittleFailure object.

Raises:

RangeError

class BrittleShear(table, temperatureDependency=0, dependencies=0, type=RETENTION_FACTOR)[source]

Bases: object

The BrittleShear object specifies the postcracking shear behavior of a material used in a brittle cracking model.

Note

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:

    • \(e\).

    • \(p\).

    • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the BrittleShear object.

Raises:

RangeError

class FailureRatios(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The FailureRatios object specifies the shape of the failure surface for a Concrete model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the FailureRatios object.

Raises:

RangeError

class ShearRetention(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

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.

Note

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:

  • \(\varrho^{\text {close }} for dry concrete. The default value is 1.0\)

  • \(\varepsilon^{\max }\) for dry concrete. The default value is a very large number (full shear retention).

  • \(\varrho^{\text {close }} for wet concrete. The default value is 1.0\)

  • \(\varepsilon^{\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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ShearRetention object.

Raises:

RangeError

class TensionStiffening(table, type=STRAIN, temperatureDependency=0, dependencies=0)[source]

Bases: object

The TensionStiffening object defines the retained tensile stress normal to a crack in a Concrete model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the TensionStiffening object.

Raises:

RangeError

class ConcreteCompressionDamage(
table,
tensionRecovery=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The ConcreteCompressionDamage object specifies hardening for the concrete damaged plasticity model.

Note

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, \(d_{c}\).

  • Inelastic (crushing) strain, \(\epsilon_{c}^{i 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ConcreteCompressionDamage object.

Raises:

RangeError

class ConcreteCompressionHardening(table, rate=0, temperatureDependency=0, dependencies=0)[source]

Bases: object

The ConcreteCompressionHardening object specifies hardening for the concrete damaged plasticity model.

Note

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, \(\sigma_{c}\).

  • Inelastic (crushing) strain, \(\epsilon_{c}^{i n}\).

  • Inelastic (crushing) strain rate, \(\dot{\epsilon}_{c}^{i 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 HARDENING

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ConcreteCompressionHardening object.

Raises:

RangeError

class ConcreteTensionDamage(
table,
compressionRecovery=1,
type=STRAIN,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The ConcreteTensionDamage object specifies hardening for the concrete damaged plasticity model.

Note

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, \(d_{t}\).

    • Direct cracking strain, \(\epsilon_{t}^{c 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, \(d_{t}\)

    • Direct cracking displacement, \(u_{t}^{c 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ConcreteTensionDamage object.

Raises:

RangeError

class ConcreteTensionStiffening(
table,
rate=0,
type=STRAIN,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The ConcreteTensionStiffening object specifies hardening for the concrete damaged plasticity model.

Note

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, \(\sigma_{t}\).

    • Direct cracking strain, \(\epsilon_{t}^{c k}\).

    • Direct cracking strain rate, \(\dot{\epsilon}_{t}^{c 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:

    • Remaining direct stress after cracking, \(\sigma_{t}\).

    • Direct cracking displacement, \(u_{t}^{c k}\).

    • Direct cracking displacement rate, \(\dot{u}_{t}^{c 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 = GFI, the table data specify the following:

    • Failure stress, \(\sigma_{t 0}\)

    • Fracture energy, \(G_{f}\).

    • Direct cracking displacement rate, \(\dot{u}_{t}^{c 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 STIFFENING

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ConcreteTensionStiffening object.

Raises:

RangeError

class Ornl(a=0, h=None, reset=0)[source]

Bases: object

The Ornl object specifies the constitutive model developed by Oak Ridge National Laboratory.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Ornl object.

Raises:

RangeError

class Potential(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Potential object defines an anisotropic yield/creep model.

Note

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:

  • \(R_{11}\).

  • \(R_{22}\).

  • \(R_{33}\).

  • \(R_{12}\).

  • \(R_{13}\).

  • \(R_{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:

  • POTENTIAL

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the Potential object.

Raises:

RangeError

class ClayHardening(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The ClayHardening object specifies hardening for the clay plasticity model.

Note

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, \(p_c\).

  • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the ClayHardening object.

Raises:

RangeError

class CrushStressVelocityFactor(crushStressVelocityFactorTable)[source]

Bases: object

The CrushStressVelocityFactor object defines how the approach velocity at a crushing interface influences a material’s resistance to crushing.

Note

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

Added in version 2022: The CrushStressVelocityFactor class was added.

Member Details:

crushStressVelocityFactorTable : --is-rst--:py:class:`~typing.Sequence`\ \[:py:class:`~typing.Sequence`\ \[:py:class:`float`]][source]

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

setValues(crushStressVelocityFactorTable=())[source]

This method creates a CrushStressVelocityFactor object.

Parameters:
crushStressVelocityFactorTable=()

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

class CrushableFoamHardening(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CrushableFoamHardening object specifies hardening for the crushable foam plasticity model.

Note

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, \(\sigma_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CrushableFoamHardening object.

Raises:

RangeError

class RateDependent(table, type=POWER_LAW, temperatureDependency=0, dependencies=0)[source]

Bases: object

The RateDependent object defines a rate-dependent viscoplastic model.

Note

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:

    • \(D\).

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

  • If type = YIELD_RATIO, the table data specify the following:

    • Yield stress ratio, \(R=\bar{\sigma} / \sigma^{0}\).

    • Equivalent plastic strain rate, \(\dot{\bar{\varepsilon}}^{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 type = JOHNSON_COOK, the table data specify the following:

    • \(C\).

    • \(\dot{\varepsilon}_{0}\).

The corresponding analysis keywords are:

  • RATE DEPENDENT

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the RateDependent object.

Raises:

RangeError

class DruckerPragerCreep(table, law=STRAIN, temperatureDependency=0, dependencies=0)[source]

Bases: object

The DruckerPragerCreep object specifies creep for Drucker-Prager plasticity models.

Note

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:

      1. (Units of \(\mathrm{F}^{-n} \mathrm{~L}^{2 n} \mathrm{~T}^{-1-m}\).)

    • \(n\).

    • \(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 \(\mathrm{T}^{-1}\). )

    • \(\alpha\). (Units of \(F^{-1} L^{2}\).)

    • \(m\).

    • \(t_{1} \cdot\) (Units of \(\mathrm{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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DruckerPragerCreep object.

Raises:

RangeError

class DruckerPragerHardening(
table,
type=COMPRESSION,
rate=0,
temperatureDependency=0,
dependencies=0,
)[source]

Bases: object

The DruckerPragerHardening object specifies hardening for Drucker-Prager plasticity models.

Note

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, \(\dot{\bar{\varepsilon}}{ }^{p l}\), 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DruckerPragerHardening object.

Raises:

RangeError

class TriaxialTestData(table, a=None, b=None, pt=None)[source]

Bases: object

The TriaxialTestData object provides triaxial test data.

Note

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, \(\sigma_1=\sigma_2\).

  • Sign and magnitude of the stress in loading direction, \(\sigma_3\).

The corresponding analysis keywords are:

  • TRIAXIAL TEST DATA

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the TriaxialTestData object.

Raises:

RangeError

class CapCreepCohesion(table, law=STRAIN, temperatureDependency=0, dependencies=0, time=TOTAL)[source]

Bases: object

The CapCreepCohesion object specifies a cap creep model and material properties.

Note

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:

    • \(A\).

    • \(n\).

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

    • \(A\).

    • \(\alpha\).

    • \(m\).

    • \(t_{1}\).

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

    • \(q_0\).

    • \(n\).

    • \(m\).

    • \(\epsilon_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CapCreepCohesion object.

class CapCreepConsolidation(
table,
law=STRAIN,
temperatureDependency=0,
dependencies=0,
time=TOTAL,
)[source]

Bases: object

The CapCreepConsolidation object specifies a cap creep model and material properties.

Note

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:

    • \(A\).

    • \(n\).

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

    • \(A\).

    • \(\alpha\).

    • \(m\).

    • \(t_{1}\).

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

    • \(q_0\).

    • \(n\).

    • \(m\).

    • \(\epsilon_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CapCreepConsolidation object.

class CapHardening(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CapHardening object specifies Drucker-Prager/Cap plasticity hardening.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CapHardening object.

Raises:

RangeError

class AnnealTemperature(table, dependencies=0)[source]

Bases: object

The AnnealTemperature object specifies the material annealing temperature.

Note

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, \(\theta\).

  • 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the AnnealTemperature object.

Raises:

RangeError

class CastIronCompressionHardening(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CastIronCompressionHardening object specifies hardening for the Cast- Iron plasticity model.

Note

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, \(\sigma_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CastIronCompressionHardening object.

Raises:

RangeError

class CastIronTensionHardening(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The CastIronTensionHardening object specifies hardening for the Cast- Iron plasticity model.

Note

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, \(\sigma_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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CastIronTensionHardening object.

Raises:

RangeError

class CycledPlastic(table, temperatureDependency=0)[source]

Bases: object

The CycledPlastic object specifies cycled yield stress data for the ORNL constitutive model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CycledPlastic object.

class CyclicHardening(table, temperatureDependency=0, dependencies=0, parameters=0)[source]

Bases: object

The CyclicHardening object defines the evolution of the elastic domain for the nonlinear isotropic/kinematic hardening model.

Note

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_{\infty}\) (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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the CyclicHardening object.

class PorousFailureCriteria(fraction=1, criticalFraction=1)[source]

Bases: object

The PorousFailureCriteria object specifies the material failure criteria for a porous metal.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the PorousFailureCriteria object.

Raises:

RangeError

class VoidNucleation(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The VoidNucleation object defines the nucleation of voids in a porous material.

Note

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:

  • \(\varepsilon_{N}\), the mean value of the nucleation-strain normal distribution.

  • \(s_{N}\), the standard deviation of the nucleation-strain normal distribution.

  • \(f_{N}\), 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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the VoidNucleation object.

Raises:

RangeError

class MohrCoulombHardening(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The MohrCoulombHardening object specifies hardening for the Mohr-Coulomb plasticity model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the MohrCoulombHardening object.

Raises:

RangeError

class TensionCutOff(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The TensionCutOff object specifies tension cutoff for different material models for example the Mohr- Coulomb plasticity model.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the TensionCutOff object.

Raises:

RangeError

class TensileFailure[source]

Bases: object

The TensileFailure object specifies the material tensile failure.

Note

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

Added in version 2020: The TensileFailure class was added.

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the TensileFailure object.

Raises:

RangeError

tensileFailure(
table,
dependencies=0,
temperatureDependency=0,
elementDeletion=True,
pressure=None,
shear=None,
)[source]

This method creates a tensileFailure object.

Note

This function can be accessed by:

mdb.models[name].materials[name].Plastic.TensileFailure
mdb.models[name].materials[name].eos.TensileFailure
session.odbs[name].materials[name].Plastic.TensileFailure
session.odbs[name].materials[name].eos.TensileFailure
Parameters:
table

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

dependencies=0

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

temperatureDependency=0

A boolean specifying whether the data depends on temperature. The default value is OFF.

elementDeletion=True

A boolean specifying whether element deletion is allowed. The default value is True.

pressure=None

A SymbolicConstant specifying the pressure stress. The Possible values are BRITTLE and DUCTILE.

shear=None

A SymbolicConstant specifying the deviatoric stress. Possible values are BRITTLE and DUCTILE.

Returns:

An TensileFailure object.

Return type:

TensileFailure

Raises:

RangeError

class Ratios(table, temperatureDependency=0, dependencies=0)[source]

Bases: object

The Ratios object specifies ratios that define anisotropic swelling.

Note

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

Member Details:

dependencies : --is-rst--:py:class:`int` = 0[source]

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

setValues(*args, **kwargs)[source]

This method modifies the Ratios object.

Raises:

RangeError

table : --is-rst--:py:class:`tuple`[source]

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

temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

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

class SaturationDependence(table)[source]

Bases: object

The SaturationDependence object specifies the dependence of the permeability of a material on the saturation of the wetting liquid.

Note

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:

  • \(k_{s}\). (Dimensionless.)

  • Saturation, \(\boldsymbol{S}\). (Dimensionless.)

The corresponding analysis keywords are:

  • PERMEABILITY

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the SaturationDependence object.

Raises:

RangeError

class VelocityDependence(table)[source]

Bases: object

The VelocityDependence object specifies the dependence of the permeability of a material on the velocity of fluid flow.

Note

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:

  • \(\beta\). Only \(\beta>0.0\) is allowed.

  • Void ratio, \(e\).

The corresponding analysis keywords are:

  • PERMEABILITY

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the VelocityDependence object.

Raises:

RangeError

class DamageEvolution(
type,
table,
degradation=MAXIMUM,
temperatureDependency=0,
dependencies=0,
mixedModeBehavior=MODE_INDEPENDENT,
modeMixRatio=ENERGY,
power=None,
softening=LINEAR,
)[source]

Bases: object

The DamageEvolution object specifies material properties to define the evolution of damage.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DamageEvolution object.

Raises:

RangeError

class DamageStabilization(
fiberTensileCoeff,
fiberCompressiveCoeff,
matrixTensileCoeff,
matrixCompressiveCoeff,
)[source]

Bases: object

The DamageStabilization object specifies the viscosity coefficients for the damage model for fiber- reinforced materials.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DamageStabilization object.

Raises:

RangeError

class DamageStabilizationCohesive(cohesiveCoeff=None)[source]

Bases: object

The DamageStabilizationCohesive object specifies the viscosity coefficients for the damage model for surface-based cohesive behavior or enriched cohesive behavior.

Note

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

Member Details:

setValues(*args, **kwargs)[source]

This method modifies the DamageStabilizationCohesive object.

Raises:

RangeError

evaluateMaterial(
material,
simulationName,
dataSource,
strainEnergyPotentials,
marlowData=None,
marlowDataType=None,
testDataTypes=None,
uniaxialStrainRange=None,
biaxialStrainRange=None,
planarStrainRange=None,
volumeRatioRange=None,
simpleShearStrainRange=None,
viscoDataSource=None,
viscoTestDataTypes=None,
relaxationTime=None,
creepTime=None,
)[source]

This method evaluates the behavior of a hyperelastic material under standard test conditions.

Note

This function can be accessed by:

evaluateMaterial
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

  • 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

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

None or a SymbolicConstant specifying the input data type for the Marlow material model. Possible values are TENSION, COMPRESSION, or BOTH.

testDataTypes=None

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=None

A tuple of Floats specifying minimum and maximum nominal strains to be applied in the uniaxial tension test.

biaxialStrainRange=None

A tuple of Floats specifying the minimum and maximum nominal strains to be applied in the biaxial tension test.

planarStrainRange=None

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=None

A tuple of Floats specifying the minimum and maximum compressive volume ratio.

simpleShearStrainRange=None

A tuple of Floats specifying the minimum and maximum nominal strains to be applied in the simple shear test.

viscoDataSource=None

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

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

None or a Float specifying the time period for the stress relaxation response mode. The default value is None.

creepTime=None

None or a Float specifying the time period for the creep response mode. The default value is None.

Raises:
  • MaterialEvaluationError – If dataSource = TEST_DATA and strainEnergyPotentials contains POLY_N3, POLY_N4, POLY_N5, or POLY_N6.

  • MaterialEvaluationError – If the material evaluation failed.

  • MaterialEvaluationError – If the material type of the material to be evaluated is not hyperelastic.