Special Considerations for Shell Elements
When you use user subroutine VUHYPER_STRETCH to define the
material response of shell elements, Abaqus/Explicit cannot calculate a default value for the transverse shear stiffness of the element. You
must manually 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_STRETCH. 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_STRETCH remains unchanged
during the analysis; deleted material points are not removed from the block. Abaqus/Explicit will “freeze” the values of the stretches passed to user subroutine VUHYPER_STRETCH 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_stretch(
C Read only (unmodifiable) variables
1 nblock, networkId, jElement, nIntPt, nLayer, nSecPt,
2 cmname,
3 nstatev, nfieldv, nprops,
4 props, tempOld, tempNew, fieldOld, fieldNew,
5 stateOld, stretchP1, stretchP2, stretchP3, detu,
C Write only (modifiable) variables
6 u, duDx, d2uDxDx,
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 stretchP1(nblock),stretchP2(nblock),stretchP3(nblock),detu(nblock),
7 duDx(nblock,4), d2uDxDx(nblock,10),
8 u(nblock,2),
9 stateNew(nblock,nstatev)
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. Define this term if the material definition includes Mullins effect
(see Stress Softening in Rubberlike Materials) or when
VUHYPER_STRETCH is used with
the parallel rheological framework and viscous softening (see Parallel Rheological Framework).
-
u(nblock,2)
-
The total strain energy density defined in terms of the principal deviatoric
stretches (
,
,
) and the total volume ratio,
J. You can find the definitions of
,
,
, and J in Hyperelastic Behavior of Rubberlike Materials. Abaqus/Explicit uses this term to compute the initial strain energy when initial stress conditions
are specified (see Initial Conditions).
-
duDx(nblock,1)
-
Array of derivatives of strain energy potential with respect to the first principal
deviatoric stretch
,
.
-
duDx(nblock,2)
-
Array of derivatives of strain energy potential with respect to the second principal
deviatoric stretch
,
.
-
duDx(nblock,3)
-
Array of derivatives of strain energy potential with respect to the third principal
deviatoric stretch
,
.
-
duDx(nblock,4)
-
Array of derivatives of strain energy potential with respect to the third invariant
J,
.
-
d2uDxDx(nblock,1)
-
.
-
d2uDxDx(nblock,2)
-
.
-
d2uDxDx(nblock,3)
-
.
-
d2uDxDx(nblock,4)
-
.
-
d2uDxDx(nblock,5)
-
.
-
d2uDxDx(nblock,6)
-
.
-
d2uDxDx(nblock,7)
-
.
-
d2uDxDx(nblock,8)
-
.
-
d2uDxDx(nblock,9)
-
.
-
d2uDxDx(nblock,10)
-
.
-
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 user subroutine VUHYPER_STRETCH.
-
networkId
-
Network identification number, which identifies the network for which the strain
energy potential is defined when user subroutine VUHYPER_STRETCH is used in
combination with the parallel rheological framework (see Parallel Rheological Framework and VUHYPER_STRETCH). 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.
-
stretchP1(nblock)
-
First principal deviatoric stretch,
, at each material point at the end of the increment.
-
stretchP2(nblock)
-
Second principal deviatoric stretch,
, at each material point at the end of the increment.
-
stretchP3(nblock)
-
Third principal deviatoric stretch,
, at each material point at the end of the increment.
-
detu(nblock)
-
Invariant
at each material point at the end of the increment.
Example: Hencky Hyperelastic Model
Below is an example of the coding of user subroutine VUHYPER_STRETCH for a Hencky
hyperelastic material. The strain energy function is given in the form
where
-
- Strain energy per unit of reference
volume.
-
- Shear
modulus.
-
- Bulk
modulus, with
being the Poisson's
ratio.
The code in user subroutine VUHYPER_STRETCH must return the
derivatives of the strain energy function with respect to the deviatoric stretches and the
volume ratio,
, which are readily computed from the above expression. The user subroutine
is coded as follows:
C user subroutine vuhyper_stretch
subroutine vuhyper_stretch(
C Read only (unmodifiable) variables
1 nblock, networkId, jElement, nIntPt, nLayer, nSecPt,
2 cmname,
3 nstatev, nfieldv, nprops,
4 props, tempOld, tempNew, fieldOld, fieldNew,
5 stateOld, stretchP1, stretchP2, stretchP3, detu,
C Write only (modifiable) variables
6 u, duDx, d2uDxDx,
7 stateNew )
*
include 'vaba_param.inc'
dimension props(nprops),
1 tempOld(nblock),
2 fieldOld(nblock,nfieldv),
3 stateOld(nblock,nstatev),
4 tempNew(nblock),
5 fieldNew(nblock,nfieldv),
6 stretchP1(nblock),stretchP2(nblock),stretchP3(nblock),detu(nblock),
7 duDx(nblock,4), d2uDxDx(nblock,10),
8 u(nblock,2),
9 stateNew(nblock,nstatev)
C
character*80 cmname
parameter (zero=0.d0, one = 1.d0, two = 2.d0, third = 1.d0/3.d0)
xE = props(1)
xNu = props(2)
twoMu = xE/(one+xNu)
BulkMod = third*xE/(one-two*xNu)
do k = 1, nblock
xl1 = stretchP1(k)
xl2 = stretchP2(k)
xl3 = stretchP3(k)
e1 = log(xl1)
e2 = log(xl2)
e3 = log(xl3)
eVol = log(detu(k))
de1dxl1 = one/xl1
de2dxl2 = one/xl2
de3dxl3 = one/xl3
detuInv = one/detu(k)
* First derivatives
duDx(k,1) = twoMu* e1* de1dxl1
duDx(k,2) = twoMu* e2* de2dxl2
duDx(k,3) = twoMu* e3* de3dxl3
duDx(k,4) = BulkMod* eVol*detuInv
* Second derivatives
d2uDxDx(k,1) = twoMu *(one-e1)* (de1dxl1)**2
d2uDxDx(k,2) = twoMu *(one-e2)* (de2dxl2)**2
d2uDxDx(k,3) = twoMu *(one-e3)* (de3dxl3)**2
d2uDxDx(k,4) = zero
d2uDxDx(k,5) = zero
d2uDxDx(k,6) = zero
d2uDxDx(k,10)= detuInv*(BulkMod/detuInv-duDx(k,4))
end do
return
end
|