A "get function" is available for some items and can be used
instead of the ***GET** command. The
function returns the value and uses it where the function is input,
bypassing the need for storing the value with a parameter name and
inputting the parameter name where the value is to be used.

For example, assume the average X location
of two nodes is to be calculated. Using the ***GET** command, parameter L1 can be assigned the X location
of node 1, and parameter L2 can be assigned the X location of node
2. Then the mid-location can be computed from MID
= (L1 + L2) / 2:

*GET,L1,NODE,1,LOC,X *GET,L2,NODE,2,LOC,X MID=(L1+L2)/2

However, using the node location "get
function" NX(* N*), which returns the X location
of node

`N`

MID=(NX(1)+NX(2))/2

Get functions return values in the active coordinate system unless stated otherwise.

Get function arguments may themselves
be parameters or other get functions. The get function NELEM(* E*,

`NPOS`

`NPOS`

`E`

`E`

`NPOS`

The table below lists available get functions
grouped by functionality. The ***GET** command also
lists get functions as alternatives to ***GET** items, where applicable (see the tables in the Notes section of ***GET**).

**Table 1: *GET - Get Function Summary**

"Get Function" Summary | ||||||||
---|---|---|---|---|---|---|---|---|

Entity Status Get Function | Description | |||||||

NSEL()`N` | Status of node -1=unselected,
0=undefined, 1=selected.`N:` | |||||||

ESEL()`E` | Status of element -1=unselected, 0=undefined, 1=selected.`E:` | |||||||

KSEL()`K` | Status of keypoint -1=unselected, 0=undefined, 1=selected.`K: ` | |||||||

LSEL()`L` | Status
of line -1=unselected, 0=undefined,
1=selected.`L: ` | |||||||

ASEL()`A` | Status of area -1=unselected, 0=undefined, 1=selected.`A: ` | |||||||

VSEL()`V` | Status of volume -1=unselected,
0=undefined, 1=selected.`V: ` | |||||||

Next Selected Entity | ||||||||

NDNEXT()`N` | Next selected node having a node number greater than .`N` | |||||||

ELNEXT()`E` | Next selected element having
an element number greater than .`E` | |||||||

KPNEXT()`K` | Next selected keypoint having a keypoint number greater
than . `K` | |||||||

LSNEXT()`L` | Next
selected line having a line number greater than .`L` | |||||||

ARNEXT()`A` | Next selected area having
an area number greater than .`A` | |||||||

VLNEXT()`V` | Next selected volume having a volume number greater
than .`V` | |||||||

Locations | ||||||||

CENTRX()`E` | Centroid X-coordinate of element in global Cartesian coordinate system.
Centroid is determined from the selected nodes on the element.`E` | |||||||

CENTRY()`E` | Centroid Y-coordinate of element in global Cartesian coordinate system. Centroid is determined from
the selected nodes on the element.`E ` | |||||||

CENTRZ()`E` | Centroid Z-coordinate of
element in global Cartesian
coordinate system. Centroid is determined from the selected nodes
on the element.`E` | |||||||

NX()`N` | X-coordinate of node in the active coordinate system.`N` | |||||||

NY`(N)` | Y-coordinate of node in the active coordinate system.`N` | |||||||

NZ`(N)` | Z-coordinate of node in the active coordinate system.`N` | |||||||

KX()`K` | X-coordinate of keypoint in the active coordinate system`K` | |||||||

KY`(K)` | Y-coordinate of keypoint in the active coordinate system`K` | |||||||

KZ`(K)` | Z-coordinate of keypoint in the active coordinate system`K` | |||||||

LX()`L,LFRAC` | X-coordinate of line at length fraction `L` (0.0 to 1.0).`LFRAC` | |||||||

LY()`L,LFRAC` | Y-coordinate of line at length fraction `L` (0.0 to 1.0).`LFRAC` | |||||||

LZ()`L,LFRAC` | Z-coordinate of line at length fraction `L` (0.0 to 1.0).`LFRAC` | |||||||

LSX()`L,LFRAC` | X slope of line at length fraction `L` (0.0 to 1.0).`LFRAC` | |||||||

LSY()`L,LFRAC` | Y slope of line at length fraction `L` (0.0 to 1.0).`LFRAC` | |||||||

LSZ()`L,LFRAC` | Z slope of line at length fraction `L` (0.0 to 1.0).`LFRAC` | |||||||

Nearest to Location | ||||||||

NODE()`X,Y,Z` | Number of the selected node nearest the point (in the active coordinate system,
lowest number for coincident nodes). A number higher than the highest
node number indicates that the node is internal (generated by program).`X,Y,Z` | |||||||

KP()`X,Y,Z` | Number of the selected keypoint nearest the point (in the active coordinate system,
lowest number for coincident keypoints).`X,Y,Z` | |||||||

Distances | ||||||||

DISTND()`N1,N2` | Distance between nodes and `N1` .`N2` | |||||||

DISTKP()`K1,K2` | Distance between keypoints and `K1` .`K2` | |||||||

DISTEN()`E,N` | Distance between the centroid of element and node `E` .
Centroid is determined from the selected nodes on the element.`N` | |||||||

Angles (in radians by default -- see the *AFUN command) | ||||||||

ANGLEN()`N1,N2,N3` | Subtended angle between
two lines (defined by three nodes where is the vertex node). Default is in radians.`N1` | |||||||

ANGLEK()`K1,K2,K3` | Subtended angle between two lines (defined by three keypoints where is the vertex keypoint). Default is in
radians.`K1` | |||||||

Nearest to Entity | ||||||||

NNEAR()`N` | Selected
node nearest node .`N` | |||||||

KNEAR()`K` | Selected keypoint nearest keypoint .`K` | |||||||

ENEARN()`N` | Selected element nearest
node . The element position
is calculated from the selected nodes.`N` | |||||||

Areas | ||||||||

AREAND()`N1,N2,N3` | Area of the triangle with vertices at nodes , and `N1, N2` .`N3` | |||||||

AREAKP()`K1,K2,K3` | Area of the triangle with vertices at keypoints , and `K1, K2` .`K3` | |||||||

ARNODE()`N` | Area at node apportioned from selected elements attached to node `N` . For 2-D planar solids, returns edge area
associated with the node. For axisymmetric solids, returns edge surface
area associated with the node. For 3-D volumetric solids, returns
face area associated with the node. For 3–D, select all the
nodes of the surface of interest before using ARNODE.`N` | |||||||

Normals | ||||||||

NORMNX()`N1,N2,N3` | X-direction cosine of the normal to the plane containing
nodes , and `N1, N2` .`N3` | |||||||

NORMNY()`N1,N2,N3` | Y-direction cosine
of the normal to the plane containing nodes , and `N1, N2` .`N3` | |||||||

NORMNZ()`N1,N2,N3` | Z-direction cosine of the normal to the plane containing
nodes , and `N1, N2` .`N3` | |||||||

NORMKX()`K1,K2,K3` | X-direction cosine
of the normal to the plane containing keypoints , and `K1, K2` .`K3` | |||||||

NORMKY()`K1,K2,K3` | Y-direction cosine of the normal to the plane containing
keypoints , and `K1, K2` .`K3` | |||||||

NORMKZ()`K1,K2,K3` | Z-direction cosine
of the normal to the plane containing keypoints , and `K1, K2` .`K3` | |||||||

Connectivity | ||||||||

ENEXTN()`N,LOC` | Element connected to
node is the position
in the resulting list when many elements share the node. A zero is
returned at the end of the list.`N. LOC` | |||||||

NELEM(,`E` )`NPOS` | Node number in position (1--20) of element `NPOS` .`E` | |||||||

NODEDOF()`N` | Returns the bit pattern for the active
DOFs at the specified node.
| |||||||

Faces | ||||||||

ELADJ()`E,FACE` | For 2-D planar solids
and 3-D volumetric solids, element adjacent to a face () of element `FACE` . The face number is the same as the surface load
key number. Only elements of the same dimensionality and shape are
considered. A -1 is returned if more than one is adjacent. `E` | |||||||

NDFACE()`E,FACE,LOC` | Node in position of a face number `LOC` of
element `FACE` . The face number
is the same as the surface load key number. LOC is the nodal position
on the face (for an IJLK face, LOC=1 is at node I, 2 is at node J,
etc.)`E` | |||||||

NMFACE()`E` | Face number of element containing the selected nodes. The face number output is the surface
load key. If multiple load keys occur on a face (such as for line
and area elements) the lowest load key for that face is output.`E` | |||||||

ARFACE()`E` | For 2-D planar solids and 3-D volumetric solids, returns the
area of the face of element containing the selected nodes. For axisymmetric elements, the area
is the full (360 degree) area.`E ` | |||||||

Model Information | ||||||||

EATT()`E,VAL` | Element attribute number assigned to element . Use `E` = 1 for MATT, 2 for TYPE, 3 for REAL, and 4 for SECN.`VAL` | |||||||

RCON()`R,LOC` | Real constant value for real table and location `R` .`LOC` | |||||||

General Contact Information | ||||||||

SECTOMAT(,`Sect1` )`Sect2` | Material ID to be used
for general contact between sections and `Sect1` .`Sect2` | |||||||

SECTOREAL(,`Sect1` )`Sect2` | Real constant ID to
be used for general contact between sections and `Sect1` .`Sect2` | |||||||

ELMTOSEC(,`ElmNum` )`FaceNum` | Section
ID of a general contact element attached to base element at face `ElmNum` .`FaceNum`
| |||||||

ELMTOTYP(,`ElmNum` )`FaceNum` | Element type ID of a general contact element attached
to base element at face `ElmNum` .`FaceNum`
| |||||||

NDTOSEC(,`Node` )`Posn` | Section ID of the general contact element in position of the sequential list of all such elements
attached to `Posn` . `Node` defaults to +1. `Posn`
| |||||||

NDTOTYP(,`Node` )`Posn` | Element type ID of the general contact element in position of the sequential list of all such elements
attached to `Posn` . `Node` defaults to +1. `Posn`
| |||||||

CMTOSEC('', `CmName` )`KTopBot` | Unique
section ID of any general contact element attached to any node belonging
to node component = -1 restricts searching
to base element bottom faces, and any other value of `KTopBot` restricts searching to base element top faces.`KTopBot` If the node component contains nodes from more than one section ID, the function returns the section ID associated with the lowest node number. | |||||||

CMTOTYP('', `CmName` )`KTopBot` | Unique element type ID of any general contact element
attached to any node belonging to node component = -1 restricts searching to base element bottom faces, and any other
value of `KTopBot` restricts searching to
base element top faces.`KTopBot` If the node component contains nodes from more than one section ID, the function returns the section ID associated with the lowest node number. | |||||||

Degree of
Freedom Results | ||||||||

UX()`N` | UX structural displacement
at node .`N` | |||||||

UY()`N` | UY
structural displacement at node .`N` | |||||||

UZ()`N` | UZ structural displacement at node .`N` | |||||||

ROTX)`(N` | ROTX structural rotation
at node .`N` | |||||||

