ansys.mapdl.core.Mapdl.starvget#
- Mapdl.starvget(parr='', entity='', entnum='', item1='', it1num='', item2='', it2num='', kloop='', **kwargs)#
Retrieves values and stores them into an array parameter.
Mechanical APDL Command: *VGET
- Parameters:
- parr
str
The name of the resulting vector array parameter. See starset for name restrictions. The program creates the array parameter if it does not exist.
- entity
str
Entity keyword. Valid keywords are NODE, ELEM, KP, LINE, AREA, VOLU, etc. as shown for
Entity
= in the tables below.- entnum
str
The number of the entity (as shown for
ENTNUM
= in the tables below).- item1
str
The name of a particular item for the given entity. Valid items are as shown in the
Item1
columns of the tables below.- it1num
str
The number (or label) for the specified
Item1
(if any). ValidIT1NUM
values are as shown in theIT1NUM
columns of the tables below. SomeItem1
labels do not require anIT1NUM
value.- item2
str
A 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.
- it2num
str
A 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.
- kloop
str
Field to be looped on:
0 or 2
- Loop on theENTNUM
field (default).3
- Loop on theItem1
field.4
- Loop on theIT1NUM
field. Successive items are as shown withIT1NUM
.5
- Loop on theItem2
field.6
- Loop on theIT2NUM
field. Successive items are as shown withIT2NUM
.
- parr
Notes
Warning
This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.
Argument Descriptions
parr : str
- The name of the resulting vector array parameter. See starset for name restrictions. The program creates the array parameter if it does not exist.entity : str
- Entity keyword. Valid keywords are NODE, ELEM, KP, LINE, AREA, VOLU, etc. as shown forEntity
= in the tables below.entnum : str
- The number of the entity (as shown forENTNUM
= in the tables below).item1 : str
- The name of a particular item for the given entity. Valid items are as shown in theItem1
columns of the tables below.it1num : str
- The number (or label) for the specifiedItem1
(if any). ValidIT1NUM
values are as shown in theIT1NUM
columns of the tables below. SomeItem1
labels do not require anIT1NUM
value.item2, it2num : str
- A 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.kloop : str
- Field to be looped on:0 or 2
- Loop on theENTNUM
field (default).3
- Loop on theItem1
field.4
- Loop on theIT1NUM
field. Successive items are as shown withIT1NUM
.5
- Loop on theItem2
field.6
- Loop on theIT2NUM
field. Successive items are as shown withIT2NUM
.
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
, andItem2
are keywords; andENTNUM
,IT1NUM
, andIT2NUM
are numbers or labels corresponding to the keywords. Looping continues over successive entity numbers (ENTNUM
) for theKLOOP
default. For example, starvget,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 starvput command.Both get and starvget 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 Mechanical APDL 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 starvget 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:
*VGET PREP7 Items *VGET PREP7 Items
*VGET POST1 Items *VGET POST1 Items
This command is valid in any processor.
*VGET PREP7 Items
*VGET PREP7 Items, Entity = NODE#
Entity
= NODE,ENTNUM
=n
(node number)#starvget,
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 = selectedNLIST
Returns the list of selected nodes (
ENTNUM
is ignored)*VGET PREP7 Items, Entity = ELEM#
Entity
= ELEM,ENTNUM
=n
(element number)#starvget,
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 SECNGEOM
Characteristic element geometry. Length of line element (straight line between ends), area of area element, or volume of volume element. Issuing starvget for an element returns a signed value. To always get a positive value, issue vabs,1 prior to issuing the starvget command.
ESEL
Select status of element
n
: -1 = unselected, 0 = undefined, 1 = selectedSHPAR
Test
Element shape test result for selected element
n
, whereTest
= 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)*VGET PREP7 Items, Entity = KP#
Entity
= KP,ENTNUM
=n
(keypoint number)#starvget,
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 ELEMDIV
Divisions (element size setting) from kesize
KSEL
Select status of keypoint
n
: -1 = unselected, 0 = undefined, 1 = selectedKLIST
Returns the list of selected keypoints (
ENTNUM
is ignored)*VGET PREP7 Items, Entity = LINE#
Entity
= LINE,ENTNUM
=n
(line number)#starvget,
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 = selectedLLIST
Returns the list of selected lines (
ENTNUM
is ignored)*VGET PREP7 Items, Entity = AREA#
Entity
= AREA,ENTNUM
=n
(area number)#starvget,
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 = selectedALIST
Returns the list of selected areas (
ENTNUM
is ignored)*VGET PREP7 Items, Entity = VOLU#
Entity
= VOLU,ENTNUM
=n
(volume number)#starvget,
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 = selectedVLIST
Returns the list of selected volumes (
ENTNUM
is ignored)*VGET PREP7 Items, Entity = CDSY#
Entity
= CDSY,ENTNUM
=n
(coordinate system number)#starvget,
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*VGET PREP7 Items, Entity = RCON#
Entity
= RCON,ENTNUM
=n
(real constant set number)#starvget,
ParR
, RCON,n
,Item1
,IT1NUM
,,KLOOP
Item1
IT1NUM
Description
CONST
1, 2,…
m
Real constant value for constant 1, 2,…
m
*VGET PREP7 Items, Entity = TLAB#
Entity
=TLAB
,ENTNUM
=n
(TLAB
is theLab
data table label on the tb command.n
is the material number.)#starvget,
ParR
,TLAB
,n
,Item1
,IT1NUM
,,KLOOP
Item1
IT1NUM
Item2
IT2NUM
Description
TEMP
val
CONST
num
IT1NUM
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.*VGET POST1 Items
Vector items are in the active results coordinate system unless otherwise specified.
*VGET POST1 Items, Entity = CYCCALC#
Entity
= CYCCALC,ENTNUM
=n
( cycspec specification number)#starvget,
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 (
NSET
on the Set displays command). ForKLOOP
= 4 or SECMAX, returns the requested sector results for all frequencies andIT1NUM
is ignored. ForKLOOP
= 6, returns the requested frequency results for all sectors andIT2NUM
is ignored. All otherKLOOP
options are invalid.*VGET POST1 Items, Entity = ELEM#
Entity
= ELEM,ENTNUM
=n
(element number)#starvget,
ParR
, ELEM,n
,Item1
,IT1NUM
,,KLOOP
Item1
IT1NUM
Description
ETAB
Label
Any user-defined element table label (see etable command)
*VGET POST1 Items, Entity = MEMBER#
Entity
= MEMBER,ENTNUM
=N
(GroupID)#starvget,
Par
,MEMBER,N
,Item1
,IT1NUM
,,KLOOP
Item1
IT1NUM
Description
TEMP
MIN, MAX
Minimum or maximum temperature of members (individual reinforcings) with GroupID =
N
in the selected set of reinforcing elements*VGET POST1 Items, Entity = NODE, Element Nodal Results#
Entity
= NODE,ENTNUM
=n
(node number)#starvget,
ParR
, NODE,n
,Item1
,IT1NUM
,,KLOOP
Item1
IT1NUM
Description
Item2
S
X, Y, Z, XY, YZ, XZ
Component stress
Item2
controls whether nodal-averaged results are used. Valid labels are: AUTO - Use nodal-averaged results, if available. Otherwise use element-based results. ESOL- Use element-based results only. NAR - Use nodal-averaged results only.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
Item2
controls whether nodal-averaged results are used. Valid labels are: AUTO - Use nodal-averaged results, if available. Otherwise use element-based results. ESOL- Use element-based results only. NAR - Use nodal-averaged results only.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
Item2
controls whether nodal-averaged results are used. Valid labels are: AUTO - Use nodal-averaged results, if available. Otherwise use element-based results. ESOL- Use element-based results only. NAR - Use nodal-averaged results only.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
Item2
controls whether nodal-averaged results are used. Valid labels are: AUTO - Use nodal-averaged results, if available. Otherwise use element-based results. ESOL- Use element-based results only. NAR - Use nodal-averaged results only.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
Item2
controls whether nodal-averaged results are used. Valid labels are: AUTO - Use nodal-averaged results, if available. Otherwise use element-based results. ESOL- Use element-based results only. NAR - Use nodal-averaged results only.1, 2, 3
Principal thermal strain
INT, EQV
Thermal strain intensity or thermal equivalent strain
EPSW
Swelling strain
Item2
controls whether nodal-averaged results are used. Valid labels are: AUTO - Use nodal-averaged results, if available. Otherwise use element-based results. ESOL- Use element-based results only. NAR - Use nodal-averaged results only.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
CONT
STAT
Contact status
PENE
Contact penetration
PRES
Contact pressure
SFRIC
Contact friction stress
STOT
Contact total stress (pressure plus friction)
SLIDE
Contact sliding distance
GAP
Contact gap distance
FLUX
Total heat flux at contact surface
CNOS
Total number of contact status changes during substep
FPRS
Actual applied fluid penetration pressure
Element nodal results are the average nodal value of the selected elements
*VGET POST1 Items, Entity = NODE, Nodal Degree of Freedom Results#
Entity
= NODE,ENTNUM
=n
(node number)#starvget,
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
andSHELL132
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 (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 (analysis with antype,TRANS)
CURR
Current
EMF
Electromotive force drop