Obtaining Contact Constraint Point Information in an Abaqus/Standard Analysis

Utility routine GETVRC can be called from user subroutines FRIC, FRIC_COEF, GAPCON, GAPELECTR, and UINTER to access contact variables for individual contact constraints. For these user subroutines GETVRC returns values at the beginning of the current increment.

This page discusses:

Utility Routine Interface

PARAMETER(NDATASIZE=10)
DIMENSION ARRAY(NDATASIZE), JARRAY(NDATASIZE)
CHARACTER*3 FLGRAY(NDATASIZE)
...
CALL GETVRC('VAR', ARRAY, JARRAY, FLGRAY, NDATASIZE, JRCD)

Variables to Be Provided to the Utility Routine

VAR
The supported list of key identifiers for various contact variables and their meanings and sizes are listed in Table 1; for example, the identifier key for contact stress for a contact constraint is CSTRESS.
NDATASIZE
The common integer size for the input buffers that are passed in to be filled with data. If the input buffer size for a particular variable is smaller than the size required, an error is issued.

Variables Returned from the Utility Routine

ARRAY
Input buffer for retrieving double precision components of the requested variable.
JARRAY
Input buffer for retrieving integer components of the requested variable when applicable.
FLGRAY
Input buffer for retrieving character flags when applicable. Flags will contain either YES, NO, or N/A (not applicable).
JRCD
Return code (0 indicates no error, 1 indicates an output request error or all components of the output request are zero).

Available Variable Keys

Table 1 describes the supported key identifiers for various contact variables.

Table 1. Variable keys for contact variables.
Variable identifier (VAR) Description Type of data Size
Contact stress and strain variables
CSTRESS Contact stress Real Number of friction directions + 1
CDISP Contact strains; first entry is the gap and is negative if constraint is open or -1e+36 if no pairing main is found; the remaining entries are the accumulated tangential slip values Real Number of friction directions + 1
CSLIPEQ Equivalent contact slip Real 1
CSLIP_PLEQ Equivalent plastic contact slip Real 1
CSLIP_PL Plastic slip Real Number of friction directions
CNAREA Contact constraint area Real 1 (or 2 only in a coupled analysis if temperatures or pore pressures are active for the contact constraint; the second entry corresponds to area associated with temperatures or pore pressures)
Contact constraint energy densities with units of energy per unit area
ELSEDEN Elastic strain energy density Real 1
ELPDDEN Plastic dissipation density Real 1
ELSDDEN Static dissipation energy density Real 1
ELVDDEN Viscous dissipation energy density Real 1
ELCDDEN Creep dissipation energy density Real 1
ELJDDEN Joule heating energy density Real 1
ELDDDEN Damage dissipation energy density Real 1
Contact constraint time integrated variables
ELSJDT Time integrated heat flux per unit area due to electrical current Real 1
ELSJDTA Time integrated heat flux due to electrical current Real 1
ELHTL Time integrated heat flux per unit area leaving the secondary surface Real 1
ELHTLA Time integrated heat flux leaving the secondary surface Real 1
ELSFDRT Time integrated heat flux per unit area due to frictional dissipation Real 1
ELSFDRTA Time integrated heat flux due to frictional dissipation Real 1
ELPTL Time integrated pore fluid volume flux per unit area leaving the secondary surface Real 1
ELPTLA Time integrated pore fluid volume flux leaving the secondary surface Real 1
ELECDT Time integrated electrical current per unit area Real 1
ELECDTA Time integrated electrical current Real 1