Material¶

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

Create materials¶

In Mdb¶

class MaterialModel(

name,

description='',

stefanBoltzmann=None,

absoluteZero=None,

waveFormulation=NOT_SET,

modelType=STANDARD_EXPLICIT,

universalGas=None,

copyConstraints=1,

copyConnectors=1,

copyInteractions=1,

)[source]¶

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Note

Check MaterialModel on help.3ds.com/2023.

Public Data Attributes:

Inherited from ModelBase

name	A String specifying the repository key.
stefanBoltzmann	None or a Float specifying the Stefan-Boltzmann constant.
absoluteZero	None or a Float specifying the absolute zero constant.
waveFormulation	A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
universalGas	None or a Float specifying the universal gas constant.
noPartsInputFile	A Boolean specifying whether an input file should be written without parts and assemblies.
endRestartStep	A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
shellToSolid	A Boolean specifying that a shell global model drives a solid submodel.
lastChangedCount	A Float specifying the time stamp that indicates when the model was last changed.
description	A String specifying the purpose and contents of the Model object.
restartJob	A String specifying the name of the job that generated the restart data.
restartStep	A String specifying the name of the step where the restart analysis will start.
globalJob	A String specifying the name of the job that generated the results for the global model.
copyConstraints	A boolean specifying the status of constraints created in a model, in the model which instances this model.
copyConnectors	A boolean specifying the status of connectors created in a model, in the model which instances this model.
copyInteractions	A boolean specifying the status of interactions created in a model, in the model which instances this model.
keywordBlock	A KeywordBlock object.
amplitudes	A repository of Amplitude objects.
profiles	A repository of Profile objects.
boundaryConditions	A repository of BoundaryCondition objects.
constraints	A repository of ConstrainedSketchConstraint objects.
analyticalFields	A repository of AnalyticalField objects.
discreteFields	A repository of DiscreteField objects.
predefinedFields	A repository of PredefinedField objects.
interactions	A repository of Interaction objects.
interactionProperties	A repository of InteractionProperty objects.
contactControls	A repository of ContactControl objects.
contactInitializations	A repository of ContactInitialization objects.
contactStabilizations	A repository of ContactStabilization objects.
linkedInstances	A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
linkedParts	A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
loads	A repository of Load objects.
materials	A repository of Material objects.
calibrations	A repository of Calibration objects.
sections	A repository of Section objects.
remeshingRules	A repository of RemeshingRule objects.
sketches	A repository of ConstrainedSketch objects.
parts	A repository of Part objects.
steps	A repository of Step objects.
featureOptions	A FeatureOptions object.
adaptiveMeshConstraints	A repository of AdaptiveMeshConstraint objects.
adaptiveMeshControls	A repository of AdaptiveMeshControl objects.
timePoints	A repository of TimePoint objects.
filters	A repository of Filter objects.
integratedOutputSections	A repository of IntegratedOutputSection objects.
fieldOutputRequests	A repository of FieldOutputRequest objects.
historyOutputRequests	A repository of HistoryOutputRequest objects.
optimizationTasks	A repository of OptimizationTask objects.
tableCollections	A repository of TableCollection objects.
eventSeriesTypes	A repository of EventSeriesType objects.
eventSeriesDatas	A repository of EventSeriesData objects.
restartIncrement	An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
rootAssembly	An Assembly object.

Public Methods:

Material(name[, description, materialIdentifier])

This method creates a Material object.

Inherited from ModelBase

__init__(name[, description, ...])	This method creates a Model object.
ModelFromInputFile(name, inputFileName)	This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile(name, odbFileName)	This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile(modelName, inputFileName)	This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues([description, noPartsInputFile, ...])	This method modifies the Model object.

---

Member Details:

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

This method creates a Material object.

Note

This function can be accessed by:

mdb.models[name].Material

Note

Check Material on help.3ds.com/2023.

Parameters:¶

name¶

A String specifying the name of the new material.

description=''¶

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

materialIdentifier=''¶

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

Returns:¶

A Material object.

Return type:¶

Material

In Odb¶

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

Bases: OdbBase

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

Note

This object can be accessed by:

import odbAccess
session.odbs[name]

Note

Check MaterialOdb on help.3ds.com/2023.

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

Note

Check Material on help.3ds.com/2023.

Parameters:¶

name¶

A String specifying the name of the new material.

