Obtaining Element Section Information from User Subroutine UVAREL

Utility routine getSecVar can be called from user subroutine UVAREL to access element section information.

This page discusses:

See Also
UVAREL
In Other Guides
Using Abaqus/Standard Output Variable Identifiers

Products Abaqus/Standard

Utility Routine Interface

character*3 flgray(15)
      dimension array(15),jarray(15)
...
 call getSecVar('Var', kPt, array, jArray, flgray, jError, abqInternal)

Variables to Be Provided to the Utility Routine

Var

Output variable key from the table in Element Section Variables. The applicable keys are listed in the output table as the element section variables; for example, SF for section force.

kPt

Integration point number.

abqInternal

Variable that must be passed into utility routine getSecVar. The calling user subroutine provides this variable.

Variables Returned from the Utility Routine

array

Real array containing individual components of the output variable.

jArray

Integer array containing individual components of the output variable.

flgray

Character array containing flags corresponding to the individual components. Flags will contain either YES, NO, or N/A (not applicable).

jError

Return code (0 – no error, 1 – output request error or all components of the output request are zero).

Available Output Variable Keys

Only output variable keys that are valid for output are available for use with getSecVar. In general, if a key corresponds to a collective output variable (rather than to an individual component), it can be used with getSecVar. For example, SF for the section force can be used, but any individual component of section force (for example, SF1) cannot be used. The collective output variable keys are distinguished from their individual components by the fact that they have the word "yes" after the category .fil in the tables in Using Abaqus/Standard Output Variable Identifiers.

Utility routine getSecVar returns array, jArray, and flgray, which correspond to the real-valued components, integer-valued components, and the flags associated with the request Var, respectively. If any array component is not applicable for a given request, its value is returned as the initialized value: 0.0 in array, 0 in jArray, and N/A in flgray. getSecVar returns the error flag jError=1 from getSecVar any time a request key is not recognized, the request is not valid (such as requesting transverse shear stress for a shell element that uses thin shell theory), or all of the output components requested are zero; otherwise, jError=0.

The following output variable keys are available for use with getSecVar:

  • COORD

  • SF

  • SSAVG

  • STH

Analysis Time for which Values Are Returned

When you request a section output quantity with the utility routine, getSecVar always returns the requested quantities with the values at the end of the current increment.

Supported Element Types

This capability pertains to section quantities; therefore, you cannot use it for most of the element types that do not require section integration.

Utility routine getSecVar supports only the following element types:

  • Membrane elements

  • Shell elements