UEPACTIVATIONVOL

User subroutine for specifying 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;
can be used only the heat transfer and static procedures; and
allows only volume fraction equal to zero or one to be added to an element, which means that the status of an element can only changed from inactivate to fully active.

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. The variable must be set equal to zero or one).

Variables passed in for information

lFlags: An array containing informational flags.
epaName: The name of the element progressive activation. It is the name specified on the option ELEMENT PROGRESSIVE ACTIVATION .
noel: User-assigned element number.
nElemNodes: Number of element nodes.
iElemNodes: An array containing user-assigned node numbers of the element.
mcrd: mcrd is 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) . 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.