PolyDataFilters.remove_unused_points

PolyDataFilters.remove_unused_points(*, inplace: bool = False) → _PolyDataType

Remove points which are not used by any cells.

This filter is similar to clean() but does not merge points or convert cells. The point order is also unchanged by this filter.

Added in version 0.46.

Parameters:

inplacebool, default: False

If True the mesh is updated in-place, otherwise a copy is returned.

Returns:

PolyData

Mesh with unused points removed.

See also

pyvista.UnstructuredGridFilters.remove_unused_points

Examples

Create PolyData with three points. The first two points are coincident and associated with VERTEX cells, and the third point is “unused” and not associated with any cells.

>>> import pyvista as pv
>>> points = [[0.0, 0.0, 0.0], [0.0, 0.0, 0.0], [1.0, 1.0, 1.0]]
>>> faces = [1, 0, 1, 1]
>>> poly = pv.PolyData(points, faces)
>>> poly
PolyData (...)
  N Cells:    2
  N Points:   3
  N Strips:   0
  X Bounds:   0.000e+00, 1.000e+00
  Y Bounds:   0.000e+00, 1.000e+00
  Z Bounds:   0.000e+00, 1.000e+00
  N Arrays:   0

Since the third point is unused, we can remove it. Note that coincident points are not merged by this filter, so the two vertex points are kept as-is.

>>> poly = poly.remove_unused_points()
>>> poly
PolyData (...)
  N Cells:    2
  N Points:   2
  N Strips:   0
  X Bounds:   0.000e+00, 0.000e+00
  Y Bounds:   0.000e+00, 0.000e+00
  Z Bounds:   0.000e+00, 0.000e+00
  N Arrays:   0