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=abaqusConstants.NOT_SET, modelType=abaqusConstants.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]

This method creates a Model object.

Note

This function can be accessed by:

mdb.Model
Parameters:
  • name (str) – A String specifying the repository key.

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • waveFormulation (Literal[SCATTERED, NOT_SET, TOTAL], default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • modelType (Literal[STANDARD_EXPLICIT, ELECTROMAGNETIC], default: STANDARD_EXPLICIT) – A SymbolicConstant specifying the analysis model type. Possible values are STANDARD_EXPLICIT and ELECTROMAGNETIC. The default is STANDARD_EXPLICIT.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • copyConstraints (Union[AbaqusBoolean, bool], default: 1) – A boolean specifying whether to copy the constraints created in the model to the model that instances this model. The default value is ON.

  • copyConnectors (Union[AbaqusBoolean, bool], default: 1) – A boolean specifying whether to copy the connectors created in the model to the model that instances this model. The default value is ON.

  • copyInteractions (Union[AbaqusBoolean, bool], default: 1) – A boolean specifying whether to copy the interactions created in the model to the model that instances this model. The default value is ON.

Returns:

A Model object.

Return type:

Model

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.

rootAssembly

An Assembly 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.

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 (str) – A String specifying the name of the new material.

  • description (str, default: '') – A String specifying user description of the material. The default value is an empty string.

  • materialIdentifier (str, default: '') – 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]

This method creates a new Odb object.

Note

This function can be accessed by:

session.Odb
Parameters:
  • name (str) – A String specifying the repository key.

  • analysisTitle (str, default: '') – A String specifying the title of the output database. The default value is an empty string.

  • description (str, default: '') – A String specifying the description of the output database. The default value is an empty string.

  • path (str, default: '') – A String specifying the path to the file where the new output database (.odb ) file will be written. The default value is an empty string.

Returns:

An Odb object.

Return type:

Odb

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 (str) – A String specifying the name of the new material.

  • description (str, default: '') – A String specifying user description of the material. The default value is an empty string.

  • materialIdentifier (str, default: '') – 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

This method creates a Material object.

Note

This function can be accessed by:

mdb.models[name].Material
session.odbs[name].Material
Parameters:
  • name (str) – A String specifying the name of the new material.

  • description (str, default: '') – A String specifying user description of the material. The default value is an empty string.

  • materialIdentifier (str, default: '') – A String specifying material identifier for customer use. The default value is an empty string.

Returns:

A Material object.

