Material Models

Existing Models

The models related functions can be found here.

MethodRelated Model in PeriLab
Bond-basedBond-based Elastic
Ordinary state-basedPD Solid Elastic, PD Solid Plastic
Non-ordinary state-basedCorrespondence Elastic, Correspondence Plastic, Correspondence UMAT
Material ModelBond-based ElasticPD Solid ElasticPD Solid PlasticCorrespondence ElasticCorrespondence Plastic
Symmetry✔️✔️✔️✔️✔️
Poisson's/Young's/Bulk/Shear✔️✔️✔️✔️✔️
Yield Stress✔️✔️
Zero Energy Control✔️✔️
C11/C12/.../C66(✔️)(✔️)(✔️)(✔️)(✔️)

Density and Horizon are keys of the block. Every material model entry accepts these shared keys:

YAML keyTypeRequiredDefaultRangeQuantityDescription
Symmetrytextoptional—one of: isotropic, isotropic plane stress, isotropic plane strain, orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic, transverse isotropic plane stress, transverse isotropic plane strain, anisotropic, anisotropic plane stress, anisotropic plane strainMaterial symmetry and 2D assumption (plane stress or plane strain); selects which elastic constants are needed. Isotropic if not given
Young's Modulusnumberrequired: two of Young's Modulus, Poisson's Ratio, Bulk Modulus, Shear Modulus (isotropic, not bond-based); required: one of Young's Modulus, Bulk Modulus, Shear Modulus (isotropic, bond-based)—≥ 0stressYoung's modulus, isotropic elastic constant; give two of Young's modulus, Poisson's ratio, bulk modulus and shear modulus, the others are computed (bond-based models fix Poisson's ratio and need one of the others); a text mesh column (e.g. Bulk_Modulus) gives it per node; only with Symmetry: isotropic, isotropic plane stress, isotropic plane strain
Poisson's Rationumberrequired: two of Young's Modulus, Poisson's Ratio, Bulk Modulus, Shear Modulus (isotropic, not bond-based)—-1 … 0.5Poisson's ratio, isotropic elastic constant; give two of Young's modulus, Poisson's ratio, bulk modulus and shear modulus, the others are computed (bond-based models fix Poisson's ratio and need one of the others); a text mesh column (e.g. Bulk_Modulus) gives it per node; only with Symmetry: isotropic, isotropic plane stress, isotropic plane strain
Bulk Modulusnumberrequired: two of Young's Modulus, Poisson's Ratio, Bulk Modulus, Shear Modulus (isotropic, not bond-based); required: one of Young's Modulus, Bulk Modulus, Shear Modulus (isotropic, bond-based)—≥ 0stressBulk modulus, isotropic elastic constant; give two of Young's modulus, Poisson's ratio, bulk modulus and shear modulus, the others are computed (bond-based models fix Poisson's ratio and need one of the others); a text mesh column (e.g. Bulk_Modulus) gives it per node; only with Symmetry: isotropic, isotropic plane stress, isotropic plane strain
Shear Modulusnumberrequired: two of Young's Modulus, Poisson's Ratio, Bulk Modulus, Shear Modulus (isotropic, not bond-based); required: one of Young's Modulus, Bulk Modulus, Shear Modulus (isotropic, bond-based)—≥ 0stressShear modulus, isotropic elastic constant; give two of Young's modulus, Poisson's ratio, bulk modulus and shear modulus, the others are computed (bond-based models fix Poisson's ratio and need one of the others); a text mesh column (e.g. Bulk_Modulus) gives it per node; only with Symmetry: isotropic, isotropic plane stress, isotropic plane strain
Young's Modulus Xnumber or data fileoptional—≥ 0stressYoung's modulus along the material x axis; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic, transverse isotropic plane stress, transverse isotropic plane strain
Young's Modulus Ynumber or data fileoptional—≥ 0stressYoung's modulus along the material y axis; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic, transverse isotropic plane stress, transverse isotropic plane strain
Young's Modulus Znumber or data fileoptional—≥ 0stressYoung's modulus along the material z axis; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain
Poisson's Ratio XYnumber or data fileoptional—Poisson's ratio in the material xy plane; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic, transverse isotropic plane stress, transverse isotropic plane strain
Poisson's Ratio YZnumber or data fileoptional—Poisson's ratio in the material yz plane; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic, transverse isotropic plane strain
Poisson's Ratio XZnumber or data fileoptional—Poisson's ratio in the material xz plane; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain
Shear Modulus XYnumber or data fileoptional—≥ 0stressShear modulus in the material xy plane; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic, transverse isotropic plane stress, transverse isotropic plane strain
Shear Modulus YZnumber or data fileoptional—≥ 0stressShear modulus in the material yz plane; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain, transverse isotropic
Shear Modulus XZnumber or data fileoptional—≥ 0stressShear modulus in the material xz plane; a number or a table over a node field; only with Symmetry: orthotropic, orthotropic plane stress, orthotropic plane strain
C11numberoptional—stressEntry 11 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C12numberoptional—stressEntry 12 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C13numberoptional—stressEntry 13 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C14numberoptional—stressEntry 14 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C15numberoptional—stressEntry 15 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C16numberoptional—stressEntry 16 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C22numberoptional—stressEntry 22 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C23numberoptional—stressEntry 23 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C24numberoptional—stressEntry 24 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C25numberoptional—stressEntry 25 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C26numberoptional—stressEntry 26 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C33numberoptional—stressEntry 33 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C34numberoptional—stressEntry 34 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C35numberoptional—stressEntry 35 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C36numberoptional—stressEntry 36 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C44numberoptional—stressEntry 44 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C45numberoptional—stressEntry 45 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C46numberoptional—stressEntry 46 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C55numberoptional—stressEntry 55 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C56numberoptional—stressEntry 56 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
C66numberoptional—stressEntry 66 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain
State Factor IDintegeroptional—≥ 1Column of the state variables that scales the isotropic elastic constants node by node, e.g. for a degradation computed in a UMAT
Accuracy Orderintegeroptional—≥ 1Polynomial order of the bond-associated correspondence formulation
Zero Energy Controltextoptional—Stabilization against zero-energy modes of correspondence materials, e.g. "Global"
Bond Associatedtrue/falseoptionalfalseUses the bond-associated correspondence formulation, which evaluates the deformation gradient per bond instead of per node
Linear Straintrue/falseoptionalfalseUses the small-strain tensor instead of the Green-Lagrange strain in correspondence materials
Flaw Functionsectionoptional—Lowers the yield stress around a point to seed localization (Correspondence Plastic)