description=''¶

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

materialIdentifier=''¶

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

Returns:¶

A Material object.

Return type:¶

Material

Assign properties to the material¶

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

Bases: MaterialBase

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

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

• MATERIAL

Note

Check Material on help.3ds.com/2023.

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

Note

Check AcousticMedium on help.3ds.com/2023.

Parameters:¶

acousticVolumetricDrag=0¶

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

temperatureDependencyB=0¶

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

temperatureDependencyV=0¶

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

dependenciesB=0¶

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

dependenciesV=0¶

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

bulkTable=()¶

A sequence of sequences of Floats specifying the following:

• Bulk modulus.

• Temperature, if the data depend on temperature.

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

• Value of the second field variable.

• Etc.

volumetricTable=()¶

A sequence of sequences of Floats specifying the following:

• Volumetric drag.

• Frequency.

• Temperature, if the data depend on temperature.

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

• Value of the second field variable.

• Etc.

The default value is an empty sequence.

Returns:¶

An AcousticMedium object.

Return type:¶

AcousticMedium

Raises:¶

RangeError –

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

This method creates a BrittleCracking object.

Note

This function can be accessed by:

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

Note

Check BrittleCracking on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

type=STRAIN¶

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

Returns:¶

A BrittleCracking object.

Return type:¶

BrittleCracking

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

This method creates a CapPlasticity object.

Note

This function can be accessed by:

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

Note

Check CapPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A CapPlasticity object.

Return type:¶

CapPlasticity

Raises:¶

RangeError –

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

This method creates a CastIronPlasticity object.

Note

This function can be accessed by:

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

Note

Check CastIronPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A CastIronPlasticity object.

Return type:¶

CastIronPlasticity

Raises:¶

RangeError –