Return type:

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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the volumetricTable data is specified. The default value is OFF.

  • temperatureDependencyB (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data in bulkTable depend on temperature. The default value is OFF.

  • temperatureDependencyV (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data in volumetricTable depend on temperature. The default value is OFF.

  • dependenciesB (int, default: 0) – An Int specifying the number of field variable dependencies for the data in bulkTable. The default value is 0.

  • dependenciesV (int, default: 0) – An Int specifying the number of field variable dependencies for the data in volumetricTable. The default value is 0.

  • bulkTable (tuple, default: ()) –

    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 (tuple, default: ()) –

    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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • type (Literal[STRAIN, DISPLACEMENT, GFI], default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • intercept (Optional[float], default: 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 (Literal[EXPONENTIAL, TABULAR], default: EXPONENTIAL) – A SymbolicConstant specifying the type of hardening/softening definition. Possible values are EXPONENTIAL and TABULAR. The default value is EXPONENTIAL.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of conductivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.STRAIN, temperatureDependency=0, dependencies=0, time=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • law (Literal[STRAIN, TIME, HYPERBOLIC_SINE, USER, ANAND, DARVEAUX, DOUBLE_POWER, POWER_LAW, TIME_POWER_LAW], default: 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.

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

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • time (Literal[TOTAL, CREEP], default: 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

New in version 2022: The CrushStress method was added.

Parameters:
  • crushStressTable (Sequence[Sequence[float]]) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A CrushStress object.

CrushableFoam(table, hardening=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • hardening (Literal[VOLUMETRIC, ISOTROPIC], default: VOLUMETRIC) – A SymbolicConstant specifying the type of hardening/softening definition. Possible values are VOLUMETRIC and ISOTROPIC. The default value is VOLUMETRIC.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (float, default: 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 (float, default: 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 (float, default: 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 (float, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • distributionType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD], default: 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 (str, default: '') – 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 (int, default: 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 (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the dielectric behavior. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on frequency. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.ISOTROPIC, law=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of diffusivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • law (Literal[GENERAL, FICK], default: GENERAL) – A SymbolicConstant specifying the diffusion behavior. Possible values are GENERAL and FICK. The default value is GENERAL.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • shearCriterion (Literal[LINEAR, HYPERBOLIC, EXPONENTIAL], default: 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 (float, default: 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 (Union[AbaqusBoolean, bool], default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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=abaqusConstants.ISOTROPIC, noCompression=0, noTension=0, temperatureDependency=0, dependencies=0, moduli=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC, ENGINEERING_CONSTANTS, LAMINA, TRACTION, COUPLED_TRACTION, SHORT_FIBER, SHEAR, BILAMINA], default: 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.

    New in version 2022: The option BILAMINA was added.

  • noCompression (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether compressive stress is allowed. The default value is OFF.

  • noTension (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether tensile stress is allowed. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • moduli (Literal[LONG_TERM, INSTANTANEOUS], default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of electrical conductivity. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on frequency. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (Literal[IDEALGAS, TABULAR, IGNITIONANDGROWTH], default: IDEALGAS) – A SymbolicConstant specifying the equation of state. Possible values are USUP, JWL, IDEALGAS, TABULAR, and IGNITIONANDGROWTH. The default value is IDEALGAS.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data in gasSpecificTable depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the data in gasSpecificTable. The default value is 0.

  • detonationEnergy (float, default: 0) – A Float specifying the detonation energy text field. The default value is 0.0.

  • solidTable (tuple, default: ()) –

    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 (tuple, default: ()) –

    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 (tuple, default: ()) –

    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 (tuple, default: ()) –

    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 (tuple, default: ()) – A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

Expansion(type=abaqusConstants.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 (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC, SHORT_FIBER], default: ISOTROPIC) – A SymbolicConstant specifying the type of expansion. Possible values are ISOTROPIC, ORTHOTROPIC, ANISOTROPIC, and SHORT_FIBER. The default value is ISOTROPIC.

  • userSubroutine (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether a user subroutine is used to define the increments of thermal strain. The default value is OFF.

  • zero (float, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • table (tuple, default: ()) – 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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=abaqusConstants.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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • type (Literal[COEFFICIENTS, USER], default: COEFFICIENTS) – A SymbolicConstant specifying the type of fluid leak-off. Possible values are COEFFICIENTS and USER. The default value is COEFFICIENTS.

  • table (tuple, default: ()) – 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

New in version 2021: The GapConductance method was added.

Parameters:
  • pressureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on pressure. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • table (tuple, default: ()) – 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

New in version 2021: The GapConvection method was added.

Parameters:
  • type (str) – An odb_String specifying the type of gap convection. Possible values are FLUX, TEMPERATURE, and TABULAR. The default value is FLUX.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • kmax (Optional[float], default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • type (Literal[NEWTONIAN, POWER_LAW, BINGHAM_PLASTIC, HERSCHEL_BULKLEY], default: 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.

    New 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

New in version 2021: The GapRadiation method was added.

Parameters:
  • masterSurfaceEmissivity (float) – A Float specifying the Emissivity of master surface.ϵA

  • slaveSurfaceEmissivity (float) – A Float specifying the Emissivity of the slave surfaceϵB.

  • table (tuple) – 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.ELASTIC_PLASTIC, unloadingDependencies=0, unloadingTemperatureDependency=0, variableUnits=abaqusConstants.STRESS, yieldOnset=0, yieldOnsetMethod=abaqusConstants.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 (tuple) – 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the loading data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (Optional[float], default: None) – A Float specifying the fraction of the initial compressive stiffness that defines the stiffness in tension. The default value is 10⁻³.

  • type (Literal[ELASTIC_PLASTIC, DAMAGE], default: 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 (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether unloading data depends on temperature. The default value is OFF.

  • variableUnits (Literal[STRESS, FORCE], default: 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 (float, default: 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 (Literal[RELATIVE_SLOPE_DROP, CLOSURE_VALUE], default: 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 (tuple, default: ()) – 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • variableUnits (Literal[STRESS, FORCE], default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

A Gel object.

Return type:

Gel

HashinDamageInitiation(table, definition=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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=abaqusConstants.UNKNOWN, moduliTimeScale=abaqusConstants.LONG_TERM, temperatureDependency=0, n=1, beta=abaqusConstants.FITTED_VALUE, testData=1, compressible=0, properties=0, deviatoricResponse=abaqusConstants.UNIAXIAL, volumetricResponse=abaqusConstants.DEFAULT, poissonRatio=0, materialType=abaqusConstants.ISOTROPIC, anisotropicType=abaqusConstants.FUNG_ANISOTROPIC, formulation=abaqusConstants.STRAIN, behaviorType=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below. This argument is valid only if testData = OFF.

  • type (Literal[ARRUDA_BOYCE, MARLOW, MOONEY_RIVLIN, NEO_HOOKE, OGDEN, POLYNOMIAL, REDUCED_POLYNOMIAL, USER, VAN_DER_WAALS, YEOH, UNKNOWN], default: 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 (Literal[LONG_TERM, INSTANTANEOUS], default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • n (int, default: 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 (Union[Literal[FITTED_VALUE, VAN_DER_WAALS], float], default: 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 (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether test data are supplied. The default value is ON.

  • compressible (Union[AbaqusBoolean, bool], default: 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 (int, default: 0) – An Int specifying the number of property values needed as data for the user-defined hyperelastic material. The default value is 0.

  • deviatoricResponse (Literal[UNIAXIAL, BIAXIAL, PLANAR], default: UNIAXIAL) – A SymbolicConstant specifying which test data to use. Possible values are UNIAXIAL, BIAXIAL, and PLANAR. The default value is UNIAXIAL.

  • volumetricResponse (Literal[DEFAULT, VOLUMETRIC_DATA, POISSON_RATIO, LATERAL_NOMINAL_STRAIN], default: 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 (float, default: 0) – A Float specifying the poisson ratio. This argument is valid only if volumetricResponse = POISSON_RATIO. The default value is 0.0.

  • materialType (Literal[ISOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of material. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.

  • anisotropicType (Literal[FUNG_ANISOTROPIC, FUNG_ORTHOTROPIC, HOLZAPFEL, USER_DEFINED], default: 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 (Literal[STRAIN, INVARIANT], default: STRAIN) – A SymbolicConstant specifying the type of formulation. Possible values are STRAIN and INVARIANT. The default value is STRAIN.

  • behaviorType (Literal[INCOMPRESSIBLE, COMPRESSIBLE], default: INCOMPRESSIBLE) – A SymbolicConstant specifying the type of anisotropic hyperelastic material behavior. Possible values are INCOMPRESSIBLE and COMPRESSIBLE. The default value is INCOMPRESSIBLE.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the data in*volumetricTable* . The default value is 0.

  • localDirections (int, default: 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=abaqusConstants.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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether test data are supplied. The default value is OFF.

  • poisson (Optional[float], default: 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 (int, default: 1) – An Int specifying the order of the strain energy potential. Possible values are 1 ≤n≤n≤ 6. The default value is 1.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • moduli (Literal[LONG_TERM, INSTANTANEOUS], default: 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 (tuple, default: ()) – 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • user (Union[AbaqusBoolean, bool], default: 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 (float, default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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 (float, default: 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 (tuple) – 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=abaqusConstants.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 (Union[AbaqusBoolean, bool], default: 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 (Optional[float], default: None) – None or a Float specifying the maximum allowable principal tensile stress. The default value is None.

  • extrapolateStressStrainCurve (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the stress-strain curve is extrapolated if exceeding maximum strain rate. The default value is OFF.

  • strainRateType (Literal[VOLUMETRIC, PRINCIPAL], default: VOLUMETRIC) – A SymbolicConstant specifying strain rate measure used for constitutive calculations. Possible values are PRINCIPAL and VOLUMETRIC. The default value is VOLUMETRIC.

  • mu0 (Optional[float], default: None) – A Float specifying the relaxation coefficient μ0. The default value is 10⁻⁴.

  • mu1 (float, default: 0) – A Float specifying the relaxation coefficient μ1. The default value is 0.5x10⁻².

  • alpha (float, default: 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=abaqusConstants.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 (tuple) – 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 (tuple) – 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 (tuple) – 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 (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of magnetic permeability. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on frequency. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • nonlinearBH (Union[AbaqusBoolean, bool], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.NMORI, position=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: NMORI) – A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

  • position (Literal[CENTROID, CRACKTIP, COMBINED], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.NMORI, position=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: NMORI) – A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

  • position (Literal[CENTROID, CRACKTIP, COMBINED], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.NMORI, position=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: NMORI) – A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

  • position (Literal[CENTROID, CRACKTIP, COMBINED], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.NMORI, position=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: NMORI) – A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

  • position (Literal[CENTROID, CRACKTIP, COMBINED], default: 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=abaqusConstants.MT, isotropization=abaqusConstants.ALLISO, uniformMatrixStrain=abaqusConstants.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

New in version 2018: The MeanFieldHomogenization method was added.

Parameters:
  • angleSubdivision (Optional[int], default: None) – An Int specifying the number of angle increments used for the discretization of the orientation space.

  • formulation (Literal[MT, REUSS, VOIGT, INVERSED_MT, BALANCED, UNSPECIFIED], default: 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 (Literal[ALLISO, EISO, PISO], default: ALLISO) – A SymbolicConstant specifying the type of isotropization method. Possible values are ALLISO, EISO, and PISO. The default value is ALLISO.

  • uniformMatrixStrain (Literal[NO, YES], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • deviatoricEccentricity (Optional[float], default: 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 (float, default: 0) – A Float specifying the flow potential eccentricity in the meridional plane, ϵϵ. The default value is 0.1.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • useTensionCutoff (Union[AbaqusBoolean, bool], default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

A MoistureSwelling object.

Return type:

MoistureSwelling

MsfldDamageInitiation(table, definition=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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=abaqusConstants.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 (float) – A Float specifying the specific weight of the wetting liquid, \(\gamma_w\).

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

  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ISOTROPIC, ORTHOTROPIC, ANISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of permeability. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[STRESS, STRAIN], default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.ISOTROPIC, rate=0, dataType=abaqusConstants.HALF_CYCLE, strainRangeDependency=0, numBackstresses=1, temperatureDependency=0, dependencies=0, extrapolation=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • hardening (Literal[ISOTROPIC, KINEMATIC, COMBINED, JOHNSON_COOK, USER], default: ISOTROPIC) – A SymbolicConstant specifying the type of hardening. Possible values are ISOTROPIC, KINEMATIC, COMBINED, JOHNSON_COOK, and USER. The default value is ISOTROPIC.

  • rate (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on rate. The default value is OFF.

  • dataType (Literal[HALF_CYCLE, PARAMETERS, STABILIZED], default: 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 (Union[AbaqusBoolean, bool], default: 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 (int, default: 1) – An Int specifying the number of backstresses. This argument is only valid if hardening = COMBINED. The default value is 1.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • extrapolation (Literal[CONSTANT, LINEAR], default: 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.

    New 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

New in version 2023: The PlasticityCorrection method was added.

Parameters:
  • type (Literal[RAMBERG_OSGOOD, TABULAR]) – Set type=RAMBERG_OSGOOD to specify the Ramberg-Osgood relationship. Set type=TABULAR to specify the tabular form.

  • table (Sequence[Sequence[float]]) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • zero (float, default: 0) – A Float specifying the value of θ0. The default value is 0.0.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • shear (Literal[POISSON, G], default: POISSON) – A SymbolicConstant specifying the shear definition form. Possible values are G and POISSON. The default value is POISSON.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • relativeDensity (Optional[float], default: None) – None or a Float specifying the initial relative density of the material, r0. The default value is None.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.NMORI, position=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: NMORI) – A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

  • position (Literal[CENTROID, CRACKTIP, COMBINED], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.NMORI, position=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: NMORI) – A SymbolicConstant specifying the damage initiation direction. Possible values are NMORI and TMORI. The default value is NMORI.

  • position (Literal[CENTROID, CRACKTIP, COMBINED], default: 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=abaqusConstants.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 (float, default: 0) – A Float specifying the tolerance to be used for regularizing material data. The default value is 0.03.

  • strainRateRegularization (Literal[LOGARITHMIC, LINEAR], default: 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=abaqusConstants.MSFLD, feq=10, fnn=10, fnt=10, frequency=1, ks=0, numberImperfections=4, temperatureDependency=0, dependencies=0, alpha=0, omega=1, tolerance=0, direction=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described in the “Table data” section.

  • definition (Literal[MSFLD, FLD], default: MSFLD) – A SymbolicConstant specifying the damage initiation definition. Possible values are FLD and MSFLD. The default value is MSFLD.

  • feq (float, default: 10) – A Float specifying the critical value of the deformation severity index for equivalent Plastic strains. The default value is 10.0.

  • fnn (float, default: 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 (float, default: 10) – A Float specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.

  • frequency (int, default: 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 (float, default: 0) – A Float specifying the value of Ks. The default value is 0.0.

  • numberImperfections (int, default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • alpha (float, default: 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 (float, default: 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 (float, default: 0) – A Float specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.

  • direction (Literal[NMORI, TMORI], default: 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.TABULAR, exsorption=0, lawExsorption=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • lawAbsorption (Literal[TABULAR, LOG], default: TABULAR) – A SymbolicConstant specifying absorption behavior. Possible values are LOG and TABULAR. The default value is TABULAR.

  • exsorption (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the exsorption data is specified. The default value is OFF.

  • lawExsorption (Literal[TABULAR, LOG], default: TABULAR) – A SymbolicConstant specifying exsorption behavior. Possible values are LOG and TABULAR. The default value is TABULAR.

  • scanning (float, default: 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 (tuple, default: ()) – 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • law (Literal[CONSTANTVOLUME, CONSTANTPRESSURE], default: CONSTANTVOLUME) – A SymbolicConstant specifying the specific heat behavior. Possible values are CONSTANTVOLUME and CONSTANTPRESSURE. The default value is CONSTANTVOLUME.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.This argument is valid only when law = INPUT.

  • law (Literal[INPUT, USER], default: INPUT) – A SymbolicConstant specifying the type of data defining the swelling behavior. Possible values are INPUT and USER. The default value is INPUT.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.MECHANICAL, unsymm=0, mechanicalConstants=(), thermalConstants=(), effmod=0, hybridFormulation=abaqusConstants.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 (Literal[MECHANICAL, THERMAL, THERMOMECHANICAL], default: 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 (Union[AbaqusBoolean, bool], default: 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 (tuple, default: ()) – 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 (tuple, default: ()) – 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 (Union[AbaqusBoolean, bool], default: 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 (Literal[INCREMENTAL, TOTAL, INCOMPRESSIBLE], default: 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 (int, default: 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=abaqusConstants.FORMULA, type=abaqusConstants.ISOTROPIC, preload=abaqusConstants.NONE, time=abaqusConstants.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 (Literal[FREQUENCY, TIME]) – 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • frequency (Literal[FORMULA, TABULAR, PRONY, CREEP_TEST_DATA, RELAXATION_TEST_DATA], default: 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 (Literal[ISOTROPIC, TRACTION], default: 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 (Literal[NONE, UNIAXIAL, VOLUMETRIC, UNIAXIAL_VOLUMETRIC], default: 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 (Literal[PRONY, CREEP_TEST_DATA, RELAXATION_TEST_DATA, FREQUENCY_DATA], default: 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 (float, default: 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 (int, default: 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 (tuple, default: ()) – 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=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[NEWTONIAN], default: NEWTONIAN) – A SymbolicConstant specifying the type of viscosity. The default value is NEWTONIAN.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 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=abaqusConstants.STRAIN, temperatureDependency=0, dependencies=0, time=abaqusConstants.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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • law (Literal[STRAIN, TIME, USER, ANAND, DARVEAUX, DOUBLE_POWER, POWER_LAW, TIME_POWER_LAW], default: 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.

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

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • time (Literal[TOTAL, CREEP], default: 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

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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the volumetricTable data is specified. The default value is OFF.

  • temperatureDependencyB (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data in bulkTable depend on temperature. The default value is OFF.

  • temperatureDependencyV (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data in volumetricTable depend on temperature. The default value is OFF.

  • dependenciesB (int, default: 0) – An Int specifying the number of field variable dependencies for the data in bulkTable. The default value is 0.

  • dependenciesV (int, default: 0) – An Int specifying the number of field variable dependencies for the data in volumetricTable. The default value is 0.

  • bulkTable (tuple, default: ()) –

    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 (tuple, default: ()) –

    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

Member Details:

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

This method modifies the AcousticMedium object.

Raises:

RangeError

class Density(table, temperatureDependency=0, dependencies=0, distributionType=abaqusConstants.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

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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • distributionType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD], default: 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 (str, default: '') – 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

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

This method creates a BiaxialTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].hyperelastic.BiaxialTestData
mdb.models[name].materials[name].hyperfoam.BiaxialTestData
mdb.models[name].materials[name].mullinsEffect.BiaxialTestData
session.odbs[name].materials[name].hyperelastic.BiaxialTestData
session.odbs[name].materials[name].hyperfoam.BiaxialTestData
session.odbs[name].materials[name].mullinsEffect.BiaxialTestData
Parameters:
  • table (tuple) –

    A sequence of sequences of Floats specifying the following:

    • Nominal stress, TB.

    • Nominal strain, ϵB.

  • smoothing (Optional[int], default: None) – None or an Int specifying the value for smoothing. If smoothing = None, no smoothing is employed. The default value is None.

  • lateralNominalStrain (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether to include lateral nominal strain. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A BiaxialTestData object.

Return type:

BiaxialTestData

Member Details:

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

This method modifies the BiaxialTestData object.

class Hyperfoam(testData=0, poisson=None, n=1, temperatureDependency=0, moduli=abaqusConstants.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

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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether test data are supplied. The default value is OFF.

  • poisson (Optional[float], default: 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 (int, default: 1) – An Int specifying the order of the strain energy potential. Possible values are 1 ≤n≤n≤ 6. The default value is 1.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • moduli (Literal[INSTANTANEOUS, LONG_TERM], default: 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 (tuple, default: ()) – 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

Member Details:

biaxialTestData: BiaxialTestData = <abaqus.Material.TestData.BiaxialTestData.BiaxialTestData object>[source]

A BiaxialTestData object.

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: SimpleShearTestData = <abaqus.Material.TestData.SimpleShearTestData.SimpleShearTestData object>[source]

A SimpleShearTestData object.

uniaxialTestData: UniaxialTestData = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

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

This method creates a PlanarTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].hyperelastic.PlanarTestData
mdb.models[name].materials[name].hyperfoam.PlanarTestData
mdb.models[name].materials[name].mullinsEffect.PlanarTestData
session.odbs[name].materials[name].hyperelastic.PlanarTestData
session.odbs[name].materials[name].hyperfoam.PlanarTestData
session.odbs[name].materials[name].mullinsEffect.PlanarTestData
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • smoothing (Optional[int], default: None) – None or an Int specifying the value for smoothing. If smoothing = None, no smoothing is employed. The default value is None.

  • lateralNominalStrain (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether to include lateral nominal strain. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A PlanarTestData object.

Return type:

PlanarTestData

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

This method creates a SimpleShearTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].hyperfoam.SimpleShearTestData
session.odbs[name].materials[name].hyperfoam.SimpleShearTestData
Parameters:

table (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

A SimpleShearTestData object.

Return type:

SimpleShearTestData

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

This method creates a UniaxialTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].hyperelastic.UniaxialTestData
mdb.models[name].materials[name].hyperfoam.UniaxialTestData
mdb.models[name].materials[name].lowDensityFoam.UniaxialTestData
mdb.models[name].materials[name].mullinsEffect.UniaxialTestData
session.odbs[name].materials[name].hyperelastic.UniaxialTestData
session.odbs[name].materials[name].hyperfoam.UniaxialTestData
session.odbs[name].materials[name].lowDensityFoam.UniaxialTestData
session.odbs[name].materials[name].mullinsEffect.UniaxialTestData
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • smoothing (Optional[int], default: None) – None or an Int specifying the value for smoothing. If smoothing = None, no smoothing is employed. The default value is None.

  • lateralNominalStrain (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether to include lateral nominal strain. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A UniaxialTestData object.

Return type:

UniaxialTestData

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

This method creates a VolumetricTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].hyperelastic.VolumetricTestData
mdb.models[name].materials[name].hyperfoam.VolumetricTestData
mdb.models[name].materials[name].viscoelastic.VolumetricTestData
session.odbs[name].materials[name].hyperelastic.VolumetricTestData
session.odbs[name].materials[name].hyperfoam.VolumetricTestData
session.odbs[name].materials[name].viscoelastic.VolumetricTestData
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • volinf (Optional[float], default: None) – None or a Float specifying a normalized volumetric value that depends on the value of the time member of the Viscoelastic object. The default value is None.If time = RELAXATION_TEST_DATA, volinf specifies the value of the long-term, normalized volumetric modulus, kR⁢(∞). If time = CREEP_TEST_DATA, volinf specifies the value of the long-term, normalized volumetric compliance, K⁢(∞).This argument is valid only for a viscoelastic material model.

  • smoothing (Optional[int], default: None) – None or an Int specifying the value for smoothing. If smoothing = None, no smoothing is employed. The default value is None.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A VolumetricTestData object.

Return type:

VolumetricTestData

Member Details:

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

This method modifies the VolumetricTestData object.

class Hyperelastic(table, type=abaqusConstants.UNKNOWN, moduliTimeScale=abaqusConstants.LONG_TERM, temperatureDependency=0, n=1, beta=abaqusConstants.FITTED_VALUE, testData=1, compressible=0, properties=0, deviatoricResponse=abaqusConstants.UNIAXIAL, volumetricResponse=abaqusConstants.DEFAULT, poissonRatio=0, materialType=abaqusConstants.ISOTROPIC, anisotropicType=abaqusConstants.FUNG_ANISOTROPIC, formulation=abaqusConstants.STRAIN, behaviorType=abaqusConstants.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

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 (tuple) – A sequence of sequences of Floats specifying the items described below. This argument is valid only if testData = OFF.

  • type (Literal[MARLOW, MOONEY_RIVLIN, POLYNOMIAL, YEOH, ARRUDA_BOYCE, REDUCED_POLYNOMIAL, UNKNOWN, VALANIS_LANDEL, USER, OGDEN, VAN_DER_WAALS, NEO_HOOKE], default: UNKNOWN) –

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

    • ARRUDA_BOYCE

    • MARLOW

    • MOONEY_RIVLIN

    • NEO_HOOKE

    • OGDEN

    • POLYNOMIAL

    • REDUCED_POLYNOMIAL

    • USER

    • VAN_DER_WAALS

    • YEOH

    • UNKNOWN

    • VALANIS_LANDEL

    The default value is UNKNOWN.

    Changed in version 2022: Add available value: VALANIS_LANDEL.

  • moduliTimeScale (Literal[INSTANTANEOUS, LONG_TERM], default: 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 (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • n (int, default: 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 (Union[Literal[FITTED_VALUE, VAN_DER_WAALS], float], default: 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 (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether test data are supplied. The default value is ON.

  • compressible (Union[AbaqusBoolean, bool], default: 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 (int, default: 0) – An Int specifying the number of property values needed as data for the user-defined hyperelastic material. The default value is 0.

  • deviatoricResponse (Literal[PLANAR, UNIAXIAL, BIAXIAL], default: UNIAXIAL) – A SymbolicConstant specifying which test data to use. Possible values are UNIAXIAL, BIAXIAL, and PLANAR. The default value is UNIAXIAL.

  • volumetricResponse (Literal[LATERAL_NOMINAL_STRAIN, VOLUMETRIC_DATA, DEFAULT, POISSON_RATIO], default: 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 (float, default: 0) – A Float specifying the poisson ratio. This argument is valid only if volumetricResponse = POISSON_RATIO. The default value is 0.0.

  • materialType (Literal[ANISOTROPIC, ISOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the type of material. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.

  • anisotropicType (Literal[USER_DEFINED, FUNG_ANISOTROPIC, HOLZAPFEL, FUNG_ORTHOTROPIC], default: 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 (Literal[STRAIN, INVARIANT], default: STRAIN) – A SymbolicConstant specifying the type of formulation. Possible values are STRAIN and INVARIANT. The default value is STRAIN.

  • behaviorType (Literal[COMPRESSIBLE, INCOMPRESSIBLE], default: INCOMPRESSIBLE) – A SymbolicConstant specifying the type of anisotropic hyperelastic material behavior. Possible values are INCOMPRESSIBLE and COMPRESSIBLE. The default value is INCOMPRESSIBLE.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the data in*volumetricTable* . The default value is 0.

  • localDirections (int, default: 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

Member Details:

biaxialTestData: BiaxialTestData = <abaqus.Material.TestData.BiaxialTestData.BiaxialTestData object>[source]

A BiaxialTestData object.

hysteresis: Hysteresis = <abaqus.Material.Elastic.HyperElastic.ViscoElastic.Hysteresis.Hysteresis object>[source]

A Hysteresis object.

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: UniaxialTestData = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

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

This method creates a Hysteresis object.

Note

This function can be accessed by:

mdb.models[name].materials[name].hyperelastic.Hysteresis
session.odbs[name].materials[name].hyperelastic.Hysteresis
Parameters:

table (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

A Hysteresis object.

Return type:

Hysteresis

Raises:

RangeError

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

This method creates a CombinedTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].viscoelastic.CombinedTestData
session.odbs[name].materials[name].viscoelastic.CombinedTestData
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below. The values of the table data depend on the value of the time member of the Viscoelastic object.

  • volinf (Optional[float], default: None) – None or a Float specifying a normalized volume. The value of volinf depends on the value of the time member of the Viscoelastic object. The default value is None. If time = RELAXATION_TEST_DATA, volinf specifies the value of the long-term normalized volumetric modulus, \(k_R(\infty)\). If time = CREEP_TEST_DATA, volinf specifies the value of the long-term normalized volumetric compliance, \(j_K(\infty)\).

  • shrinf (Optional[float], default: None) – None or a Float specifying a normalized shear. The value of shrinf depends on the value of the time member of the Viscoelastic object. The default value is None. If time = RELAXATION_TEST_DATA, shrinf specifies the value of the long-term normalized shear modulus, \(g_R(\infty)\) If time = CREEP_TEST_DATA, shrinf specifies the value of the long-term normalized shear compliance, \(j_S(\infty)\).

Returns:

A CombinedTestData object.

Return type:

CombinedTestData

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

This method creates a ShearTestData object.

Note

This function can be accessed by:

mdb.models[name].materials[name].viscoelastic.ShearTestData
session.odbs[name].materials[name].viscoelastic.ShearTestData
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying values that depend on the time member of the Viscoelastic object.

  • shrinf (Optional[float], default: None) – None or a Float specifying a normalized shear. The value of shrinf depends on the value of the time member of the Viscoelastic object. The default value is None.If time = RELAXATION_TEST_DATA, shrinf specifies the value of the long-term, normalized shear modulus \(g_R(\infty)\).If time = CREEP_TEST_DATA, shrinf specifies the value of the long-term, normalized shear compliance \(j_S(\infty)\).

Returns:

A ShearTestData object.

Return type:

ShearTestData

Member Details:

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

This method modifies the ShearTestData object.

class Trs(definition=abaqusConstants.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

This method creates a Trs object.

Note

This function can be accessed by:

mdb.models[name].materials[name].viscoelastic.Trs
mdb.models[name].materials[name].viscosity.Trs
session.odbs[name].materials[name].viscoelastic.Trs
session.odbs[name].materials[name].viscosity.Trs
Parameters:
  • definition (Literal[USER, WLF, ARRHENIUS], default: WLF) – A SymbolicConstant specifying the definition of the shift function. Possible values are WLF, ARRHENIUS, and USER. The default value is WLF.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.This argument is valid only when definition = WLF.

Returns:

A Trs object.

Return type:

Trs

Member Details:

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

This method modifies the Trs object.

class Viscoelastic(domain, table, frequency=abaqusConstants.FORMULA, type=abaqusConstants.ISOTROPIC, preload=abaqusConstants.NONE, time=abaqusConstants.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

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 (Literal[FREQUENCY, TIME]) – 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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • frequency (Literal[PRONY, CREEP_TEST_DATA, TABULAR, FREQUENCY, RELAXATION_TEST_DATA, FORMULA], default: 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 (Literal[FREQUENCY, TRACTION, ISOTROPIC, TABULAR], default: 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 (Literal[VOLUMETRIC, UNIAXIAL, TABULAR, FREQUENCY, UNIAXIAL_VOLUMETRIC, NONE], default: 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 (Literal[PRONY, CREEP_TEST_DATA, FREQUENCY_DATA, TIME, RELAXATION_TEST_DATA], default: 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 (float, default: 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 (int, default: 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 (tuple, default: ()) – 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

Member Details:

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: ShearTestData = <abaqus.Material.TestData.ShearTestData.ShearTestData object>[source]

A ShearTestData object.

trs: Trs = <abaqus.Material.Mechanical.Viscosity.Trs.Trs object>[source]

A Trs object.

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

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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • user (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying that hypoelasticity is defined by user subroutine UHYPEL. The default value is OFF.

Returns:

A Hypoelastic object.

Return type:

Hypoelastic

Member Details:

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

This method modifies the Hypoelastic object.

class Elastic(table, type=abaqusConstants.ISOTROPIC, noCompression=0, noTension=0, temperatureDependency=0, dependencies=0, moduli=abaqusConstants.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

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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ENGINEERING_CONSTANTS, TRACTION, LAMINA, SHEAR, ANISOTROPIC, ORTHOTROPIC, SHORT_FIBER, BILAMINA, ISOTROPIC, COUPLED_TRACTION], default: 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.

    Changed in version 2022: Add available value: BILAMINA.

  • noCompression (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether compressive stress is allowed. The default value is OFF.

  • noTension (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether tensile stress is allowed. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • moduli (Literal[INSTANTANEOUS, LONG_TERM], default: 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

Member Details:

failStrain: FailStrain = <abaqus.Material.Elastic.Linear.FailStrain.FailStrain object>[source]

A FailStrain object.

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

This method creates a FailStrain object.

Note

This function can be accessed by:

mdb.models[name].materials[name].elastic.FailStrain
session.odbs[name].materials[name].elastic.FailStrain
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A FailStrain object.

Return type:

FailStrain

Raises:

RangeError

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

This method creates a FailStress object.

Note

This function can be accessed by:

mdb.models[name].materials[name].elastic.FailStress
session.odbs[name].materials[name].elastic.FailStress
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A FailStress object.

Return type:

FailStress

Raises:

RangeError

Member Details:

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

This method modifies the FailStress object.

Raises:

RangeError

class LowDensityFoam(elementRemoval=0, maxAllowablePrincipalStress=None, extrapolateStressStrainCurve=0, strainRateType=abaqusConstants.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

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 (Union[AbaqusBoolean, bool], default: 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 (Optional[float], default: None) – None or a Float specifying the maximum allowable principal tensile stress. The default value is None.

  • extrapolateStressStrainCurve (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the stress-strain curve is extrapolated if exceeding maximum strain rate. The default value is OFF.

  • strainRateType (Literal[PRINCIPAL, VOLUMETRIC], default: VOLUMETRIC) – A SymbolicConstant specifying strain rate measure used for constitutive calculations. Possible values are PRINCIPAL and VOLUMETRIC. The default value is VOLUMETRIC.

  • mu0 (Optional[float], default: None) – A Float specifying the relaxation coefficient μ0. The default value is 10⁻⁴.

  • mu1 (float, default: 0) – A Float specifying the relaxation coefficient μ1. The default value is 0.5x10⁻².

  • alpha (float, default: 2) – A Float specifying the relaxation coefficient α. The default value is 2.0.

Returns:

A LowDensityFoam object.

Return type:

LowDensityFoam

Raises:

RangeError

Member Details:

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

This method modifies the LowDensityFoam object.

Raises:

RangeError

uniaxialCompressionTestData: UniaxialTestData = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

uniaxialTensionTestData: UniaxialTestData = <abaqus.Material.TestData.UniaxialTestData.UniaxialTestData object>[source]

A UniaxialTestData object.

class PorousElastic(table, shear=abaqusConstants.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

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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • shear (Literal[POISSON], default: POISSON) – A SymbolicConstant specifying the shear definition form. Possible values are G and POISSON. The default value is POISSON.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A PorousElastic object.

Return type:

PorousElastic

Raises:

RangeError

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

This method creates a SuperElasticHardening object.

Note

This function can be accessed by:

mdb.models[name].materials[name].superElasticity.SuperElasticHardening
session.odbs[name].materials[name].superElasticity.SuperElasticHardening
Parameters:

table (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

A SuperElasticHardening object.

Return type:

SuperElasticHardening

Raises:

RangeError

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

This method creates a SuperElasticHardeningModifications object.

Note

This function can be accessed by:

mdb.models[name].materials[name].superElasticity.SuperElasticHardeningModifications
session.odbs[name].materials[name].superElasticity.SuperElasticHardeningModifications
Parameters:

table (tuple) – A sequence of sequences of Floats specifying the items described below or user-defined data if the dependence of the transformation stress levels on Plastic strain is specified in a user subroutine.

Returns:

A SuperElasticHardeningModifications object.

Return type:

SuperElasticHardeningModifications

Raises:

RangeError

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

This method creates a SuperElasticity object.

Note

This function can be accessed by:

mdb.models[name].materials[name].SuperElasticity
session.odbs[name].materials[name].SuperElasticity
Parameters:
  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

  • nonassociated (Optional[float], default: None) – None or a Float specifying the volumetric transformation strain. If nonassociated = None, the value of the volumetric transformation strain is equal to the uniaxial transformation strain. The default value is None.

Returns:

A SuperElasticity object.

Return type:

SuperElasticity

Raises:

RangeError

Member Details:

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

This method modifies the SuperElasticity object.

Raises:

RangeError

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: 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=abaqusConstants.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

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 (tuple) – A sequence of sequences of Floats specifying the items described below.

  • type (Literal[ANISOTROPIC, ISOTROPIC, ORTHOTROPIC], default: ISOTROPIC) – A SymbolicConstant specifying the dielectric behavior. Possible values are ISOTROPIC, ORTHOTROPIC, and ANISOTROPIC. The default value is ISOTROPIC.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on frequency. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A Dielectric object.

Return type:

Dielectric

Member Details:

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

This method modifies the Dielectric object.

class ElectricalConductivity(table, type=abaqusConstants.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.

    • <