UEPACTIVATIONVOL

User subroutine to specify material volume fraction added during element activation.

can be used to add a volume fraction of material to an element during element activation;
will be called at the beginning of each increment in a step in which element activation is active; and
can be used only with the heat transfer and static procedures.

The following topics are discussed:

User subroutine interface
Variables to be defined
Variables passed in for information

User subroutine interface

      subroutine uepactivationvol(
     * lFlags,
     * epaName,
     * noel,
     * nElemNodes,
     * iElemNodes,
     * mcrd,
     * coordNodes,
     * uNodes,
     * kstep,
     * kinc,
     * time,
     * dtime,
     * temp,
     * npredef,
     * predef,
     * nsvars,
     * svars,
     * sol,
     * solinc,
     * volFract,
     * nVolumeAddEvents,
     * volFractAdded,
     * csiAdded)     
C
      include 'aba_param.inc'
C
      dimension   
     * lFlags(*),
     * iElemNodes(nElemNodes),
     * coordNodes(mcrd,nElemNodes),
     * uNodes(mcrd,nElemNodes),
     * time(2),
     * svars(2,nsvars),
     * temp(2,nElemNodes),
     * predef(2,npredef,nElemNodes),
     * sol(nElemNodes),
     * solinc(nElemNodes),
     * volFract(*),
     * volFractAdded(*),
     * csiAdded(3,*)

      character*80 epaName

      user coding to define material volume fraction added.

      return
      end

Variables to be defined

volFractAdded: The volume fraction of material added to the element in the current increment.

Variables passed in for information

lFlags

An array containing the flags that define the current solution procedure and analysis type.

lFlags(1)	Defines the procedure type. See Results file for the key used for each procedure.
lFlags(2)=0	Small-displacement analysis.
lFlags(2)=1	Large-displacement analysis (nonlinear geometric effects included in the step; see General and perturbation procedures).

epaName

The name of the progressive element activation. It is the name specified on the ELEMENT PROGRESSIVE ACTIVATION option.

noel

User-assigned element number.

nElemNodes

Number of element nodes.

iElemNodes

An array containing user-assigned node numbers of the element.

mcrd

Defined as the maximum of the user-defined maximum number of coordinates needed at any node point (Defining the maximum number of coordinates needed at any nodal point) and the value of the largest active degree of freedom of the user element that is less than or equal to 3. For example, if you specify that the maximum number of coordinates is 1 and the active degrees of freedom of the user element are 2, 3, and 6, mcrd will be 3. If you specify that the maximum number of coordinates is 2 and the active degrees of freedom of the user element are 11 and 12, mcrd will be 2.

coordNodes

An array containing the coordinates of the nodes of the element.

uNodes

An array containing displacements at the element nodes.

kstep

Current step number.

kinc

Current increment number.

time(1)

Current value of step time.

time(2)

Current value of total time.

dtime

Time increment.

temp

An array containing predefined temperature at the element nodes.

npredef

Number of field variables.

predef

An array containing predefined field variables at the element nodes.

nsvars

The variable is currently not used.

svars

The variable is currently not used.

sol

An array of the solution variables (temperature in a heat transfer analysis) at the beginning of the increment.

solinc

An array of estimated values of the increment of the solution variables (temperature in a heat transfer analysis). Currently the values are always set equal to zero.

volFract

Total volume fracture of the material at the previous increment.

nVolumeAddEvents

The variable is currently not used.

csiAdded

The variable is currently not used.