1.2. Matmodlab Conventions¶
Overview¶
Conventions used throught Matmodlab are described
Dimension¶
Material models are always called with full 3D tensors.
Tensor Storage¶
In general, second-order symmetric tensors are stored as 6x1 arrays with the following ordering
(1)
Tensor components are used for all second-order symmetric tensors.
Nonsymmetric, second-order tensors are stored as 9x1 arrays in row major ordering, i.e.,
Note
The tensor order is runtime configurable using ordering keyword to the MaterialModel
constructor. See Invoking User Materials for details.
Engineering Strains¶
The shear components of strain-like tensors are sent to the material model as engineering strains, i.e.
matmodlab Namespace¶
Input scripts to Matmodlab should include:
from matmodlab import *
to populate the script’s namespace with Matmodlab specific parameters and methods.
Parameters¶
Some useful parameters exposed by importing matmodlab
are
ROOT_D
, the rootmatmodlab
directoryPKG_D
, thematmodlab/lib
directory, the location shared objects are copiedMAT_D
, the directory where builtin materials are contained
Methods¶
Some useful methods exposed by importing matmodlab
are
MaterialPointSimulator
, the material point simulator constructorPermutator
, the permutator constructorOptimizer
, the optimizer constructor
Each of these methods is described in more detail in the following sections.
Symbolic Constants¶
The following symbolic constants are exposed by importing matmodlab
:
XX, YY, ZZ, XY, YZ, XZ
, constants representing the xx, yy, zz, xy, yz, and xz components of second-order symmetric tensors.