29.1 Material object

A Material object is the object used to specify a material. The Material object stores the various settings that determine how a material behaves.

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

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


29.1.1 Material(...)

This method creates a Material object.

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

Required argument

name

A String specifying the name of the new material.

Optional arguments

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.

Return value

A Material object.

Exceptions

InvalidNameError.


29.1.2 materialsFromOdb(...)

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

Path
mdb.models[name].materialsFromOdb

Required argument

fileName

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

Optional arguments

None.

Return value

A list of Material objects.

Exceptions

None.


29.1.3  Members

The Material object has members with the same names and descriptions as the arguments to the Material method.

In addition, the Material object can have the following members:

acousticMedium

An AcousticMedium object.

brittleCracking

A BrittleCracking object.

capPlasticity

A CapPlasticity object.

castIronPlasticity
clayPlasticity

A ClayPlasticity object.

concrete

A Concrete object.

concreteDamagedPlasticity
conductivity

A Conductivity object.

creep

A Creep object.

crushableFoam

A CrushableFoam object.

ductileDamageInitiation
fldDamageInitiation
flsdDamageInitiation
johnsonCookDamageInitiation
maxeDamageInitiation
maxsDamageInitiation
maxpeDamageInitiation
maxpsDamageInitiation
mkDamageInitiation
msfldDamageInitiation
quadeDamageInitiation
quadsDamageInitiation
shearDamageInitiation
hashinDamageInitiation
damping

A Damping object.

deformationPlasticity
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
eos

An Eos object.

expansion

An Expansion object.

fluidLeakoff

A FluidLeakoff object.

gapFlow

A GapFlow object.

gasketThicknessBehavior
gasketTransverseShearElastic
gasketMembraneElastic
gel

A Gel object.

heatGeneration

A HeatGeneration object.

hyperelastic

A Hyperelastic object.

hyperfoam

A Hyperfoam object.

hypoelastic

A Hypoelastic object.

inelasticHeatFraction
jouleHeatFraction
latentHeat

A LatentHeat object.

lowDensityFoam

A LowDensityFoam object.

magneticPermeability
mohrCoulombPlasticity
moistureSwelling
mullinsEffect

A MullinsEffect object.

permeability

A Permeability object.

piezoelectric

A Piezoelectric object.

plastic

A Plastic object.

poreFluidExpansion
porousBulkModuli
porousElastic

A PorousElastic object.

porousMetalPlasticity
regularization

A Regularization object.

solubility

A Solubility object.

sorption

A Sorption object.

specificHeat

A SpecificHeat object.

swelling

A Swelling object.

userDefinedField
userMaterial

A UserMaterial object.

userOutputVariables
viscoelastic

A Viscoelastic object.

viscosity

A Viscosity object.

viscous

A Viscous object.


29.1.4  Corresponding analysis keywords

*MATERIAL