ansys.mapdl.core.Mapdl.starvput#
- Mapdl.starvput(parr='', entity='', entnum='', item1='', it1num='', item2='', it2num='', kloop='', **kwargs)#
Restores array parameter values into the Mechanical APDL database.
Mechanical APDL Command: *VPUT
- Parameters:
- parr
str
The name of the input vector array parameter. See starset for name restrictions. The parameter must exist as a dimensioned array ( dim ) with data input.
- entity
str
Entity keyword. Valid keywords are shown for
Entity
= in the table below.- entnum
str
The number of the entity (as shown for
ENTNUM
= in the table below).- item1
str
The name of a particular item for the given entity. Valid items are as shown in the
Item1
columns of the table below.- it1num
str
The number (or label) for the specified
Item1
(if any). ValidIT1NUM
values are as shown in theIT1NUM
columns of the table 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 stored. 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 stored. 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 input vector array parameter. See starset for name restrictions. The parameter must exist as a dimensioned array ( dim ) with data input.entity : str
- Entity keyword. Valid keywords are shown forEntity
= in the table below.entnum : str
- The number of the entity (as shown forENTNUM
= in the table below).item1 : str
- The name of a particular item for the given entity. Valid items are as shown in theItem1
columns of the table below.it1num : str
- The number (or label) for the specifiedItem1
(if any). ValidIT1NUM
values are as shown in theIT1NUM
columns of the table 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 stored. 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
.
The starvput command is not supported for PowerGraphics displays. Inconsistent results may be obtained if this command is not used in graphics, FULL.
Plot and print operations entered via the GUI ( Utility Menu> Pltcrtls, Utility Menu> Plot ) incorporate the avprin command. This means that the principal and equivalent values are recalculated. If you use starvput to put data back into the database, issue the plot commands from the command line to preserve your data.
This operation is basically the inverse of the starvget operation. Vector items are put directly (without any coordinate system transformation) into the Mechanical APDL database. Items can only replace existing items of the database and not create new items. Degree of freedom results that are replaced in the database are available for all subsequent postprocessing operations. Other results are changed temporarily and are available mainly for the immediately following print and display operations. The vector specification vcum does not apply to this command. The valid labels for the location fields (
Entity
,ENTNUM
,Item1
, andIT1NUM
) are listed below.Item2
andIT2NUM
are not currently used. Not all items from the starvget list are allowed on starvput, as putting values into some locations could cause the database to be inconsistent.This command is valid in any processor.
*VPUT - POST1 Items#
Entity
= NODE,ENTNUM
=n
(node number)#Item1
IT1NUM
Description
Valid labels for nodal degree of freedom results are:
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).
CONC
Concentration.
CURR
Current.
EMF
Electromotive force drop.
Valid labels for element nodal results are:
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.
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.
TG
X, Y, Z
Component thermal gradient.
TF
X, Y, Z
Component thermal flux.
PG
X, Y, Z
Component pressure gradient.
EF
X, Y, Z
Component electric field.
D
X, Y, Z
Component electric flux density.
H
X, Y, Z
Component magnetic field intensity.
B
X, Y, Z
Component magnetic flux density.
FMAG
X, Y, Z
Component electromagnetic force.
Entity= ELEM,
ENTNUM
=n
(element number)Valid labels for element results are:
Item1
IT1NUM
Description
ETAB
Lab
Any user-defined element table label ( etable ).