Bond-based Elastic

The Bond-based Elastic calculates the linear elastic behavior of a simple bond-based material. The theory of the bond-based elastic material can be found here.

It needs one of the shared keys Young's Modulus, Bulk Modulus and Shear Modulus.

Fixed Poisson's ratio

In the bond-based formulation the Poisson's ratio is fixed by 0.25 for 2D plane strain and 1/3 for 3D and 2D plane stress, respectively.

Unified Bond-based Elastic

The unified bond-based material after Guan et al. [8] allows Poisson's ratios other than the fixed bond-based ones; see the theory. The PeriLab version is simplified: no rigid body rotation and no surface correction. It needs two of the shared isotropic elastic keys and has no keys of its own.

PD Solid Elastic

The PD Solid Elastic module calculates the isotropic linear elastic material law for a peridynamic solid material. The underlying theory can be found here.

It needs two of the shared keys Young's Modulus, Poisson's Ratio, Bulk Modulus and Shear Modulus. The other two are determined automatically and can be used in the model if needed.

PD Solid Plastic

The PD Solid Plastic material uses elastic stresses and calculate the plastic part for a peridynamic solid material. Has to be combined with a function, which provides elastic stresses.

YAML keyTypeRequiredDefaultRangeQuantityDescription
Yield Stressnumber or data filerequired≥ 0stressVon Mises stress at which the material yields (yield stress); a number or a table over a node field

