Mapdl.starvput(parr='', entity='', entnum='', item1='', it1num='', item2='', it2num='', kloop='', **kwargs)[source]#

Restores array parameter values into the ANSYS database.

APDL Command: *VPUT


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:

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.


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.