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` | |||||||

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` | |||||||

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. |