Special Considerations for Shell Elements
When user subroutine VUHYPER is used to define the
material response of shell elements, Abaqus/Explicit cannot calculate a default value for the transverse shear stiffness of the element.
Hence, you must define the material transverse shear modulus (see Defining the Elastic Transverse Shear Modulus) or the element's transverse shear stiffness (see Shell Section Behavior).
Material Point Deletion
Material points that satisfy a user-defined failure criterion can be deleted from the model
(see User-Defined Mechanical Material Behavior). You must
specify the state variable number controlling the element deletion flag when you allocate
space for the solution-dependent state variables, as explained in User-Defined Mechanical Material Behavior. The deletion
state variable should be set to a value of one or zero in user subroutine VUHYPER. A value of one indicates
that the material point is active, and a value of zero indicates that Abaqus/Explicit should delete the material point from the model by setting the stresses to zero.
The structure of the block of material points passed to user subroutine VUHYPER remains unchanged during the
analysis; deleted material points are not removed from the block. Abaqus/Explicit will “freeze” the values of the invariants passed to user subroutine VUHYPER for all deleted material
points; that is, the values remain constant after deletion is triggered. Once a material
point has been flagged as deleted, it cannot be reactivated.
User Subroutine Interface
subroutine vuhyper(
C Read only (unmodifiable) variables
1 nblock, networkId, jElem, nIntPt, nLayer, nSecPt,
2 cmname,
3 nstatev, nfieldv, nprops,
4 props, tempOld, tempNew, fieldOld, fieldNew,
5 stateOld, bi1, bi2, detu,
C Write only (modifiable) variables
6 u, duDi, d2uDiDi,
7 stateNew )
C
include 'vaba_param.inc'
C
dimension props(nprops),
1 tempOld(nblock),
2 fieldOld(nblock,nfieldv),
3 stateOld(nblock,nstatev),
4 tempNew(nblock),
5 fieldNew(nblock,nfieldv),
6 bi1(nblock), bi2(nblock), detu(nblock), u(nblock,2),
7 duDi(nblock,3), d2uDiDi(nblock,6),
8 stateNew(nblock,nstatev), d1inv(nblock)
C
character*80 cmname
C
do 100 km = 1,nblock
user coding
100 continue
return
end
Variables to Be Defined
-
u(nblock,1)
-
, the deviatoric part of the strain energy density of the primary
material response. This term must be defined only if the current material definition
also includes Mullins effect (see Stress Softening in Rubberlike Materials).
-
u(nblock,2)
-
The total strain energy density defined in terms of the strain invariants. The strain invariants—
,
, and J—are defined in Hyperelastic Behavior of Rubberlike Materials. This term
must be defined when initial stress conditions are specified (see Initial Conditions).
-
duDi(nblock,1)
-
Array of derivatives of strain energy potential with respect to the first invariant
,
.
-
duDi(nblock,2)
-
Array of derivatives of strain energy potential with respect to the second invariant
,
.
-
duDi(nblock,3)
-
Array of derivatives of strain energy potential with respect to the third invariant
J,
.
-
d2uDiDi(nblock,1)
-
-
d2uDiDi(nblock,2)
-
-
d2uDiDi(nblock,3)
-
-
d2uDiDi(nblock,4)
-
-
d2uDiDi(nblock,5)
-
-
d2uDiDi(nblock,6)
-
-
stateNew(nblock,nstatev)
-
State variables at each material point at the end of the increment. You define the
size of this array by allocating space for it (see About User Subroutines and Utilities for more information).
Variables Passed in for Information
-
nblock
-
Number of material points to be processed in this call to VUHYPER.
-
networkId
-
Network identification number, which identifies the network for which the strain
energy potential is defined when VUHYPER is used in combination
with the Parallel Rheological Framework (see Parallel Rheological Framework and VUHYPER). You can define
different strain energy functions for different networks.
-
jElem(nblock)
-
Array of element numbers.
-
nIntPt
-
Integration point number.
-
nLayer
-
Layer number (for composite shells).
-
nSecPt
-
Section point number within the current layer.
-
cmname
-
User-specified material name, left justified. It is passed in as an uppercase
character string. Some internal material models are given names starting with the
“ABQ_” character string. To avoid conflict, you
should not use “ABQ_” as the leading string for
cmname.
-
nstatev
-
Number of user-defined state variables that are associated with this material type
(you define this as described in Allocating Space for Solution-Dependent State Variables).
-
nfieldv
-
Number of user-defined external field variables.
-
nprops
-
User-specified number of user-defined material properties.
-
props(nprops)
-
User-supplied material properties.
-
tempOld(nblock)
-
Temperatures at each material point at the beginning of the increment.
-
tempNew(nblock)
-
Temperatures at each material point at the end of the increment.
-
fieldOld(nblock,nfieldv)
-
Values of the user-defined field variables at each material point at the beginning of
the increment.
-
fieldNew(nblock,nfieldv)
-
Values of the user-defined field variables at each material point at the end of the
increment.
-
stateOld(nblock,nstatev)
-
State variables at each material point at the beginning of the increment.
-
bi1(nblock)
-
Invariant
, at each material point at the end of the increment.
-
bi2(nblock)
-
Invariant
, at each material point at the end of the increment.
-
detu(nblock)
-
Invariant
, at each material point at the end of the increment.
Example: Neo-Hookean Hyperelastic Model
Below is an example of the coding of user subroutine VUHYPER for a neo-Hookean
hyperelastic material. The strain energy function is given in the form
The code in user subroutine VUHYPER must return the derivatives
of the strain energy function with respect to the invariants, which are readily computed
from the above expression. The user subroutine would be coded as follows:
subroutine vuhyper(
C Read only (unmodifiable) variables
1 nblock, networkId,jElem, kIntPt, kLayer, kSecPt,
2 cmname,
3 nstatev, nfieldv, nprops,
4 props, tempOld, tempNew, fieldOld, fieldNew,
5 stateOld, bi1,bi2,detu,
C Write only (modifiable) variables
6 u, duDi, d2uDiDi,
7 stateNew )
C
include 'vaba_param.inc'
C
dimension props(nprops),
1 tempOld(nblock),
2 fieldOld(nblock,nfieldv),
3 stateOld(nblock,nstatev),
4 tempNew(nblock),
5 fieldNew(nblock,nfieldv),
6 bi1(nblock), bi2(nblock), detu(nblock), u(nblock,2),
7 duDi(nblock,3), d2uDiDi(nblock,6),
* stateNew(nblock,nstatev)
C
character*80 cmname
C
parameter ( zero =0.d0, one = 1.d0, two = 2.d0, three = 3.d0 )
c10 = props(1)
d1 = props(2)
d1inv = one/d1
do km = 1,nblock
a1 = bi1(km)-three
a2 = bi2(km) - three
a3 = detu(km) - one
u(km,1) = c10*a1
u(km,2) = c10*a1 + d1inv * a3**2
duDi(km,1) = c10
duDi(km,2) = zero
duDi(km,3) = d1inv * a3 * two
C
d2uDiDi(km,1) = zero
d2uDiDi(km,2) = zero
d2uDiDi(km,3) = zero
d2uDiDi(km,6) = d1inv * two
end do
return
end
|