Products: ABAQUS/Standard ABAQUS/Explicit ABAQUS/Aqua
A variety of utility routines are available to assist in the coding of user subroutines. When called, the utility routine will perform a predefined function or action whose output or results can be integrated into the user subroutine.
The following utility routines are available for use in coding user subroutines in ABAQUS:
GETENVVAR can be called from any ABAQUS/Standard user subroutine to obtain the value of an environment variable (“Obtaining ABAQUS/Standard environment variables,” Section 2.1.1 of the ABAQUS User Subroutines Reference Manual).
GETJOBNAME can be called from any user subroutine to obtain the name of the current analysis job (“Obtaining the ABAQUS job name,” Section 2.1.2 of the ABAQUS User Subroutines Reference Manual).
GETOUTDIR can be called from any user subroutine to obtain the name of the directory where analysis job output is being placed (“Obtaining the ABAQUS output directory name,” Section 2.1.3 of the ABAQUS User Subroutines Reference Manual).
GETPARTINFO or VGETPARTINFO can be called from any ABAQUS/Standard or ABAQUS/Explicit user subroutine, respectively, to retrieve the part instance name and local node or element number corresponding to an internal node or element number. GETINTERNAL or VGETINTERNAL can be called from any ABAQUS/Standard or ABAQUS/Explicit user subroutine, respectively, to retrieve the internal node or element number corresponding to a given part instance name and local number. (See “Obtaining part information,” Section 2.1.4 of the ABAQUS User Subroutines Reference Manual.)
GETVRM provides access to material point information for ABAQUS/Standard user subroutines UVARM and/or USDFLD (“Obtaining material point information,” Section 2.1.5 of the ABAQUS User Subroutines Reference Manual).
GETVRMAVGATNODE provides access to material point information, extrapolated to and averaged at a node, for ABAQUS/Standard user subroutine UMESHMOTION (“Obtaining material point information averaged at a node,” Section 2.1.6 of the ABAQUS User Subroutines Reference Manual).
GETVRN provides access to node point information for ABAQUS/Standard user subroutine UMESHMOTION (“Obtaining node point information,” Section 2.1.7 of the ABAQUS User Subroutines Reference Manual).
GETNODETOELEMCONN can be called from user subroutine UMESHMOTION to retrieve a list of elements connected to a specific node. This element list can then be used with utility routine GETVRMAVGATNODE (“Obtaining node to element connectivity,” Section 2.1.8 of the ABAQUS User Subroutines Reference Manual).
SINV determines the first and second stress invariants for a given stress tensor in ABAQUS/Standard (“Obtaining stress invariants, principal stress/strain values and directions, and rotating tensors,” Section 2.1.9 of the ABAQUS User Subroutines Reference Manual).
SPRINC determines the principal values for a given stress or strain tensor in ABAQUS/Standard (“Obtaining stress invariants, principal stress/strain values and directions, and rotating tensors,” Section 2.1.9 of the ABAQUS User Subroutines Reference Manual).
SPRIND determines both the principal values and principal directions for a given stress or strain tensor in ABAQUS/Standard (“Obtaining stress invariants, principal stress/strain values and directions, and rotating tensors,” Section 2.1.9 of the ABAQUS User Subroutines Reference Manual).
ROTSIG can be called from ABAQUS/Standard user subroutine UMAT to perform the rotation of tensors when large-strain calculations are performed (“Obtaining stress invariants, principal stress/strain values and directions, and rotating tensors,” Section 2.1.9 of the ABAQUS User Subroutines Reference Manual).
GETWAVE determines wave kinematic data associated with the applied wave theory in an ABAQUS/Aqua analysis (“Obtaining wave kinematic data in an ABAQUS/Aqua analysis,” Section 2.1.10 of the ABAQUS User Subroutines Reference Manual).
GETWAVEVEL, GETWINDVEL, and GETCURRVEL are used to obtain the wave, wind, and steady current velocity components, respectively, for a given point in an ABAQUS/Aqua analysis (“Obtaining wave kinematic data in an ABAQUS/Aqua analysis,” Section 2.1.10 of the ABAQUS User Subroutines Reference Manual).
STDB_ABQERR or XPLB_ABQERR can be called from any ABAQUS/Standard or ABAQUS/Explicit user subroutine, respectively, to print an informational, warning, or error message to the message file in ABAQUS/Standard or the status file in ABAQUS/Explicit (“Printing messages to the message or status file,” Section 2.1.11 of the ABAQUS User Subroutines Reference Manual).
XIT or XPLB_EXIT can be called from any ABAQUS/Standard or ABAQUS/Explicit user subroutine, respectively, to terminate an analysis (“Terminating an analysis,” Section 2.1.12 of the ABAQUS User Subroutines Reference Manual).