ROTY()`N` | ROTY structural rotation at node .`N` | |||||||

ROTZ()`N` | ROTZ structural rotation at node .`N` | |||||||

TEMP()`N` | Temperature at node . For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use TBOT(`N` ), TE2(`N` ), TE3(`N` ), . . ., TTOP(`N` ) instead of TEMP(`N` ).`N` | |||||||

PRES()`N` | Pressure at node .`N` | |||||||

VX()`N` | VX fluid velocity at node .`N` | |||||||

VY()`N` | VY fluid velocity at node .`N` | |||||||

VZ)`(N` | VZ fluid velocity at node .`N` | |||||||

VOLT()`N` | Electric potential at node .`N` | |||||||

MAG()`N` | Magnetic scalar potential
at node .`N` | |||||||

AX()`N` | AX
magnetic vector potential at node .`N` | |||||||

AY()`N` | AY magnetic vector
potential at node .`N` | |||||||

AZ()`N` | AZ magnetic vector potential at node .`N` | |||||||

Returns information about the
database manager | ||||||||

VIRTINQR(1) | Number of pages in core. | |||||||

VIRTINQR(4) | Page size in integer words. | |||||||

VIRTINQR(7) | Maximum number of pages allowed on disk. | |||||||

VIRTINQR(8) | Number of read/write operations on page. | |||||||

