*VPUT, ParR, Entity, ENTNUM, Item1, IT1NUM, Item2, IT2NUM, KLOOP
Restores array parameter values into the ANSYS database.

Compatible Products: – | Pro | Premium | Enterprise | Ent PP | Ent Solver | DYNA

Argument Descriptions


The name of the input vector array parameter. See *SET for name restrictions. The parameter must exist as a dimensioned array [*DIM] with data input.


Entity keyword. Valid keywords are shown for Entity = in the table below.


The number of the entity (as shown for ENTNUM= in the table below).


The name of a particular item for the given entity. Valid items are as shown in the Item1 columns of the table below.


The number (or label) for the specified Item1 (if any). Valid IT1NUM values are as shown in the IT1NUM columns of the table below. Some Item1 labels do not require an IT1NUM value.

Item2, IT2NUM

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.


Field to be looped on:

0 or 2 -- 

Loop on the ENTNUM field (default).

3 -- 

Loop on the Item1 field.

4 -- 

Loop on the IT1NUM field. Successive items are as shown with IT1NUM.

5 -- 

Loop on the Item2 field.

6 -- 

Loop on the IT2NUM field. Successive items are as shown with IT2NUM.


The *VPUT 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 *VPUT 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 *VGET operation. Vector items are put directly (without any coordinate system transformation) into the ANSYS 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, and IT1NUM) are listed below. Item2 and IT2NUM are not currently used. Not all items from the *VGET list are allowed on *VPUT since putting values into some locations could cause the database to be inconsistent.

This command is valid in any processor.

Table 240:  *VPUT - POST1 Items

Entity = NODE, ENTNUM = n (node number)
Valid labels for nodal degree of freedom results are:
UX, Y, ZX, Y, or Z structural displacement.
ROTX, Y, ZX, 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.
VX, 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).

AX, 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).

CONC Concentration.
CURR Current.
EMF Electromotive force drop.
Valid labels for element nodal results are:
SX, Y, Z, XY, YZ, XZComponent stress.
"1, 2, 3Principal stress.
"INT, EQV Stress intensity or equivalent stress.
EPTOX, Y, Z, XY, YZ, XZComponent total strain (EPEL + EPPL + EPCR).
"1,2,3Principal total strain.
"INT, EQVTotal strain intensity or total equivalent strain.
EPELX, Y, Z, XY, YZ, XZComponent elastic strain.
"1, 2, 3Principal elastic strain.
"INT, EQVElastic strain intensity or elastic equivalent strain.
EPPLX, Y, Z, XY, YZ, XZComponent plastic strain.
"1,2,3Principal plastic strain.
"INT, EQVPlastic strain intensity or plastic equivalent strain.
EPCRX, Y, Z, XY, YZ, XZComponent creep strain.
"1, 2, 3Principal creep strain.
"INT, EQVCreep strain intensity or creep equivalent strain.
EPTHX, Y, Z, XY, YZ, XZComponent thermal strain.
"1, 2, 3Principal thermal strain.
"INT, EQVThermal strain intensity or thermal equivalent strain.
EPSW Swelling strain.
NLSEPLEquivalent stress (from stress-strain curve).
"SRATStress state ratio.
"HPRESHydrostatic pressure.
"EPEQAccumulated equivalent plastic strain.
"PSVPlastic state variable.
"PLWKPlastic work/volume.
TGX, Y, ZComponent thermal gradient.
TFX, Y, ZComponent thermal flux.
PGX, Y, ZComponent pressure gradient.
EFX, Y, ZComponent electric field.
DX, Y, ZComponent electric flux density.
HX, Y, ZComponent magnetic field intensity.
BX, Y, ZComponent magnetic flux density.
FMAGX, Y, ZComponent electromagnetic force.
Entity = ELEM, ENTNUM = n (element number)
Valid labels for element results are:
ETABLabAny user-defined element table label (see ETABLE command).

Menu Paths

Utility Menu>Parameters>Array Operations>Put Array Data

Release 18.2 - © ANSYS, Inc. All rights reserved.