Obtaining Node Point Information

Utility routine GETVRN can be called from user subroutine UMESHMOTION to access node point information.

This page discusses:

Utility Routine Interface

DIMENSION ARRAY(15),JGVBLOCK(*)
...
CALL GETVRN(NODE,'VAR',ARRAY,JRCD,JGVBLOCK,LTRN)

Variables to Be Provided to the Utility Routine

NODE

Node number.

VAR

Output variable key from the table in Nodal Variables. The applicable keys are listed in the output table as being available for results file output at nodes; e.g., U for displacement.

JGVBLOCK

Variable that must be passed into the GETVRN utility routine. The variable is available in user subroutine UMESHMOTION for this purpose.

LTRN

Variable indicating the coordinate system the nodal quantity is to be returned in. A value of 0 specifies that the results are to be returned in the global coordinate system, regardless of any transformation applied at the node. A value of 1 specifies that the results are to be returned in the local transformed system.

Variables Returned from the Utility Routine

ARRAY

Real array containing individual components of the output variable.

JRCD

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

Available Output Variable Keys

Only nodal output variable keys that are valid for results file output in the current step are available for use with GETVRN. In general, if a key corresponds to a collective output variable, rather than an individual component, it can be used with GETVRN. For example, U for displacement can be used, whereas any individual component of displacement, say U1, 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 Nodal Variables.

You will be returned ARRAY, which corresponds to the real-valued components associated with the request VAR. If any array component is not applicable for a given request, its value will be returned as the initialized value: 0.0. The error flag JRCD=1 is returned from GETVRN any time a request key is not recognized, the request is not valid (such as requesting pore pressure for a node not associated with a pore pressure or acoustic element, or requesting a variable not available for the current procedure), or all of the output components requested are zero; otherwise, JRCD=0.

Ordering of Returned Components

The components for a vector request are returned in positions 1, 2, 3, etc.

Analysis Time for Which Values Are Returned

GETVRN returns values at the end of the current increment.