VIRTINQR(9) | Maximum record number on page. | |||||||

VIRTINQR(11) | Maximum pages touched. | |||||||

Returns the current value of ANSYS filtering
keywords. | ||||||||

KWGET()`KEYWORD` | Returns the current
value the keyword specified by KEYWORD. See the ANSYS UIDL Programmer's Guide for a list of keywords and values. | |||||||

Character String
Functions Strings must be dimensioned (see *DIM) as a character parameter or enclosed
in single apostrophes ('char'). | ||||||||

Functions which return a double
precision value of a numeric character string. | ||||||||

VALCHR()`a8` | is a decimal value
expressed in a string. `a8` | |||||||

VALOCT
()`a8` | is an octal value expressed in a string. `a8` | |||||||

VALHEX()`a8` | is a
hex value expressed in a string.`a8` | |||||||

Functions which return an 8
character string of a numeric value. | ||||||||

CHRVAL ()`dp` | is a double precision
variable. `dp` | |||||||

CHROCT ()`dp` | is an integer value. `dp` | |||||||

CHRHEX()`dp` | is an integer value. `dp` | |||||||

Functions which manipulate strings: StrOut is the output string (or character parameter) Str1 and Str2 are input strings. Strings are a maximum of 128 characters. (see *DIM) | ||||||||

StrOut = STRSUB(Str1, nLoc,nChar) | Get the nChar substring starting at character nLoc in Str1. | |||||||

StrOut = STRCAT(Str1,Str2) | Add Str2 at the end of Str1. | |||||||

StrOut = STRFILL(Str1,Str2,nLoc) | Add Str2 to Str1 starting at character nLoc. | |||||||

StrOut = STRCOMP(Str1) | Remove all blanks from Str1 | |||||||

StrOut = STRLEFT(Str1) | Left-justify Str1 | |||||||

nLoc = STRPOS(Str1,Str2) | Get starting location of Str2 in Str1. | |||||||

nLoc = STRLENG(Str1) | Location of last nonblank character | |||||||

StrOut = UPCASE(Str1) | Upper case of Str1 | |||||||

StrOut = LWCASE(Str1) | Lower case of Str1 | |||||||

The following functions manipulate
file names. | ||||||||

Path String = JOIN ('directory','filename','extension') | Produces a contiguous pathstring. e.g. directory/filename.ext | |||||||

Path String = JOIN ('directory','filename') | Produces a contiguous pathstring. e.g. directory/filename | |||||||

SPLIT('PathString', 'DIR') | Produces a separate output of the directory from the pathstring. | |||||||

SPLIT('PathString', 'FILE') | Produces a separate output of the complete filename (with extension) from the pathstring. | |||||||

SPLIT('PathString', 'NAME') | Produces a separate output of the filename from the pathstring. | |||||||

SPLIT('PathString', 'EXT') | Produces a separate output of the file extension from the pathstring. |