Académique Documents
Professionnel Documents
Culture Documents
Introduction
SimXpert crash is a preprocessor for graphically preparing input data for LS-DYNA, an explicit dynamic
software, used in applications such as crash, crush, and drop test simulations. Use of crash workspace
allows users to work within one common modeling environment with other SimXpert workspaces such
as Structures. Thus, for example, a model originally prepared for NVH, linear, or implicit nonlinear
analysis can be easily used in explicit applications (crash). This dramatically reduces the time spent to
build different models for implicit and explicit analysis and prevents you from making mistakes because
of unfamiliarity between different programs.
Theory
A detailed theory of explicit analysis is outside the scope of this guide. However, it is important to
understand the basics of the solution technique, since it is critical to many aspects of using the SimXpert
crash workspace. If you are already familiar with explicit methods and how they differ from implicit
methods, you may disregard this section.
Method of Solution
Although crash simulation software, including LS-DYNA uses the Explicit methods, a brief overview of
both the Implicit and the Explicit Methods for the solution of dynamic response calculations is given
below.
Implicit Methods
Most finite element programs use implicit methods to carry out a transient solution. Normally, they use
Newmark schemes to integrate in time. If the current time step is step n , a good estimate of the
acceleration at the end of step n + 1 will satisfy the following equation of motion:
ext
Ma' n + 1 + Cv' n + 1 + Kd' n + 1 = F n + 1
where:
a' n + 1 = n+1
estimate of acceleration at step
v' n + 1 = estimate of velocity at step n + 1
d' n + 1 = estimate of displacement at step n + 1
2 2
d'n + 1 = d n + v n Δt + ( ( 1 – 2β )a n Δt ) ⁄ 2 + βa'n + 1 Δt
v' n + 1 = v n + ( 1 – γ )a n Δt + γa'n + 1 Δt
or
2
d'n + 1 = d *n + βa'n + 1 Δt
v' n + 1 = v n* + γa'n + 1 Δt
The terms d n* and v n* are predictive and are based on values already calculated.
Substituting these values in the equation of motion results in
2 ext
Ma' n + 1 + C ( v* n + γa' n + 1 Δt ) + K ( d* n + βa' n + 1 Δt ) = F n + 1
or
2 ext
[ M + CγΔt + KβΔt ]a' n + 1 = F n + 1 – Cv n* – Kd n*
The equation of motion may then be defined as
residual
M*a'n + 1 = F n + 1
–1 residual
a'n + 1 = M* F n + 1
This is analogous to decomposing the stiffness matrix in a linear static analysis. However, in dynamics,
mass and damping terms are also present.
4
Overview and Definition
Explicit Methods
The equation of motion
ext
Ma n + Cv n + Kd n = F n
can be rewritten as
ext int
Ma n = F n – F n
–1 residual
an = M Fn
where:
The acceleration can be found by inverting the mass matrix and multiplying it by the residual load vector.
In LS_DYNA, like any explicit finite element code, the mass matrix is lumped which results in a diagonal
mass matrix.
Since M is diagonal, its inversion is trivial, and the matrix equation is a set of independent equations for
each degree of freedom, as follows:
residual
a ni = F ni ⁄ Mi
The Leap-frog scheme is used to advance in time.
The position, forces, and accelerations are defined at time level n , while the velocities are defined at time
level n + 1 ⁄ 2 . Graphically, this can be depicted as:
v n + 1 ⁄ 2 = v n – 1 ⁄ 2 + a n ( Δt n + 1 ⁄ 2 + Δt n – 1 ⁄ 2 ) ⁄ 2
d n + 1 = dn + v n + 1 ⁄ 2 Δt n + 1 ⁄ 2
Introduction 5
Overview and Definition
The Leap-frog scheme results in a central difference approximation for the acceleration, and is second-
order accurate in Δt .
Explicit methods with a lumped mass matrix do not require matrix decompositions or matrix solutions.
Instead, the loop is carried out for each time step as shown in the following diagram:
Grid-Point Accelerations
Element Stresses
Courant Criterion
Since it is impossible to do a complete eigenvalue analysis every cycle to calculate the timestep, an
approximate method, known as the Courant Criterion, is used. This is based on the minimum time which
is required for a stress wave to cross each element:
Δt = SL/c
where:
Δt = Timestep
S = Timestep scale factor (<1)
L = Smallest element dimension
c = Speed of sound in the element material
c = E⁄ρ
where:
E = Young’s modulus
ρ = density
Units
SimXpert interprets all dimensions and input data with respect to a system of units. It is important to set
the appropriate units prior to importing any unitless analysis files (such as a Nastran Bulk Data file) or
creating materials, properties, or loads. You can control the system of units by selecting Units Manager
from the Tools menu. If you import a file that contains units, SimXpert will convert them into those
specified in the Units Manager.
Creating Geometry
In the first release SimXpert has very limited geometry creation capabilities. It is possible to create curves
and very simple surfaces. For the most part you will be importing geometry from an external source. The
imported geometry can be edited in SimXpert
Importing Geometry
If the geometry of the part is available in a CATIA, parasolid, IGES, or STL file, it can be directly
imported into the SimXpert Crash Workspace.
coordinate system with one of its axes normal to the inclined plane needs to be created and used to specify
the fixity (SPC) of the displacement component along the direction normal to the inclined plane.
CONSTRAINT
Local coordinate systems can be in cartesian, cylindrical or spherical systems. Coordinate system created
in SimXpert are represented by the following icons, corresponding to the method selected.
Spherical
Cylindrical
Cartesian
You can create local coordinate systems by selecting Cartesian, Cylindrical, or Spherical from the
Coordinate System group under the Geometry tab. There are numerous methods to create local
coordinate systems in SimXpert:
12
Parts and Geometry
1. 3 Points: Three points are used to define the coordinate system. The first point corresponds to the
location of origin. The second point defines the point on a specified axis and the third point
defines a point in a specified plane.
2. Euler: Creates a coordinate system through three specified rotations about the axes of an existing
coordinate system.
3. Normal: Creates a coordinate system with its origin at a point location on a surface. A specified
axis is normal to the surface.
4. Two Vectors: Creates a coordinate system with its origin at a designated location and two of the
coordinate frame axes are defined using vectors
5. Advanced: Location and orientation can be independently defined. There are 4 different ways to
define the location of the origin of the coordinate system: Geometry, Point/Node, Coordinate
System, and Center of Part. Further, the orientation can also be defined 3 ways: Global, Two
Axes, and Coordinate System.
Materials 13
Materials
14
Materials
Materials
SimXpert Crash Workspace supports most of the LS-DYNA material types, covering isotropic,
anisotropic, orthotropic, and laminated material properties. These material properties can be dependent
on temperature, strain, and strain rate. Here we briefly describe all the material types supported currently
by the crash workspace. Please refer to “LS-DYNA Keyword Users’ Manual”, for a full description of
all the LS-DYNA supported materials.
Supported Materials
MAT_ADD_EROSION
This material model option provides a way of including failure in material models that do not allow
failure and erosion. This option can also be applied to constitutive models with other failure and erosion
criterion. Each of the criterion defined here is applied independently, and once any of them is satisfied,
the element is deleted from further calculation.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0) for which this erosion
definition applies.
EXCL The Exclusion number. When any of the failure constants are set to the
exclusion number, the associated failure criteria calculations are bypassed.
For example, to prevent a material from going into tension, you may
specify an unusual value for the exclusion number, e.g. 1234., set Pmin to
0.0 and all the remaining constants to 1234. The default value is 0.0, which
eliminates all criteria from consideration that have their constants set to 0.0,
or left blank.
PFAIL Pressure at failure, Pmin. Failure occurs when pressure is less than PFAIL
Materials 15
Materials
Field Comments
SIGP1 principal stress at failure, σmax. Failure occurs when the maximum
principal stress exceeds SIGP1.
SIGVM Equivalent stress at failure, σvM. Failure occurs when the von Mises
equivalent stress exceeds SIGVM.
EPSP1 Principal strain at failure, εmax. Failure occurs when the maximum
principal strain exceeds EPSP1.
EPSSH Shear strain at failure, γmax. Failure occurs when the maximum shear strain
exceeds EPSSH.
SIGTH Threshold stress, σ0 (used in evaluating the Tuler-Butcher criterion)
IMPULSE Stress impulse for failure, Kf. Failure occurs when the Tuler-Butcher
criterion exceeds IMPULSE.
FAILTM Failure time. When the analysis time exceeds the failure time, the material
is removed.
Remarks:
1. This failure model only applies to the 2D and 3D solid elements with one point integration.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ANISOTROPIC_ELASTIC
This material model is used for modeling elastic anisotropic behavior of solids.
Field Contents
Title Unique name identifying the material model.
Desc Optional description of the material model.
16
Materials
Field Contents
TITLE_OPTION If selected, the material Title will be exported to LS-DYNA
MID Material identification number. (Integer > 0)
RO Mass density.
C11... C66 Anisotropic constitutive matrix components
AOPT Material axes option
XP, YP, ZP Coordinates for point P (for AOPT= 1 and 4)
A1, A2, A3 Components of a vector a (for AOPT=2)
D1, D2, D3 Components of a vector d (for AOPT=2)
V1, V2, V3 Components of a vector v (for AOPT= 3 and 4)
BETA Material angle in degrees (for AOPT= 3)
REF Use Reference geometry to initialize the stress tensor
See Also:
• LS-DYNA Keyword User’s Manual
MAT_BLATZ-KO_RUBBER
This is used to model nearly incompressible continuum rubber. The Poisson’s ratio is fixed to 0.463
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear modulus
REF Use reference geometry to initialize the stress tensor (0 =off; 1 = on)
See Also:
• LS-DYNA Keyword User’s Manual
Materials 17
Materials
MAT_CABLE_DISCRETE_BEAM
This material model is used to define elastic cables realistically.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass density
E Young’s modulus (if value greater than zero), or stiffness (if value smaller
than zero)
LCID Load curve Id for loading (engineering stress vs. engineering strain)
F0 Initial Tensile Force
TMAXF0 Time for which pre-tension force will be held
TRAMP Ramp-up time for pre-tension force
IREAD Flag: If value greater than zero, use the value of OUTPUT from card 2.
OUTPUT Flag = 1 to output axial strain
Remarks:
1. The force, F generated by the cable is nonzero if the cable is in tension. The force is given by:
F = max (F0 + KΔL, 0.)
where K is the stiffness, and ΔL is the change in length. If E is greater than zero, K is defined as:
K = (E X cross sectional area)/ (Initial length - offset)
2. A constant force element can be obtained by setting:
F0 > 0, and K = 0
18
Materials
3. The cross section, and offset are defined on the *SECTION or *ELEMENT cards. For a slack
cable, the offset should be input as a negative value. For an initial tensile force, the offset should
be positive.
4. If a load curve is specified, the Young’s modulus will be ignored, and the load curve will be used
instead. The points on the load curve are defined as engineering stress vs. engineering strain. The
unloading behavior follows the loading.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC
This LS-DYNA material model (001) is an isotropic elastic material available for beam, shell and solid
elements.
Field Contents
Title Unique name identifying the material model.
Desc Optional description of the material model.
TITLE_OPTION If selected, the material Title will be exported to LS-DYNA
MID Material identification number. (Integer > 0)
RO Mass density.
E Young’s modulus
PR Poisson’s ratio
DA Axial damping factor (used in Belytscho-Schwer beam type 2 only)
DB Bending damping factor (used in Belytscho-Schwer beam type 2 only)
Remarks:
1. The axial and bending damping factors are used to damp down numerical noise. The update of the
force resultants, F i , and moment resultants, M i , includes the damping factors:
Materials 19
Materials
= F i + 1 + -------- ΔF i
n+1 n DA n+1⁄2
Fi
Δt
= M i + 1 + -------- ΔM i
n+1 n DB n+1⁄2
Mi
Δt
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_FLUID
This LS-DYNA material model (001) is an isotropic elastic material available for solid elements.
Field Contents
Title Unique name identifying the material model.
Desc Optional description of the material model.
TITLE_OPTION If selected, the material Title will be exported to LS-DYNA
MID Material identification number. (Integer > 0)
RO Mass density.
E Young’s modulus
PR Poisson’s ratio
DA Axial damping factor (used in Belytscho-Schwer beam type 2 only)
DB Bending damping factor (used in Belytscho-Schwer beam type 2 only)
K Bulk Modulus (for fluid option)
VC Tensor viscosity coefficient (between 0.1 and 0.5)
CP Cavitation pressure (default = 1.0E+20)
20
Materials
Remarks:
1. The axial and bending damping factors are used to damp down numerical noise. The update of the
force resultants, F i , and moment resultants, M i , includes the damping factors:
= F i + 1 + -------- ΔF i
n+1 n DA n+1⁄2
Fi
Δt
= M i + 1 + -------- ΔM i
n+1 n DB n+1⁄2
Mi
Δt
2. Fluid like behavior is obtained with the following relationship between bulk modulus, K, and
pressure rate, p:
E
K = ------------------------
3 ( 1 – 2υ )
··
p = – Kε ii
A tensor viscosity VC, if used, which acts only on the deviatoric stresses
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_PLASTIC_THERMAL
Temperature dependent material coefficients can be defined using this material type. A minimum of two
temperature points are needed, and a maximum of eight can be defined.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
Materials 21
Materials
Field Comments
MID Material identification number (Integer > 0)
RO Mass Density of the material
YM_LC Load curve defining Young’s modulus Vs. Temperatures.
PR_LC Load curve defining Poisson’s raito Vs. Temperatures.
A_LC Load curve defining the coefficent of thermal expansion Vs. Temperatures.
SIGY_LC Load curve defining Yield stressVs. Temperatures.
V_LC Load curve defining the plastic hardening modulus Vs. Temperatures.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ISOTROPIC_ELASTIC_PLASTIC
Defines an isotropic plasticity material with isotropic hardening. This is a very low cost plasticity model,
suitable for 3D solids and plane stress elements. If used in shell elements, this material model leads to
inaccurate shell thickness updates and stresses after yielding.
Field Contents
Name Unique name identifying the material model.
Desc Optional description of the material model.
Fields:
MID Material identification number. (Integer > 0)
RO Mass density.
G Shear modulus.
SIGY Yield Stress.
ETAN Plastic hardening modulus
BULK Bulk modulus
22
Materials
Remarks:
1. In the plane stress implementation for shell elements, a one-step radial return approach is used to
scale the Cauchy stress tensor if the state of stress exceeds the yield surface.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_LOW_DENSITY_FOAM
This material is used to model highly compressible low density foams. Its main applications are for seat
cushions and padding on the Side Impact Dummies (SID). Optionally, a tension cut-off failure can be
defined.
Field Contents
Name Unique name identifying the material model.
Desc Optional description of the material model.
Fields:
MID Material identification number. (Integer > 0)
RO Mass density.
E Young’s modulus
LCID Load Curve Id for nominal stress versus strain
TC Tension cut-off stress
HU Hysteric unloading factor (between 0 and 1). Default is 1 (no energy
dissipation)
BETA Decay constant (β) for creep in unloading
Materials 23
Materials
Field Contents
DAMP Viscous damping coefficient (0.05< recommended value < 0.50) to model
damping effects.
LT. 0: the absolute value of DAMP is used as the load curve which defines the
damping coefficient as a function of the maximum strain in compression εmax
(see Remark 1). In tension, the damping constant is set to the value
corresponding to the strain at 0.
SHAPE Shape factor for unloading. Active for non-zero values of the Hysteric
unloading factor (HU)
FAIL Failure option, after cut-off stress reached.
= 0, Off
= 1, On
Remarks:
The compressive behavior is illustrated in Figure 1 where hysteresis on unloading is shown. This
behavior under uniaxial loading is assumed not to significantly couple in the transverse directions. In
tension the material behaves in a linear fashion until tearing occurs. Although the implementation may
be somewhat unusual, it was motivated by Storakers (1986).
The model uses tabulated input data for the loading curve where the nominal stresses are defined as a
function of the elongations, εi , which are defined in terms of the principal stretches, λ i , as:
εi = λi – 1
24
Materials
The stretch ratios are found by solving for the eigenvalues of the left stretch tensor, V ij , which is obtained
via a polar decomposition of the deformation gradient matrix, F ij . Recall that,
F ij = R ik Ukj = V ik Rkj
The update of Vij follows the numerically stable approach of (Taylor and Flanagan 1989). After solving
for the principal stretches, we compute the elongations and, if the elongations are compressive, the
corresponding values of the nominal stresses, τi are interpolated. If the elongations are tensile, the
nominal stresses are given by
τ i = Eε i
and the Cauchy stresses in the principal system become
τi
σ i = ----------
λ i λk
The stresses can now be transformed back into the global system for the nodal force calculations.
Additional Remarks:
1. When hysteretic unloading is used the reloading will follow the unloading curve if the decay
constant, β , is set to zero. If β is nonzero the decay to the original loading curve is governed by
the expression:
– βt
1. – e
2. The bulk viscosity, which generates a rate dependent pressure, may cause an unexpected
volumetric response and, consequently, it is optional with this model.
3. The hysteretic unloading factor results in the unloading curve to lie beneath the loading curve as
shown below. This unloading provide energy dissipation which is reasonable in certain kinds of
foam.
4. Note that since this material has no effective plastic strain, the internal energy per initial volume
is written into the output databases.
5. Rate effects are accounted for through linear viscoelasticity by a convolution integral of the form
t ∂ε kl
0 ijkl
r
σ ij = g ( t – τ ) --------- dτ
∂τ
where g ijkl ( t – τ ) is the relaxation function.
The stress tensor augments the stresses determined from the foam. Consequently, the final stress,
σ ij is taken as the summation of the two contributions:
f r
σ ij = σ ij + σ ij
Materials 25
Materials
Since we wish to include only simple rate effects, the relaxation function is represented by one
term from the Prony series:
N
– βt
g ( t ) = α0 + am e
m=1
given by,
–β1 t
g ( t ) = Ed e
This model is effectively a Maxwell fluid which consists of a damper and spring in series. We
characterize this in the input by a Young's modulus, Ed , and decay constant, β 1 .The formulation
is performed in the local system of principal stretches where only the principal values of stress are
computed and triaxial coupling is avoided. Consequently, the one-dimensional nature of this foam
material is unaffected by this addition of rate effects. The addition of rate effects necessitates
twelve additional history variables per integration point. The cost and memory overhead of this
model comes primarily from the need to “remember” the local system of principal stretches.
6. The time step size is based on the current density and the maximum of the instantaneous loading
slope, E, and ECON. If ECON is undefined the maximum slope in the loading curve is used
instead.
See Also:
• LS-DYNA Keyword User’s Manual
26
Materials
MAT_MOONEY_RIVLIN_RUBBER
This LS-DYNA material is used to define material properties for a two-parameter material model for
rubber.
Field Contents
Name Unique name identifying the material model.
Desc Optional description of the material model.
Fields:
MID Material identification number. (Integer > 0)
PR Poisson’s ratio.
RO Mass density.
A Mooney Rivlin Constant, A
B Mooney Rivlin Constant, B
REF Use Reference geometry to initialize the stress tensor
=0, Off
= 1, On
SGL Specimen Gauge length, l0
SW Specimen width
ST Specimen thickness
LCID Load Curve Id defining the force versus actual length change (ΔL) in the
gauge length.
Remarks:
The strain energy density function is defined as:
–2 2
W = A ( I – 3 ) + B ( II – 3 ) + C ( III – 1 ) + D ( III – 1 )
Materials 27
Materials
C = 0.5A + B
D = A(5ν - 2) + B(11ν -5)/(2(1 - 2ν))
ν = Poisson’s ratio
2(A + B) = Shear modulus of linear elasticity
I, II, III are the three invariants of the Cauchy-Green Tensor
The load curve definition that provides the uniaxial data should give the change in gauge length, Δ L ,
versus the corresponding force. In compression both the force and the change in gauge length must be
specified as negative values. In tension the force and change in gauge length should be input as positive
values. The principal stretch ratio in the uniaxial direction, λ 1 , is then given by
L 0 + ΔL
λ 1 = ------------------
-
L0
with L0 being the initial length and L being the actual length.
Alternatively, the stress versus strain curve can also be input by setting the gauge length, thickness, and
width to unity (1.0) and defining the engineering strain in place of the change in gauge length and the
nominal (engineering) stress in place of the force (Figure 2).
28
Materials
The least square fit to the experimental data is performed during the initialization phase and is a
comparison between the fit and the actual input is provided in the printed file. It is a good idea to visually
check to make sure that it is acceptable. The coefficients A and B are also printed in the Dyna output file.
The stress versus strain curve can used instead of the force versus the change in the gauge length by
setting the gauge length, thickness, and width to unity (1.0) and defining the engineering strain in place
of the change in gauge length and the nominal (engineering) stress in place of the force (Figure 3).
See Also:
• LS-DYNA Keyword User’s Manual
Materials 29
Materials
MAT_NONLOCAL
Defines failure criterion to be dependent on the state of the material within a radius of influence which
surrounds the integration point. With this failure model, the mesh size sensitivity of failure is greatly
reduced, giving better convergence to a unique solution as the mesh is refined.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Non local Material identification number (Integer > 0)
PID Part Id for non local material
P Exponent of weighting function. A typical value might be 8., depending on
the choice of the value for L.
Q Exponent of weighting function. A typical value might be 2.
L Characteristic length. This length should span a few elements
NFREQ Number of time steps before updating neighbors. Since the nearest
neighbor search can add significant computational time, NFREQ should be
set to value of 10 to 100.
NL1,,, NL8 History variable Ids for non local treatment
XC1, YC1, ZC1 Coordinate of point on symmetry plane
XC2, YC2, ZC2 Coordinate of a point along the normal vector
See Also:
• LS-DYNA Keyword User’s Manual
30
Materials
MAT_ORTHOTROPIC_ELASTIC
This LS_Dyna material model (002) is an orthotropic elastic material available for solids, shells, and
thick shells.
Field Contents
Title Unique name identifying the material model.
Desc Optional description of the material model.
TITLE_OPTION If selected, the material Title will be exported to LS-DYNA
MID Material identification number. (Integer > 0)
RO Mass density.
EA Young’s modulus in a-direction
EB Young’s modulus in b-direction
EC Young’s modulus in c-direction
PRBA Poisson’s ratio (νba)
PRCA Poisson’s ratio (νca)
PRCB Poisson’s ratio (νcb)
GAB Shear modulus (Gab)
GBC Shear modulus (Gbc)
GCA Shear modulus (Gca)
AOPT Material axis option
G Shear modulus for frequency dependent damping
SIGF Limit stress for frequency independent frictional damping
XP, YP, ZP Coordinates for point P (for AOPT= 1 and 4)
Materials 31
Materials
Field Contents
A1, A2, A3 Components of a vector a (for AOPT=2)
D1, D2, D3 Components of a vector d (for AOPT=2)
V1, V2, V3 Components of a vector v (for AOPT= 3 and 4)
BETA Material angle in degrees (for AOPT= 3)
REF Use Reference geometry to initialize the stress tensor
Remarks:
The material law that relates stresses to strains is defined as:
T
C = T CL T
˜ ˜ ˜ ˜
where T is a transformation matrix, and C L is the constitutive matrix defined in terms of the material
˜ ˜
constants of the orthogonal material axes, a , b , and c . The inverse of CL for the orthotropic case is
˜
defined as:
1- ν ba ν ca
----- – -------- – ------- 0 0 0
Ea Eb Ec
ν ab 1 ν cb
– -------- ------ – ------- 0 0 0
Ea Eb Ec
νac ν bc 1
–1
– ------- – ------- ----- 0 0 0
CL = Ea Eb Ec
˜
1-
--------
0 0 0 0 0
G ab
1
0 0 0 0 --------- 0
G bc
1
0 0 0 0 0 ---------
G ca
ν ab ν ba ν ca ν ac ν cb ν bc
Note that -, ------- = -------
-------- = ------- , ------- = -------
Ea Eb Ec E a Ec Eb
32
Materials
The frequency independent damping is obtained by having a spring and slider in series as shown in the
following sketch:
σ fric
This option applies only to orthotropic solid elements and affects only the deviatoric stresses.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PIECEWISE_LINEAR_PLASTICITY
Defines elasto-plastic material with an arbitrary stress versus strain curve and arbitrary strain rate
dependency. Also, failure based on a plastic strain or a minimum time step size can be defined.
Field Contents
Name Unique name identifying the material model.
Desc Optional description of the material model.
Fields:
MID Material identification number. (Integer > 0)
E Young’s modulus. (Real > 0.0 or blank)
PR Poisson’s ratio.
RO Mass density.
SIGY Yield Stress.
ETAN Tangent modulus (ignored if LCSS.GT. 0 is defined)
Materials 33
Materials
Field Contents
FAIL Failure Flag
GT. 0.0: Plastic strain to failure. When the plastic strain reaches this value, the
element is deleted from the calculation.
TDEL Minimum time step size for automatic element deletion
C Strain rate parameter, C
P Strain rate parameter, P
LCSS Load Curve Id or Table Id defining effective stress versus effective plastic
strain. The tableId defined for each strain rate a value of load curve Id giving
the stress versus effective plastic strain for that rate.
LCSR Load Curve Id defining strain rate scaling effect on yield stress
VP Formulation for rate effects
= 1, Viscoplastic formulation
Remarks:
The stress strain behavior may be treated by a bilinear stress strain curve by defining the tangent modulus,
ETAN. The most general approach is to use the table definition (LCSS) discussed below.
Three options to account for strain rate effects are possible.
1. Strain rate may be accounted for using the Cowper and Symonds model which scales the yield
stress with the factor
ε 1⁄p
·
1 + ----
C
where, ε· is the strain rate
· · ·
ε = ε ij ε ij
If VP=-1, the deviatoric strain rates are used instead.
If the viscoplastic option is active, VP=1.0, and if SIGY is > 0 then the dynamic yield stress is
computed from the sum of the static stress,
34
Materials
s p
σ y ( ε eff )
which is typically given by a load curve ID, and the initial yield stress, SIGY, multiplied by the
Cowper-Symonds rate term as follows:
1⁄p
ε· eff
p
p ·p s p
σ y ( ε eff, ε eff ) = σ y ( ε eff ) + SIGY ⋅ -------
C
where the plastic strain rate is used. If SIGY=0, the following equation is used instead where the
static stress
s p
σ y ( ε eff )
must be defined by a load curve:
1⁄p
ε· eff
p
p ·p s p
σ y ( ε eff, ε eff ) = σ y ( ε eff ) 1 + -------
C
This latter equation is always used if the viscoplastic option is off.
2. For complete generality a load curve (LCSR) to scale the yield stress may be input instead. In this
curve the scale factor versus strain rate is defined.
3. If different stress versus strain curves can be provided for various strain rates, the option using the
reference to a table (LCSS) can be used. See figure below.
Materials 35
Materials
Figure 4 Rate effects may be accounted for by defining a table of curves. If a table
Id is specified a curve Id is given for each strain rate. Intermediate values
are found by interpolating between curves. Effective plastic strain versus
yield stress is expected. If the strain rate values fall out of range,
extrapolation is not used; rather, either the first or last curve determines
the yield stress depending on whether the rate is low or high,
respectively.
4. A fully viscoplastic formulation is optional (variable VP) which incorporates the different options
above within the yield surface. An additional cost is incurred over the simple scaling but the
improvement in results can be dramatic.
See Also:
• LS-DYNA Keyword User’s Manual
36
Materials
MAT_PLASTIC_KINEMATIC
Defines elasto-plastic material with isotropic and kinematic hardening with or without rate effects.
Field Contents
Name Unique name identifying the material model.
Desc Optional description of the material model.
Fields:
MID Material identification number. (Integer > 0)
E Young’s modulus. (Real > 0.0 or blank)
PR Poisson’s ratio.
RO Mass density.
SIGY Yield Stress.
ETAN Tangent modulus
BETA Hardening parameter
= 0: Kinematic hardening
= 1: Isotropic hardening
= 1, Viscoplastic formulation
Materials 37
Materials
Remarks:
Figure 5 Elastic-plastic behavior with kinematic and isotropic hardening where l0 and l
are respectively undeformed and deformed lengths of uniaxial tension
specimen, and Et is the slope of the bilinear stress vs. strain curve.
Strain rate may be accounted for using the Cowper and Symonds model which scales the yield stress with
the factor
·
ε 1⁄p
1 + ----
C
where, ε· is the strain rate
38
Materials
· · ·
ε = ε ij ε ij
A fully viscoplastic formulation is optional which incorporates the Cowper and Symonds formulation
within the yield surface. Although an additional computational cost is incurred, the improvement in the
results can be substantial. To ignore strain rate effects, set both SRC and SRP to zero.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_POWER_LAW_PLASTICITY
Defines an isotropic plasticity material model with rate effects which uses a power law for hardening.
Field Contents
Name Unique name identifying the material model.
Desc Optional description of the material model.
Fields:
MID Material identification number. (Integer > 0)
RO Mass density.
E Young’s modulus. (Real > 0.0 or blank)
PR Poisson’s ratio.
K Strength coefficient
N Hardening exponent
SRC Strain rate parameter, C. If zero, rate effects are ignored.
SRP Strain rate parameter, P. If zero, rate effects are ignored.
Materials 39
Materials
Field Contents
SIGY Yield Stress (optional). Generally this parameter is not necessary (See
Remarks)
VP Formulation for rate effects:
= 1, Viscoplastic formulation
Remarks:
The yield stress, σy is a function of plastic strain, and obeys the following equation:
σ y = k ε n = k ( ε yp + ε p )
n
where, ε· yp is the strain rate to yield, and ε p is the effective plastic strain (logarithmic).
The parameter SIGY governs how the strain to yield is identified. If SIGY is set to zero, the strain to yield
is found by solving for the intersection of the linear elastic loading with the strain hardening equation:
σ = Eε
σ =kεn
which gives the elastic strain at yield as:
1
E n −1
ε yp =
k
If SIGY is set to nonzero, and greater than 0.02 then:
1
σ n
ε yp = y
k
40
Materials
Strain rate is accounted for using the Cowper-Symonds model which scales the yield stress with the
following factor:
1
ε
P
1+
C
where ε· is the strain rate. A fully viscoplastic formulation is optional with this model which incorporates
the Cowper-Symonds formulation within the yield surface. Although an additional cost
is incurred, the improvement in results can be substantial.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_RIGID
This material model is used to model parts made from rigid materials. Also, the coupling of a rigid body
with MADYMO, and CAL3D can be defined via this material. Alternatively, a VDA surface can be
attached as surface to model the geometry, e.g., for the tooling in metal-forming applications. Also,
global and local constraints on the mass center can be optionally defined. Optionally, a local
consideration for output and user-defined airbag sensors can be chosen.
Field Contents
Title Unique name identifying the material model.
Desc Optional description of the material model.
TITLE_OPTION If selected, the material Title will be exported to LS-DYNA
MID Material identification number. (Integer > 0)
Materials 41
Materials
Field Contents
RO Mass density
E Young’s modulus. (Real > 0.0 or blank)
PR Poisson’s ratio
N MADYMO3D coupling flag.
COUPLE Coupling Option
ALIAS VDA Surface alias Name
CMO Center of mass constraint option
=0, No constraints
=0, No constraints
Field Contents
CON2 Second constraint parameter
=0, No constraints
Remarks:
1. A rigid material provides a convenient way of turning one or more parts comprised of beams,
shells, or solid elements into a rigid body. Approximating a deformable body as rigid is a
preferred modeling technique in many real world applications. For example, an engine block in a
car crash simulation can be treated as rigid. Elements belonging to a rigid material are bypassed
in the element processing and no storage is allocated for storing history variables. Consequently,
using a rigid material is very cost efficient.
2. The inertial properties are calculated from the geometry of the constituent elements and the
density RO as specified on the MAT_RIGID.
3. The initial velocity of a rigid material is calculated from the initial velocity of the constituent
grids.
4. A rigid body can be made up of disjoint meshes. All elements that are part of a rigid body will
move together as one rigid, even if they are disjoint.
5. Motion control for a rigid material can be defined using the BOUNDARY_SPC entry. The SPC
must be applied to one grid point only.
6. Load control for a rigid material can be defined using the FORCE and MOMENT entries. These
loads can be applied to any grid point that belongs to the rigid body. The forces and moments
acting on the grid points will be accumulated and applied to the rigid body.
7. If no constraints are specified for the rigid material (CMO=0) the nodes belonging to the rigid
material are scanned to determine constraints of the rigid material in global directions. If
constraints are specified for the rigid material (CMO equal to +1 or –1), the nodes belonging to
the rigid material are not scanned
Materials 43
Materials
8. Constraint directions for rigid materials (CMO equal to +1 or –1) are fixed, that is, not updated,
with time.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SEATBELT
This material model is used to define the stretch characteristics and mass properties for seat belts.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
MPUL Mass per unit length
LLCID Load curve Id for loading (Force vs. engineering strain)
ULCID Load curve Id for unloading (Force vs. engineering strain)
LMIN Minimum length for elements connected to slip rings and retractors
Remarks:
1. The Load curves for loading and unloading should start at the origin (0, 0), and contain positive
force and strain values only. The belt material is tension only, with zero forces being calculated
whenever the strain becomes negative (compressive). The first nonzero point on the loading curve
defines the initial yield point of the material. On unloading, the unloading curve is shifted along
the strain axis until it crosses the loading curve at the yield point from which unloading starts. If
the initial yield has not yet exceeded, or the origin of the (shifted) unloading curve is at negative
strain, the original loading curve will be used for both loading and unloading. If the strain is less
than the strain at the origin of the unloading curve, the belt is slack, and no force is generated.
Otherwise, forces will be determined by the unloading curve for unloading, and reloading until
the strain again exceeds yield after which the loading curve will again be used.
44
Materials
2. A small amount of damping is automatically included, to reduce high frequency oscillation. The
damping force, D opposes the relative motion of the nodes, and is limited by stability:
D = (0.1 X Mass X Relative velocity)/(Time step size)
The magnitude of the damping force is limited to one-tenth of the force calculated from the force
vs. strain relationship, and is zero when the belt is slack. Damping forces are not applied to
elements attached to slip rings and retractors.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SOIL_AND_FOAM
This simple material model works similar to fluid. It should be used only in situations when soils and
foams are confined within a structure or when geometric boundaries are present.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear modulus
BULK Bulk modulus for unloading
A0, A1, A2 Yield function constants
PC Pressure cut off for tensile fracture
VCR Volumetric crushing option:
0.0: on,
Field Comments
REF use reference geometry to initialize the pressure
LCID Load curve Id defining pressure vs. volumetric strain
Remarks:
1. Pressure is positive in compression
2. Volumetric strain is given by the natural log of the relative volume and is negative in compression
3. Relative volume is the ratio of current volume to the initial volume at the start of the calculation
4. If the pressure drops below the cutoff value specified, it is reset to that value
See Also:
• LS-DYNA Keyword User’s Manual
MAT_VISCOELASTIC
This material model is used to define viscoelastic behavior for beams (Hughes-Liu), shells, and solids
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
BULK Bulk modulus for unloading
G0 Short time shear modulus
GI long time (Infinite) Shear modulus
BETA Decay constant
Remarks:
1. The shear relaxation behavior is described by [Hermann and Peterson, 1968]:
– βt
G ( t ) = GI + ( G0 – GI )e
46
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_HIGH_EXPLOSIVE_BURN
This material model is used to input the detonation properties of high explosive materials.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
D Detonation Velocity
PCJ Chapman-Jouget pressure
BETA Beta burn flag
See Also:
• LS-DYNA Keyword User’s Manual
Materials 47
Materials
MAT_NULL
The use of this material model allows equations of state without computing deviatoric stresses.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
PC Pressure Cutoff
MU Dynamic Viscosity Coefficient
TEROD Relative Volume for Erosion in Tension
CEROD Relative Volume for Erosion in Compression
YM Young’s Modulus (used for null beams and shells only)
PR Poisson’s ratio (used for nul beams and shells only)
See Also:
• LS-DYNA Keyword User’s Manual
48
Materials
MAT_ELASTIC_PLASTIC_HYDRO
This material model is used to model an elastic-plastic hydrodynamic material.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
SIGY Yield Stress
EH Plastic hardening modulus
PC Pressure Cutoff
FS Failure strain for Erosion
LCID Load curve Id defining pressure vs. volumetric strain
See Also:
• LS-DYNA Keyword User’s Manual
Materials 49
Materials
MAT_ELASTIC_PLASTIC_HYDRO_SPALL
This material model is used to model an elastic-plastic hydrodynamic material with spall to represent
splitting, cracking, and failure under tensile loads.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
SIGY Yield Stress
EH Plastic hardening modulus
PC Pressure Cutoff
FS Failure strain for Erosion
A1 Linear Pressure Hardening Coefficient
A2 Quadratic Pressure Hardening Coefficient
SPALL Spall Type
LCID Load curve Id defining pressure vs. volumetric strain
See Also:
• LS-DYNA Keyword User’s Manual
50
Materials
MAT_STEINBERG
This material model is used to model materials deforming at very high strain rate for use with solid
elements. The yield strength is a function of temperature and pressure.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G0 Basic shear modulus
SIG0 Yield Stress, σ0
BETA Parameter β, used in the equation defining Yield Strength
N Parameter n, used in the equation defininig Yield Strength
GAMA Initial Plastic Strain γi
SIGM σm
B Parameter b, used in the equation defininig Yield Strength
BP Parameter b' , used in the equation defininig Yield Strength
H Parameter h, used in the equation defininig Yield Strength
F Parameter b, used in the equation defininig Yield Strength
A Atomic Weight
TM0 Melting Temperature
Materials 51
Materials
Field Comments
GAM0 Yield Stress equation Parameter, Gama_0
SA Melting Temperature equation Parameter, a
PC Pressure Cutoff
SPALL Spall Type
1: P >= PC
2: if σmax >= -PC, element spalls and tension, p < 0, is never allowed
See Also:
• LS-DYNA Keyword User’s Manual
52
Materials
MAT_STEINBERG_LUND
This material model is used to input the properties of a Steinberg and Lund [1999].material model for
including the strain rate effect.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G0 Basic shear modulus
SIG0 Yield Stress, σ0
BETA Parameter β, used in the equation defininig Yield Strength
N Parameter n, used in the equation defininig Yield Strength
GAMA Initial Plastic Strain γi
SIGM σm
B Parameter b, used in the equation defininig Yield Strength
BP Parameter b' , used in the equation defininig Yield Strength
H Parameter h, used in the equation defininig Yield Strength
F Parameter b, used in the equation defininig Yield Strength
Materials 53
Materials
Field Comments
A Atomic Weight
TM0 Melting Temperature
GAM0 Yield Stress equation Parameter, Gama_0
SA Melting Temperature equation Parameter, a
PC Pressure Cutoff
SPALL Spall Type
1: P >= PC
2: if σmax >= -PC, element spalls and tension, p < 0, is never allowed
See Also:
• LS-DYNA Keyword User’s Manual
54
Materials
MAT_ISOTROPIC_ELASTIC_FAILURE
This material model is used to define the properties of a non-iterative plasticity model with simple plastic
strain failure criteria.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
SIGY Yield Stress
ETAN Plastic Hardening Modulus
BULK Bulk Modulus
EPF Plastic Failure Strain
PRF Failure Pressure
REM Element Erosion option
0: Eroded at failure
0: Δt is not considered
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SOIL_AND_FOAM_FAILURE
This material model is used to define the material properties for a soil and foam model. This material
model works similar to fluid, and should be used only in situations when soils and foams are confined
within a structure or when geometric boundaries are present.In this material model, the material loses its
ability to carry tension when the pressure exceeds the failure pressure.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
BULK Bulk Modulus for unloading
A0, A1, A2 Plastic Yield Function Constants
PC Pressure Cutoff for Tensile Fracture
VCR Volumetric Crushing Option
0: On
Field Comments
REF Use reference geometry to initialize pressure
0: Off
1:On
LCID Load Curve Id defining pressure vs. volumetric strain
See Also:
• LS-DYNA Keyword User’s Manual
MAT_JOHNSON_COOK
The Johnson-Cook material model is a strain and temperature sensitive plasticity model. It is sometimes
used for materials with a large variation in the strain rate, and/or undergoing softening due to plastic
heating.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
Materials 57
Materials
Field Comments
E Young’s Modulus (for shell elements only)
PR Poisson’s Ratio (for shell elements only)
DTF Minimum Time step for Automatic Shell Element Deletion
VP Formulation for Rate Effects
1: ViscoPlastic Formulation
RATEOP Optional forms of strain-rate term:
1: P >= PC
2: if σmax >= -PC, element spalls and tension, p < 0, is never allowed
0: No Iteration
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PSEUDO_TENSOR
This material model is used to define the properties a pseudo-tensor material model. This has been used
to analyze buried steel reinforced concrete structures subjected to impulsive loadings.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
PR Poisson’s Ratio
SIGF Tension Cutoff (Maximum Principal Stress at failure)
A0 Cohesion
A1, A2 Pressure Hardening Coefficients
A0F Cohesion for failed material
A1F Pressure hardening coefficient for failed material
B1 Damage Scaling Factor
PER Percent Reinforcement
Materials 59
Materials
Field Comments
ER Young’s Modulus for Reinforcement
PRR Poisson’s Ratio for Reinforcement
SIGY Initial Yield Stress
ETAN Tangent Modulus/Plastic Hardening Modulus
LCP Load Curve Id defining rate sensitivity for principal material
LCR Load Curve Id defining rate sensitivity for reinforcement
LCID Load Curve defining Yield Stress (or scale factor) vs. effective plastic
strains, damages, or pressures
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ORIENTED_CRACK
Defines the properties of brittle materials failing due to large tensile stresses.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Plastic Hardening Modulus
FS Fracture Stress
PRF Fracture Pressure
60
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_STRAIN_RATE_DEPENDENT_PLASTICITY
Defines the properties of a strain rate dependent material.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
VP Formulation for Rate Effects
1: Viscoplastic Formulation
LC1 Load Curve Id for Yield Stress σ0 vs. effective strain rate
ETAN Tangent Modulus
LC2 Load Curve Id for Young’s Modulus vs. effective strain rate
LC3 Load Curve Id for Tangent Modulus vs. effective strain rate
LC4 Load Curve Id for von Mises stress at failure vs. effective strain rate
TDEL Time Step Size for Automatic Element Deletion (shell elements only)
RDEF Redefinition of failure curve
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ORTHOTROPIC_THERMAL
Defines the properties of a linear elastic material with temperature dependent orthotropic properties.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA, EB, EC Young’s Moduli in the A, B and C direction
PRBA, PRCA, PRCB Poisson’s Ratio in the ba, ca and cb directions
GAB, GBC, GCA Shear Moduli in the ab, bc and ca directions
AA, AB, AC Coefficients of Thermal Expansion in the a, b, and c directions
62
Materials
Field Comments
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 63
Materials
MAT_COMPOSITE_DAMAGE
Defines the properties of an orthrotropic material with optional brittle failure for composites.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA, EB, EC Young’s Moduli in the A, B and C direction
PRBA, PRCA, PRCB Poisson’s Ratio in the ba, ca and cb directions
GAB, GBC, GCA Shear Moduli in the ab, bc and ca directions
KF Bulk Modulus of failed material
64
Materials
Field Comments
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 65
Materials
MAT_TEMPERATURE_DEPENDENT_ORTHOTROPIC
Defines the properties of an orthotropic elastic material with arbitrary temperature dependency.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
66
Materials
Field Comments
AOPT Material Axes option
Field Comments
AA_LC, AB_LC, Load curves defining Coefficients of Thermal Expansion in the a, b, and c
AC_LC directions, respectively, vs. Temperature
GAB_LC Load curve defining Shear modulus in the ab plane vs. Temperature
GBC_LC Load curve defining Shear modulus in the bc plane vs. Temperature
GCA_LC Load curve defining Shear modulus in the ca plane vs. Temperature
See Also:
• LS-DYNA Keyword User’s Manual
MAT_GEOLOGIC_CAP_MODEL
Defines the properties for geomechanical problems or materials like concrete.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
BULK Initial Bulk Modulus
G Initial Shear Modulus
ALPHA Failure Envelope Parameter
THETA Failure Envelope Linear coefficient
GAMMA Failure Envelope Exponential coefficient
BETA Failure Envelope Exponent
R Cap, surface axis ratio
68
Materials
Field Comments
D Hardening law exponent
W Hardening law coefficient
X0 Hardening Law Exponent
C Kinematic Hardening Coefficient
N Kinematic Hardening Parameter
PLOT Plotting Flag for LS-Taurus
FTYPE Formulation Flag
1: Soil or concrete
2: Rock
VEC Vectorization Flag
1: Fully Iterative
TOFF Tension Cutoff
See Also:
• LS-DYNA Keyword User’s Manual
Materials 69
Materials
MAT_HONEYCOMB
Defines the properties for honeycomb and foam materials with real anisotropic behavior.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress for fully compacted Honeycomb
VF Relative Volume at which Honeycomb is fully compacted
MU Material Viscosity Coefficient
BULK Bulk Viscosity Flag
Field Comments
LCC Load Curve Id for (Sigma_cc vs. either Relative Volume or Volumetric
Strain (Default LCC = LCA)
LCS Load Curve Id for (shear stress vs. either Relative Volume or Volumetric
Strain (Default LCS = LCA)
LCAB Load Curve Id for (Sigma_ab vs. either Relative Volume or Volumetric
Strain (Default LCAB = LCS)
LCBC Load Curve Id for (Sigma_bc vs. either Relative Volume or Volumetric
Strain (Default LCBC = LCS)
LCCA Load Curve Id for (Sigma_ca vs. either Relative Volume or Volumetric
Strain (Default LCCA = LCS)
LCSR Load Curve Id for strain rate effects defining the scale factor vs. strain rate.
The curves defined above are scaled using this curve.
EAAU, EBBU, ECCU Elastic Moduli in uncompressed configuration in aa, bb, and cc directions
GABU, GBCU, GCAU Shear Moduli in uncompressed configuration in ab, bc, and ca planes
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 71
Materials
MAT_RESULTANT_PLASTICITY
Defines a resultant formulation material model, including elastoplastic behavior.for beam and shell
elements,
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Plastic Hardening Modulus (shell elements only)
See Also:
• LS-DYNA Keyword User’s Manual
72
Materials
MAT_FORCE_LIMITED
This material model allows the simulation of plastic hinge formation at the ends of a beam, using a curve
definition (for Belytschko-Schwer beam only).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
DF Damping Factor
AOPT Axial Load Curve Option
Field Comments
LPSi Load Curve Id for plastic moment vs. rotation about s-axis at node i
SFSi Scale factor, plastic moment vs. rotation about s- axis at node i
YMSi Yield moment about s- axis at node i for interaction calculations
LPTi Load Curve Id for plastic moment vs. rotation about t-axis at node i
SFTi Scale factor, plastic moment vs. rotation about t- axis at node i
YMTi Yield moment about t- axis at node i for interaction calculations
LPR Load Curve Id for plastic torsional moment vs. rotation
SFR Scale factor for plastic torsional moment vs. rotation
YMR Torsional yield moment for interaction calculations
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SHAPE_MEMORY
Defines the superplastic response present in shape memory alloys (SMA).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIG_ASS Starting value for the forward phase transformation
74
Materials
Field Comments
SIG_ASF Final value for the forward phase transformation
SIG_SAS Starting value for the reverse phase transformations
SIG_SAF Final value for the reverse phase transformation
EPSL Recoverable strain or maximum residual strain
ALPHA Parameter Measuring the difference between material response in tension
and compression
YMRT Young’s Modulus for Martensite
LC_ASS Load Curve Id for Starting value of forward phase transformation
LC_ASF Load Curve Id for Final value of forward phase transformation
LC_SAS Load Curve Id for Starting value of reverse phase transformations
LC_SAF Load Curve Id for Final value of reverse phase transformation
See Also:
• LS-DYNA Keyword User’s Manual
MAT_FRAZER_NASH_RUBBER_MODEL
Defines rubber from uniaxial test data.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
Materials 75
Materials
Field Comments
RO Mass Density of the material
PR Poisson’s Ratio
C100, C200, C300, Strain Energy Parameters
C400, C110, C210,
C010, C020
EXIT Exit option of strain limit
0: Off
1: On
SGL Specimen Gauge Length
SW Specimen Width
ST Specimen Thickness
LCID Load Curve Id defining Force vs. Actual Change in gauge Length
See Also:
• LS-DYNA Keyword User’s Manual
76
Materials
MAT_LAMINATED_GLASS
Defines layered glass including polymeric layers.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EG Young’s Modulus for Glass
PRG Poisson’s Ratio for Glass
SYG Yield Strength for Glass
ETG Plastic Hardening Modulus for Glass
EFG Plastic Strain at Failure for Glass
EP Young’s Modulus for Polymer
PRP Poisson’s Ratio for Polymer
SYP Yield Strength for Polymer
ETP Plastic Hardening Modulus for Polymer
NUM_RFS Number of Integration Points of Material
F1, F2,, ..., FN Integration Point Material
Fi = 0: glass; Fi = 1: polymer
Materials 77
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_BARLAT_ANISOTROPIC_PLASTICITY
Defines the properties of an anisotropic material behavior during forming processes.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
K Strength Coefficient
E0 Strain corresponding to initial yield
N Hardening exponent for yield strength
M Flow potential exponent in Barlat’s model
A, B, C, F, G, H Anisotropic Coefficients in Barlat’s model
LCID Load Curve Id defining effective Stress vs. effective Plastic Strain
78
Materials
Field Comments
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 79
Materials
MAT_BARLAT_YLD96
Defines the properties of an anisotropic material behavior during forming processes, especially for
aluminum alloys (only for shell elements only).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
K Strength Coefficient
E0 Strain corresponding to initial yield
N Hardening exponent for yield strength
ESRO εSRO, in power law rate sensitivity
M Exponent, m for strain rate effects
80
Materials
Field Comments
HARD Hardening option
1:Powerlaw
2: Voce
A Flow Potential Exponent
Ci Equation parameters
AX Equation parameter
AY Equation Parameter
AZ0 Equation Parameter
AZ1 Equation Parameter
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 81
Materials
MAT_FABRIC
Defines the properties for airbag materials.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus, Longitudinal Direction
EB Young’s Modulus, Transverse Direction
EC Young’s Modulus, Normal Direction
PRBA, PRCA, PRCB Poisson’s Ratio in ba, ca, and cb directions
GAB, GBC, BCA Shear Moduli in ab., bc, and ca directions
82
Materials
Field Comments
CSE Compressive Stress Elimination Option
0: Don’t Eliminate
1: Eliminate
EL Young’s Modulus for Elastic Liner
PRL Poisson’s Ratio for Elastic Liner
LRATIO Ratio of linear thickness to total fabric thickness
DAMP Rayleigh Damping Coefficient
AOPT Material Axes option
0: Off
1:On
Materials 83
Materials
Field Comments
FORM Flag to modify Membrane Formulation for fabric material:
0: default
Field Comments
LC_FAC Load Curve Id for Fabric Area Coefficient
LC_ELA Load Curve Id for Effective Leakage Area for blocked fabric
LC_TSR Load Curve Id for Tensile Stress Cutoff Reduction factor vs. Time
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PLASTIC_GREEN-NAGHDI_RATE
This model is available for brick elements only. It is similar to MAT_PLASTIC_KINEMATIC, but uses
the Green-Naghdi Rate formulation for the stress update.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Strength
ETAN Plastic Hardening Modulus
SRC Strain Rate Parameter
SRP Strain Rate Parameter
BETA Hardening Parameter
See Also:
• LS-DYNA Keyword User’s Manual
Materials 85
Materials
MAT_3-PARAMETER_BARLAT
This material model is designed for modeling sheets with anisotropic materials under plane stress
conditions.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
HR Hardening Rule
1: Linear
2: Exponential
3: Load Curve
P1, P2 Material Parameters
86
Materials
Field Comments
ITER Iteration Flag
0: Fully iterative
1: Fixed to 3 iterations
M Exponent in Barlat’s yield surface
R00, R45, R90 Lankford Parameters
LCID Load Curve Id for hardening rule
Epsilon_0 ε0 for determining initial yield stress for exponential hardening
SPI Parameter to redefine ε0
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 87
Materials
MAT_TRANS_ANISO_ELASPLASTIC
Simulates sheet forming processes with anisotropic material. Only transverse anisotropy can be
considered.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Plastic Hardening Modulus
R Anisotropic Hardening Parameter
HLCID Load Curve Id for Effective Yield Stress vs. Effective Plastic Strain
See Also:
• LS-DYNA Keyword User’s Manual
88
Materials
MAT_TRANS_ANISO_ELASPLASTIC_ECHANGE
Simulates sheet forming processes with anisotropic material. Only transverse anisotropy can be
considered.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Plastic Hardening Modulus
R Anisotropic Hardening Parameter
HLCID Load Curve Id for Effective Yield Stress vs. Effective Plastic Strain
IDSCALE Load curve Id defining the scale factor for Young’s modulus change with
respect to effective strain. Note: if EA, and COE are defined, this curve is
not necessary.
EA, COE Coefficients (EA and ζ) defining Young’s modulus with respect to the
effective strain. Note: if EA, and COE are defined, this curve is not
necessary.
See Also:
• LS-DYNA Keyword User’s Manual
Materials 89
Materials
MAT_BLATZ-KO_FOAM
Defines the properties for rubber like foams of polyurethane. It is a simple one parameter model with a
fixed Poisson’s ratio of 0.25.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
REF Use Reference Geometry to initialize stress tensor
See Also:
• LS-DYNA Keyword User’s Manual
90
Materials
MAT_FLD_TRANSVERSELY_ANISOTROPIC
Simulates sheet forming processes with anisotropic material. Only transverse anisotropy can be
considered.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Plastic Hardening Modulus
R Anisotropic Hardening Modulus
HLCID Load Curve Id defining Effective Yield Stress vs. Effective Plastic Strain
LCIDFLD Load Curve Id defining the Forming Limit Diagram (major vs. minor
strain)
See Also:
• LS-DYNA Keyword User’s Manual
Materials 91
Materials
MAT_NONLINEAR_ORTHOTROPIC
Defines an orthotropic nonlinear elastic material based on a finite strain formulation with initial geometry
as the reference. Optional failure and stiffness properties are available.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EAA, EBB, ECC Young’s Modulus in the A, B and C directions
PRBA, PRCA, PRCB Poisson’s Ratio in the ba, ca and cb directions
GAB, GBC, GCA Shear Modulus in the ab, bc and ca directions
DT Temperature increment for stress stabilization
TRAMP Time to ramp up to the final temperature
ALPHA Thermal expansion coefficient
LCIDA, LCIDB, LCIDC Load Curve Id for nominal stress vs. nominal strain in the a- , b-, and c-axes
EFAIL Failure Strain
92
Materials
Field Comments
DTFAIL Timestep size criteria for element erosion
CDAMP Damping Coefficient
AOPT Material Axes option
LCIDAB, LCIDBC, Load Curve Id for nominal shear stress vs. nominal shear strain in the ab,
LCIDCA bc, and ca plane
See Also:
• LS-DYNA Keyword User’s Manual
Materials 93
Materials
MAT_BAMMAN
Defines a material with temperature and rate dependent plasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
T Initial Temperature
HC Heat Generation Coefficient
Ci Input parameters
Ai Initial value of state variable i
KAPPA Initial value of internal state variable 6 (κ)
See Also:
• LS-DYNA Keyword User’s Manual
94
Materials
MAT_BAMMAN_DAMAGE
Defines a material with temperature and rate dependent plasticity including damage in the modeling.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
T Initial Temperature
HC Heat Generation Coefficient
Ci Input parameter
Ai Initial value of state variable i
N Exponent in damage evaluation
D0 Initial Damage (porosity)
FS Failure Strain for Erosion
Materials 95
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_CLOSED_CELL_FOAM
Defines a low density, closed polyurethane foam for simulating impact limiters in automotive
applications.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
A, B, C Factors a, b, and c for Yield Stress definition
P0 Initial Foam Pressure
PHI Ratio of Foam to Polymer Density
GAMA0 Initial Volumetric Strain
LCID Load Curve Id defining vonMises Stress vs. Volumetric Strain
See Also:
• LS-DYNA Keyword User’s Manual
96
Materials
MAT_ENHANCED_COMPOSITE_DAMAGE
Defines the properties of an orthrotropic material with optional brittle failure for composites. This is an
enhanced version of MAT_COMPOSITE_DAMAGE (MAT_022).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus, Longitudinal Direction
EB Young’s Modulus, Transverse Direction
EC Young’s Modulus, Normal Direction (NOT used)
PRBA, PRCA, PRCB Poisson’s Ratio in the ba, ca, and cb planes (PRCA, PRCB NOT used)
GAB, GBC, GCA Shear Modulus in the ab, bc, and ca planes
KF Bulk Modulus of failed material (NOT used)
Materials 97
Materials
Field Comments
AOPT Material Axes option
Field Comments
CRIT Failure Criteria (Material Number)
See Also:
• LS-DYNA Keyword User’s Manual
Materials 99
Materials
MAT_LAMINATED_COMPOSITE_FABRIC
Defines a composite material with unidirectional layers, complete laminates and woven fabrics (for shell
elements only).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus, Longitudinal Direction
EB Young’s Modulus, Transverse Direction
EC Young’s Modulus, Normal Direction (NOT used)
PRBA Poisson’s Ratio in BA direction
100
Materials
Field Comments
TAU1 Stress limit of first slightly nonlinear part of Shear Stress vs. Shear Strain
curve
GAMMA1 Strain limit of first slightly nonlinear part of Shear Stress vs. Shear Strain
curve
SLIMT1 Factor to determine the minimum Stress Limit after Stress Maximum (fiber
Tension)
SLIMC1 Factor to determine the minimum Stress Limit after Stress Maximum (fiber
Compression)
SLIMS Factor to determine the minimum Stress Limit after Stress Maximum
(Shear)
AOPT Material Axes option
1: Smooth surface Failure with Quadratic criteria for both fiber and
transverse directions
Field Comments
ZP Z-coordinate of point p for AOPT=1
Ai Component of Vector a, for AOPT=2
Vi Component of Vector v, for AOPT=3
Di Component of Vector d, for AOPT=2
BETA Material Angle (Degrees), for AOPT=3
E11C Strain at Longitudinal Compression Strength, a-axis
E11T Strain at Longitudinal Tensile Strength, a-axis
E22C Strain at Transverse Compression Strength, b-axis
E22T Strain at Transverse Tensile Strength, b-axis
GMS Strain at Shear Strength, ab plane
XC Longitudinal Compression Strength
XT Longitudinal Tensile Strength
YC Transverse Compression Strength, b-axis
YT Transverse Tensile Strength, b-axis
SC Shear Strength, ab plane
See Also:
• LS-DYNA Keyword User’s Manual
102
Materials
MAT_COMPOSITE_FAILURE_SHELL_MODEL
Defines the properties of a composite material with failure properties (for shell elements only).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus, Longitudinal Direction
EB Young’s Modulus, Transverse Direction
EC Young’s Modulus, Normal Direction
PRBA, PRCA< PRCB Poisson’s Ratio in ba, ca and cb directions
GAB, GBC, GCA Shear Moduli in ab, bc and ca directions
KF Bulk Modulus of failed material
Materials 103
Materials
Field Comments
AOPT 0: Locally orthotropic with material axes determined by element nodes 1,
2, and 4. (Node 1 is the local origin, Node 2 is along the local a- axis; Local
c-axis is the cross product of local a-axis, and the vector from node 1 to
node 4; Local b- axis is the cross product of loca c- and a- axes.)
See Also:
• LS-DYNA Keyword User’s Manual
104
Materials
MAT_COMPOSITE_FAILURE_SOLID_MODEL
Defines the properties of a composite material with failure properties (for solid elements only).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus, Longitudinal Direction
EB Young’s Modulus, Transverse Direction
EC Young’s Modulus, Normal Direction
PRBA, PRCA< PRCB Poisson’s Ratio in ba, ca and cb directions
GAB, GBC, GCA Shear Moduli in ab, bc and ca directions
KF Bulk Modulus of failed material
Materials 105
Materials
Field Comments
AOPT Material Axes option
1: Default
Field Comments
ZZC Normal Compression Strength, c-axis
XXT Longitudinal Tensile Strength, x-axis
YYT Transverse Tensile Strength, b-axis
ZZT Normal Tensile Strength, c-axis
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_WITH_VISCOSITY
Simulates the forming of glass products at high temperatures.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
Materials 107
Materials
Field Comments
RO Mass Density of the material
V0
A, B, C Viscosity coefficients
LCID Load Curve Id defining factor for viscosity vs. temperature
PRi
Ti Temperatures
Vi Corresponding Viscosity coefficients
Ei Corresponding Young’s moduli coefficients
ALPHAi Corresponding thermal expansion coefficients
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_WITH_VISCOSITY_CURVE
Simulates the forming of glass products at high temperatures.Load curves are used to represent the
temperature dependence of Poisson’s ratio, Young’s modulus, the coefficient of thermal expansion, and
the viscosity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
V0
108
Materials
Field Comments
A, B, C Viscosity coefficients
LCID Load Curve Id defining factor for viscosity vs. temperature
PR_LC Load curve defining Poisson’s ratio as a function of temperature
YM_LC Load curve defining Young’s modulus as a function of temperature
A_LC Load curve defining the coefficient of thermal expansion as a function of
temperature
V_LC Load curve defining the viscosity as a function of temperature
V_LOG Falg for the form of V_LC. If V_LOg =1, the value specified in V_LC is
the natural logarithm of the viscosity. If V_LOg =0, the value is the
viscosity.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_KELVIN-MAXWELL_VISCOELASTIC
A classic Kelvin-Maxwell material model for modeling viscoelastic bodies, like foams.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
BULK Bulk Modulus (elastic)
GO Short time Shear Modulus
GI Long time Shear Modulus
DC Maxwell decay constant or Kelvin relaxation constant
Materials 109
Materials
Field Comments
FO Formulation option
0: Maxwell
1: Kelvin
SO Strain output option
See Also:
• LS-DYNA Keyword User’s Manual
MAT_VISCOUS_FOAM
A material to represent the Confor Foam on the ribs of EuroSID side impact dummy (valid only for solid
elements under compressive load).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E1 Initial Young’s Modulus
N1 Exponent in power law for Young’s Modulus
V2 Viscous Coefficient
E2 Elastic Modulus for viscosity
110
Materials
Field Comments
N2 Exponent in power law for viscosity
PR Poisson’s Ratio
See Also:
• LS-DYNA Keyword User’s Manual
MAT_CRUSHABLE_FOAM
A material model for modeling crushable foam with optional damping and tension cutoff.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
LCID Load Curve Id defining Yield Stress vs. Volumetric Strain
TSC Tensile Stress Cutoff
DAMP Rate sensitivity via damping coefficient
See Also:
• LS-DYNA Keyword User’s Manual
Materials 111
Materials
MAT_RATE_SENSITIVE_POWERLAW_PLASTICITY
A strain rate sensitive elasto-plastic material model with a power law hardening.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
K Material Constant
M Strain Hardening Coefficient
N Strain Rate Sensitivity Coefficient
E0 Initial Strain Rate
VP Formulation for Rate Effects
1: ViscoPlastic Formulation
EPSO Factor to Normalize Strain (Time Units)
1: Seconds
1e-006 : Milliseconds
1e-006 : Microseconds
112
Materials
Field Comments
LCID_K Load Curve Id defining material constant K vs. Effective Plastic Strain
LCID_M Load Curve Id defining material constant M vs. Effective Plastic Strain
LCID_N Load Curve Id defining material constant N vs. Effective Plastic Strain
See Also:
• LS-DYNA Keyword User’s Manual
MAT_MODIFIED_ZERILLI_ARMSTRONG
A rate and temperature sensitive plasticity material model, sometimes used in ordinance design
calculations.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
E0 Factor to normalize strain rate
N Exponent for bcc metal
TROOM Room Temperature
PC Pressure Cutoff
Materials 113
Materials
Field Comments
SPALL Spall Type
1: ViscoPlastic Formulation
Bi Coefficients for polynomial representation of temperature dependency of
flow stress yield
Gi Coefficient for defining Heat Capacity and temperature dependency of
Heat Capacity
BULK Bulk Modulus (for shell elements only)
See Also:
• LS-DYNA Keyword User’s Manual
114
Materials
MAT_LINEAR_ELASTIC_DISCRETE_BEAM
A material model for linear elastic beams by using six springs each acting along one of its six degrees of
freedom. The two nodes that define the beam can be coincident to give a zero length beam, or offset to
give a finite length beam.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TKR, TKS, TKT Translational Stiffness along local ar-, s-, and t- axes respectively
RKR, RKS, RKT Rotational Stiffness about local r-, s-, and t- axes respectively
TDR, TDS, TDT Translational viscous damping along local r-, s-, and t- axes respectively
RDR, RDS, RDT Rotational viscous damping about local r-, s-, and t- axes respectively
FOR, FOS, FOT Pre-load forces in r-, s- and t-directions repectively (optional)
MOR, MOS, MOT Pre-load moments in r-, s- and t-directions repectively (optional)
See Also:
• LS-DYNA Keyword User’s Manual
Materials 115
Materials
MAT_NONLINEAR_ELASTIC_DISCRETE_BEAM
A material model for nonlinear elastic and nonlinear viscous beams by using six springs each acting
along one of its six degrees of freedom. The two nodes that define the beam can be coincident to give a
zero length beam, or offset to give a finite length beam.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
LCIDTR, LCIDTS, Load Curve Id defining Translational Force along the r-, s-, and t- axes vs.
LCIDTT Translational Displacement
LCIDRR, LCIDRS, Load Curve Id defining Rotational Moment about the r-, s-, and t- axes vs.
LCIDRT Rotational Displacement
LCIDTDR, LCIDTDS, Load Curve Id defining Translational Damping Force along the r-, s-, and
LCIDTDT t- axes vs. Translational Velocity
LCIDRDR, LCIDRDS, Load Curve Id defining Rotational Damping Force the r-, s-, and t- axes
LCIDRDT axis vs. Rotational Velocity
FOR, FOS, FOT Pre-load forces in r-, s- and t-directions repectively (optional)
MOR, MOS, MOT Pre-load moments in r-, s- and t-directions repectively (optional)
See Also:
• LS-DYNA Keyword User’s Manual
116
Materials
MAT_NONLINEAR_PLASTIC_DISCRETE_BEAM
A a material model for nonlinear elastoplastic, linear viscous behavior of beams by using six springs each
acting along one of its six degrees of freedom. The two nodes that define the beam can be coincident to
give a zero length beam, or offset to give a finite length beam.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TKR, TKS, TKT Translational Stiffness along local r-, s-, and t- axes respectively
RKR, RKS, RKT Rotational Stiffness about local r-, s-, and t- axes respectively
TDR, TDS, TDT Translational viscous damping along local r-, s-, and t- axes respectively
RDR, RDS, RDT Rotational viscous damping about local r-, s-, and t- axes respectively
LCPDR, LCPDS, Load Curve Id for Yield Force vs. Plastic Displacement along local r-, s-,
LCPDT and t- axes respectively
LCPMR, LCPMS, Load Curve Id for Yield Moment vs. Plastic Rotation about local r-, s-, and
LCPMT t- axes respectively
Materials 117
Materials
Field Comments
FFAILR, FAILS, FAILT Failure Parameters corresponding to Force Fr, Fs, Ft
MFAILR, MFAILS, Failure Parameters corresponding to Moment Mr, Ms, Mt
MFAILT
UFAILR, UFAILS, Failure Parameters corresponding to Displacement Ur, Us, Ut
UFAILT
TFAILR, TFAILS, Failure Parameters corresponding to Rotation θr, θs, θt
TFAILT
FOR, FOS, FOT Pre-load forces in r-, s- and t-directions repectively (optional)
MOR, MOS, MOT Pre-load moments in r-, s- and t-directions repectively (optional)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SID_DAMPER_DISCRETE_BEAM
A material model for side impact dummy, using a damper that is not adequately taken care of by the
nonlinear force versus relative velocity curves.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
118
Materials
Field Comments
RO Mass Density of the material
ST Piston Stroke
D Piston Diameter
R Orifice Radius
H Orifice Controller Position
K Damping Constant
C Discharge Coefficient
C3 Coefficient for fluid inertia term
STF Stiffness Coefficient (piston bottom out)
RHOF Fluid Density
C1 Coefficient of linear velocity term
C2 Coefficient of quadratic velocity term
LCIDF Load Curve Id defining Force vs. Piston Displacement
LCIDD Load Curve Id defining Damping Coefficient vs. Piston Displacement
S0 Initial Displacement
NUM_RFS Number of Orifice Location
ORFLOCi Orifice Location of the i-th orifice, relative to the fix end
ORFRADi Orifice Radius of the i-th orifice
SFi Scale factor on calculated force for the i-th orifice
DCi Linear viscous damping coefficient (after damper bottoms out in tension or
compression) for the i-th orifice
See Also:
• LS-DYNA Keyword User’s Manual
Materials 119
Materials
MAT_HYDRAULIC_GAS_DAMPER_DISCRETE_BEAM
A special element that represents a combined hydraulic and gas-filled damper with a variable orifice
coefficient. This material can only be used as a discrete beam element.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
C0 Length of Gas Column
N Adiabatic constant
P0 Initial gas Pressure
PA Atmospheric Pressure
AP Piston Cross-Section Area
KH Hydraulic Constant
LCID Load Curve Id Defining Orifice Area vs. Element Deletion
FR Return factor on orifice force
SCLF Scale factor on Force
CLEAR Clearance
See Also:
• LS-DYNA Keyword User’s Manual
120
Materials
MAT_CONCRETE_DAMAGE
A material model for analyzing buried steel reinforced concrete structure with impulsive loading.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGF Maximum principal Stress at Failure
A0, A0Y Cohesion and Cohesion for Yield
Materials 121
Materials
Field Comments
A1, A2 Pressure Hardening Coefficients
A1Y, A2Y Pressure Hardening Coefficients for yield limit
A1F, A2F Pressure Hardening Coefficients Failed Material)
B1 Damage Scaling Factor
B2 Damage Scaling Facto for uniaxial tensile path
B3 Damage Scaling Facto for triaxial tensile path
PER Percent Reinforcement
ER Young’s Modulus for Reinforcement
PRR Poisson’s Ration for Reinforcement
SIGY Initial Yield Stress
ETAN Tangent Modulus/Plastic hardening Modulus
LCP Load Curve Id giving rate sensitivity for principal material
LCR Load Curve Id giving rate sensitivity for reinforcement
LAMBDAi Tabulated Damage functions
ETAi Tabulated Scale Factors
See Also:
• LS-DYNA Keyword User’s Manual
122
Materials
MAT_LOW_DENSITY_VISCOUS_FOAM
A material model for low density urethane foam with high compressibility, and with rate sensitivity
characterized by a relaxation curve.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
LCID Load Curve Id for nominal Stress vs. Strain
TC Tension Cutoff Stress
HU Hysteretic Unloading Factor between 0 to 1
BETA Decay constant to model creep in unloading
DAMP Viscous coefficient
SHAPE Shape factor for unloading
FAIL Failure Option after Cutoff Stress
Field Comments
BVFLAG Bulk Viscosity activation Flag
0: No
1: Active
KCON Stiffness coefficient for contact interface stiffness
LCID2 Load Curve Id of relaxation curve
BSTART Fit Parameter
TRAMP Optional ramp time for loading
NV Number of terms in fit
NUM_RFS Number of viscoelastic constants
GI1 Optional relaxation modulus for rate effect
BETAI1 Optional decay constant
REF Use Reference Geometry to initialize stress tensor
0: Off
1: On
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_SPRING_DISCRETE_BEAM
A model for elastic springs with damping to be combined and represented with a discrete beam element.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
124
Materials
Field Comments
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
K Elastic loading and unloading stiffness
F0 Optional initial force
D Optional viscous damping coefficient
CDF Compressive displacement at failure
TDF Tensile displacement at failure
FLCID Load Curve Id defining Yield Force vs. Deflection for nonlinear behavior
HLCID Load Curve Id defining Force vs. Relative Velocity for nonlinear behavior
Ci Damping Coefficients
DLE Scale factor for time unit
GLCID Load Curve Id defining Scale Factor vs. Deflection for Load Curve Id
(HLCID)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_BILKHU/DUBOIS_FOAM
A material model to simulate isotropic crushable foams using uniaxial and triaxial test data.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
Materials 125
Materials
Field Comments
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
YM Young’s Modulus
LCPY Load Curve Id defining Yield Pressure vs. Volumetric Strain
LCUYS Load Curve Id defining uniaxial Yield Stress vs. Volumetric Strain
VC Viscous Damping Coefficient
PC Pressure Cutoff
VPC Variable Pressure Cutoff as a fraction of pressure yield value
TC Tension Cutoff for uniaxial tensile stress
VTC Variable Tension Cutoff as a fraction of uniaxial compressive yield strength
LCRATE Load Curve Id defining Scale Factor for the previous yield curves,
dependent upon the volumetric strain vs. Volumetric plastic Strain
PR Poisson coefficient applying to both elastic and plastic deformations
KCON Stiffness coefficient for contact interface stiffness. If undefined, one third
of Young’s Modulus (YM) is used..
ISFLG Tensile response flag (active only if negative abscissa are present in the
load curve LCUYS).
See Also:
• LS-DYNA Keyword User’s Manual
126
Materials
MAT_GENERAL_VISCOELASTIC
A general viscoelastic Maxwell model used for modeling dense continuum rubber and solid explosives.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
BULK Elastic Bulk Modulus
PCF Tensile Pressure elimination flag (for solid elements only)
1: Elastic layer
0: Viscoelastic layer
LCID Load Curve Id for deviatoric behavior
NT Number of terms in shear fit
BSTART Parameter for resetting the exponents in the Relaxation Curve
TRAMP Optional Time ramp for loading
LCIDK Load Curve ID defining the bulk behavior
Materials 127
Materials
Field Comments
NTK Number of terms in bulk
BSTARTK Fit Parameter for bulk
TRAMPK Optional ramp time for bulk loading
NUM_RFS number of viscoelastic constants
GIi Optional shear relaxation modulus for the i-th term
BETAIi Optional shear Decay Constant for the i-th term
KIi Optional bulk Relaxation Modulus for the i-th term
BETAKIi Optional bulk Decay Constant for the i-th term
See Also:
• LS-DYNA Keyword User’s Manual
MAT_HYPERELASTIC_RUBBER
A general hyperelastic rubber material model, combined optionally with linear viscoelasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
128
Materials
Field Comments
MID Material identification number (Integer > 0)
RO Mass Density of the material
PR Poisson’s Ratio
N Constants to solve for
3: Solve for All constants (C10, C01, C11, C20, C02, and C30)
NV Number of Prony series terms in fit
G Shear Modulus
SIGF Limit stress for frequency independent, frictional, Damping
SGL Specimen gauge length
SW Specimen Width
ST Specimen Thickness
LCID1 Load Curve Id defining Force vs. Actual Change in gauge Length
DATA Type of experimental data
0:Uniaxial
LCID2 Load Curve Id of relaxation curve
BSTART Fit Parameter
TRAMP Optional ramp time for loading
Ci Material Constants
NUM_RFS Number of viscoelastic constants
GIi Optional Shear Relaxation Modulus for the i-th term
BETAIi Optional Decay Constants for the i-th term
See Also:
• LS-DYNA Keyword User’s Manual
Materials 129
Materials
MAT_OGDEN_RUBBER
An Ogden rubber material model, combined optionally with linear viscoelasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
PR Poisson’s Ratio
N Order to fit the Ogden model
Field Comments
LCID1 Load Curve Id defining Force vs. Actual Change in Length
DATA Type of experimental data
1:Uniaxial
2:Biaxial
LCID2 Load Curve Id of relaxation curve
BSTART Fit Parameter
TRAMP Optional ramp time for loading
MUi i-th Shear Modulus
ALPHAi i-th Exponent
NUM_RFS Number of viscoelastic constants
GIi i-th Optional Shear Relaxation Modulus
BETAIi i-th Optional Decay Constant
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SOIL_CONCRETE
An efficient soil and concrete material model.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
Materials 131
Materials
Field Comments
K Bulk Modulus
LCPV Load Curve Id defining Pressure vs. Volumetric Strain
LCYP Load Curve Id defining von Mises Stress vs. Pressure
LCFP Load Curve Id defining Plastic Strain at which fracture starts vs. Pressure
LCRP Load Curve Id defining Plastic Strain at which residual strength is released
vs. Pressure
PC Pressure Cutoff
OUT Output option for plastic strain
0: Volumetric
1: Deviatoric
B Residual strength factor after cracking
FAIL Failure flag
0: No
See Also:
• LS-DYNA Keyword User’s Manual
132
Materials
MAT_HYSTERETIC_SOIL
A nested surface material model with five superimposed layers of elasto-perfectly plastic material, each
with its own elastic moduli and yield values.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K0 Bulk Modulus
P0 Pressure Cutoff
B Exponent for pressure sensitive moduli
A0, A1, A2 Yield Function Constants
DF Damping Factor
RP Reference Pressure
LCID Load Curve Id defining Shear Stress vs. Shear Strain
SCLF Scale Factor o apply on shear stress in LCID
DIL_A Dilation Parameter A
DIL_B Dilation Parameter B
DIL_C Dilation Parameter C
DIL_D Dilation Parameter D
Materials 133
Materials
Field Comments
GAMi Shear Strains (if LCID is zero)
PINIT Pressure sensitivity flag:
See Also:
• LS-DYNA Keyword User’s Manual
MAT_RAMBERG_OSGOOD
A simple material model of shear behavior, and can be used for seismic analysis.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
GAMY Reference Shear Strain
TAUY Reference Shear Stress
ALPHA Stress coefficient
R Stress exponent
BULK Elastic Bulk Modulus
134
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PLASTICITY_WITH_DAMAGE
An elasto-visco-plastic material with an arbitrary stress versus strain curve and arbitrary strain rate
dependency. Damage, in this model, is considered before rupture occurs.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
EPPF Plastic Strain, at which material softening begins
TDEL Minimum time step size for Automatic Element Deletion
C, P Strain Rate Parameters
LCSS Load Curve Id defining Effective Stress vs. Effective Plastic Strain
LCSR Load Curve Id defining Strain Rate Scaling Effect on Yield Stress
EPPFR Plastic Strain at which material ruptures
VP Formulation for Rate Effects
1: Viscoplastic Formulation
Materials 135
Materials
Field Comments
LCDM Load Curve Id defining nonlinear damage curve
NUMINT No. of through thickness integration points which must fail before the
element is deleted
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PLASTICITY_WITH DAMAGE_ORTHO_RCDC
An elasto-visco-plastic material with an arbitrary stress versus strain curve and arbitrary strain rate
dependency. This includes an orthotropic damage model (only for shell elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
EPPF Plastic Strain, at which material softening begins
TDEL Minimum time step size for Automatic Element Deletion
136
Materials
Field Comments
C, P Strain Rate Parameter
LCSS Load Curve Id defining Effective Stress vs. Effective Plastic Strain
LCSR Load Curve Id defining Strain Rate Scaling Effect on Yield Stress
EPPFR Plastic Strain at which material ruptures
VP Formulation for Rate Effects
1: Viscoplastic Formulation
NUMINT No. of through thickness integration points which must fail before the
element is deleted
LCDM Load Curve Id defining nonlinear damage curve
ALPHA Parameter α
BETA Parameter β
GAMMA Parameter γ
D0 Parameter D0
B Parameter b
LAMDA Parameter λ
DS Parameter Ds
L Optional characteristic element length for this material.
See Also:
• LS-DYNA Keyword User’s Manual
Materials 137
Materials
MAT_FU_CHANG_FOAM
A material such as low and medium density foams, for hysteric unloading behaviors. Rate effects can be
included in this material model.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
ED Young’s Relaxation Modulus for rate effect
TC Tension Cutoff Stress
FAIL Failure option after Cutoff Stress is reached
Field Comments
BVFLAG Bulk Viscosity activation Flag
0: No
1: Active
SFLAG Strain Rate Flag
0: True strain
1: Engineering strain
RFLAG Strain Rate evaluation flag
0: Linear
.EQ. 0: OFF
.EQ. 1: ON
HU Hysteric unloading factor between 0 and 1 (default = 1, i.e. no energy
dissipation).
D0, N0, C0, Ni, Ci Material Constants
AIJ, SIJ Material Constants
MINR Minimum strain rate of interest
MAXR Maximum strain rate of interest
SHAPE Shape factor for unloading. Active for nonzero values of the hysteric
unloading factor HU.
Materials 139
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_WINFRITH_CONCRETE
A smeared crack, smeared rebar, material model (only for the 8-noded single integration point continuum
element).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TM Tangent Modulus of Concrete
PR Poisson’s Ratio
UCS Uniaxial Compression Strength
UTS Uniaxial Tensile Strength
FE Depends on value for RATE
Field Comments
EH Hardening Modulus for rebar
UELONG Ultimate elongation before rebar fails
RATE Rate effects Flag
See Also:
• LS-DYNA Keyword User’s Manual
Materials 141
Materials
MAT_WINFRITH_CONCRETE_REINFORCEMENT
A rebar reinforcement material model (material type 84). Reinforcement quantity is defined as the ratio
of the cross-sectional area of steel, relative to the cross-sectioanl area of concrete in the element (or
layer).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TM Tangent Modulus of Concrete
PR Poisson’s Ratio
UCS Uniaxial Compression Strength
UTS Uniaxial Tensile Strength
FE Depends on value for RATE
Field Comments
ASIZE Aggregate size (radius)
E Young’s Modulus for rebar
YS Yield Stress for rebar
EH Hardening Modulus for rebar
UELONG Ultimate elongation before rebar fails
RATE Rate effects Flag
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ORTHOTROPIC_VISCOELASTIC
A viscoelastic material model (only for shell elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus in Longitudinal Direction
EB Young’s Modulus in Transverse Direction
EC Young’s Modulus in Normal Direction
VF Volume fraction for viscoelastic material
K Elastic Bulk Modulus
G0 Short time Shear Modulus
GINF Long time Shear Modulus
BETA Decay Constant
144
Materials
Field Comments
PRBA, PRCA, PRCB Poisson’s Ratio in the ba, ca and cb directions
GAB, GBC, GCA Shear Moduli in the ab, bc and ca directions
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 145
Materials
MAT_CELLULAR_RUBBER
A material model for a cellular rubber with confined air pressure, combined with linear viscoelasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
PR Poisson’s Ratio
N Order or fit
SGL Specimen Gauge Length
SW Specimen Width
ST Specimen Thickness
LCID Load Curve Id defining the Force vs. Actual Change in gauge Length
C10, C01, C11, C20, Material Constants
C02
P0 Initial Air Pressure
PHI Ratio of cellular rubber to rubber density
IVS Initial Volumetric Strain
G Optional shear relaxation modulus, G, for rate effects
BETA Optional Decay Constant
146
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_MTS
This MTS material model, developed by Maudlin, Davidson, and Henninger [1990], is used for
applications involving high pressures, large strains, and high strain rates. This model uses dislocation
mechanics and provides an understanding of the plastic deformation process in ductile materials.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
SIGA Dislocation interaction with long-range barriers
SIGI Dislocation interaction with interstitial atoms
SIGS Dislocation interaction with solute atoms
SIG0 NOT used
BULK Bulk Modulus (for shell elements)
HF0, HF1, HF2 Dislocation generation material constants
SIGSO Saturation Threshold stress at 0 degrees K
Materials 147
Materials
Field Comments
EDOTSO, EDOTO, Reference Strain rates
EDOTI, EDOTS
BURG Magnitude of Burgers vector
CAPA Material Constant, A
BOLTZ Boltzmann’s constant, k
SM0, SM1, SM2 Shear Modulus Constants
G0, GOI, GOS Normalized activation energies
PINV, QINV, PINVI, Material Constants
QINVI, PINVS.,
QINVS., ALPHA
RHOCPR Product of density and specific heat
TEMPRF Initial Element Temperature
EPSO Factor to normalize strain rate
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PLASTICITY_POLYMER
An elasto-plastic material model with arbitrary stress versus strain curve, and arbitrary strain rate
dependency.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
148
Materials
Field Comments
MID Material identification number (Integer > 0)
RO Mass Density of the material
PR Poisson’s Ratio
C, P Strain Rate Parameters
LCSS Load Curve Id defining Effective Stress vs. Total Effective Strain
LCSR Load Curve Id defining Strain Rate Scaling effect on Yield Stress
EFTX Failure Flag
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ACOUSTIC
Defines the properties of materials used to track low pressure waves in acoustic media, like air or water
(only for acoustic pressure elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
Materials 149
Materials
Field Comments
MID Material identification number (Integer > 0)
RO Mass Density of the material
C Sound Speed
BETA Damping Factor
CF Cavitation Flag
0: Off
1: On
ATMOS Atmospheric Pressure
GRAV Gravitational Acceleration constant
XP, YP, ZP Coordinates of free surface point
XN, YN, ZN Direction cosines of free surface normal vector
See Also:
• LS-DYNA Keyword User’s Manual
150
Materials
MAT_SOFT_TISSUE
Defines a transversely isotropic hyperelastic material that represents biological soft tissue such as
ligaments, tendons, and fascia.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
Ci Hyperelastic Coefficients
XK Bulk Modulus
XLAM Stretch ratio at which fibers are straightened
FANG Fiber angle in local shell coordinate system (shell elements only)
XLAMO Initial fiber stretch
FAILSF stretch ratio for ligament fibers at failure (shell elements only). If zero,
failure is not considered.
FAILSM stretch ratio for surrounding matrix material at failure (shell elements only).
If zero, failure is not considered.
Materials 151
Materials
Field Comments
FAILSHR Shear strain at failure of a material point (shell elements only). If zero,
failure is not considered. This failure value is independent of FAILSF and
FAILSM.
AOPT 0: Locally orthotropic with material axes determined by element nodes 1,
2, and 4. (Node 1 is the local origin, Node 2 is along the local a- axis; Local
c-axis is the cross product of local a-axis, and the vector from node 1 to
node 4; Local b- axis is the cross product of loca c- and a- axes.)
See Also:
• LS-DYNA Keyword User’s Manual
152
Materials
MAT_SOFT_TISSUE_VISCO
A transversely isotropic hyperelastic material model that represents biological soft tissue such as
ligaments, tendons, and fascia. This model has a viscoelastic option activating a six-term Prony series
kernel for the relaxation function.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
Ci Hyperelastic Coefficients
XK Bulk Modulus
XLAM Stretch ratio at which fibers are straightened
FANG Fiber angle in local shell coordinate system (shell elements only)
XLAMO Initial fiber stretch
Materials 153
Materials
Field Comments
AOPT 0: Locally orthotropic with material axes determined by element nodes 1,
2, and 4. (Node 1 is the local origin, Node 2 is along the local a- axis; Local
c-axis is the cross product of local a-axis, and the vector from node 1 to
node 4; Local b- axis is the cross product of loca c- and a- axes.)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_6DOF_SPRING_DISCRETE_BEAM
A material model for simulating the effects of nonlinear elastic and nonlinear viscous beams using six
springs each acting along one of it six degrees-of-freedom.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TPIDR Part Id governing the Translational motion in the local r direction (If zero,
no force is computed in this direction)
154
Materials
Field Comments
TPIDS Part Id governing the Translational motion in the local s direction (If zero,
no force is computed in this direction)
TPIDT Part Id governing the Translational motion in the local t direction (If zero,
no force is computed in this direction)
RPIDR Part Id governing the Rotational motion about the local r direction (If zero,
no moment is computed in this direction)
RPIDS Part Id governing the Rotational motion about the local s direction (If zero,
no moment is computed in this direction)
RPIDT Part Id governing the Rotational motion about the local t direction (If zero,
no moment is computed in this direction)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_INELASTIC_SPRING_DISCRETE_BEAM
A material model for elastoplastic springs, with damping to be represented with discrete beam elements.
A yield force versus deflection is used which can vary in tension and compression.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Elastic Loading/Unloading Stiffness
F0 Optional initial force
D Optional viscous damping coefficient
Materials 155
Materials
Field Comments
CDF Compressive displacement at failure
TDF Tensile Displacement at failure
FLCID Load Curve Id defining Yield Force vs. Plastic Displacement
HLCID Load Curve Id defining Force vs. Relative Velocity
C1, C2 Damping Coefficients
DLE Scale Factor for time unit
GLCID Load Curve Id defining a Scale Factor vs. Deflection for Load Curve Id,
HLCID
See Also:
• LS-DYNA Keyword User’s Manual
MAT_INELASTIC_6DOF_SPRING_DISCRETE_BEAM
A material model for nonlinear inelastic and nonlinear viscous beams using six springs each acting along
one of it six degrees-of-freedom.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TPIDR Part Id governing the Translational motion in the local r direction (If zero,
no force is computed in this direction)
TPIDS Part Id governing the Translational motion in the local s direction (If zero,
no force is computed in this direction)
TPIDT Part Id governing the Translational motion in the local t direction (If zero,
no force is computed in this direction)
156
Materials
Field Comments
RPIDR Part Id governing the Rotational motion about the local r direction (If zero,
no moment is computed in this direction)
RPIDS Part Id governing the Rotational motion about the local s direction (If zero,
no moment is computed in this direction)
RPIDT Part Id governing the Rotational motion about the local t direction (If zero,
no moment is computed in this direction)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_BRITTLE_DAMAGE
A material model with anisotropic brittle damage characteristics, used mainly for concrete but can be
applied for a variety of brittle materials.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
TLIMIT Tensile Limit
SLIMIT Shear Limit
FTOUGH Fracture Toughness
SRETEN Shear Retention
VISC Viscosity
Materials 157
Materials
Field Comments
FRA_RF Fraction of reinforcement in section
E_RF Young’s Modulus of Reinforcement
YS_RF Yield Stress of Reinforcement
EH_RF Hardening Modulus of Reinforcement
FS_RF Failure Strain of Reinforcement
SIGY Compressive Yield Stress
See Also:
• LS-DYNA Keyword User’s Manual
MAT_GENERAL_JOINT_DISCRETE_BEAM
Defines the properties of a general joint constraining any combination of degrees of freedom between
two nodes.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
TR Translational Constraint Code along r-axis
0: Free
1:Fixed
158
Materials
Field Comments
TS Translational Constraint Code along s-axis
0: Free
1:Fixed
TT Translational Constraint Code along t-axis
0: Free
1:Fixed
RR Rotational Constraint Code about r-axis
0: Free
1:Fixed
RS Rotational Constraint Code about s-axis
0: Free
1:Fixed
RT Rotational Constraint Code about t-axis
0: Free
1:Fixed
RPST Penalty stiffness scale factor for translational constraints
RPSR Penalty stiffness scale factor for rotational constraints
See Also:
• LS-DYNA Keyword User’s Manual
Materials 159
Materials
MAT_SIMPLIFIED_JOHNSON_COOK
A material model used for problems where the strain rates vary over a large range. In this model, thermal
effect and damage are ignored and maximum stress is directly limited since thermal softening is not
available.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
VP Formulation for Rate Effects
1: Viscoplastic Formulation
A, B, N, C Parameters used in the Johnson-Cook flow stress equation
PSFAIL Effective Plastic Strain at Failure
SIGMAX Maximum Stress obtained from Work Hardening before rate effects are
added
SIGSAT Saturation Stress
EPSO Effective Plastic Strain rate
See Also:
• LS-DYNA Keyword User’s Manual
160
Materials
MAT_SIMPLIFIED_JOHNSON_COOK_ORTHO_DAMAGE
Defines the properties of a material used for problems where the strain rates vary over a large range.
Orthotropic damage is included as a means for treating failure in aluminum panels (only for shell
elements with multiple through thickness integration points).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
VP Formulation for Rate Effects
1: Viscoplastic Formulation
EPPFR Plastic Strain at which the material ruptures
LCDM Load Curve Id defining nonlinear damage curve
NUMINT No. of through thickness integration points which must fail before element
is deleted
A, B, N, C Parameters used in the Johnson-Cook flow stress equation
PSFAIL Effective Plastic Strain at Failure
SIGMAX Maximum Stress obtained from Work Hardening before rate effects are
added
SIGSAT Saturation Stress
EPSO Effective Plastic Strain rate
Materials 161
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPOTWELD
A material model for spotweld modeled with beam element type 9, and solid element type 1.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Initial Yield Stress
ET Hardening Modulus
DT Time Step Size for Mass Scaling
TFAIL Failure Time (Ignored if value is zero)
EFAIL Effective Plastic Strain at Failure
NRR Axial force resultant NrrF (or Maximum Axial Stress σrrF) at failure
NRS Force resultant NrsF (or Maximum Shear Stress τF) at failure
NRT Force resultant NrtF at failure
MRR Torsional moment resultant MrrF at failure
MSS Moment resultant MssF at failure
MTT Moment resultant MttF at failure
NF No. of force vectors stored for filtering
162
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPOTWELD_DAMAGE-FAILURE
A material model used in spotweld, modeled with beam element type 9, and solid element type 1.
Damage parameters are also included in this model.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Initial Yield Stress
ET Hardening Modulus
DT Time Step Size for Mass Scaling
TFAIL Failure Time (Ignored if value is zero)
EFAIL Effective Plastic Strain at Failure
NRR Axial force resultant NrrF (or Maximum Axial Stress σrrF) at failure
NRS Force resultant NrsF (or Maximum Shear Stress τF) at failure
NRT Force resultant NrtF at failure
MRR Torsional moment resultant MrrF at failure
Materials 163
Materials
Field Comments
MSS Moment resultant MssF at failure
MTT Moment resultant MttF at failure
NF No. of force vectors stored for filtering
RS Rupture Strain
OPT Failure Option
.EQ. 6: Number of cycles that that failure condition must be met to trigger
beam deletion.
.EQ. 9: Number of cycles that that failure condition must be met to trigger
beam deletion.
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPOTWELD_DAIMLERCHRYSLER
A material model used in spotweld, modeled with solid element type 1, with type 6 hour glass control.
Special Damage parameters are used in this model.
164
Materials
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
DT Time Step Size for Mass Scaling
TFAIL Failure Time (Ignored if value is zero)
EFAIL Effective Plastic Strain at Failure
NF Number of failure function evaluations stored for filtering by time
averaging.
RS Rupture Strain
TRUE_T True weld thickness for hexahedron solid weld element.
CON_ID Connection Id of *DEFINE_CONNECTION
See Also:
• LS-DYNA Keyword User’s Manual
Materials 165
Materials
MAT_GEPLASTIC_SRATE_2000a
Defines properties for the General Electric’s commercially available thermoplastics subjected to high
strain rates. This model features variation of yield stress dependent upon strain rate, cavitation effects of
rubber modified material, and automatic element deletion for either ductile or brittle materials.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
RATESF Constant in plastic strain rate equation
EDOTO Reference Strain Rate
ALPHA Pressure Sensitive Factor
LCSS Load Curve Id (or Table Id) for post Yield Stress behavior vs. Strain
LCFEPS Load Curve Id for Plastic failure Strain vs. Strain Rate
LCFSIG Load Curve Id for Maximum principal failure Stress vs. Strain Rate
LCE Load Curve Id for Unloading Moduli vs. Plastic Strain
See Also:
• LS-DYNA Keyword User’s Manual
166
Materials
MAT_HYPERBOLIC_SIN
Defines properties for modeling materials with temperature and rate dependent plasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
T Initial Temperature
HC Heat Generation Coefficient
VP Formulation for Rate Effects
1: Viscoplastic Formulation
ALPHA, N, A, Q, G Material constitutive constants
EPSO Effective plastic strain rate
See Also:
• LS-DYNA Keyword User’s Manual
Materials 167
Materials
MAT_ANISOTROPIC_VISCOPLASTIC
Defines an anisotropic viscoplastic material that is applied to either shell or brick elements. The material
constants may be input directly, or by stress-strain data. If stress-strain data is provided, a least squares
fit will be performed to determine the constants.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Initial Yield Stress
FLAG Flag for material parameters
LCSS Load Curve Id for Effective Stress vs. Effective Plastic Strain
168
Materials
Field Comments
ALPHA α distribution hardening:
= 1: Isotropic hardening
QRi, CRi Isotropic Hardening Parameters
QXi, CXi Kinematic Hardening Parameters
VK, VM Viscous Material Parameters
R00/F R00 for shell, or F for solid
R45/G R45 for shell, or G for solid
R90/H R90 for shell, or H for solid
L, M, N Parameters (for solid elements only
AOPT Material Axes option
.GT. 0: Plastic strain to failure. When the plastic strain reaches this value,
the element is deleted from calculation.
Materials 169
Materials
Field Comments
NUMINT Number of integration point which must fail before element is deleted.. If
zero, all points must fail. This option applies to shell elements only.
MACF Material axes change flag:
See Also:
• LS-DYNA Keyword User’s Manual
170
Materials
MAT_ANISOTROPIC_PLASTIC
This anisotropic plastic material model is a simplified version of the
MAT_ANISOTROPIC_VISCOPLASTIC model. This model applies to shell elements only.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Initial Yield Stress
LCSS Load Curve Id for effective Stress vs. effective plastic Strain
QRi, CRi Isotropic Hardening Parameters
QXi, CXi Kinematic Hardening Parameters
R00/F R00 for shell or F for solid
R45/G R45 for shell or G for solid
R90/H R90 for shell or H for solid
Materials 171
Materials
Field Comments
S11, S22, S33, S12 Yield Stress in the x, y, z and xy direction, respectively
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
172
Materials
MAT_DAMAGE_1
Defines properties for a continuum damage mechanics material model which includes anisotropy and
viscoplasticity. This model is applied to shell, thick shell and brick elements.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Initial Yield Stress
LCSS Load Curve Id for effective Stress vs. effective plastic Strain
LCDM Load Curve Id defining nonlinear damage (for FLAG = -1)
Qi, Ci Isotropic Hardening Parameters
EPSD Damage Threshold, rd
Materials 173
Materials
Field Comments
S Damage Material Constant
EPSR Plastic strain at which material ruptures
DC Critical Damage valueDc
FLAG Flag for Localization
Field Comments
Di Component of Vector d, for AOPT=2
BETA Material Angle (Degrees), for AOPT=3
See Also:
• LS-DYNA Keyword User’s Manual
MAT_DAMAGE_2
Defines properties for an elastic viscoplastic material model combined with the continuum damage
mechanics. This model is applied to shell, thick shell and brick elements.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
FAIL Failure flag
> 0: Plastic strain to failure considered. When the plastic strain reaches this
value, the element is deleted from calculation.
Materials 175
Materials
Field Comments
TDEL Minimum time step for Automatic Element Deletion
C, P Strain Rate Parameters
LCSS Load Curve Id defining effective Stress vs. effective plastic Strain
LCSR Load Curve Id defining Strain Rate Scaling Effect on Yield Stress
EPSD Damage Threshold, rd
S Damage Material Constant
DC Critical Damage valueDc
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ELASTIC_VISCOPLASTIC_THERMAL
Defines properties for an elastic viscoplastic material with thermal effects.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
176
Materials
Field Comments
SIGY Initial Yield Stress
ALPHA Coefficient of thermal expansion
LCSS Load Curve Id for effective Stress vs. effective plastic Strain
QRi, CRi Isotropic Hardening Parameters
QXi, CXi Kinematic Hardening Parameters
C, P Viscous Material Parameters
LCE Load Curve Id defining Young’s Modulus vs. Temperature
LCPR Load Curve Id defining Poisson’s Ratio vs. Temperature
LCSIGY Load Curve Id defining Initial Yield Stress vs. Temperature
LCR Load Curve Id defining for Parameters QR1 and QR2 vs. Temperature
LCX Load Curve Id defining for Parameters QX1 and QX2 vs. Temperature
LCALPH Load Curve Id defining Coefficient of thermal expansion vs. Temperature
LCC Load Curve Id defining scaling Viscous material parameter C vs.
Temperature
LCP Load Curve Id defining scaling Viscous material parameter P vs.
Temperature
See Also:
• LS-DYNA Keyword User’s Manual
Materials 177
Materials
MAT_JOHNSON_HOLMQUIST_CERAMICS
Defines properties for a material used to model ceramics, glass and other brittle materials.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
A Intact normalized strength parameter
B Fractured normalized strength parameter
C Strength Parameter (for strain rate dependence)
M Fracture strength parameter (Pressure exponent)
N Intact strength parameter (Pressure exponent)
EPSI Reference Strain Rate
T Maximum Tensile Strength
SFMAX Maximum normalized Fractured Strength
HEL Hugoniot elastic limit
PHEL Pressure component at the at Hugoniot elastic limit
BETA Fraction of elastic energy loss converted to hydrostatic energy
Di Parameters for plastic strain to fracture
K1, K2 First and Second pressure coefficients
178
Materials
Field Comments
K3 Elastic Constant (Note that K1 is the bulk modulus)
FS Failure Criteria
0: No failure
See Also:
• LS-DYNA Keyword User’s Manual
MAT_JOHNSON_HOLMQUIST_CONCRETE
This material model is used for concrete under high strain rates, large strains and high pressure.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
G Shear Modulus
A Normalized Cohesive Strength
B Normalized Pressure Hardening
C Strain rate coefficient
N Pressure Hardening Exponent
Materials 179
Materials
Field Comments
FC Quasi-static uniaxial compressive strength
T Maximum Tensile hydrostatic pressure
EPSO Reference Strain Rate
EFMIN Plastic strain before fracture
SFMAX Maximum Fractured Strength
PC Crushing Pressure
UC Crushing Volumetric Strain
PL Locking Pressure
UL Locking Volumetric Strain
D1, D2 Damage Constants
K1, K2, K3 Pressure Constants
FS Failure Type
See Also:
• LS-DYNA Keyword User’s Manual
MAT_FINITE_ELASTIC_STRAIN_PLASTICITY
An elasto-plastic material model with arbitrary stress-strain curve and arbitrary strain rate dependency.
This material model uses a finite strain formulation allowing large elastic strains before yielding.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
180
Materials
Field Comments
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
FAIL Failure Flag
>0: Plastic strain to failure. When plastic strain reaches this value, the
element is deleted from calculation.
TDEL Minimum time step size for automatic element deletion
C, P Strain Rate Parameters
LCSS Load Curve Id for effective Stress vs. effective plastic Strain
LCSR Load Curve Id defining Strain Rate Effect on Yield Stress
See Also:
• LS-DYNA Keyword User’s Manual
MAT_LAYERED_LINEAR_PLASTICITY
Defines a layered elastoplastic material with an arbitrary stress-strain curve and arbitrary strain rate
dependency.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
Materials 181
Materials
Field Comments
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
FAIL Failure Flag
>0: Plastic strain to failure. When plastic strain reaches this value, the
element is deleted from calculation.
TDEL Minimum time step size for automatic element deletion
C, P Strain Rate Parameters
LCSS Load Curve Id for effective Stress vs. effective plastic Strain
LCSR Load Curve Id defining Strain Rate Effect on Yield Stress
See Also:
• LS-DYNA Keyword User’s Manual
MAT_UNIFIED_CREEP
Defines properties of a material for elastic creep behavior.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
182
Materials
Field Comments
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
A Stress Coefficient
N Stress Exponent
M Time Exponent
See Also:
• LS-DYNA Keyword User’s Manual
MAT_COMPOSITE_LAYUP
Defines the elastic response of composite layups that have an arbitrary number of layers through the shell
thickness.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus, a Direction
Materials 183
Materials
Field Comments
EB Young’s Modulus, b Direction
EC Young’s Modulus, c Direction
PRBA, PRCA, PRCB Poisson’s Ratio in the ba, ca and cb directions
GAB, GBC, GCA Shear Moduli in the ab, bc and ca directions
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
184
Materials
MAT_COMPOSITE_MATRIX
Defines the properties of materials used for the elastic response of composites where pre-integration is
used to compute the extensional, bending, and coupling stiffness coefficients (available only for
Belytschko-Tsay resultant shell formulation).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
Cij Coefficient of Stiffness Matrix
Materials 185
Materials
Field Comments
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
186
Materials
MAT_COMPOSITE_DIRECT
Defines properties for a material used for the elastic response of composites where pre-integration is used
to compute the extensional, bending, and coupling stiffness coefficients (available only for Belytschko-
Tsay resultant shell formulation).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
Cij Coefficient of Stiffness Matrix
See Also:
• LS-DYNA Keyword User’s Manual
Materials 187
Materials
MAT_GENERAL_NONLINEAR_6DOF_DISCRETE_BEAM
Defines the properties of a very general spring and damper. The beam is based on
MAT_SPRING_GENERAL_NONLINEAR option. This model includes additional unloading options.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
KT Translational stiffness for unloading option 2.0
KR Rotational Stiffness for unloading option 2.0
UNLDOPT Unloading Option
OFFSET Offset Factor (between 0 and 1)
188
Materials
Field Comments
DAMPF Damping factor for stability
LCIDTR, LCIDTS, Load Curve Id defining Translational Force resultant along r, s, t axes
LCIDTT respectively vs. Translational Displacement.
LCIDRR, LCIDRS, Load Curve Id defining Rotational Moment about r, s, t axes vs. Rotational
LCIDRT Displacement.
LCIDTUR, LCIDTUS, Load Curve Id defining Translational Force resultant along r, s, t axes vs.
LCIDTUT Translational Displacement during unloading
LCIDRUR, LCIDRUS, Load Curve Id defining Rotational Moment about r, s, t axes vs. Rotational
LCIDRUT Displacement during unloading.
LCIDTDR, LCIDTDS, Load Curve Id defining Translational Damping Force along r, s, t axes vs.
LCIDTDT relative Translational Velocity.
LCIDRDR, LCIDRDS, Load Curve Id defining Rotational Damping Moment about r, s, t axes vs.
LCIDRDT relative Rotational Velocity.
LCIDTER, LCIDTES, Load Curve Id defining Translational Damping Force scale factor vs.
LCIDTET relative Displacement along r, s, t axes
LCIDRER, LCIDRES, Load Curve Id defining Rotational Damping Moment scale factor vs.
LCIDRER relative Displacement along r, s, t axes
UTFAILR, UTFAILS, Translational Displacement along r, s, t at failure in Tension
UTFAILT
WTFAILR, WTFAILS, Rotational Displacement about r, s, t at failure in Tension
WTFAILT
UCFAILR, UCFAILS, Translational Displacement along r, s, t at failure in Compression
UCFAILT
WCFAILR, WCFAILS, Rotational Displacement about r, s, t at failure in Compression
WCFAILT
IUR, IUS< IUT Initial Translational Displacement along r, s, t directions
IWR, IWS, IWT Initial Rotational Displacement about r, s, t axes
See Also:
• LS-DYNA Keyword User’s Manual
Materials 189
Materials
MAT_GURSON
Defines the material properties for the Gurson dilational plastic material model (available only for shell
elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
N Exponent in power law
Q1, Q2 Parameters
FC Critical void volume fraction
F0 Initial void volume fraction
EN Mean nucleation strain
SN Standard deviation SN of the normal distribution of εN
FN Void Volume Fraction of nucleating particles
ETAN Hardening Modulus
190
Materials
Field Comments
ATYP Hardening Type
1: Power Law
2: Linear
3: 8 points curve
FF0 Failure void volume fraction
Li Element Length Value
FFi Corresponding failure void volume fraction
LCSS Load Curve id defining effective Stress vs. effective plastic Strain
LCLF Load Curve Id defining Failure Void Volume Fraction vs. Element Length
NUMINT No of through thickness integration points which must fail before element
is deleted
LCF0 Lod curve Id defining initial void volume fraction f0 vs. element length.
LCFC Lod curve Id defining initial void volume fraction fN vs. element length.
LCFN Lod curve Id defining initial void volume fraction f0 vs. element length.
VGTYP Type of void growth behavior:
See Also:
• LS-DYNA Keyword User’s Manual
Materials 191
Materials
MAT_GURSON_RCDC
Defines the material properties for the Gurson model with Wilkins Rc-Dc (for shell elements only).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
N Exponent in power law
Q1, Q2 Parameters
FC Critical void volume fraction
F0 Initial void volume fraction
EN Mean nucleation strain
SN Standard deviation SN of the normal distribution of εN
FN Void Volume Fraction of nucleating particles
192
Materials
Field Comments
ETAN Hardening Modulus
ATYP Hardening Type
1: Power Law
2: Linear
3: 8 points curve
FF0 Failure void volume fraction
Li Element Length Value
FFi Corresponding failure void volume fraction
LCSS Load Curve id defining effective Stress vs. effective plastic Strain
LCLF Load Curve Id defining Failure Void Volume Fraction vs. Element Length
NUMINT No of through thickness integration points which must fail before element
is deleted
ALPHA Parameter α for Rc-Dc Model
BETA Parameter β for Rc-Dc Model
GAMMA Parameter γ for Rc-Dc Model
D0 Parameter D0 for Rc-Dc Model
B Parameter b for Rc-Dc Model
LAMBDA Parameter λ for Rc-Dc Model
DS Parameter ds for Rc-Dc Model
L Characteristic element length for Rc-Dc Material
See Also:
• LS-DYNA Keyword User’s Manual
Materials 193
Materials
MAT_GENERAL_NONLINEAR_1DOF_DISCRETE_BEAM
Defines the material properties for a very general spring and damper. The beam is based on
MAT_SPRING_GENERAL_NONLINEAR option and is a one dimensional version of
6DOF_DESCRETE_BEAM. This model includes additional unloading options.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Translational stiffness for unloading option 2
UNLDOPT Unloading option
OFFSET Offset to determine permanent set upon unloading if the UNLDOPT equals
to 3.
DAMPF Damping factor for stability
LCIDT Load Curve Id defining Translational Force along the axis vs. relative
Translational Displacement.
LCIDTU Load Curve Id defining Translational Force along the axis vs. relative
Translational Displacement, during unloading
LCIDTD Load Curve Id defining Translational Damping Force along the local axis
vs. relative Translational Velocity.
LCIDTE Load Curve Id defining Translational Damping Force scale factor along the
local axis vs. relative Displacement.
UTFAIL Translational displacement at failure in tension
194
Materials
Field Comments
UCFAIL Translational displacement at failure in compression
IU Initial translational displacement along the axis
See Also:
• LS-DYNA Keyword User’s Manual
MAT_HILL_3R
Defines the properties for the Hill’s planar anisotropic material model with 3 R values.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
Materials 195
Materials
Field Comments
HR Hardening Rule
1: Linear
2: Exponential
3: Load Curve
P1, P2 Material Parameters
R00, R45, R90 Lankford parameters
LCID Load Curve Id for the hardening rule
Epsilon_0 ε0 for determining initial yield stress for exponential hardening
SPI Parameter to redefine ε0
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
196
Materials
MAT_MODIFIED_PIECEWISE_LINEAR_PLASTICITY
Defines an elasto-plastic material with an arbitrary stress versus strain curve and arbitrary strain rate
dependency (available only for shell elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
FAIL Failure flag
TDEL Minimum time step size for automatic element deletion
C, P Strain Rate Parameters
LCSS Load Curve Id defining effective Stress vs. effective plastic Strain
LCSR Load Curve Id defining Strain Rate scaling effect on Yield Stress
VP Formulation for Rate Effects
EPSTHIN Thinning Plastic Strain at Failure
EPSMAJ Major Plastic Strain at Failure
NUMINT No. of through thickness integration points that must fail before element is
deleted
See Also:
• LS-DYNA Keyword User’s Manual
Materials 197
Materials
MAT_PLASTICITY_COMPRESSION_TENSION
Defines an isotropic elastic-plastic material allowing different yield stress versus plastic strain curves in
compression and tension.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
C, P Strain Rate Parameters
FAIL Failure Flag
TDEL Minimum time step size for automatic element deletion
LCIDC Load Curve Id defining Yield Stress vs. effective Plastic Strain in
compression
LCIDT Load Curve Id defining Yield Stress vs. effective Plastic Strain in tension
198
Materials
Field Comments
LCSRC Optional load curve Id defining strain rate scaling effect on yield stress
when the material is in compression
LCSRT Optional load curve Id defining strain rate scaling effect on yield stress
when the material is in tension
SRFLAG Formulation for rate effects:
0 = inactive ; 1 = active
K (optional) bulk modulus for the viscoelastic material. If nonzero, a Kelvin
type will be used.
NUM_RFS Number of terms used for shear relaxationmodulus/shear decay constant
GI1 (optional) shear relaxation modulus for the i-th term
BETAI1 (optional) shear decay constant for the i-th term
See Also:
• LS-DYNA Keyword User’s Manual
Materials 199
Materials
MAT_MODIFIED_HONEYCOMB
Defines the properties for aluminum honeycomb crushable foam materials with anisotropic behavior.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
VF Relative volume at which honeycomb is fully compacted
MU Material viscosity coefficient
BULK Bulk Viscosity Flag
0: Not used
Field Comments
LCA Load Curve ID, defining:
<0: Yield stress vs. the angle off the material axis is degrees
LCB Load Curve ID, defining:
<0: the damage curve defining the shear stress multiplier as a function of
the shear strain component
LCAB Load Curve ID, defining:
<0: the damage curve defining the shear stress-ab multiplier as a function
of the shear strain-ab
LCBC Load Curve ID, defining:
<0: the damage curve defining the shear stress-bc multiplier as a function
of the shear strain-bc
LCCA Load Curve ID, defining:
<0: the damage curve defining the shear stress-ca multiplier as a function
of the shear strain-ca
LCSR Load Curve ID of Strain Rate effect scale factor vs. Strain Rate
EAAU, EBBU, ECCU Elastic Moduli in the a-, b-, and c- directions, in uncompressed
configuration
GABU, GBCU, GCAU Shear Moduli in the ab, bc, ca planes in uncompressed configuration
Materials 201
Materials
Field Comments
AOPT Material Axes option
Field Comments
TREF Element timestep size at which the reference geometry is stored
SHDFLG Flag defining treatment of damage from curves LCS, LCAB, LCBC, and
LCBC (relevant only if LCA < 0):
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ARRIBA_BOYCE_RUBBER
Defines the material properties for hyperelastic rubber combined optionally with linear viscoelasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Bulk Modulus
G Shear Modulus
N Number of statistical links
Materials 203
Materials
Field Comments
LCID Load Curve id defining Relaxation curve for shear
TRAMP Optional ramp time for loading
NT Number of Prony series terms in fit
NUM_RFS Number of viscoelastic constants
GIi Optional i-th shear Relaxation Modulus i
BETAIi Optional i-th shear Decay Constant
See Also:
• LS-DYNA Keyword User’s Manual
MAT_HEART_TISSUE
Defines the material properties for heart tissue as described in the paper by Guccione, McCulloch and
Waldman [1991]. This model is transversely anisotropic.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
C, B1, B2, B3 Material Coefficients
204
Materials
Field Comments
P Pressure in muscle tissue
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 205
Materials
MAT_LUNG_TISSUE
Defines the material properties for a hyperelastic material model for heart tissue combined optionally
with linear viscoelasticity.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Bulk Modulus
C, DELTA, ALPHA, Material Coefficients
BETA, C1, C2
LCID Relaxation curve for shear
TRAMP Optional ramp time for loading
NT Number of Prony series terms in fit
NUM_RFS Number of viscoelastic constants
GIi Optional i-th shear Relaxation Modulus
BETAIi Optional i-th shear Decay Constant
See Also:
• LS-DYNA Keyword User’s Manual
206
Materials
MAT_SPECIAL_ORTHOTROPIC
This material model defines the properties for a material model developed for the Belytschko-Tsay and
the C0 triangle shell elements. It is based on a resultant stress formulation. In plane behavior is treated
separately from bending in order to model perforated materials such as television shadow masks.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
YS Yield Stress
EP Plastic Hardening Modulus
EiiP Young’s Modulus (in-plane) in i- direction
NUijP Poisson’s Ratio in plane ij
GijP Shear Modulus in Plane ij
EiiB Young’s Modulus (Bending) in i-direction
NUijB Poisson’s Ratio (Bending) in ij plane
G12B Shear Modulus (Bending) in 12 plane
Materials 207
Materials
Field Comments
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
208
Materials
MAT_MODIFIED_FORCE_LIMITED
This material model is an extension of MAT_FORCE_LIMITED (MAT_029). In addition to plastic
hinge and collapse mechanisms, yield moments may be defined as a function of axial force. The moment
transmitted by the hinge is defined by a moment-plastic rotation relationship.
Materials 209
Materials
210
Materials
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
Materials 211
Materials
Field Comments
DF Damping Factor
AOPT Axial load curve option
Field Comments
HMR_i Hinge moment for the torsional axis for hinge i
LPMR_i Load Curve Id for plastic moment vs. plastic rotation for HMR_i
See Also:
• LS-DYNA Keyword User’s Manual
MAT_VACUUM
Defines the properties for a dummy material representing a vacuum in a multi-material Euler/ALE
model.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
KW_OPTION Title optional keywords
See Also:
• LS-DYNA Keyword User’s Manual
Materials 213
Materials
MAT_RATE_SENSITIVE_POLYMER
Defines the properties for simulating an isotropic ductile polymer with strain rate effects. It uses uniaxial
test data.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
D0 Reference Strain Rate (D0)
N Exponent for inelastic strain rate
Z0 Initial hardness of material (Z0)
q Parameter used in the constitutive equation
Omega Maximum internal stress
See Also:
• LS-DYNA Keyword User’s Manual
214
Materials
MAT_TRANSVERSELY_ANISOTROPIC_CRUSHABLE_FOAM
Defines the properties for extruded foam material that is transversely anisotropic, crushable, and of low
density with no significant Poisson effect.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E11, E22 Elastic Moduli in the 1(axial) and 2 (transverse) direction
E12 Elastic shear Modulus in the axial-transverse plane (E12 = E13)
G Shear Modulus
K Bulk Modulus for Contact Stiffness
I11 Load Curve Id for Nominal Axial Stress vs. Volumetric Strain
I22 Load Curve Id for Nominal Transverse Stress vs. Volumetric Strain (I22=
I33)
I12 Load Curve Id for Shear Stress components 12 and 31 vs. Volumetric Strain
(I22= I31)
I23 Load Curve Id for Shear Stress components 23 vs. Volumetric Strain
Materials 215
Materials
Field Comments
IAA Load Curve Id for Nominal stress vs. Volumetric strain at angle, ANG,
relative to the material axis
NY Flag for symmetric yield surface
ANG Angle corresponding to Load Curve Id, IAA
MU Damping factor
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
216
Materials
MAT_WOOD
Defines the material properties for a transversely isotropic material (available only for solid elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
Materials 217
Materials
Field Comments
NPLOT Plotting Option
1: Parallel damage
2: Perpendicular damage
ITER Number of plasticity algorithm iterations
IRATE Rate effects option
0: Turn off
1: Turn on
HARD Perfect plasticity override
IFAIL Erosion perpendicular to the ground
0: No
1: Yes
IVOL Erode on negative volume or strain increments greater than 0.01
=0 No (default) ; =1 Yes
EL Parallel Normal Modulus
ET Perpendicular Normal Modulus
GLT Parallel Shear Modulus (GLT=GLR)
GTR Perpendicular Shear Modulus
PR Poisson’s Ratio
XT Parallel Tensile Strength
XC Parallel Compressive Strength
YT Perpendicular Tensile Strength
YC Perpendicular Compressive Strength
SXY Parallel Shear Strength
SYZ Perpendicular Shear Strength
GF1_I Parallel Fracture Energy in Tension
GF2_I Parallel Fracture Energy in Shear
BFIT Parallel softening Parameter
DMAX_I Parallel Maximum Damage
GF1_r Perpendicular Fracture Energy in Tension
GF2_r Perpendicular Fracture Energy in Shear
218
Materials
Field Comments
DFIT Perpendicular Softening Parameter
DMAX_r Perpendicular Maximum Damage
FLPAR Parallel Fluidity Parameter for Tension and Shear
FLPARC Parallel Fluidity Parameter for Compression
POWPAR Parallel Power
FLPER Perpendicular Fluidity Parameter for Tension and Shear
FLPERC Perpendicular Fluidity Parameter for Compression
POWPER Perpendicular Power
NPAR Parallel Hardening initiation
CPAR Parallel Hardening Rate
NPER Perpendicular Hardening initiation
CPER Perpendicular Hardening Rate
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
MAT_WOOD_PINE
Defines the material properties for a transversely isotropic material (available only for solid elements).
This model has default material properties for yellow pine.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
NPLOT Plotting Option
1: Parallel damage
2: Perpendicular damage
ITER Number of plasticity algorithm iterations
220
Materials
Field Comments
IRATE Rate effects option
0: Turn off
1: Turn on
HARD Perfect plasticity override
IFAIL Erosion perpendicular to the ground
0: No
1: Yes
IVOL Erode on negative volume or strain increments greater than 0.01
=0 No (default) ; =1 Yes
MOIS Percentage moisture content
TEMP Temperature
QUAL_T Quality Factor Option in Tension
QUAL_C Quality Factor Option in Compression
UNITS Units Option
0: Yes
1: No
Materials 221
Materials
Field Comments
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
222
Materials
MAT_WOOD_FIR
Defines the material properties for a transversely isotropic material (available only for solid elements).
This model has default material properties for Douglas Fir.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
NPLOT Plotting Option
1: Parallel damage
2: Perpendicular damage
ITER Number of plasticity algorithm iterations
IRATE Rate effects option
0: Turn off
1: Turn on
HARD Perfect plasticity override
Materials 223
Materials
Field Comments
IFAIL Erosion perpendicular to the ground
0: No
1: Yes
IVOL Erode on negative volume or strain increments greater than 0.01
=0 No (default) ; =1 Yes
MOIS Percentage moisture content
TEMP Temperature
QUAL_T Quality Factor Option in Tension
QUAL_C Quality Factor Option in Compression
UNITS Units Option
0: Yes
1: No
AOPT Material Axes option
Field Comments
BETA Material angle in degrees (for AOP = 3)
XP X-coordinate of point p for AOPT=1
YP Y-coordinate of point p for AOPT=1
ZP Z-coordinate of point p for AOPT=1
Ai Component of Vector a, for AOPT=2
Vi Components of vector v( for AOP = 3 and 4)
Di Component of Vector d, for AOPT=2
See Also:
• LS-DYNA Keyword User’s Manual
MAT_PITZER_CRUSHABLE_FOAM
Defines the properties for a material model that simulates isotropic crushable foams with strain rate
effects. It uses uniaxial and triaxial data.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Bulk Modulus
G Shear Modulus
PR Poisson’s Ratio
TY Tension Yield
SRTV Young’s Modulus
LCPY Load Curve Id defining pressure vs. volumetric strain
Materials 225
Materials
Field Comments
LCUYS Load Curve Id defining uniaxial stress vs. volumetric strain
LCRS Load Curve Id defining Strain rate Scale Factor vs. Volumetric Strain rate
VC Viscous Damping Coefficient
DFLG Density Flag
See Also:
• LS-DYNA Keyword User’s Manual
226
Materials
MAT_SCHWER_MURRAY_CAP_MODEL
Defines the material properties for a three invariant extension of MAT_GEOLOGIC_CAP_MODEL
(MAT_025) that also includes viscoplasticity for rate effects and damage mechanics to model strain
softening.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
SHEAR Shear Modulus
BULK Bulk Modulus
GRUN Gruneisen Ratio
SHOCK Shock Velocity Parameter
PORE Flag for Pore Collapse
0: Yes
Field Comments
ALPHA, THETA, Shear Failure Parameters
GAMMA, BETA
EFIT, FFIT Dilitation damage mechanics parameters
ALPHAN, CALPHA Kinematic strain hardening parameters
R0 Initial Gap Surface ellipticity, R
X0 Initial Gap Surface J1 (mean stress) axis intercept
IROCK Material Flag
1: Rock/Concrete
SECP Shear Enhanced Compaction
AFIT, BFIT, RDAM0 Ductile damage mechanics parameters
W, D1, D2 Plastic volume strain parameters
NPLOT History variable post-processed as effective plastic strain
EPSMAX Maximum permitted strain increment
CFIT, DFIT Brittle damage parameters
TFAIL Tensile Failure Stress
FAILFL Failure Flag (failed element)
DBETA, DDELTA Rounded Vertices Parameters
VPTAU Viscoplastic Relaxation time Parameter
ALPHA1 THETA1, Torsional scaling parameters
GAMMA1, BETA1
ALPHA2 THETA2, Triaxial extension scaling parameters
GAMMA2, BETA2
See Also:
• LS-DYNA Keyword User’s Manual
228
Materials
MAT_1DOF_GENERALIZED_SPRING
Defines the properties for a linear spring or damper that allows different degrees-of-freedom at two nodes
to be coupled with linear spring and/or damper.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Spring Stiffness
C Damping Constant
SCLNi Scale Factor on force at node i
DOFNi Active dof at node i
CIDi Local coordinate system Id at node 1 and node 2 respectively
See Also:
• LS-DYNA Keyword User’s Manual
Materials 229
Materials
MAT_FHWA_SOIL
Defines the material properties for an isotropic material with damage for solid elements. The model has
a modified Mohr-Coulomb surface for determining pressure dependent peak shear strength.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
NPLOT Plotting option
SPGRAV Specific gravity of soil
RHOWAT Density of water
VN, GAMMAR Viscoplastic parameters
ITERMAX Maximum number of plastic iterations
K Bulk Modulus
G Shear Modulus
PHIMAX Peak Shear strength (friction) angle (degrees)
AHYP Coefficient A for modified Drucker-Prager surface
COH Cohesion shear strength at zero confinement (overburden)
ECCEN Eccentricity parameter
AN Strain hardening percent of PHIMAX where nonlinear effects start
ET Strain hardening amount of nonlinear effects
230
Materials
Field Comments
MCONT Moisture content in soil
PWD1 Parameter for pore water effects on Bulk Modulus
PWSK Skeleton Bulk Modulus
PWD2 Parameter for pore water effects on the effective pressure
PHIRES Minimum internal frictional angle (radians)
DINT Volumetric strain at initial threshold damage
VDFM Void formation energy
DAMLEV Level of damage that will cause element deletion
EPSMAX Maximum principal failure strain
See Also:
• LS-DYNA Keyword User’s Manual
MAT_FHWA_SOIL_NEBRASKA
Defines the material properties for a soil model with default property values for soils used at the
University of Nebraska. Default units are in millimeter, milliseconds and kilograms.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
FCTIM Factor to multiply milliseconds by to get desired time unit
FCTMAS Factor to multiply Kg by to get desired mass unit
FCTLEN Factor to multiply mm by to get desired length unit
See Also:
• LS-DYNA Keyword User’s Manual
Materials 231
Materials
MAT_GAS_MIXTURE
Defines the material properties for a material model that simulates gas mixture and works in conjunction
with the multi-material ALE formulation.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
IADIAB Flag for turning adiabatic compression logic ON/OFF
0 = ON ; 1 = OFF
RUNIV Universal gas constant in per-mole unit
CVi Heat Capacity at constant volume for upto eight different gases in per-mass
unit gas (If RUNIV = 0 or blank)
MOLi Molecular weight of each ideal gas in the mixture (mass-unit/molde) (if
RUNIV is nonzero)
CPi Heat Capacity at constant pressure for upto eight different gases in per-
mass unit gas (If RUNIV = 0 or blank)
232
Materials
Field Comments
Bi First order coefficient for a temperature dependent heat capacity at constant
pressure for up to eight different gases (If RUNIV = 0 or blank)
Ci Second order coefficient for a temperature dependent heat capacity at
constant pressure for up to eight different gases (If RUNIV = 0 or blank)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_CFD
Defines the material properties for a material model that allows constant, isotropic fluid properties to be
defined for the incompressible/low-Mach CFD solver.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RHO Fluid Density
MU Fluid Viscosity
K Thermal Conductivity
CP Heat Capacity
BETA Coefficient of expansion
TREF Reference Temperature
Materials 233
Materials
Field Comments
GX, GY, GZ Gravitational acceleration in the X, Y, Z direction
DIFFi Diffusivity for Species i
See Also:
• LS-DYNA Keyword User’s Manual
MAT_CFD_CONSTANT
Defines the material properties for a material model that allows constant, isotropic fluid properties to be
defined for the incompressible/low-Mach CFD solver.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RHO Fluid Density
MU Fluid Viscosity
K Thermal Conductivity
CP Heat Capacity
BETA Coefficient of expansion
TREF Reference Temperature
GX, GY, GZ Gravitational acceleration in the X, Y, Z direction
DIFFi Diffusivity for Species i
234
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_DESHPANDE_FLECK_FOAM
Defines the material properties for aluminum foam, used as a filler material in aluminum extrusions to
enhance the energy absorbing capability of the extrusion.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
ALPHA Parameter to Control Shape of yield surface
GAMMA, ALPHA2, Equation parameters
BETA, SIGP
EPSD Densification strain
DERFI Type of derivation in Material subroutine
0: Numerical
1: Analytical
CFAIL Failure Strain
See Also:
• LS-DYNA Keyword User’s Manual
Materials 235
Materials
MAT_COMPOSITE_MSC
Defines the material properties for a material model to simulate the progressive failure analysis for
composite materials consisting of unidirectional and woven fabric layers.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus - longitudinal direction
EB Young’s Modulus - transverse direction
EC Young’s Modulus - through thickness direction
PRBA, PRCA, PRCB Poisson’s Ratio in ba, ca, and cb directions
GAB, GBC, GCA Shear Stress in ab bc, and ca directions
236
Materials
Field Comments
AOPT Material Axes option
= 1 no change (default)
Field Comments
AMODEL Material Model
See Also:
• LS-DYNA Keyword User’s Manual
238
Materials
MAT_COMPOSITE_MSC_DMG
Defines the material properties for a material model to simulate the progressive failure analysis for
composite materials consisting of unidirectional and woven fabric layers.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
EA Young’s Modulus - longitudinal direction
EB Young’s Modulus - transverse direction
EC Young’s Modulus - through thickness direction
PRBA, PRCA, PRCB Poisson’s Ratio in ba, ca, and cb directions
GAB, GBC, GCA Shear Stress in ab bc, and ca directions
Materials 239
Materials
Field Comments
AOPT Material Axes option
= 1 no change (default)
Field Comments
AMODEL Material Model
1: Unidirectional
2: Fabric
PHIC Coulomb friction angle
E_LIMT Element eroding axial strain
S_DELM Scale factor for delamination criteria
OMGMX Limit damage parameter for elastic modulus
ECRSH Limit compressive volume strain
EEXPN Limit tensile volume strain
CERATEi Coefficient for strain rate dependent strength parameter, axial moduli, shear
moduli, transverse moduli
See Also:
• LS-DYNA Keyword User’s Manual
MAT_MODIFIED_CRUSHABLE_FOAM
Defines the material properties for a material model to simulate crushable foam with optional damping,
tension cutoff and strain rate effects. Unloading is fully elastic. Tension is treated as elastic-perfectly-
plastic at the tension cutoff value.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
Materials 241
Materials
Field Comments
E Young’s Modulus
PR Poisson’s Ratio
TID Load Curve Id defining Yield Stress vs. Volumetric Strain
TSC Tensile Stress Cutoff
DAMP Rate sensitivity via damping coefficient
NCYCLE Number of cycles to determine volumetric strain rate
SRCLMT Strain rate change limit
See Also:
• LS-DYNA Keyword User’s Manual
MAT_QUASILINEAR_VISCOELASTIC
Defines the properties for a material model to simulate a quasi-linear, isotropic, viscoelastic material
which represents biological soft tissue such as brain, kidney, etc.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Bulk Modulus
LC1 Load Curve Id for the Relaxation function in shear
242
Materials
Field Comments
LC2 Load Curve Id for the instantaneous Elastic response in shear
N No. of Prony series terms in fit
GSTART Starting value for least square fit
M No. of terms used to determine the instantaneous elastic response
S0 Strain output option to be plotted as component 7 in LS-TAURUS
See Also:
• LS-DYNA Keyword User’s Manual
Materials 243
Materials
MAT_HILL_FOAM
Defines the properties for a material model to simulate a highly compressible foam based on strain energy
function, proposed by Hill. This model takes Poisson’s ratio effects into account.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Bulk Modulus
N Material constant
MU Damping coefficient
LCID Load Curve Id defining Force per unit area vs. Stretch Ratio
FITTYPE Type of fit
1: Uniaxial
2: Biaxial
LCSR Load Curve Id defining uniaxial (or biaxial, depending on FITTYPE)
Stress ratio vs. Transverse Stretch Ratio
R Mullinus effect model r coefficient
M Mullinus effect model m coefficient
See Also:
• LS-DYNA Keyword User’s Manual
244
Materials
MAT_VISCOELASTIC_HILL_FOAM
Defines the properties for a material model to simulate a highly compressible foam based on strain energy
function, proposed by Hill. with extensions to include large strain viscoelasticity proposed by Feng and
Hallquist [2002].
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
K Bulk Modulus
N Material constant
MU Damping coefficient
LCID Load Curve Id defining Force per unit area vs. Stretch Ratio
FITTYPE Type of fit
1: Uniaxial
2: Biaxial
LCSR Load Curve Id defining uniaxial (or biaxial, depending on FITTYPE)
Stress ratio vs. Transverse Stretch Ratio
LCVE Load Curve Id defining the Relaxation function in shear
NT No. of Prony series terms in fit
GSTART Starting value for least square fit
See Also:
• LS-DYNA Keyword User’s Manual
Materials 245
Materials
MAT_LOW_DENSITY_SYNTHETIC_FOAM
Defines the properties of rate independent low density foams exhibiting considerably reduced properties
in the loading-unloading curve after the first loading cycle.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
LCID1 Load Curve Id defining nominal Stress vs. Strain for the first loading cycle
LCID2 Load Curve Id defining nominal Stress vs. Strain for loading cycles after
the first loading cycle is completed
HU Hysteric unloading factor between 0 and 1
BETA Decay constant to model creep in unloading
DAMP Viscous coefficient
SHAPE Shape factor for unloading
FAIL Failure option after cutoff stress
Field Comments
BVFLAG Bulk viscosity activation flag
0: No
1: Active
ED Optional Young’s relaxation modulus for rate effects
BETA1 Optional decay constant
KCON Stiffness coefficient for contact interface stiffness
REF Use reference geometry to initialize stress tensor
0: Off
1: On
TC Tension Cutoff Stress
RFLAG Rate type for input:
See Also:
• LS-DYNA Keyword User’s Manual
MAT_LOW_DENSITY_SYNTHETIC_FOAM_ORTHO
Defines the properties of rate independent low density foams exhibiting considerably reduced properties
in the loading-unloading curve after the first loading cycle. This material model considers any orthotropic
behavior after the first loading and unloading cycle of the material in the orthogonal directions.
Materials 247
Materials
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
LCID1 Load Curve Id defining nominal Stress vs. Strain for the first loading cycle
LCID2 Load Curve Id defining nominal Stress vs. Strain for loading cycles after
the first loading cycle is completed
HU Hysteric unloading factor between 0 and 1
BETA Decay constant to model creep in unloading
DAMP Viscous coefficient
SHAPE Shape factor for unloading
FAIL Failure option after cutoff stress
Field Comments
BVFLAG Bulk viscosity activation flag
0: No
1: Active
ED Optional Young’s relaxation modulus for rate effects
BETA1 Optional decay constant
KCON Stiffness coefficient for contact interface stiffness
REF Use reference geometry to initialize stress tensor
0: Off
1: On
TC Tension Cutoff Stress
RFLAG Rate type for input:
See Also:
• LS-DYNA Keyword User’s Manual
Materials 249
Materials
MAT_SIMPLIFIED_RUBBER/FOAM
Defines the properties of a rubber amd foam model defined by a single uniaxial load curve or by a family
of curves at discrete strain rates.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
KM Linear Bulk Modulus
MU Damping coefficient
G Shear Modulus
SIGF Limit stress for frequency independent, frictional, damping
REF Use Reference Geometry (defined in
*INITIAL_FOAM_REFERENCE_GEOMETRY) to initialize the stress
tensor. 0 = ON ; 1 = OFF
PRTEN Tensile Poisson’s ratio.
= 0 indicates that PR/BETA will serve as Poisoon’s ratio for both tension
and compression in shells. Otherwise, PR/BETA will serve as Poisoon’s
ratio for compression in shells.
SGL Specimen Gauge Length
SW Specimen Width
ST Specimen Thickness
250
Materials
Field Comments
LCID Load Curve Id defining Force vs. Actual change in gauge length
TENSION Parameter to control rate effect
-1: Rate effects are treated for loading either in tension or in compression
(but not for unloading)
1:Rate effects are treated identically for tension and compressive loading
only
RTYPE Strain rate type
0: True
1: Engineering
AVGOPT Averaging option to determine strain rate (to reduce numerical noise)
See Also:
• LS-DYNA Keyword User’s Manual
Materials 251
Materials
MAT_SEISMIC_BEAM
Defines the properties of a material characterized by lumped plasticity to be developed at the ‘node 2’
end of Belytschko-Schwer beams. The plastic yield surface allows interaction between the two moments
and the axial force.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
AOPT Axial force option
NE. 0: Axial Load Curves are Collapse Load vs. Change in Length
252
Materials
Field Comments
FTYPE Formulation type for interaction
1: Parabolic coefficients
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SOIL_BRICK
Defines the properties of clay like soils accurately.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
RLAMDA, RKAPPA, Material coefficient
RIOTA, RBETAi
RMU Shape factor coefficient
RNU Poisson’s ratio
RLCID Load Curve Id referring to a curve defining up to ten pairs of ‘string-length’
vs. G/Gmax points.up to 10 points of string-length vs. Gmax
TOL User defined tolerance for convergence checking
PGCL Pre consolidation ground level
SUB-INC User defined strain increment size
BLK Elastic bulk stiffness of the soil
GRAV Gravitational acceleration
254
Materials
Field Comments
THEORY Version of material subroutine used
See Also:
• LS-DYNA Keyword User’s Manual
MAT_DRUCKER_PRAGER
Defines the properties of materials such as soils modeled with the modified Drucker-Prager yield surface.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
GMOD Elastic Shear Modulus
RNU Poisson’s ratio
RKF Failure surface shape parameter
Materials 255
Materials
Field Comments
PHI Angle of friction (radians)
CVAL Cohesive Value
PSI Dilation angle (radians)
STR_LIM Factor for calculating minimum shear strength of material which is
calculated as STR_LIM*CVAL
GMODDP Depth at which shear modulus is correct
PHIDP Depth at which friction angle is correct
CVALDP Depth at which cohesive value is correct
PSIDP Depth at which dilation angle is correct
GMODGR Gradient at which shear modulus increases with depth
PHIGR Gradient at which friction angle increases with depth
CVALGR Gradient at which cohesive value increases with depth
PSIGR Gradient at which dilation angle increases with depth
See Also:
• LS-DYNA Keyword User’s Manual
256
Materials
MAT_RC_SHEAR_WALL
Defines the properties of materials to model cyclic shear loading of reinforced concrete walls (available
only for shell elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
TMAX Ultimate shear stress
Materials 257
Materials
Field Comments
Fc Unconfirmed compressive strength of Concrete
PREF Percent reinforcement
FYIELD Yield stress of reinforcement
SIG0 Overburden stress
UNCONV Unit conversion factor, to compute ultimate tensile stress of Concrete
ALPHA Shear span factor
FT Cracking stress in direct tension
ERIENF Young’s Modulus for reinforcement
A, B, C, D, E Hysteresis constants to determine shape of the hysteresis loops
F Strength gradient factor
Yi Shear strain points on stress vs. strain curve
Ti Shear stress points on stress vs. strain curve
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
258
Materials
MAT_CONCRETE_BEAM
Defines an elasto-plastic material with an arbitrary stress-strain curve and arbitrary strain rate
dependency. Also, failure based on plastic strain or a minimum time step can be defined.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
E Young’s Modulus
PR Poisson’s Ratio
SIGY Yield Stress
ETAN Tangent Modulus
C, P Strain Rate Parameters
FAIL Failure Flag
TDEL Minimum time step size for automatic element deletion
LCSS Load Curve Id defining Effective Stress vs. Effective Plastic Strain in
compression
LCSR Load Curve Id defining Strain rate effects on Yield Stress
Materials 259
Materials
Field Comments
NOTEN No-tension flag
0: Takes tension
See Also:
• LS-DYNA Keyword User’s Manual
MAT_GENERAL_SPRING_DISCRETE_BEAM
Defines the properties of materials with elastic and elastoplastic springs with damping to be represented
by discrete beam elements using six springs, each acting along one of the six local degrees-of-freedom.
260
Materials
For elastic behavior, use a load curve of yield force or moment versus displacement or rotation. For
inelastic case, use a load curve of yield force or moment versus plastic deflection or rotation.
Materials 261
Materials
262
Materials
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
DOFi Active degree-of-freedom
TYPEi Behavior
0: Elastic
1: Inelastic
Ki Elastic loading/unloading stiffness
Di Optional viscous damping coefficient
CDFi Compressive displacement at failure
TDFi Tensile displacement at failure
FLCIDi Load Curve Id defining Force (or Moment) vs. Displacement for nonlinear
elastic (TYPE1 = 0). For inelastic behavior, this curve defines the yield
force vs. plastic deflection.
HLCIDi Load Curve Id defining Force vs. Relative Velocity
C1_i, C2_i Damping coefficients
DLEi Scale factor for time unit
GLCIDi Load Curve Id defining scale factor vs. deflection for HLCIDi
See Also:
• LS-DYNA Keyword User’s Manual
Materials 263
Materials
MAT_SEISMIC_ISOLATOR
Defines the properties of materials used as sliding and elastometric seismic isolation bearings. This
material model uses a bi-directional coupled plasticity theory (available only for discrete beam elements).
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
A, GAMMA, BETA Non dimensional variable
DISPY Yield displacement
STIFFV Vertical stiffness
ITYPE Type
0: Sliding
1: Elastomeric
PRELOAD Vertical preload
DAMP Damping ratio
MXi Moment factor at end i in local x direction
MYi Moment factor at end i in local y direction
FMAX Maximum dynamic friction coefficient
264
Materials
Field Comments
DELF Difference between maximum and Static Friction coefficient
AFRIC Velocity multiplier in sliding friction equation
RADX Radius for sliding in local x direction
RADY Radius for sliding in local y direction
RADB Radius of retaining ring
STIFFL Stiffness for lateral contact against retaining ring
STIFFTS Stiffness for tensile vertical response (sliding)
FORCEY Yield force
ALPHA Ratio of post and pre yielding stiffness
STIFFT Stiffness for tensile vertical response (elastomeric)
DFAIL Lateral displacement at which isolator fails
FMAXYC Maximum dynamic friction coefficient in compression in local y-direction
FMAXXT Maximum dynamic friction coefficient in tension in local x-direction
FMAXYT Maximum dynamic friction coefficient in tension in local y-direction
YLOCK Stiffness locking the local y- displacement (optional in single axis sliding)
See Also:
• LS-DYNA Keyword User’s Manual
Materials 265
Materials
MAT_JOINTED_ROCK
Defines the properties of jointed rocks.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
RO Mass Density of the material
GMOD Elastic Shear Modulus
RNU Poisson’s ratio
RKF Failure surface shape parameter
PHI Angle of friction (radians)
CVAL Cohesive Value
PSI Dilation angle (radians)
STR_LIM Factor for calculating minimum shear strength of material which is
calculated as STR_LIM*CVAL
NPLANES No of joint planes
266
Materials
Field Comments
ELASTIC Flag for Elastic Behavior
0: Non elastic
1: Elastic
LCCPDR Load Curve Id for extra cohesion for parent material (dynamic relaxation)
LCCPT Load Curve Id for extra cohesion for parent material (transient)
LCCJDR Load Curve Id for extra cohesion for joints (dynamic relaxation)
LCCJT Load Curve Id for extra cohesion for joint material (transient)
LCSFAC Load Curve Id giving factor on Strength vs. Time
GMODDP Depth at which shear modulus is correct
PHIDP Depth at which friction angle is correct
CVALDP Depth at which cohesive value is correct
PSIDP Depth at which dilation angle is correct
GMODGR Gradient at which shear modulus increases with depth
PHIGR Gradient at which friction angle increases with depth
CVALGR Gradient at which cohesive value increases with depth
PSIGR Gradient at which dilation angle increases with depth
DIPi Angle (degrees) of plane below the horizontal
STRIKEi Plan view angle (degrees) of downhill vector drawn on the plane
CPLANEi Cohesion for shear behavior on plane i
FRPLANEi Friction angle for shear behavior on plane i
TPLANEi Tensile strength across plane i
SHRMAXi Maximum shear stress on plane i
LOCALi DIP and STRIKE Coordinate System flag
See Also:
• LS-DYNA Keyword User’s Manual
Materials 267
Materials
MAT_SPRING_ELASTIC
Defines the properties of a translational or rotational elastic spring placed between two nodes. Only one
degree of freedom is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
K Elastic Stiffness (Translational or Rotational)
See Also:
• LS-DYNA Keyword User’s Manual
MAT_DAMPER_VISCOUS
Defines the properties of translational and rotational dampers located between two nodes. Only one
degree of freedom is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
DC Damping Constant (Force/Displacement rate or Moment/Rotation rate)
268
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPRING_ELASTOPLASTIC
Defines the properties of discrete springs providing an elastoplastic translational or rotational spring with
isotropic hardening located between two nodes. Only one degree of freedom is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
K Elastic Stiffness (Translational or Rotational)
KT Tangent Stiffness
FY Yield Force or Moment
See Also:
• LS-DYNA Keyword User’s Manual
Materials 269
Materials
MAT_SPRING_NONLINEAR_ELASTIC
Defines the properties of discrete springs providing a nonlinear elastic translational or rotational spring
with arbitrary force versus displacement and moment versus rotation data. Only one degree of freedom
is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
LCD Load Curve Id defining Force vs. Displacement or Moment vs. Rotation
LCR Load Curve Id defining Scale factor on Force or Moment as a function of
relative velocity, or rotational velocity respectively
See Also:
• LS-DYNA Keyword User’s Manual
270
Materials
MAT_DAMPER_NONLINEAR_VISCOUS
Defines the properties of discrete dampers providing a viscous translational or rotational damper with
arbitrary force versus velocity or a moment versus rotational velocity data. Only one degree of freedom
is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
LCDR Load Curve Id defining the Force vs. rate of Displacement or Moment vs.
rate of Rotation relationship
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPRING_GENERAL_NONLINEAR
Defines the properties of discrete springs providing a general nonlinear translational or rotational spring
with arbitrary loading and unloading data. It also considers hardening or softening. Only one degree of
freedom is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
Materials 271
Materials
Field Comments
MID Material identification number (Integer > 0)
LCDL Loading Curve Id for Force vs. Displacement or Moment vs. Rotation
LCDU Unloading Load Curve Id for Force vs. Displacement or Moment vs.
Rotation
BETA Hardening parameter
TYI Initial Yield force in tension
CYI Initial Yield force in compression
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPRING_MAXWELL
Defines the properties of discrete springs providing a three Parameter Maxwell Viscoelastic translational
or rotational spring. Only one degree of freedom is connected.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
K0 Short term stiffness
KI Long term stiffness
BETA Decay constant
TC Cutoff time. After this time a constant force/moment transmitted
272
Materials
Field Comments
FC Force/Moment after cutoff time
COPT Time implementation option
See Also:
• LS-DYNA Keyword User’s Manual
MAT_SPRING_INELASTIC
Defines the properties of discrete springs and dampers providing an inelastic tension or compression
only, translational or rotational spring.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
LCFD Load Curve Id defining the Force/Torque vs. Displacement/Twist
relationship
KU Unloading Stiffness
CTF Flag for compression/tension
See Also:
• LS-DYNA Keyword User’s Manual
Materials 273
Materials
MAT_SPRING_TRILINEAR_DEGRADING
Defines the properties of concrete shear walls under seismic loading modelled as discrete elements. It
represents cracking of the concrete, yield of the reinforcement, and overall failure.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
DEFL1 Deflection at point where concrete cracks
F1 Force corresponding to DEFL1
DEFL2 Deflection at reinforcement yield
F2 Force corresponding to DEFL2
DEFL3 Deflection at complete failure
F3 Force corresponding to DEFL3
FFLAG Failure Flag
See Also:
• LS-DYNA Keyword User’s Manual
274
Materials
MAT_SPRING_SQUAT_SHEARWALL
Defines the properties of squat shear walls modelled as discrete elements. This material model allows
concrete cracking, reinforcement yield, and ultimate strength, followed by degradation of strength,
leading finally to collapse.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
A14, B14, C14, D14, Material coefficient
E14
LCID Load Curve Id referencing the maximum strength envelope curve
FSD Sustained strength reduction factor
See Also:
• LS-DYNA Keyword User’s Manual
Materials 275
Materials
MAT_SPRING_MUSCLE
Defines the properties for discrete springs and dampers. This is a Hill-type muscle model with activation.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
L0 Initial muscle length
VMAX Maximum CE shortening velocity
SV Scale factor for Vmax vs. Active State
A Scale factor for Activation Level vs. Time function
FMAX Peak isometric force
TL Scale factor for Active tension vs. length function
TV Scale factor for Active tension vs. velocity function
FPE Scale factor for Force vs. length function, for parallel elastic element
LMAX Relative length at FPE=FMAX
KSH Constant governing the exponential rise of FPE
LCID_SV Load Curve Id defining Vmax vs. active state
LCID_A Load Curve Id defining Active level vs. Time function
LCID_TL Load Curve Id defining Active tension vs. Length function
LCID_TV Load Curve Id defining Active tension vs. velocity function
LCID_FPE Load Curve Id defining Force vs. Length function
See Also:
• LS-DYNA Keyword User’s Manual
276
Materials
MAT_THERMAL_ISOTROPIC
Defines isotropic thermal properties of materials in coupled structural/thermal and thermal only analyses.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
TRO Thermal Density
TGRLC Thermal generation rate value
TGMULT Thermal generation rate multiplier
TLAT Phase chnage temperature
HLAT Latent heat
HC Heat capacity
TC Thermal conductivity
See Also:
• LS-DYNA Keyword User’s Manual
MAT_THERMAL_ORTHOTROPIC
Defines orthotropic thermal properties in coupled structural/thermal and thermal only analyses.
Materials 277
Materials
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
TRO Thermal Density
TGRLC Thermal generation rate value
TGMULT Thermal generation rate multiplier
AOPT Material Axes option
Field Comments
K1, K2, K3 Thermal conductivity in local x, y and z, respectively
XP X-coordinate of point p for AOPT=1
YP Y-coordinate of point p for AOPT=1
ZP Z-coordinate of point p for AOPT=1
Ai Component of Vector a, for AOPT=2
Di Component of Vector d, for AOPT=2
See Also:
• LS-DYNA Keyword User’s Manual
MAT_THERMAL_ISOTROPIC_TD
Defines temperature dependent isotropic thermal properties in coupled structural/thermal and thermal
only analyses.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
TRO Thermal Density
TGRLC Thermal generation rate value
Materials 279
Materials
Field Comments
TGMULT Thermal generation rate multiplier
TLAT Phase chnage temperature
HLAT Latent heat
LC_C Load Curve defining Heat capacity (C) Vs. Temperature
LC_K Load Curve defining Thermal Conductivity (K) Vs. Temperature
See Also:
• LS-DYNA Keyword User’s Manual
MAT_ORTHOTROPIC_TD
Defines temperature dependent orthotropic thermal properties in coupled structural/thermal and thermal
only analyses.
280
Materials
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
TRO Thermal Density
TGRLC Thermal generation rate value
TGMULT Thermal generation rate multiplier
AOPT Material Axes option
See Also:
• LS-DYNA Keyword User’s Manual
Materials 281
Materials
MAT_THERMAL_ISOTROPIC_PHASE_CHANGE
Defines temperature dependent isotropic properties with phase changes in coupled structural/thermal and
thermal only analyses.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
TRO Thermal Density
TGRLC Thermal generation rate value
TGMULT Thermal generation rate multiplier
LC_C Load Curve defining Heat capacity Vs. Temperature
LC_K Load Curve defining Thermal conductivity Vs. Temperature
SOLT Solid Temperature
LIQT Liquid Temperature
LH Latent Heat
282
Materials
See Also:
• LS-DYNA Keyword User’s Manual
MAT_THERMAL_ISOTROPIC_TD_LC
Defines temperature dependent isotropic thermal properties by specifying a load curve in coupled
structural/thermal and thermal only analyses.
Field Comments
Title Unique name identifying material model
Desc Optional description of the material model
TITLE_OPTION If selected material title option is used
MID Material identification number (Integer > 0)
TRO Thermal Density
TGRLC Thermal generation rate value
TGMULT Thermal generation rate multiplier
HCLC Load Curve Id specifying Heat capacity vs. Temperature
TCLC Load Curve Id specifying Thermal conductivity vs. Temperature
TGRLCID Load Curve Id specifying Thermal generation rate curve number
See Also:
• LS-DYNA Keyword User’s Manual
Properties 273
Properties
274
Properties
Properties
Overview
Typical properties include cross-sectional properties of beam elements, thicknesses of plate and shell
elements, element integration rules, and hourglass controls. Properties are assigned to the elements of a
specified part or element type, either directly to the elements, or indirectly through the part to which the
elements belong.
*SECTION_SHELL - The thin shell elements are commonly referred to as the plate and shell elements
within SimXpert. Their properties, are defined using the *SECTION_SHELL entry. The format of the
*SECTION_SHELL entry is as follows:
276
Properties
Field Contents
SECID Section ID, to be referred by parts
ELFORM Element formulation options
= 1: Hughes-Liu
= 2: Belytscho-Tsay
= 4: C0 triangular shell
= 5: Belytscho-Tsay membrane
= 6: S/R Hughes-Liu
= 8: Belytscho-Leviathan shell
= 10: Belytscho-Wong-Chiang
= 21: Fully integrated linear assumed strain (5 DOF per node) C0 shell
Field Contents
PROPT Printout options
= 0: Homogeneous
=1: Composite
SETYP 2D solid element type (defined for ELFORM 13, 14, and 15)
= 1: Lagrangian
= 3: ALE
T1 Shell thickness at node 1
T2, T3, T4 Shell thickness at nodes 2, 3, and 4 respectively
NLOC Location of reference surface normal to s axis (Hughes-Liu elements:
ELFORM = 1 or 6)
MAREA Nonstructural mass per unit area
IDOF Applies to shell element types 25 and 26.
.EQ. 1(default): The thickness field is continuous across the element edges for
metal-forming applications.
.EQ. 2: The thickness field is discontinuous across the element edges. This is
necessary for applications such as crashworthiness where shell intersections,
sharp included angles, and non-smooth deformations exist.
EDGSET Edge node set, required for shell type seatbelts.
AFAC Smoothing weight factor - simple average (No smoothing if value is -1.)
BFAC Smoothing weight factor - volume weighting
278
Properties
Field Contents
CFAC Smoothing weight factor - isoparametric
DFAC Smoothing weight factor - equipotential
EFAC Smoothing weight factor - equilibrium
START Start time for smoothing
END End time for smoothing
AAFAC ALE advection factor
DX, DY Normalized dilatation parameters of the kernel function in X and Y directions
respectively
ISPLINE Replaces choice for the EFG kernel functions definition in *CONTROL_EFG.
IDILA Replaces choice for the normalized dilation parameter definition in
*CONTROL_EFG.
IRID Integration Rule Id (User defined)
The element coordinate systems for the shell element is shown in Figure 2. The orientation of the element
coordinate system is determined by the order of the connectivity for the nodes. The element z-axis, often
referred to as the positive normal, is determined using the right-hand rule. Therefore, if you change the
order of the nodal connectivity, the direction of this positive normal also reverses. This rule is important
to remember when applying pressure loads or viewing the untransformed element forces or stresses.
Untransformed directional element stress plots may appear strange when they are displayed by the
postprocessor in SimXpert because the normals of the adjacent elements may be inconsistent. Remember
that components of forces, moments, and element stresses are always output in the element coordinate
system.
See Also:
• LS-DYNA Keyword User’s Manual
Properties 279
Properties
*ELEMENT_TSHELL - Eight noded thick shell element useful for modeling thick plated components.
Unlike the thin shell element, *ELEMENT_SHELL which represents the plate through the middle
surface, and thickness, the 8-noded thick shell element represents plate as a hexahedron, the first four
nodes representing the bottom surface, and the last four nodes representing the top surface. The thick
280
Properties
shell wedge element is defined by repeating the third for the fourth node, and repeating the seventh for
the eighth node
.
SECTION_TSHELL
The properties of the thick shell elements are defined using the *SECTION_TSHELL entry. The format
of the *SECTION_TSHELL entry is as follows:
Field Contents
SECID Section ID, to be referred by parts
ELFORM Element formulation options
SHRF Shear correction factor (a value of 5/6 recommended for solid section plate)
NIP Number of through thickness integration points. (If NIP = 0, the Default value
of 2 is used)
PROPT Printout options
Field Contents
QR Quadrature rule
= 0: Homogeneous
=1: Composite
IRID Integration Rule Id (User defined)
B1 Material angle (β1) at first integration point. This angle is measured with
respect to the element edge n1-n2.
The orientation of the element coordinate system is determined by the order of the connectivity for the
nodes. The element z-axis (the thickness direction) often referred to as the positive normal to the face
connected by nodes n1, n2, n3, and is determined using the right-hand rule (cross product of edge vectors
n1-n2 and n1-n3). Therefore, if you change the order of the nodal connectivity, the direction of this
positive normal also reverses. This rule is important to remember when applying pressure loads or
viewing the untransformed element forces or stresses. Untransformed directional element stress plots
may appear strange when they are displayed by the postprocessor in SimXpert because the normals of
the adjacent elements may be inconsistent. Remember that components of forces, moments, and element
stresses are always output in the element coordinate system.
See Also:
• LS-DYNA Keyword User’s Manual
Three-Dimensional Elements
Whenever you need to model a structure that does not behave as a bar or plate structure under the applied
loads, you need to use one or more of the three-dimensional elements. The three-dimensional elements
are commonly referred to as solid elements. Typical engineering applications of solid elements include
engine blocks, brackets, and gears.
4. 10 noded tetrahedron
SECTION_SOLID
The properties of the solid elements are entered on the *SECTION_SOLID form shown below:
Field Contents
Title Unique name identifying the section.
SECID Section ID, to be referred by parts
Properties 285
Properties
Field Contents
ELFORM Element formulation options
= 5: 1 point ALE
= 6: 1 point Eulerian
= 8: acoustic
= 18: 8 point enhanced strain solid element for linear statics only
AET Ambient element type (foe ELFORM = 7, 11 or 12)
= 3: pressure outflow
Field Contents
DFAC Smoothing weight factor - equipotential
START End time for smoothing
END Start time for smoothing
AAFAC ALE advection factor
DX, DY, DZ Normalized dilatation parameters of the kernel function in X, Y, and Z directions
respectively
ISPLINE Replaces choice for the EFG kernel functions definition in *CONTROL_EFG..
Field Contents
IDIM Domain integration method:
See Also:
• LS-DYNA Keyword User’s Manual
One-Dimensional Elements
A one-dimensional element is one in which the properties of the element are defined along a line or curve.
Typical applications for the one-dimensional element include trusses, beams, and stiffeners. One-
288
Properties
dimensional elements discussed in this chapter include 3D beams, trusses, 2D axisymmetric shells, and
2D plane strain beam elements.
SECTION_BEAM
Properties 289
Properties
The properties of the one dimensional elements are entered on the *SECTION_BEAM form shown
below:
Field Contents
SECID Section ID, to be referred by parts
ELFORM Element formulation options
= 3: Truss resultant
= 6: Discrete beam/cable
Field Contents
QR Quadrature rule or rule number for user defined integration rule
= 1: 1 point integration
= -n: where the absolute value of n is the number of the user defined rule.
CST Cross section type (Not needed for truss, resultant beam, discrete beam, and
cable elements)
= 0: rectangular
See Also:
• LS-DYNA Keyword User’s Manual
Properties 291
Properties
Discrete Elements
Discrete elements in SimXpert Crash comprise of spring and damper elements used between two nodes,
or a node and ground.
SECTION_DISCRETE
The properties of the discrete elements are entered on the *SECTION_DISCRETE form shown below:
Field Contents
SECID Section ID, to be referred by parts
DRO Displacement/Rotation Option:
See Also:
• LS-DYNA Keyword User’s Manual
Seatbelt Elements
Seat belt elements are elements with single degree of freedom, connecting two nodes.
292
Properties
SECTION_SEATBELT
The properties of the seat belt elements are entered on the *SECTION_SEATBELT form shown below:
Field Contents
SECID Section ID, to be referred by parts
See Also:
• LS-DYNA Keyword User’s Manual
Mass Elements
Mass elements are used to defined lumped masses to nodes. In SimXpert crash workspace, the mass
associated with the mass elements are assigned directly to the mass element, and hence no properties are
needed to be created.
See Also:
• LS-DYNA Keyword User’s Manual
Element Integration
SimXpert crash Workspace normally uses the recommended integration through thickness of beams and
shell elements. However, you can use other through-thickness integration rules using
• *INTEGRATION_BEAM for defining through thickness integration rules for the beam elements
• *INTEGRATION_SHELL for defining through thickness integration rules for both the thin and
thick shell elements.
See Also:
• LS-DYNA Keyword User’s Manual
Properties 293
Properties
Hourglassing
The advantage of the reduced integration elements is that the strains and stresses are calculated at the
location that provide optimal accuracy, the so-called Barlow points. The reduced integration elements
also tend to underestimate the stiffness of the element which often gives better results in a typically
overly-stiff finite element analysis displacement method. An additional advantage is that the reduced
number of integration points decreases CPU time and storage requirements. The disadvantage is that the
reduced integration procedure may admit deformation modes that cause no straining at the integration
points. These zero-energy modes cause a phenomenon called “hourglassing,” where the zero energy
mode starts propagating through the mesh, leading to inaccurate solutions. This problem is particularly
severe in first-order quadrilaterals and hexahedrals. To prevent these excessive deformations, an
additional artificial stiffness is added to these elements. In this so-called hourglass control procedure, a
small artificial stiffness is associated with the zero-energy modes. This procedure is used in many of the
solid and shell elements in SimXpert crash Workspace Use the *HOURGLASS keyword data to define
hourglass and bulk viscosity properties which are referenced via the HGID in the *part command.
.
Figure 7 Hourglassing
See Also:
• LS-DYNA Keyword User’s Manual
294
Properties
Meshing and Element Creation 293
Modeling Guidelines
Finite element modeling in many ways is more like an art than a science since the quality of the results
is dependent upon the quality of your model. One of the more common errors that a beginning finite
element analyst makes in modeling is to simply simulate the geometry rather than to simulate both the
geometry and the physical behavior of the real structure. The following modeling guidelines are provided
to put a little more science back into the art of finite element modeling:
• Choosing the right element.
• Mesh transitions.
The above guidelines are by no means complete; however, they do serve as a good starting point. There
is no better substitute for good modeling than experience. It is also good modeling practice to simulate
and validate a new capability or a feature that you have not used before with a small prototype model
before applying this feature to your production model. Model verification techniques are covered in
Quality Checks, 297.
SimXpert contains a large library of structural elements. In many situations several elements are capable
of modeling the same structural effects. The criteria for the selection of an element may include its
capabilities (for example, whether it supports anisotropic material properties), the amount of time
required to run an analysis (in general, the more DOF an element has, the longer it runs), and/or its
accuracy.
In many cases the choice of the best element for a particular application may not be obvious. For
example, in the model of a space frame, you may choose to use truss elements if bending or torsional
stiffness is unimportant or to use the beam elements with axial, bending and torsional stiffness. You may
even choose to represent the members with built-up assemblies of plate or solid elements. The choice of
which type and number of elements to use depends primarily on your assessment of the effects that are
important to represent in your model and on the speed and accuracy you are willing to accept.
In this context, it is critical that you have a fairly good idea of how the structure will behave prior to
generating your finite element model. The best source of such insight is usually experience with similar
structures or components. In other words, understanding the load path is crucial in the selection of the
appropriate element. In addition, a few hand calculations can usually provide a rough estimate of stress
intensities. Such calculations are always recommended. If you do not have a fairly good idea of how the
structure will behave, you may be misled by incorrect results due to errors or incorrect assumptions in
your input data preparation.
The following guidelines are provided to help you in selecting the “right” element for your task.
Meshing and Element Creation 295
Meshing and Element Creation
Avoid highly skewed elements (see Figure 1). The angle α should be as close to 90 degrees as possible.
Aspect ratio is defined as l ⁄ ω (length/width). Very high aspect ratio (see Figure 2) should also be
avoided in areas where there is a high stress gradient.
Warping is a measure of the amount the element deviates from being planar (see Figure 3). Element
warping should be minimized.
Element Mid-Plane
Mesh Transitions
Mesh transition can be a complicated subject. It may simply be used to refine the mesh in a particular
area, connect different element types (for example, a CBAR element to a solid element), or provide
transitions required to model the geometry of the structure. Two guidelines for mesh transitions are as
follows:
1. Never place a mesh transition in an area of interest or in an area where there is a large variation
in stress.
2. Mesh transitions should be located away from the areas of interest in a region.
296
Meshing and Element Creation
Due to incompatibilities between finite element types, any transition between different element types
(even a transition from quadrilateral to a triangular elements) can result in local stress anomalies.
Normally, these stress anomalies are localized and dissipate quickly as you move away from the
transition. However, a problem arises when the transition occurs in an area of interest. In this case, the
local stress rises (or decreases) due to the effect of the transition; in other words, the results may be
conservative (or non-conservative) in an area near a transition. However, if this localized stress variation
occurs away from areas of interest, the increase (or decrease) in stress caused by the transition should
cause no concern.
• Transition from a Coarse Mesh to a Fine Mesh
The transition from a coarse mesh to a fine mesh, or vice versa, may not always be an easy task. One
common method of performing a transition is to use an intermediate belt of triangular elements as shown
in Figure 4.
Q4 Q4 T3
T3 Q4
Q4 Q4 T3
Q4 Q4 T3
T3 Q4
Q4 Q4 T3
Mesh Control
Before you create elements, you should first specify a default mesh size by selecting Element Options
from the Elements menu. Mesh sizes can also be set interactively using Mesh Size from the Elements
menu. In addition you can also define hard points on curves or surfaces to ensure that a node is placed at
that location. You do this using Create Hard Points from the Geometry menu. Mesh should have high
density in areas of large stress gradients.
Meshing
Automeshing
You can use the selections under Automeshing to create multiple elements on geometry.
• Automesh - Used to create quadrilateral and triangular plate/shell elements on surfaces.
• Solid Mesher - Used to create a tetrahedral mesh inside bounding surfaces
• Interactive Mesh Size - Interactively modifies the number of elements along a selected curve
Meshing and Element Creation 297
Meshing and Element Creation
Manual Meshing
You can use the selections under Manual Meshing to create mesh without having surfaces.
• 2-3-4 Line Mesh - Creates a mapped mesh by selecting 2,3, or 4 bounding curves. User can
modify the number of elements to be created on each curve. Set or modify the mesh elements
parameters using Params button from the pick menu.
• 3-4 Point Mesh - Creates mesh between the 3 or 4 selected points. You can specify the number of
elements to be created between each pair of selected points. Points should be selected in a
circular manner.
• Drag Mesh - Creates a solid or shell mesh by dragging elements or nodes along a specified
vector or curve.
• Flange Creation - Creates a flange by dragging selected nodes through a specified width and
angle.
• Linear Solid Mesh - Creates solid elements between two groups of shell elements.
• Refine Mesh - Refines the selected mesh region to specified edge length, while maintaining
element connectivity with congruent elements.
• Spin Mesh - Creates solid or shell elements by rotating shell elements or nodes through a
specified angle about a vector.
Quality Checks
Free Edges
You can check that your model has completed merging coincident nodes by displaying free edges in your
model. In Figure 5 the model is shown with free edges displayed by selecting Highlight FE Boundary
from the View menu.The picture on the left shows the model with a solid horizontal line running through
the middle. This indicates that a free edge exists there and the top and bottom are not connected. The
298
Meshing and Element Creation
picture on the right shows the model after the coincident nodes have been merged. The model is now one
continuos piece.
I
Free
(unconnected)
edge
Before After
Figure 5 Free Edge Check - Before and After Merge Coincident Nodes
You can enforce consistent normals by now clicking Fix Normal in the Mode list and then selecting a
reference element with the desired normal direction. You could also click Rev. Normal and then select
the elements on which to reverse normals.
• Warp check: Evaluates how far out of plane the element ‘bends’. Warp is computed by
determining the angle between the normals of 2 triangular regions superimposed on the element.
This check is also applicable to quad faces of solid elements.
• Taper check: Compares the ratios of the lengths of opposite edges of an element.
• Skew check: Compares the maximum angles between the element diagonals.
300
Meshing and Element Creation
• Interior Angle check: Evaluates the interior angles measured at each of the four (or 3) corner
nodes.
If any element exceeds minimum or maximum tolerance levels specified for an element check, it is
considered to have failed that test.
SimXpert can compute a Quality Index which is a weighted composite of all the selected quality checks.
You can toggle the display of the Quality Index from the Bottom Block by selecting Fringes On/Off from
the FE-Grafix menu.
Elements that violate any of the activated quality criteria will be displayed in magenta.
Those elements color-coded red to orange have marginal quality. You can further investigate which
specific tests your elements may be failing by selecting the individual quality measure from the FE-Qual
Meshing and Element Creation 301
Meshing and Element Creation
menu and your display will update accordingly. The following image shows the model now color-coded
based on Warpage.
Once again, failed elements are shown in magenta. Elements with a high value that does not exceed the
threshold are color-coded red or orange.
• Mesh Quality - Element / Quality / Quick Quality - allows you to select elements for mesh
quality enhancement then select desired parameters as shown below:
• Fast Shell Enhancing attempts to fix failed elements only. Once they pass all selected criteria,
no further enhancement is attempted.
• Slow Shell Enhancing attempts to fix failed elements and also to further improve all selected
elements.
• All passes except Warp Enhancing will maintain nodes on the FE-Surface.
Warp Enhancing will move the node (within the specified tolerance) normal to the surface to decrease
the warping.
Loads and Boundary Conditions 303
Single-Point Constraints
A Single-Point Constraint (SPC) is a constraint that is applied to a single degree of freedom, which may
be either a component of motion at a node or the displacement of a scalar point.
The primary applications for single-point constraints are:
1. To tie a structure to ground.
2. To apply symmetric or anti symmetric boundary conditions by restraining the degrees of freedom
that must have a zero value to satisfy symmetry or anti symmetry. Symmetry is discussed in the
Modeling Guide.
3. To remove degrees of freedom that are not used in the structural analysis (that is, are not
connected to any structural elements or otherwise joined to the structure).
SPC BC
• *BOUNDARY_SPC constraints usually specified at model boundaries to define rigid support
points. These can also be used to apply an enforced nonzero displacement. Directions are in the
applicable nodal coordinate system.
Loads and Boundary Conditions 305
Loads and Boundary Conditions
C u
k =1
k k = C0
where uk are the displacements/rotations, and Ck are the user defined coefficients.
Nodal BC
• FORCE and MOMENT -- Concentrated forces and moments, which are applied directly to
nodes. The magnitude is entered directly. The direction is defined by selecting an appropriate
degree-of-freedom (DOF) code. The node or nodes to which forces or moments are to be
applied, can be selected directly or via node set. Follower forces and moments can also be
applied. The temporal variation of the force or moment can be defined by using a load versus
time curve (LCID).
• Boundary Sliding Plane -- Boundary conditions at nodes on symmetry planes defined by
creating the symmetry plane.
• Boundary Temperature -- Temperature Boundary Conditions at nodes for thermal loading, or
temperature dependent materials.
• Initial Temperature -- Defines initial nodal temperatures. These can be applied either directly to
the nodes, or via node set.
• Initial Foam Reference Geometry -- Defines reference configuration for the geometry of the
foam material for initialization of stresses in the foam.
• Boundary Prescribed Motion -- Defines imposed (nonzero) nodal motion (velocity, acceleration,
or displacement) on nodes, node sets, or rigid bodies.
Element BC
• Load Shell -- Distributed pressure load applied to shell or thick shell elements, or element set.
• Load Beam -- Distributed traction load along any local axis of beam elements or a set of beams.
• Initial Strain Shell -- Applies initial strains to shell elements.
• Initial Stress Shell -- Applies initial stresses to shell elements.
• Initial Stress Beam-- Applies initial stresses to beam elements.
• Initial Stress Solid -- Applies initial stresses to solid elements.
• Initial Volume Fraction -- Defines initial volume fraction for different materials in multi-material
ALE, or in single material and void models.
• Initial Momentum -- Defines initial momentum for depositing in solid elements, to simulate
impulse loading.
306
Loads and Boundary Conditions
Load Segment
• Applies distributed pressure load over a triangular or quadrilateral segment defined by four
nodes, over each segment in a segment set.
Global BC
• BOUNDARY_CYCLIC -- Defines nodes in boundary planes for cyclic symmetry
• BOUNDARY_PRESCRIBED_MOTION -- Defines imposed (nonzero) nodal motion (velocity,
acceleration, or displacement) on nodes, node sets, or rigid bodies.
• CONSTRAINED_ADAPTIVITY -- Defines adaptive constraints to constrain nodes to the
midpoint along edges of shell elements.
• CONSTRAINED_GENERALIZED_WELD_BUTT -- Defines butt welds. Weld failures include
both plastic and brittle failures. Coincident nodes are permitted, provided local coordinates are
defined.
• CONSTRAINED_EULER_IN_EULER -- Defines coupling between materials in two
overlapping, and geometrically identical multi-materials Eulerian mesh sets. It also allows
frictional contact between two or more Eulerian materials.
• CONSTRAINED_GLOBAL -- Defines a global boundary constraint plane
• CONSTRAINED_INTERPOLATION -- Defines an interpolation constraint whereby the motion
of a single dependent node is interpolated from the motion of a set of independent nodes.
• CONSTRAINED_POINTS -- Defines constraint between two points with the specified
coordinates connecting two shell elements at locations other than nodal points.
• CONSTRAINED_RIGID_BODIES -- Defines rigid body stoppers, to conveniently control the
motion of rigid tooling in metal forming applications.
• CONSTRAINED_RIGID_BODY_STOPPERS -- Defines the merger of two rigid bodies
• CONSTRAINED_SHELL_TO_SOLID -- Defines a tie (constraint) between the edge of a shell
and solid elements.
• CONSTRAINED_TIE_BREAK -- Defines a tie (constraint) between the edge of a shell and
solid elements enabling local release as a function of plastic strain at the shell elements
surrounding the interface nodes.
• CONSTRAINED_TIED_NODES_FAILURE -- Defines a tied (constrained) node set with
failure based on plastic strains.
• CONSTRAINED_JOINT_STIFFNESS -- Defines translational and rotational joint stiffness.
Options include FLEXION-TORSION, GENERALIZED, and, TRANSLATIONAL.
• INITIAL_DETONATION -- Defines points to initiate high explosive detonations in parts
• INITIAL_GAS_MIXTURE -- Defines initial temperature and density of different gas species in
*MAT_GAS_MIXTURE for the simulation of gas mixtures.
• INITIAL_VELOCITY -- Defines initial nodal velocities using node set IDs.
• INITIAL_VEHICLE_KINEMATICS -- Defines initial kinematical information such as
orientation, yaw, pitch, and roll axes for a vehicle.
Loads and Boundary Conditions 307
Loads and Boundary Conditions
LBC Sets
Loads and boundary conditions can be grouped into sets. The applied loads can be applied independently
or in combination.
To group your applied loads into load sets select Create LBC Set from the BC menu.
Supply a name for your LBC set, then select the desired loads and boundary conditions.
Contact 309
Contact
310
Contact
Contact
Overview
The simulation of many physical problems requires the ability to model the contact phenomena. This
includes analysis of interference fits, rubber seals, tires, crash, and manufacturing processes among
others. The analysis of contact behavior is complex because of the requirement to accurately track the
motion of multiple geometric bodies, and the motion due to the interaction of these bodies after contact
occurs or breaks. This includes representing the friction between surfaces and heat transfer between the
bodies if required. The numerical objective is to detect the motion of the bodies, apply a constraint to
avoid penetration, and apply appropriate boundary conditions to simulate the frictional behavior and heat
transfer. This section gives an overview of the methods used in the SimXpert crash Workspace for
handling contact.
Contact problems can be classified as one of the following types of contact.
• Deformable-Deformable contact between single (self-contact), or multiple two- and three-
dimensional deformable bodies.
• Rigid - Deformable contact between a deformable body and a rigid body, for two- or three-
dimensional cases.
• Tied contact in two and three dimensions. This is a general capability for tying (bonding) two
deformable bodies, or a deformable body and a rigid body, to each other.
Contact problems involve a variety of different geometric and kinematic situations. Some contact
problems involve small relative sliding between the contacting surfaces, while others involve large
sliding. Some contact problems involve contact over large areas, while others involve contact between
discrete points. The approach adopted by SimXpert crash Workspace to model contact can be used to
handle most contact problems.
Contact Methodology
This section gives an overview of the methods used in the SimXpert crash Workspace for handling
contact.
Constraint Method
One side of the contact interface is called the slave side, and the other is designated as the master side.
Nodes lying in those surfaces are respectively referred to as the slave nodes and the master nodes.
Constraints are imposed on the global equations by a transformation of the displacement components of
the slave nodes along the contact interface. To keep the efficiency of the explicit time integration scheme,
the mass is lumped to the extent that only the global degrees of freedom of each master node are lumped.
Impact and release conditions are imposed to ensure the conservation of momentum.
If the mesh in the master surface zone is finer than the slave surface zone, master nodes can penetrate
through the slave surface without resistance, and create incorrect solution, especially if the interface
pressures are too high. Better choice of master and slave zoning would minimize such errors in some
Contact 311
Contact
cases. However, in some modeling situations (e.g. modeling of airbags in automotive crash applications)
good zoning in the initial configuration may be poor zoning later as the deformation progresses.
Penalty Method
The penalty method places normal interface springs between all penetrating nodes and the contact
surface. Momentum is conserved exactly without the necessity of imposing impact and release
conditions. Currently there are three formulations of the penalty algorithm.
Standard Penalty Formulation: In this formulation, the interface stiffness is chosen to be approximately
of the same order of magnitude as the stiffness of the interface element normal to the interface. If
interface pressures become large, unacceptable penetration may occur. The usual remedy of scaling up
the penalty stiffness, and scaling down the time step size increase the cost of the simulation.
Soft Constraint Penalty Formulation: In this formulation, in addition to the master and slave contact
stiffness, an additional stiffness (called the stability contact stiffness) which is based on the stability
(Courant’s criterion) of the local system comprised of two masses (segments) connected by a spring is
added. The stability contact stiffness kcs is calculated as:
where, SOFSCL is the Soft Constraint Penalty Scale factor, m* is a function of the mass of the slave node
and the master nodes, and Δtc is set to the initial solution time step.
Segment-based Penalty Formulation: This formulation uses a slave segment-master segment approach
instead of the slave node-master segment approach. It is especially very efficient for airbag self-contact
during inflation and complex contact conditions.
Contact Damping
Viscous contact damping can be added to all contact options including single surface contact. It allows
to damp out oscillations normal to the contact surfaces during metal forming operations, and it also works
effectively in removing high frequency noise in problems involving impact.
Friction
Friction in crash Workspace is based on a Coulomb formulation
See “LS-DYNA Theory Manual” for a complete description of the friction formulation.
312
Contact
Tied Contact
Tied contact or tied interfaces provides a convenient way of modeling with dissimilar (non congruent)
meshes across an interface. This can often decrease the amount of effort required to generate meshes
since it eliminates the need to match nodes across common faces of parts.
Contact Types
Different types of contact may be defined in SimXpert crash. Some of the most common contact types
are listed here. Refer to the “LS-DYNA Keyword User’s Manual” for a more complete and detailed
description.
• Automatic Nodes to Surface
• Automatic Single Surface
• Automatic One way Surface to Surface
• Automatic Surface to Surface
• Nodes to Surface
• Surface to Surface
• Tied Nodes to Surface
Contact 313
Contact
Contact Parameters
A list of the most common contact parameters are described here. Refer to the “LS-DYNA Keyword
User’s Manual” for a more complete and detailed description.
Variable Description
FS Static coefficient of friction
FD Dynamic coefficient of friction
DC Exponential decay coefficient
VC Coefficient for viscous friction
VDC Viscous damping coefficient in percent critical
PENCHK Small penetration option in contact search.
BT Birth time of contact (contact surface becomes active at this time)
DT Death time of contact (contact surface is deactivated at this time)
SFS Scale factor on default slave penalty stiffness.
SFM Scale factor on default master penalty stiffness
SST Optional thickness for slave surface (overrides true thickness)
MST Optional thickness for master surface (overrides true thickness)
SFST Scale factor for slave thickness (scales true thickness)
SFMT Scale factor for master thickness (scales true thickness)
FSF Coulomb friction scale factor
vs.F Viscous friction scale factor
CF Thermal conductivity of fluid between the slide surfaces
FRAD Radiation factor between the slide surfaces
HTC Heat Transfer conductance for close gaps
GCRIT Critical gap. Use Heat Transfer conductance defined (HTC) for gap
thickness less than the value of GCRIT
GMAX No thermal contact if gap is greater than GMAX
314
Contact
Variable Description
CD_FAC A multiplier used on the element characteristic distance for the search
algorithm.
SOFSCL Scale factor for constraint forces of soft constraint option
LCIDAB Load Curve Id defining thickness of airbag (used in airbag contacts)
MAXPAR Maximum parametric coordinate in segment search.
EDGE Edge to edge penetration check
DEPTH Option to search depth in automatic contact
BSORT Number of cycles between bucket sorts
FRCFRQ Number of cycles between contact force updates for penalty contact
formulations
PENMAX Maximum penetration distance
THKOPT Thickness option
SHLTHK Shell thickness option
SNLOG Option to enable/disable shooting node logic in thickness offset
contact
ISYMB Symmetric plane option (set to 1, to retain the correct boundary
conditions in models with symmetry.)
I2D3D Segment searching option
SLDTHK Solid element thickness (a nonzero positive value activates the contact
thickness offsets in the contact algorithm where offsets apply)
SLDSTF Solid element stiffness (a nonzero positive value overrides the bulk
modulus taken from the material model referenced by the solid
element)
IGAP Flag to improve implicit convergence behavior at the expense of
creating some sticking, if parts attempt to separate
IGNORE Option to allow/ignore initial penetrations
trackpen Flag for initial penetration compensation
bucket Bucket sorting frequency
lcbucket Load Curve Id defining bucket sorting frequency vs. time
nseg2trac Number of segments to track for each slave node
initiator Number of iterations for initial penetration checking
Simulation 315
Simulation
316
Time Step Control
Le
Δte =
{ Q + (Q 2
+ c 2 )
1/ 2
}
where, c is the adiabatic speed of sound, Q is a function of the bulk viscosity coefficients C0 and C1.
For elastic materials with a constant bulk modulus c can be computed as:
E (1 − υ )
c=
(1 + υ )(1 − 2υ ) ρ
where, E, ν, and ρ are respectively the Young’s modulus, Poisson’s ratio, and density.
where, Le is a characteristic length calculated as the minimum altitude (for 4-node tetrahedrons), or the
ratio of the element volume to the area of the largest face (for 8-node hexahedra)
Ls
Δte =
c
Simulation 317
Time Step Control
E
c=
ρ (1 −ν 2 )
Three user options exist for selecting the characteristic length Ls.
Ls =
(1 + β ) As
max( L1 , L2 , L3 , (1 − β ) L4 )
where, β = 0 for quadrilateral, and 1 for triangular shell elements, As is the area, and Li (i = 1, 2, 3, 4) is
the length of the sides defining the shell elements.
In the second option, the following more conservative value is used for Ls:
Ls =
(1 + β ) As
max( D1 , D2 )
where, Di (i = 1, 2) is the length of the diagonals.
The third option, which provides the largest time step size, and is often used for triangular shell elements
with very small altitudes uses the following expression for Ls:
Ls = max
(1 + β ) As
, min( L1 , L2 , L3 , L4 + β 1020 )
max( L1 , L2 , L3 ,(1 − β ) L4 )
L
Δt e =
c
318
Time Step Control
where, L is the length of the element, an c is the speed of sound calculated as:
E
c=
ρ
The Belytscho beam also uses smaller of the values given by:
L
Δt e =
c
and
.5L
Δt e =
3 1
c 3I + 2
12 I + AL AL
2
where, I and A are the maximum value of the moment of inertia, and the area of the beam cross section
respectively.
2M 1M 2
Δte = 2
k ( M1 + M 2 )
Simulation 319
Output Control
Output Control
The Control and the database options are used to set solution and output options for the analysis.
320
Control
Control
The Control options are used to set solution options such as analysis duration
(*CONTROL_TERMINATION), adaptive meshing (*CONTROL_ADAPTIVE), parallel processing
(*CONTROL_PARALLEL), and output options such as energy (*CONTROL_ENERGY), output
interval (*CONTROL_OUTPUT). Refer to the LS-DYNA Keyword user’s Manual for a complete list of
the Control cards and options. These control options can be set, and or changed from the SimXpert crash
Workspace. Many of these options have default settings which work pretty well in most situations.
However, a set of standard or user selected control options can be imported from an existing LS-DYNA
keyword file, for use either on an as-is basis, or to be selectively modified in the crash workspace GUI.
Database
The LS-DYNA Database options define options for output files containing results information for post
processing. For example, the use of the *DATABASE_BINARY_D3_PLOT card lets you select the time
interval (DT) between output for the d3plot files. Refer to the “LS-DYNA Keyword User’s Manual” for
a complete list of the database cards and options. These database options can be set, and or changed from
the SimXpert crash Workspace. Many of these options have default settings which work pretty well in
most situations. However, a set of standard or user selected control options can be imported from an
existing LS-DYNA keyword file, for use either on an as-is basis, or to be selectively modified in the crash
workspace GUI.
Simulation 321
Perform the Simulation
A square cross section thin tube is to be simulated for crushing by a rigid wall moving with an initial
velocity toward one end of the tube, while the other end is fixed. The basic FEA model containing the
nodes and the elements is imported from a Nastran input file. Complete the crush model with materials,
sections, boundary conditions, loads, and analysis and output options for performing the crush
simulation.
Some Key Data:
Cross-section of the tube: 69.954 mm X 69.954 mm
Length of the tube: 320 mm
Thickness of the tube: 1.2 mm
Weight of the rigid wall: 0.4 ton
Initial velocity of the rigid wall: 5646 mm/sec
Steps:
Following are the steps to complete the crush model.
1. Launch SimXpert
Select Structures as the Workspace
This fixes the bottom edge of the tube against all translations and rotations.
328
Crushing of a Thin Square Tube
Top edge
z-symmetry edge
x-symmetry
edge
10. Create a constrained node set on all the nodes on the top edge:
Nodes/Elements ->Elements -> Create -> Rigid -> Constrained Node Set
Set DOF to 2
Click Store
Click Exit
Pick all the nodes on the top edge
Click Done on the Pick panel
Click OK
Control -> [N to Z] -> CONTROL OUTPUT
Select value for NPOPT: 1
Select value for NEECHO: 3
Click OK
Control -> Title ->TITLE
Enter value for Title: Crushing of a thin square tube
Click OK
15. Select the dyna database options:
Database -> OPC -> DATABASE BINARY option
Enter valuEnter value for DT_D3PLOT: 1.E-4
Check in the IOPT select box, and set its value to 1
Click OK
Database -> OPC -> DATABASE option
Enter value for DT_GLSTAT: 2.E-5
Enter value for DT_MATSUM: 2.E-5
Click OK