User Subroutine Interface
subroutine vutrsnetwork (
c Read only variables -
* nblock, networkID, nstatev, nfieldv, nprops,
* stepTime, totalTime, dt,
* jElem, kIntPt, kLayer, kSecPt,
* cmname, props, density, coordMp,
* tempOld, fieldOld, stateOld,
* tempNew, fieldNew,
* nIarray, i_array, nRarray, r_array,
c Write only variables -
* shift, stateNew )
c
include 'vaba_param.inc'
c
c indices for shift I/O
parameter( io_trs_shift_begin = 1,
* io_trs_shift_end = 2 )
c
dimension props(nprops), density(nblock), coordMp(nblock, *),
* jElem(nblock),
* i_array(nblock,nIarray),
* r_array(nblock,nRarray),
* tempOld(nblock), tempNew(nblock),
* fieldOld(nblock, nfieldv), fieldNew(nblock, nfieldv),
* stateOld(nblock, nstatev), stateNew(nblock, nstatev),
* shift(nblock, 2)
c
character*80 cmname
c
do 100 k=1, nblock
user coding to define shift(k,io_trs_shift_begin)
and shift(k,io_trs_shift_end)
100 continue
c
return
end
Variables to Be Defined
-
shift(nblock,2)
-
Array that defines the shift function, A (
), at the material points. For material point k,
shift(k,io_trs_shift_begin) defines the shift
function at the beginning of the increment, and
shift(k,io_trs_shift_end) defines the shift function
at the end of the increment. Abaqus/Explicit will apply an averaging scheme to these values that assumes that the natural
logarithm of the shift function can be approximated by a linear function over the
increment.
If either shift(k,io_trs_shift_begin) or
shift(k,io_trs_shift_end) is less than or equal to
zero, no time shift will be applied.
Variables That Can Be Updated
-
stateNew(nblock,nstatev)
-
Array containing the solution-dependent state variables at the material points. This
array will be passed in containing the values of these variables at the start of the
increment unless they are updated in user subroutine VUSDFLD, in which case the
updated values are passed in. If any of the solution-dependent state variables are
being used in conjunction with the viscoelastic behavior, they must be updated in this
subroutine to their values at the end of the increment.
Variables Passed in for Information
-
nblock
-
Number of material points to be processed in this call to VUTRSNETWORK.
-
networkID
-
Network identification number, which identifies the network for which the shift
function is defined.
-
nstatev
-
Number of user-defined state variables that are associated with this material type
(see Allocating Space for Solution-Dependent State Variables).
-
nfieldv
-
Number of field variables.
-
nprops
-
User-specified number of user-defined material properties.
-
stepTime
-
Value of time since the step began.
-
totalTime
-
Value of total time. The time at the beginning of the step is given by
totalTime-stepTime.
-
dt
-
Time increment size.
-
jElem (nblock)
-
Array of element numbers.
-
kIntPt
-
Integration point number.
-
kLayer
-
Layer number (for composite shells).
-
kSecPt
-
Section point number within the current layer.
-
cmname
-
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,
“ABQ_” should not be used as the leading string for
cmname.
-
props(nprops)
-
User-supplied material properties.
-
density(nblock)
-
Current density at the material points in the midstep configuration. This value might
be inaccurate in problems where the volumetric strain increment is very small. If an
accurate value of the density is required in such cases, the analysis should be run in
double precision. Mass scaling does not affect this value of the density.
-
coordMp(nblock,*)
-
Material point coordinates. It is the midplane material point for shell elements and
the centroid for beam elements.
-
tempOld(nblock)
-
Temperatures at each material point at the beginning of the increment.
-
fieldOld(nblock,nfieldv)
-
Values of the user-defined field variables at each material point at the beginning of
the increment.
-
stateOld(nblock,nstatev)
-
State variables at each material point at the beginning of the increment.
-
tempNew(nblock)
-
Temperatures at each material point at the end of the increment.
-
fieldNew(nblock,nfieldv)
-
Values of the user-defined field variables at each material point at the end of the
increment.
-
nIarray
-
Size of array i_array.
-
i_array(nblock,nIarray)
-
Array containing integer arguments. It is not currently used.
-
nRarray
-
Size of array r_array.
-
r_array(nblock,nRarray)
-
Array containing real arguments. It is not currently used.
Example: Williams-Landel-Ferry Shift Function
As an example of the coding of user subroutine VUTRSNETWORK, consider the
William-Landel-Ferry model to define the shift function. In this case the shift function is
expressed as (see Thermorheologically Simple Temperature Effects)
where
-
-
is the temperature,
-
-
is the reference temperature, and
-
-
are constants.
The user subroutine would be coded as follows:
subroutine vutrsnetwork (
c Read only variables -
* nblock, networkID, nstatev, nfieldv, nprops,
* stepTime, totalTime, dt,
* jElem, kIntPt, kLayer, kSecPt,
* cmname, props, density, coordMp,
* tempOld, fieldOld, stateOld,
* tempNew, fieldNew,
* nIarray, i_array, nRarray, r_array,
c Write only variables -
* shift, stateNew )
c
include 'vaba_param.inc'
c
c indices for shift I/O
parameter( io_trs_shift_begin = 1,
* io_trs_shift_end = 2 )
c
dimension props(nprops), density(nblock), coordMp(nblock, *),
* jElem(nblock),
* i_array(nblock,nIarray),
* r_array(nblock,nRarray),
* tempOld(nblock), tempNew(nblock),
* fieldOld(nblock, nfieldv), fieldNew(nblock, nfieldv),
* stateOld(nblock, nstatev), stateNew(nblock, nstatev),
* shift(nblock, 2)
c
character*80 cmname
c
parameter ( rln10 = 2.302585093d0 )
c
theta0 = props(1)
C1 = props(2)
C2 = props(3)
do 100 k=1, nblock
dTemp1 = tempOld(k) - theta0
shift(k,io_trs_shift_begin) =
* exp(-C1*rln10*dTemp1/(C2+dTemp1))
dTemp2 = tempNew(k) - theta0
shift(k,io_trs_shift_end) =
* exp(-C1*rln10*dTemp2/(C2+dTemp2))
100 continue
c
return
end
|