Mapdl.get_array(entity='', entnum='', item1='', it1num='', item2='', it2num='', kloop='', **kwargs)#

Uses the *VGET command to Return an array from ANSYS as a Python array.

See VGET <> for more details.


Entity keyword. Valid keywords are NODE, ELEM, KP, LINE, AREA, VOLU, etc


The number of the entity.


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


The 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, it2num

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.


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.


Please reference your Ansys help manual *VGET command tables for all the available *VGET values.


List the current selected node numbers

>>> mapdl.get_array('NODE', item1='NLIST')
array([  1.,   2.,   3.,   4.,   5.,   6.,   7.,   8.,
      314., 315., 316., 317., 318., 319., 320., 321.])

List the displacement in the X direction for the first result

>>> mapdl.post1()
>>> mapdl.set(1, 1)
>>> disp_x = mapdl.get_array('NODE', item1='U', it1num='X')
array([ 0.01605306, -0.01605306,  0.00178402, -0.01605306,
       -0.00178402, -0.01234851,  0.01234851, -0.01234851])