element_values#

PostProcessing.element_values(item, comp='', option='AVG')[source]#

Compute the element-wise values for a given item and component.

This method uses Mapdl.etable() <ansys.mapdl.core.Mapdl.etable() and returns a numpy.ndarray rather than storing it within MAPDL.

Parameters:
itemstr

Label identifying the item. See the table below in the notes section.

compstr, optional

Component of the item if applicable. See the table below in the notes section.

optionstr, optional

Option for storing element table data. One of the following:

  • "MIN" : Store minimum element nodal value of the specified item component.

  • "MAX" : Store maximum element nodal value of the specified item component.

  • "AVG" : Store averaged element centroid value of the specified item component (default).

Returns:
numpy.ndarray

Numpy array containing the requested element values for a given item and component.

Return type:

ndarray

Notes

This an incomplete table of element values available to this method. For a full table, see ETABLE

Item

Comp

Description

U

X, Y, Z

X, Y, or Z structural displacement.

ROT

X, Y, Z

X, Y, or Z structural rotation.

TEMP

Temperature.

PRES

Pressure.

VOLT

Electric potential.

MAG

Magnetic scalar potential.

V

X, Y, Z

X, Y, or Z fluid velocity.

A

X, Y, Z

X, Y, or Z magnetic vector potential

CONC

Concentration.

CURR

Current.

EMF

Electromotive force drop.

S

X, Y, Z, XY, YZ, XZ

Component stress.

1, 2, 3

Principal stress.

INT

Stress intensity.

EQV

Equivalent stress.

EPEL

X, Y, Z, XY, YZ, XZ

Component elastic strain.

1, 2, 3

Principal elastic strain.

INT

Elastic strain intensity.

EQV

Elastic equivalent strain.

EPTH

X, Y, Z, XY, YZ, XZ

Component thermal strain.

1, 2, 3

Principal thermal strain.

INT

Thermal strain intensity.

EQV

Thermal equivalent strain.

EPPL

X, Y, Z, XY, YZ, XZ

Component plastic strain.

1, 2, 3

Principal plastic strain.

INT

Plastic strain intensity.

EQV

Plastic equivalent strain.

EPCR

X, Y, Z, XY, YZ, XZ

Component creep strain.

1, 2, 3

Principal creep strain.

INT

Creep strain intensity.

EQV

Creep equivalent strain.

Examples

Return the averaged element displacement in the X direction.

>>> arr = mapdl.post_processing.element_values("U", "X")
>>> arr
array([1.07396154e-06, 3.15631730e-06, 5.12543515e-06, ...,
       5.41204700e-06, 3.33649806e-06, 1.13836132e-06])

Return the maximum element X component stress.

>>> arr = mapdl.post_processing.element_values("S", "X", "max")
>>> arr
array([-1.12618148, -0.93902147, -0.88121128, ...,  0.        ,
        0.        ,  0.        ])

Return the minimum element thermal equivalent strain.

>>> arr = mapdl.post_processing.element_values("EPTH", "EQV", "min")
>>> arr
array([0., 0., 0., ..., 0., 0., 0.])