Correspondence Elastic

The Correspondence Elastic module calculates the fully anisotropic linear elastic material law. The underlying correspondence theory can be found here.

It uses the shared elastic keys. With an anisotropic Symmetry you can provide the entries C11, ..., C66 of the Hooke matrix.

Isotropic elastic parameter

For the time step calculation two of the four isotropic elastic parameter have to be defined.

Material Rotation

If you define a field "Angles" for 2D or "Anglesx", "Anglesy" and "Anglesz" for 3D in the mesh file your material will be rotated. This helps to create an arbitrary material orientation.

Correspondence Plastic

The Correspondence Plastic material uses elastic stresses and calculate the plastic part. Has to be combined with a function, which provides elastic stresses.

YAML keyTypeRequiredDefaultRangeQuantityDescription
Yield Stressnumber or data filerequired≥ 0stressVon Mises stress at which the material yields (yield stress); a number or a table over a node field

Correspondence UMAT

The Correspondence UMAT can be used to include Abaqus user materials.

Replace ABAQUS Functions

No extra Abaqus functions should be called in the user subroutine. For example INCLUDE 'ABA_PARAM.INC' needs to be replaced by implicit real(8) (a-h,o-z)

You can call the user subroutine by defining path with a compiled Fotran library. [5] gives an overview about the interface for Peridigm. In PeriLab all fields in the UMAT interface are supported execpt these integer (NOEL, NPT, LAYER, KSPT, JSTEP, KINC) and float values (PNEWDT, CELENT). In the material module these values defined for the interfase and named as notsupportedint and notsupportedfloat, respectively.

YAML keyTypeRequiredDefaultRangeQuantityDescription
FiletextrequiredUMAT library, relative to the input deck
Number of Propertiesintegerrequired≥ 1Number of Property_N values passed to the UMAT
Number of State Variablesintegeroptional—≥ 0Size of the state variable field passed to the UMAT
Predefined Field Namestextoptional—Node fields passed to the UMAT as predefined fields, separated by spaces
UMAT Material Nametextoptional—Material name passed to the UMAT (at most 80 characters)
Matrix based

If you use the matrix based approach you can use UMATS as well. But you must provide the tangential stiffness matrix. As solver right now you can use Matrix Verlet and Linear Static Matrix Based. The material definition remains equal.

Compilation of the UMAT subroutine

In order to compile the UMAT subroutine you need to install gfortran. Have a look at this page. After installation you can compile the Fortran subroutine with the following command:

gfortran -shared -fPIC -ffixed-form -ffixed-line-length-132 -fno-range-check -o libusermat.so base.f

Correspondence VUMAT

Like the Correspondence UMAT, but for an Abaqus VUMAT (explicit) subroutine compiled into a shared library. Its properties are given as Property_1 … Property_N.

YAML keyTypeRequiredDefaultRangeQuantityDescription
FiletextrequiredVUMAT library, relative to the input deck
Number of Propertiesintegerrequired≥ 1Number of Property_N values passed to the VUMAT
Number of State Variablesintegeroptional—≥ 0Size of the state variable field passed to the VUMAT
VUMAT Material Nametextoptional—Material name passed to the VUMAT (at most 80 characters)

Rigid

A rigid block: no internal forces and no deformation. It has no keys of its own.

Model merging

In PeriLab you are able to combine models with each other, by simply adding a +. Therefore, modules can be merged and double coding can be avoided.

Elastic platic

If you want to run elastic platic please use Correspondence Elastic + Correspondence Plastic or PD Solid Elastic + PD Solid Plastic

Model order

The order is defined by the user. Because the plastic routines need stresses to work, make sure the materials which provide these stresses are before the plastic models.