ClayPlasticity(

table,

intercept=None,

hardening=EXPONENTIAL,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a ClayPlasticity object.

Note

This function can be accessed by:

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

Note

Check ClayPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

intercept=None¶

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

hardening=EXPONENTIAL¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A ClayPlasticity object.

Return type:¶

ClayPlasticity

Raises:¶

RangeError –

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

This method creates a Concrete object.

Note

This function can be accessed by:

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

Note

Check Concrete on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Concrete object.

Return type:¶

Concrete

Raises:¶

RangeError –

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

This method creates a ConcreteDamagedPlasticity object.

Note

This function can be accessed by:

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

Note

Check ConcreteDamagedPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A ConcreteDamagedPlasticity object.

Return type:¶

ConcreteDamagedPlasticity

Raises:¶

RangeError –

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

This method creates a Conductivity object.

Note

This function can be accessed by:

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

Note

Check Conductivity on help.3ds.com/2023.

Parameters:¶

table¶

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

type=ISOTROPIC¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Conductivity object.

Return type:¶

Conductivity

Raises:¶

RangeError –

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

This method creates a Creep object.

Note

This function can be accessed by:

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

Note

Check Creep on help.3ds.com/2023.

Parameters:¶

table¶

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

law=STRAIN¶

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

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

temperatureDependency=0¶

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

dependencies=0¶

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

time=TOTAL¶

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

Returns:¶

A Creep object.

Return type:¶

Creep

Raises:¶

RangeError –

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

This method creates a CrushStress object.

Note

This function can be accessed by:

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

Added in version 2022: The CrushStress method was added.

Note

Check CrushStress on help.3ds.com/2023.

Parameters:¶

crushStressTable¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A CrushStress object.

CrushableFoam(

table,

hardening=VOLUMETRIC,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a CrushableFoam object.

Note

This function can be accessed by:

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

Note

Check CrushableFoam on help.3ds.com/2023.

Parameters:¶

table¶

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

hardening=VOLUMETRIC¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A CrushableFoam object.

Return type:¶

CrushableFoam

Raises:¶

RangeError –

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

This method creates a Damping object.

Note

This function can be accessed by:

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

Note

Check Damping on help.3ds.com/2023.

Parameters:¶

alpha=0¶

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

beta=0¶

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

composite=0¶

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

structural=0¶

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

Returns:¶

A Damping object.

Return type:¶

Damping

Raises:¶

RangeError –

DeformationPlasticity(table, temperatureDependency=0)[source]¶

This method creates a DeformationPlasticity object.

Note

This function can be accessed by:

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

Note

Check DeformationPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

Returns:¶

A DeformationPlasticity object.

Return type:¶

DeformationPlasticity

Raises:¶

RangeError –

Density(

table,

temperatureDependency=0,

dependencies=0,

distributionType=UNIFORM,

fieldName='',

)[source]¶

This method creates a Density object.

Note

This function can be accessed by:

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

Note

Check Density on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

distributionType=UNIFORM¶

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

fieldName=''¶

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

Returns:¶

A Density object.

Return type:¶

Density

Raises:¶

RangeError –

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

This method creates a Depvar object.

Note

This function can be accessed by:

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

Note

Check Depvar on help.3ds.com/2023.

Parameters:¶

deleteVar=0¶

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

n=0¶

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

Returns:¶

A Depvar object.

Return type:¶

Depvar

Raises:¶

RangeError –

Dielectric(

table,

type=ISOTROPIC,

frequencyDependency=0,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a Dielectric object.

Note

This function can be accessed by:

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

Note

Check Dielectric on help.3ds.com/2023.

Parameters:¶

table¶

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

type=ISOTROPIC¶

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

frequencyDependency=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Dielectric object.

Return type:¶

Dielectric

Diffusivity(

table,

type=ISOTROPIC,

law=GENERAL,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a Diffusivity object.

Note

This function can be accessed by:

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

Note

Check Diffusivity on help.3ds.com/2023.

Parameters:¶

table¶

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

type=ISOTROPIC¶

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

law=GENERAL¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Diffusivity object.

Return type:¶

Diffusivity

Raises:¶

RangeError –

DruckerPrager(

table,

shearCriterion=LINEAR,

eccentricity=0,

testData=0,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a DruckerPrager object.

Note

This function can be accessed by:

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

Note

Check DruckerPrager on help.3ds.com/2023.

Parameters:¶

table¶

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

shearCriterion=LINEAR¶

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

eccentricity=0¶

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

testData=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A DruckerPrager object.

Return type:¶

DruckerPrager

Raises:¶

RangeError –

DuctileDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check DuctileDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

Elastic(

table,

type=ISOTROPIC,

noCompression=0,

noTension=0,

temperatureDependency=0,

dependencies=0,

moduli=LONG_TERM,

)[source]¶

This method creates an Elastic object.

Note

This function can be accessed by:

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

Note

Check Elastic on help.3ds.com/2023.

Parameters:¶

table¶

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

type=ISOTROPIC¶

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

• ISOTROPIC

• ORTHOTROPIC

• ANISOTROPIC

• ENGINEERING_CONSTANTS

• LAMINA

• TRACTION

• COUPLED_TRACTION

• SHORT_FIBER

• SHEAR

• BILAMINA

The default value is ISOTROPIC.

Added in version 2022: The option BILAMINA was added.

noCompression=0¶

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

noTension=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

moduli=LONG_TERM¶

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

Returns:¶

An Elastic object.

Return type:¶

Elastic

Raises:¶

RangeError –

ElectricalConductivity(

table,

type=ISOTROPIC,

frequencyDependency=0,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates an ElectricalConductivity object.

Note

This function can be accessed by:

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

Note

Check ElectricalConductivity on help.3ds.com/2023.

Parameters:¶

table¶

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

type=ISOTROPIC¶

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

frequencyDependency=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

An ElectricalConductivity object.

Return type:¶

ElectricalConductivity

Raises:¶

RangeError –

Eos(

type=IDEALGAS,

temperatureDependency=0,

dependencies=0,

detonationEnergy=0,

solidTable=(),

gasTable=(),

reactionTable=(),

gasSpecificTable=(),

table=(),

)[source]¶

This method creates an Eos object.

Note

This function can be accessed by:

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

Note

Check Eos on help.3ds.com/2023.

Parameters:¶

type=IDEALGAS¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

detonationEnergy=0¶

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

solidTable=()¶

A sequence of sequences of Floats specifying the following:

• \(A_{s}\).

• \(B_{s}\).

• \({\omega}_{s}\).

• \(R_{1s}\).

• \(R_{2s}\).

The default value is an empty sequence.

gasTable=()¶

A sequence of sequences of Floats specifying the following:

• \(A_{g}\).

• \(B_{g}\).

• \({\omega}_{g}\).

• \(R_{1g}\).

• \(R_{2g}\).

The default value is an empty sequence.

reactionTable=()¶

A sequence of sequences of Floats specifying the following:

• Initial Pressure, \(I\).

• Product co-volume, \(a\).

• Exponent on the unreacted fraction (ignition term), \(x\).

• First burn rate coefficient, \(G_{1}\)

• Exponent on the unreacted fraction (growth term), \(c\).

• Exponent on the reacted fraction (growth term), \(d\).

• Pressure exponent (growth term), \(y\).

• Second burn rate coefficient, \(G_{2}\).

• Exponent on the unreacted fraction (completion term), \(e\).

• Exponent on the reacted fraction (completion term), \(g\).

• Pressure exponent (completion term), \(z\).

• Initial reacted fraction, \({F^{max}}_{ig}\).

• Maximum reacted fraction for the growth term, \({F^{max}}_{G1}\).

• Minimum reacted fraction, \({F^{min}}_{G2}\).

The default value is an empty sequence.

gasSpecificTable=()¶

A sequence of sequences of Floats specifying the following:

• Specific Heat per unit mass.

• Temperature dependent data.

• Value of first field variable.

• Value of second field variable.

• Etc.

The default value is an empty sequence.

table=()¶

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

Expansion(

type=ISOTROPIC,

userSubroutine=0,

zero=0,

temperatureDependency=0,

dependencies=0,

table=(),

)[source]¶

This method creates an Expansion object.

Note

This function can be accessed by:

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

Note

Check Expansion on help.3ds.com/2023.

Parameters:¶

type=ISOTROPIC¶

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

userSubroutine=0¶

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

zero=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

table=()¶

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

Returns:¶

An Expansion object.

Return type:¶

Expansion

Raises:¶

RangeError –

FldDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check FldDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

FlsdDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check FlsdDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

FluidLeakoff(

temperatureDependency=0,

dependencies=0,

type=COEFFICIENTS,

table=(),

)[source]¶

This method creates a FluidLeakoff object.

Note

This function can be accessed by:

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

Note

Check FluidLeakoff on help.3ds.com/2023.

Parameters:¶

temperatureDependency=0¶

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

dependencies=0¶

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

type=COEFFICIENTS¶

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

table=()¶

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

Returns:¶

A FluidLeakoff object.

Return type:¶

FluidLeakoff

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

This method creates a GapConductance object.

Note

This function can be accessed by:

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

Added in version 2021: The GapConductance method was added.

Note

Check GapConductance on help.3ds.com/2023.

Parameters:¶

pressureDependency=0¶

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

dependencies=0¶

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

table=()¶

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

Returns:¶

A GapConductance object.

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

This method creates a GapConvection object.

Note

This function can be accessed by:

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

Added in version 2021: The GapConvection method was added.

Note

Check GapConvection on help.3ds.com/2023.

Parameters:¶

type¶

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

table=()¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A GapConvection object.

GapFlow(

table,

kmax=None,

temperatureDependency=0,

dependencies=0,

type=NEWTONIAN,

)[source]¶

This method creates a GapFlow object.

Note

This function can be accessed by:

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

Note

Check GapFlow on help.3ds.com/2023.

Parameters:¶

table¶

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

kmax=None¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

type=NEWTONIAN¶

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

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

Returns:¶

A GapFlow object.

Return type:¶

GapFlow

GapRadiation(mainSurfaceEmissivity, secondarySurfaceEmissivity, table)[source]¶

This method creates a GapRadiation object.

Note

This function can be accessed by:

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

Added in version 2021: The GapRadiation method was added.

Note

Check GapRadiation on help.3ds.com/2023.

Parameters:¶

mainSurfaceEmissivity¶

A Float specifying the Emissivity of master surface \(\varepsilon_A\).

Changed in version 2022: The masterSurfaceEmissivity argument was renamed to mainSurfaceEmissivity.

secondarySurfaceEmissivity¶

A Float specifying the Emissivity of the slave surface \(\varepsilon_B\).

Changed in version 2022: The slaveSurfaceEmissivity argument was renamed to secondarySurfaceEmissivity.

table¶

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

Returns:¶

A Gapradiation object.

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

This method creates a GasketMembraneElastic object.

Note

This function can be accessed by:

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

Note

Check GasketMembraneElastic on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A GasketMembraneElastic object.

Return type:¶

GasketMembraneElastic

Raises:¶

RangeError –

GasketThicknessBehavior(

table,

temperatureDependency=0,

dependencies=0,

tensileStiffnessFactor=None,

type=ELASTIC_PLASTIC,

unloadingDependencies=0,

unloadingTemperatureDependency=0,

variableUnits=STRESS,

yieldOnset=0,

yieldOnsetMethod=RELATIVE_SLOPE_DROP,

unloadingTable=(),

)[source]¶

This method creates a GasketThicknessBehavior object.

Note

This function can be accessed by:

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

Note

Check GasketThicknessBehavior on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

tensileStiffnessFactor=None¶

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

type=ELASTIC_PLASTIC¶

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

unloadingDependencies=0¶

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

unloadingTemperatureDependency=0¶

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

variableUnits=STRESS¶

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

yieldOnset=0¶

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

yieldOnsetMethod=RELATIVE_SLOPE_DROP¶

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

unloadingTable=()¶

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

Returns:¶

A GasketThicknessBehavior object.

Return type:¶

GasketThicknessBehavior

Raises:¶

RangeError –

GasketTransverseShearElastic(

table,

variableUnits=STRESS,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a GasketTransverseShearElastic object.

Note

This function can be accessed by:

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

Note

Check GasketTransverseShearElastic on help.3ds.com/2023.

Parameters:¶

table¶

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

variableUnits=STRESS¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A GasketTransverseShearElastic object.

Return type:¶

GasketTransverseShearElastic

Raises:¶

RangeError –

Gel(table)[source]¶

This method creates a Gel object.

Note

This function can be accessed by:

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

Note

Check Gel on help.3ds.com/2023.

Parameters:¶

table¶

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

Returns:¶

A Gel object.

Return type:¶

Gel

HashinDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check HashinDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

Hyperelastic(

table,

type=UNKNOWN,

moduliTimeScale=LONG_TERM,

temperatureDependency=0,

n=1,

beta=FITTED_VALUE,

testData=1,

compressible=0,

properties=0,

deviatoricResponse=UNIAXIAL,

volumetricResponse=DEFAULT,

poissonRatio=0,

materialType=ISOTROPIC,

anisotropicType=FUNG_ANISOTROPIC,

formulation=STRAIN,

behaviorType=INCOMPRESSIBLE,

dependencies=0,

localDirections=0,

)[source]¶

This method creates a Hyperelastic object.

Note

This function can be accessed by:

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

Note

Check Hyperelastic on help.3ds.com/2023.

Parameters:¶

table¶

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

type=UNKNOWN¶

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

moduliTimeScale=LONG_TERM¶

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

temperatureDependency=0¶

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

n=1¶

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

beta=FITTED_VALUE¶

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

testData=1¶

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

compressible=0¶

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

properties=0¶

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

deviatoricResponse=UNIAXIAL¶

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

volumetricResponse=DEFAULT¶

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

poissonRatio=0¶

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

materialType=ISOTROPIC¶

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

anisotropicType=FUNG_ANISOTROPIC¶

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

formulation=STRAIN¶

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

behaviorType=INCOMPRESSIBLE¶

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

dependencies=0¶

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

localDirections=0¶

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

Returns:¶

A Hyperelastic object.

Return type:¶

Hyperelastic

Raises:¶

• InvalidNameError –

• RangeError –

Hyperfoam(

testData=0,

poisson=None,

n=1,

temperatureDependency=0,

moduli=LONG_TERM,

table=(),

)[source]¶

This method creates a Hyperfoam object.

Note

This function can be accessed by:

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

Note

Check Hyperfoam on help.3ds.com/2023.

Parameters:¶

testData=0¶

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

poisson=None¶

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

n=1¶

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

temperatureDependency=0¶

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

moduli=LONG_TERM¶

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

table=()¶

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

Returns:¶

A Hyperfoam object.

Return type:¶

Hyperfoam

Raises:¶

RangeError –

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

This method creates a Hypoelastic object.

Note

This function can be accessed by:

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

Note

Check Hypoelastic on help.3ds.com/2023.

Parameters:¶

table¶

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

user=0¶

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

Returns:¶

A Hypoelastic object.

Return type:¶

Hypoelastic

InelasticHeatFraction(fraction=0)[source]¶

This method creates an InelasticHeatFraction object.

Note

This function can be accessed by:

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

Note

Check InelasticHeatFraction on help.3ds.com/2023.

Parameters:¶

fraction=0¶

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

Returns:¶

An InelasticHeatFraction object.

Return type:¶

InelasticHeatFraction

Raises:¶

RangeError –

JohnsonCookDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check JohnsonCookDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

JouleHeatFraction(fraction=1)[source]¶

This method creates a JouleHeatFraction object.

Note

This function can be accessed by:

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

Note

Check JouleHeatFraction on help.3ds.com/2023.

Parameters:¶

fraction=1¶

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

Returns:¶

A JouleHeatFraction object.

Return type:¶

JouleHeatFraction

Raises:¶

RangeError –

LatentHeat(table)[source]¶

This method creates a LatentHeat object.

Note

This function can be accessed by:

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

Note

Check LatentHeat on help.3ds.com/2023.

Parameters:¶

table¶

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

Returns:¶

A LatentHeat object.

Return type:¶

LatentHeat

Raises:¶

RangeError –

LowDensityFoam(

elementRemoval=0,

maxAllowablePrincipalStress=None,

extrapolateStressStrainCurve=0,

strainRateType=VOLUMETRIC,

mu0=None,

mu1=0,

alpha=2,

)[source]¶

This method creates a LowDensityFoam object.

Note

This function can be accessed by:

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

Note

Check LowDensityFoam on help.3ds.com/2023.

Parameters:¶

elementRemoval=0¶

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

maxAllowablePrincipalStress=None¶

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

extrapolateStressStrainCurve=0¶

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

strainRateType=VOLUMETRIC¶

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

mu0=None¶

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

mu1=0¶

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

alpha=2¶

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

Returns:¶

A LowDensityFoam object.

Return type:¶

LowDensityFoam

Raises:¶

RangeError –

MagneticPermeability(

table,

table2,

table3,

type=ISOTROPIC,

frequencyDependency=0,

temperatureDependency=0,

dependencies=0,

nonlinearBH=0,

)[source]¶

This method creates a MagneticPermeability object.

Note

This function can be accessed by:

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

Note

Check MagneticPermeability on help.3ds.com/2023.

Parameters:¶

table¶

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

table2¶

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

table3¶

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

type=ISOTROPIC¶

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

frequencyDependency=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

nonlinearBH=0¶

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

Returns:¶

A MagneticPermeability object.

Return type:¶

MagneticPermeability

Raises:¶

RangeError –

MaxeDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

position=CENTROID,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check MaxeDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

position=CENTROID¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

MaxpeDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

position=CENTROID,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check MaxpeDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

position=CENTROID¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

MaxpsDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

position=CENTROID,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check MaxpsDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

position=CENTROID¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

MaxsDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

position=CENTROID,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check MaxsDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

position=CENTROID¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

MeanFieldHomogenization(

angleSubdivision=None,

formulation=MT,

isotropization=ALLISO,

uniformMatrixStrain=NO,

)[source]¶

This method creates a MeanFieldHomogenization object.

Note

This function can be accessed by:

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

Added in version 2018: The MeanFieldHomogenization method was added.

Note

Check MeanFieldHomogenization on help.3ds.com/2023.

Parameters:¶

angleSubdivision=None¶

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

formulation=MT¶

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

isotropization=ALLISO¶

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

uniformMatrixStrain=NO¶

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

Returns:¶

A MeanFieldHomogenization object.

Raises:¶

RangeError –

MkDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check MkDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

MohrCoulombPlasticity(

table,

deviatoricEccentricity=None,

meridionalEccentricity=0,

temperatureDependency=0,

dependencies=0,

useTensionCutoff=0,

)[source]¶

This method creates a MohrCoulombPlasticity object.

Note

This function can be accessed by:

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

Note

Check MohrCoulombPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

deviatoricEccentricity=None¶

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

meridionalEccentricity=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

useTensionCutoff=0¶

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

Returns:¶

A MohrCoulombPlasticity object.

Return type:¶

MohrCoulombPlasticity

Raises:¶

RangeError –

MoistureSwelling(table)[source]¶

This method creates a MoistureSwelling object.

Note

This function can be accessed by:

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

Note

Check MoistureSwelling on help.3ds.com/2023.

Parameters:¶

table¶

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

Returns:¶

A MoistureSwelling object.

Return type:¶

MoistureSwelling

MsfldDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check MsfldDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

Permeability(

specificWeight,

inertialDragCoefficient,

table,

type=ISOTROPIC,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a Permeability object.

Note

This function can be accessed by:

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

Note

Check Permeability on help.3ds.com/2023.

Parameters:¶

specificWeight¶

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

inertialDragCoefficient¶

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

table¶

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

type=ISOTROPIC¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Permeability object.

Return type:¶

Permeability

Raises:¶

RangeError –

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

This method creates a Piezoelectric object.

Note

This function can be accessed by:

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

Note

Check Piezoelectric on help.3ds.com/2023.

Parameters:¶

table¶

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

type=STRESS¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Piezoelectric object.

Return type:¶

Piezoelectric

Plastic(

table,

hardening=ISOTROPIC,

rate=0,

dataType=HALF_CYCLE,

strainRangeDependency=0,

numBackstresses=1,

temperatureDependency=0,

dependencies=0,

extrapolation=CONSTANT,

)[source]¶

This method creates a Plastic object.

Note

This function can be accessed by:

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

Note

Check Plastic on help.3ds.com/2023.

Parameters:¶

table¶

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

hardening=ISOTROPIC¶

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

rate=0¶

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

dataType=HALF_CYCLE¶

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

strainRangeDependency=0¶

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

numBackstresses=1¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

extrapolation=CONSTANT¶

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

Added in version 2022: The extrapolation argument was added.

Returns:¶

A Plastic object.

Return type:¶

Plastic

Raises:¶

RangeError –

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

This method creates a PlasticityCorrection object.

Note

This function can be accessed by:

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

Added in version 2023: The PlasticityCorrection method was added.

Note

Check PlasticityCorrection on help.3ds.com/2023.

Parameters:¶

type¶

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

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A PlasticCorrection object.

Return type:¶

PlasticityCorrection

Raises:¶

RangeError –

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

This method creates a PoreFluidExpansion object.

Note

This function can be accessed by:

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

Note

Check PoreFluidExpansion on help.3ds.com/2023.

Parameters:¶

table¶

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

zero=0¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A PoreFluidExpansion object.

Return type:¶

PoreFluidExpansion

Raises:¶

RangeError –

PorousBulkModuli(table, temperatureDependency=0)[source]¶

This method creates a PorousBulkModuli object.

Note

This function can be accessed by:

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

Note

Check PorousBulkModuli on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

Returns:¶

A PorousBulkModuli object.

Return type:¶

PorousBulkModuli

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

This method creates a PorousElastic object.

Note

This function can be accessed by:

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

Note

Check PorousElastic on help.3ds.com/2023.

Parameters:¶

table¶

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

shear=POISSON¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A PorousElastic object.

Return type:¶

PorousElastic

Raises:¶

RangeError –

PorousMetalPlasticity(

table,

relativeDensity=None,

temperatureDependency=0,

dependencies=0,

)[source]¶

This method creates a PorousMetalPlasticity object.

Note

This function can be accessed by:

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

Note

Check PorousMetalPlasticity on help.3ds.com/2023.

Parameters:¶

table¶

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

relativeDensity=None¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A PorousMetalPlasticity object.

Return type:¶

PorousMetalPlasticity

Raises:¶

RangeError –

QuadeDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

position=CENTROID,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check QuadeDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

position=CENTROID¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

QuadsDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

position=CENTROID,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check QuadsDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

position=CENTROID¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

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

This method creates a Regularization object.

Note

This function can be accessed by:

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

Note

Check Regularization on help.3ds.com/2023.

Parameters:¶

rtol=0¶

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

strainRateRegularization=LOGARITHMIC¶

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

Returns:¶

A Regularization object.

Return type:¶

Regularization

Raises:¶

RangeError –

ShearDamageInitiation(

table,

definition=MSFLD,

feq=10,

fnn=10,

fnt=10,

frequency=1,

ks=0,

numberImperfections=4,

temperatureDependency=0,

dependencies=0,

alpha=0,

omega=1,

tolerance=0,

direction=NMORI,

)[source]¶

This method creates A DamageInitiation object.

Note

This function can be accessed by:

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

Note

Check ShearDamageInitiation on help.3ds.com/2023.

Parameters:¶

table¶

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

definition=MSFLD¶

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

feq=10¶

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

fnn=10¶

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

fnt=10¶

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

frequency=1¶

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

ks=0¶

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

numberImperfections=4¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

alpha=0¶

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

omega=1¶

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

tolerance=0¶

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

direction=NMORI¶

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

Returns:¶

A DamageInitiation object.

Return type:¶

DamageInitiation

Raises:¶

RangeError –

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

This method creates a Solubility object.

Note

This function can be accessed by:

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

Note

Check Solubility on help.3ds.com/2023.

Parameters:¶

table¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Solubility object.

Return type:¶

Solubility

Raises:¶

RangeError –

Sorption(

absorptionTable,

lawAbsorption=TABULAR,

exsorption=0,

lawExsorption=TABULAR,

scanning=0,

exsorptionTable=(),

)[source]¶

This method creates a Sorption object.

Note

This function can be accessed by:

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

Note

Check Sorption on help.3ds.com/2023.

Parameters:¶

absorptionTable¶

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

lawAbsorption=TABULAR¶

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

exsorption=0¶

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

lawExsorption=TABULAR¶

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

scanning=0¶

A Float specifying the slope of the scanning line, \(\left.\left(d u_{w} / d s\right)\right|_{s}\). This slope must be positive and larger than the slope of the absorption or exsorption behaviors. The default value is 0.0.

exsorptionTable=()¶

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

Returns:¶

A Sorption object.

Return type:¶

Sorption

Raises:¶

RangeError –

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

This method creates a SpecificHeat object.

Note

This function can be accessed by:

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

Note

Check SpecificHeat on help.3ds.com/2023.

Parameters:¶

table¶

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

law=CONSTANTVOLUME¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A SpecificHeat object.

Return type:¶

SpecificHeat

Raises:¶

RangeError –

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

This method creates a Swelling object.

Note

This function can be accessed by:

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

Note

Check Swelling on help.3ds.com/2023.

Parameters:¶

table¶

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

law=INPUT¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Swelling object.

Return type:¶

Swelling

Raises:¶

RangeError –

UserMaterial(

type=MECHANICAL,

unsymm=0,

mechanicalConstants=(),

thermalConstants=(),

effmod=0,

hybridFormulation=INCREMENTAL,

)[source]¶

This method creates a UserMaterial object.

Note

This function can be accessed by:

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

Note

Check UserMaterial on help.3ds.com/2023.

Parameters:¶

type=MECHANICAL¶

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

unsymm=0¶

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

mechanicalConstants=()¶

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

thermalConstants=()¶

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

effmod=0¶

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

hybridFormulation=INCREMENTAL¶

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

Returns:¶

A UserMaterial object.

Return type:¶

UserMaterial

Raises:¶

RangeError –

UserOutputVariables(n=0)[source]¶

This method creates a UserOutputVariables object.

Note

This function can be accessed by:

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

Note

Check UserOutputVariables on help.3ds.com/2023.

Parameters:¶

n=0¶

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

Returns:¶

A UserOutputVariables object.

Return type:¶

UserOutputVariables

Raises:¶

RangeError –

Viscoelastic(

domain,

table,

frequency=FORMULA,

type=ISOTROPIC,

preload=NONE,

time=PRONY,

errtol=0,

nmax=13,

volumetricTable=(),

)[source]¶

This method creates a Viscoelastic object.

Note

This function can be accessed by:

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

Note

Check Viscoelastic on help.3ds.com/2023.

Parameters:¶

domain¶

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

table¶

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

frequency=FORMULA¶

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

type=ISOTROPIC¶

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

preload=NONE¶

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

time=PRONY¶

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

errtol=0¶

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

nmax=13¶

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

volumetricTable=()¶

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

Returns:¶

A Viscoelastic object.

Return type:¶

Viscoelastic

Raises:¶

RangeError –

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

This method creates a Viscosity object.

Note

This function can be accessed by:

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

Note

Check Viscosity on help.3ds.com/2023.

Parameters:¶

table¶

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

type=NEWTONIAN¶

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

temperatureDependency=0¶

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

dependencies=0¶

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

Returns:¶

A Viscosity object.

Return type:¶

Viscosity

Raises:¶

RangeError –

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

This method creates a Viscous object.

Note

This function can be accessed by:

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

Note

Check Viscous on help.3ds.com/2023.

Parameters:¶

table¶

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

law=STRAIN¶

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

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

temperatureDependency=0¶

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

dependencies=0¶

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

time=TOTAL¶

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

Returns:¶

A Viscous object.

Return type:¶

Viscous