*VGET, ParR, Entity, ENTNUM, Item1, IT1NUM, Item2, IT2NUM, KLOOP
Retrieves values and stores them into an array parameter.
ParRThe name of the resulting vector array parameter. See *SET for name restrictions. The program creates the array parameter if it does not exist.
EntityEntity keyword. Valid keywords are NODE, ELEM, KP,
LINE, AREA, VOLU, etc. as shown for Entity = in the tables below.
ENTNUMThe number of the entity (as shown for ENTNUM = in the tables below).
Item1The name of a particular item for the given entity.
Valid items are as shown in the Item1 columns
of the tables below.
IT1NUMThe number (or label) for the specified Item1 (if any). Valid IT1NUM values are as shown in the IT1NUM columns
of the tables below. Some Item1 labels
do not require an IT1NUM value.
Item2, IT2NUMA second set of item labels and numbers to further qualify the item for which data is to be retrieved. Most items do not require this level of information.
KLOOPField to be looped on:
Loop on the ENTNUM field (default).
Loop on the Item1 field.
Loop on the IT1NUM field. Successive items are as shown with IT1NUM.
Loop on the Item2 field.
Loop on the IT2NUM field. Successive items are as shown with IT2NUM.
Retrieves values for specified items and stores the values in an output vector of a user-named array parameter according to:
ParR = f(Entity, ENTNUM, Item1, IT1NUM, Item2, IT2NUM)
where (f) is the *GET function; Entity, Item1, and Item2 are keywords; and ENTNUM, IT1NUM, and IT2NUM are numbers or labels corresponding to the keywords. Looping continues
over successive entity numbers (ENTNUM)
for the KLOOP default. For example, *VGET,A(1),ELEM,5,CENT,X returns the centroid x-location
of element 5 and stores the result in the first location of A. Retrieving
continues with element 6, 7, 8, etc., regardless of whether the element
exists or is selected, until successive array locations are filled.
Use *VLEN or *VMASK to skip
locations. Absolute values and scale factors may be applied to the
result parameter [*VABS, *VFACT]. Results may be cumulative [*VCUM]. See the *VOPER command for general details. Results can be put
back into an analysis by writing a file of the desired input commands
with the *VWRITE command. See also the *VPUT command.
Both *GET and *VGET retrieve information from the active data stored in memory. The database is often the source, and sometimes the information is retrieved from common memory blocks that ANSYS uses to manipulate information. Although POST1 and POST26 operations use a *.rst file, GET data is accessed from the database or from the common blocks. Get operations do not access the *.rst file directly.
The *VGET command retrieves both the unprocessed real and the imaginary parts (original and duplicate sector nodes and elements) of a cyclic symmetry solution.
Each of the sections for accessing *VGET parameters are shown in the following order:
This command is valid in any processor.
Table 227: *VGET PREP7 Items, Entity = NODE
Entity = NODE, ENTNUM = n (node number) | ||
|---|---|---|
*VGET, ParR, NODE, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| LOC | X, Y, Z | X, Y, or Z location in the active coordinate system |
| ANG | XY, YZ, ZX | THXY, THYZ, THZX rotation angle |
| NSEL | Select
status of node n: -1 = unselected, 0 =
undefined, 1 = selected | |
| NLIST | Returns the list of selected nodes (ENTNUM is ignored) | |
Table 228: *VGET PREP7 Items, Entity = ELEM
Entity = ELEM, ENTNUM = n (element number) | ||
|---|---|---|
*VGET, ParR, ELEM, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| NODE | 1, 2, ... 20 | Node
number at position 1, 2, ... 20 of element n |
| CENT | X, Y, Z | Centroid X, Y, or Z location (based on shape function) in the active coordinate system |
| ADJ | 1, 2, ... 6 | Number of elements adjacent to face 1, 2, ... 6 |
| ATTR | name | Number assigned to specified attribute; name = MAT, TYPE, REAL, ESYS, ENAM, or SECN |
| GEOM | Characteristic element geometry. Length of line element (straight line between ends), area of area element, or volume of volume element. Issuing *VGET for an element returns a signed value. To always get a positive value, issue *VABS,1 prior to issuing the *VGET command. | |
| ESEL | Select status of element n: -1 = unselected, 0 = undefined, 1 = selected | |
| SHPAR | Test | Element shape test result for selected element n, where
Test = ASPE (aspect ratio), JACR (Jacobian ratio), MAXA (maximum
corner angle), PARA (deviation from parallelism of opposite edges), or WARP (warping
factor) |
| ELIST | Returns the list
of selected elements (ENTNUM is ignored) | |
Table 229: *VGET PREP7 Items, Entity = KP
Entity = KP, ENTNUM = n (keypoint number) | ||
|---|---|---|
*VGET, ParR, KP, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| LOC | X, Y, Z | X, Y, or Z location in the active coordinate system |
| ATTR | name | Number assigned to specified attribute; name = MAT, TYPE, REAL, ESYS, NODE, or ELEM |
| DIV | Divisions (element size setting) from KESIZE | |
| KSEL | Select status of keypoint n: -1 = unselected, 0 = undefined, 1 = selected | |
| KLIST | Returns the list of selected
keypoints (ENTNUM is ignored) | |
Table 230: *VGET PREP7 Items, Entity = LINE
Entity = LINE, ENTNUM = n (line number) | ||
|---|---|---|
*VGET, ParR, LINE, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| KP | 1, 2 | Keypoint number at position 1 or 2 |
| ATTR | name | Number assigned to specified attribute; name = MAT, TYPE, REAL, ESYS, NNOD, NELM, or NDIV (NNOD
= number of nodes, NELM = number of elements, NDIV = number of divisions) |
| LENG | Length | |
| LSEL | Select status of line n: -1 = unselected, 0 = undefined, 1 = selected | |
| LLIST | Returns the list
of selected lines (ENTNUM is ignored) | |
Table 231: *VGET PREP7 Items, Entity = AREA
Entity = AREA, ENTNUM = n (area number) | ||||
|---|---|---|---|---|
*VGET, ParR, AREA, n, Item1, IT1NUM, Item2, IT2NUM, KLOOP | ||||
| Item1 | IT1NUM | Item2 | IT2NUM | Description |
| LOOP | 1,2, ... | LINE | 1, 2, ... p | IT1NUM
is the loop number, and must be input if LINE is to be retrieved.
IT2NUM is line number at position 1, 2, ... p |
| ATTR | name | Number assigned to specified attribute; name = MAT, TYPE, REAL, ESYS, SECN, NNOD, or NELM (NNOD = number of nodes,
NELM = number of elements) | ||
| AREA | - | Area (after last ASUM) | ||
| ASEL | - | Select status of area n: -1 = unselected, 0 = undefined, 1 = selected | ||
| ALIST | - | Returns the
list of selected areas (ENTNUM is ignored) | ||
Table 232: *VGET PREP7 Items, Entity = VOLU
Entity = VOLU, ENTNUM = n (volume number) | ||||
|---|---|---|---|---|
*VGET, ParR, VOLU, n, Item1, IT1NUM, Item2, IT2NUM, KLOOP | ||||
| Item1 | IT1NUM | Item2 | IT2NUM | Description |
| SHELL | 1, 2, ... | AREA | 1, 2, ... p | IT1NUM
is the shell number, and must be input if AREA is to be retrieved.
IT2NUM is area number at position 1, 2 ... p |
| ATTR | name | Number assigned to specified attribute; name = MAT, TYPE, REAL, ESYS, NNOD, or NELM (NNOD = number of nodes,
NELM = number of elements) | ||
| VOLU | - | Volume (after last VSUM) | ||
| VSEL | - | Select status
of volume n: -1 = unselected, 0 = undefined,
1 = selected | ||
| VLIST | - | Returns the list of selected volumes (ENTNUM is ignored) | ||
Table 233: *VGET PREP7 Items, Entity = CDSY
Entity = CDSY, ENTNUM = n (coordinate system number) | ||
|---|---|---|
*VGET, ParR, CDSY, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| LOC | X, Y, Z | X, Y, or Z origin location (global Cartesian coordinate) |
| ANG | XY, YZ, ZX | THXY, THYZ, or THZX rotation angle (°) relative to the global Cartesian coordinate system |
| ATTR | name | Number assigned to specified attribute; name = KCS, KTHET, KPHI, PAR1, or PAR2. If the coordinate
system is undefined, KCS returns as -1.0 |
Table 234: *VGET PREP7 Items, Entity = RCON
Entity = RCON, ENTNUM = n (real constant set number) | ||
|---|---|---|
*VGET, ParR, RCON, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| CONST | 1, 2, ... m | Real constant value for constant 1, 2, ... m |
Table 235: *VGET PREP7 Items, Entity = TLAB
Entity =
TLAB, ENTNUM =
n (TLAB is the
Lab data table label on the TB command.
n is the material number.) | ||||
|---|---|---|---|---|
*VGET, ParR, TLAB, n, Item1, IT1NUM, , , KLOOP | ||||
| Item1 | IT1NUM | Item2 | IT2NUM | Description |
| TEMP | val | CONST | num | value is the temperature value at which to
retrieve table data. num is the constant number whose value is to
be retrieved. For constants input as X, Y points, the constant numbers are consecutive with
the X constants being the odd numbers, beginning with one. |
Note: Vector items are in the active results coordinate system unless otherwise specified.
Table 236: *VGET POST1 Items, Entity = NODE, Nodal Degree of Freedom Results
Entity = NODE, ENTNUM = n (node number) | ||
|---|---|---|
*VGET, ParR, NODE, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| U | X, Y, Z | X, Y, or Z structural displacement |
| ROT | X, Y, Z | X, Y, or Z structural rotation |
| TEMP | Temperature. For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use TBOT, TE2, TE3, ..., TTOP instead of TEMP. Alternative get functions: TEMP(N), TBOT(N), TE2(N), etc. | |
| PRES | Pressure | |
| VOLT | Electric potential | |
| MAG | Magnetic scalar potential | |
| V | X, Y, Z | X, Y, or Z fluid velocity; X, Y, or Z nodal velocity in a transient structural analysis (LS-DYNA analysis or analysis with ANTYPE,TRANS) |
| A | X, Y, Z | X, Y, or Z magnetic vector potential; X, Y or Z nodal acceleration in a transient structural analysis (LS-DYNA analysis or analysis with ANTYPE,TRANS) |
| CURR | Current | |
| EMF | Electromotive force drop | |
Table 237: *VGET POST1 Items, Entity = NODE, Element Nodal Results
Entity = NODE, ENTNUM = n (node number) | ||
|---|---|---|
*VGET, ParR, NODE, n, Item1, IT1NUM, , , KLOOP | ||
| Item1 | IT1NUM | Description |
| S | X, Y, Z, XY, YZ, XZ | Component stress |
| 1, 2, 3 | Principal stress | |
| INT, EQV | Stress intensity or equivalent stress | |
| EPTO | X, Y, Z, XY, YZ, XZ | Component total strain (EPEL + EPPL + EPCR) |
| 1, 2, 3 | Principal total strain | |
| INT, EQV | Total strain intensity or total equivalent strain | |
| EPEL | X, Y, Z, XY, YZ, XZ | Component elastic strain |
| 1, 2, 3 | Principal elastic strain | |
| INT, EQV | Elastic strain intensity or elastic equivalent strain | |
| EPPL | X, Y, Z, XY, YZ, XZ | Component plastic strain |
| 1, 2, 3 | Principal plastic strain | |
| INT, EQV | Plastic strain intensity or plastic equivalent strain | |
| EPCR | X, Y, Z, XY, YZ, XZ | Component creep strain |
| 1, 2, 3 | Principal creep strain | |
| INT, EQV | Creep strain intensity or creep equivalent strain | |
| EPTH | X, Y, Z, XY, YZ, XZ | Component thermal strain |
| 1, 2, 3 | Principal thermal strain | |
| INT, EQV | Thermal strain intensity or thermal equivalent strain | |
| EPSW | Swelling strain | |
| EPDI | X, Y, Z, XY, YZ, XZ | Component diffusion strain |
| 1, 2, 3 | Principal diffusion strain | |
| INT, EQV | Diffusion strain intensity or diffusion equivalent strain | |
| NL | SEPL | Equivalent stress (from stress-strain curve) |
| SRAT | Stress state ratio | |
| HPRES | Hydrostatic pressure | |
| EPEQ | Accumulated equivalent plastic strain | |
| PSV | Plastic state variable | |
| PLWK | Plastic work/volume | |
| HS | X, Y, Z | Component magnetic field intensity from current sources (in the global Cartesian coordinate system) |
| BFE | TEMP | Body temperatures (calculated from applied temperatures) as used in solution |
| TG | X, Y, Z, SUM | Component thermal gradient and sum |
| TF | X, Y, Z, SUM | Component thermal flux and sum |
| PG | X, Y, Z, SUM | Component pressure gradient and sum |
| EF | X, Y, Z, SUM | Component electric field and sum |
| D | X, Y, Z, SUM | Component electric flux density and sum |
| H | X, Y, Z, SUM | Component magnetic field intensity and sum |
| B | X, Y, Z, SUM | Component magnetic flux density and sum |
| FMAG | X, Y, Z, SUM | Component electromagnetic force and sum |
| Element nodal results are the average nodal value of the selected elements. | ||
Table 239: *VGET POST1 Items, Entity = CYCCALC
Entity = CYCCALC, ENTNUM = n (CYCSPEC specification
number) | ||||
|---|---|---|---|---|
*VGET, ParR, CYCCALC, n, Item1, IT1NUM, Item2, IT2NUM, KLOOP | ||||
| Item1 | IT1NUM | Item2 | IT2NUm | Description |
| FREQ | Frequency point | SECTOR | sector | CYCSPEC results at the IT1NUM frequency or sector (depending on KLOOP) |
| SECMAX | CYCSPEC maximum results | |||
The frequency point
refers to the harmonic solution data set number ( For For All other | ||||