active_normals

property DataSetAttributes.active_normals: Optional[pyvista_ndarray]

Return or set the normals.

Returns

pyvista_ndarray

Normals of this dataset attribute. None if no normals have been set.

Notes

Field data will have no normals.

Examples

First, compute cell normals.

>>> import pyvista
>>> mesh = pyvista.Plane(i_resolution=1, j_resolution=1)
>>> mesh.point_data
pyvista DataSetAttributes
Association     : POINT
Active Scalars  : None
Active Vectors  : None
Active Texture  : TextureCoordinates
Active Normals  : Normals
Contains arrays :
    Normals                 float32    (4, 3)               NORMALS
    TextureCoordinates      float32    (4, 2)               TCOORDS

>>> mesh.point_data.active_normals
pyvista_ndarray([[0.000000e+00,  0.000000e+00, -1.000000e+00],
                 [0.000000e+00,  0.000000e+00, -1.000000e+00],
                 [0.000000e+00,  0.000000e+00, -1.000000e+00],
                 [0.000000e+00,  0.000000e+00, -1.000000e+00]],
                dtype=float32)

Assign normals to the cell arrays. An array will be added named "Normals".

>>> mesh.cell_data.active_normals = [[0.0, 0.0, 1.0]]
>>> mesh.cell_data
pyvista DataSetAttributes
Association     : CELL
Active Scalars  : None
Active Vectors  : None
Active Texture  : None
Active Normals  : Normals
Contains arrays :
    Normals                 float64    (1, 3)               NORMALS