UEPACTIVATIONSETUP

User subroutine to control interaction with the toolpath-mesh intersection module and to specify the list of elements that can be activated.

User subroutine UEPACTIVATIONSETUP:

  • is called for each progressive activation once at the start of the step and again at the start of each increment;
  • can be used to identify potentially active elements at the start of an increment;
  • can be used only in heat transfer and static analyses;
  • can be use to modify the time increment at the start of an increment; and
  • can be used to communicate data between external programs and user subroutines.

This page discusses:

See Also
In Other Guides
*ACTIVATE ELEMENTS
*ELEMENT PROGRESSIVE ACTIVATION
Progressive Element Activation

ProductsAbaqus/Standard

User Subroutine Interface

            subroutine uepactivationsetup(
     *	lop,
     *	epaName,
     *	epaElsetName,
     *	jActivatingElems,
     * nActivatingElems,
     * kstep,
     *	kinc,
     *	time,
     *	dtime)     
C
      include 'aba_param.inc'
C
      dimension   
     *	jActivatingElems(nActivatingElems),
     * time(2),
     *	dtime(2)

      character*80 
     * epaName, 
     * epaElsetName

      user coding.

      return
      end

Variables to Be Defined

None.

Variables That Can Be Updated

jActivatingElems(nActivatingElems)
An array containing elements that can be activated in this increment. This array contains all the elements of the element set epaElsetName that was specified on the ELEMENT PROGRESSIVE ACTIVATION option. It can be modified by removing elements that will not be activated in the increment, which may improve performance for models with large number of elements that potentially can be activated. It is used only when lop=2.
nActivatingElems
Number of elements that can be activated in this increment. It must be modified if the array jActivatingElems is modified and its size changes. It is used only when lop=2.
dtime(2)

Ratio of your defined time increment to the time increment currently being used [dtime(1), see below]. This variable allows you to provide input to the automatic time incrementation algorithms if automatic time incrementation is chosen.

If dtime(2) is redefined to be other than 1.0, Abaqus/Standard must abandon the time increment and attempt it again with a new time increment. The suggested new time increment provided to the automatic time integration algorithms is dtime(2) × dtime(1), where the dtime(2) used is the minimum value for all calls to user subroutine UEPACTIVATIONSETUP that allows redefinition of dtime(2) for this iteration.

If automatic time incrementation is not selected in the analysis procedure, values of dtime(2) greater than 1.0 will be ignored and values of dtime(2) less than 1.0 will cause the job to terminate.

Variables Passed in for Information

lop

lop=1 indicates that the user subroutine is called at the start of a step.

lop=2 indicates that the user subroutine is called at the start of an increment.

epaName

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

epaElsetName

The name of the element set specified on the ELEMENT PROGRESSIVE ACTIVATION option.

kstep

Current step number.

kinc

Current increment number.

time(1)

Current value of step time.

time(2)

Current value of total time.

dtime(1)

Time increment.