Material Models
Existing Models
The models related functions can be found here.
| Material Model | Bond-based Elastic | PD Solid Elastic | PD Solid Plastic | Correspondence Elastic | Correspondence 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 key | Type | Required | Default | Range | Quantity | Description |
|---|---|---|---|---|---|---|
| Symmetry | text | optional | — | 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 strain | Material symmetry and 2D assumption (plane stress or plane strain); selects which elastic constants are needed. Isotropic if not given | |
| Young's Modulus | number | required: 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) | — | ≥ 0 | stress | Young'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 Ratio | number | required: two of Young's Modulus, Poisson's Ratio, Bulk Modulus, Shear Modulus (isotropic, not bond-based) | — | -1 … 0.5 | Poisson'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 Modulus | number | required: 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) | — | ≥ 0 | stress | Bulk 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 Modulus | number | required: 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) | — | ≥ 0 | stress | Shear 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 X | number or data file | optional | — | ≥ 0 | stress | Young'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 Y | number or data file | optional | — | ≥ 0 | stress | Young'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 Z | number or data file | optional | — | ≥ 0 | stress | Young'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 XY | number or data file | optional | — | 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 YZ | number or data file | optional | — | 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 XZ | number or data file | optional | — | 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 XY | number or data file | optional | — | ≥ 0 | stress | Shear 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 YZ | number or data file | optional | — | ≥ 0 | stress | Shear 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 XZ | number or data file | optional | — | ≥ 0 | stress | Shear 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 |
| C11 | number | optional | — | stress | Entry 11 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C12 | number | optional | — | stress | Entry 12 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C13 | number | optional | — | stress | Entry 13 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C14 | number | optional | — | stress | Entry 14 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C15 | number | optional | — | stress | Entry 15 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C16 | number | optional | — | stress | Entry 16 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C22 | number | optional | — | stress | Entry 22 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C23 | number | optional | — | stress | Entry 23 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C24 | number | optional | — | stress | Entry 24 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C25 | number | optional | — | stress | Entry 25 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C26 | number | optional | — | stress | Entry 26 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C33 | number | optional | — | stress | Entry 33 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C34 | number | optional | — | stress | Entry 34 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C35 | number | optional | — | stress | Entry 35 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C36 | number | optional | — | stress | Entry 36 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C44 | number | optional | — | stress | Entry 44 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C45 | number | optional | — | stress | Entry 45 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C46 | number | optional | — | stress | Entry 46 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C55 | number | optional | — | stress | Entry 55 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C56 | number | optional | — | stress | Entry 56 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| C66 | number | optional | — | stress | Entry 66 of the stiffness matrix in Voigt notation; only with Symmetry: anisotropic, anisotropic plane stress, anisotropic plane strain | |
| State Factor ID | integer | optional | — | ≥ 1 | Column of the state variables that scales the isotropic elastic constants node by node, e.g. for a degradation computed in a UMAT | |
| Accuracy Order | integer | optional | — | ≥ 1 | Polynomial order of the bond-associated correspondence formulation | |
| Zero Energy Control | text | optional | — | Stabilization against zero-energy modes of correspondence materials, e.g. "Global" | ||
| Bond Associated | true/false | optional | false | Uses the bond-associated correspondence formulation, which evaluates the deformation gradient per bond instead of per node | ||
| Linear Strain | true/false | optional | false | Uses the small-strain tensor instead of the Green-Lagrange strain in correspondence materials | ||
| Flaw Function | section | optional | — | 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.
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 key | Type | Required | Default | Range | Quantity | Description |
|---|---|---|---|---|---|---|
| Yield Stress | number or data file | required | ≥ 0 | stress | Von 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.
For the time step calculation two of the four isotropic elastic parameter have to be defined.
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 key | Type | Required | Default | Range | Quantity | Description |
|---|---|---|---|---|---|---|
| Yield Stress | number or data file | required | ≥ 0 | stress | Von 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.
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 key | Type | Required | Default | Range | Quantity | Description |
|---|---|---|---|---|---|---|
| File | text | required | UMAT library, relative to the input deck | |||
| Number of Properties | integer | required | ≥ 1 | Number of Property_N values passed to the UMAT | ||
| Number of State Variables | integer | optional | — | ≥ 0 | Size of the state variable field passed to the UMAT | |
| Predefined Field Names | text | optional | — | Node fields passed to the UMAT as predefined fields, separated by spaces | ||
| UMAT Material Name | text | optional | — | Material name passed to the UMAT (at most 80 characters) |
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.fCorrespondence 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 key | Type | Required | Default | Range | Quantity | Description |
|---|---|---|---|---|---|---|
| File | text | required | VUMAT library, relative to the input deck | |||
| Number of Properties | integer | required | ≥ 1 | Number of Property_N values passed to the VUMAT | ||
| Number of State Variables | integer | optional | — | ≥ 0 | Size of the state variable field passed to the VUMAT | |
| VUMAT Material Name | text | optional | — | 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.