DataObjectFilters.cell_centers

DataObjectFilters.cell_centers#

DataObjectFilters.cell_centers( *, vertex: bool = True, pass_cell_data: bool = True, progress_bar: bool = False, ) → PolyData | MultiBlock[source]#

Generate points at the center of the cells in this dataset.

These points can be used for placing glyphs or vectors.

Parameters:

vertexbool, default: True: Enable or disable the generation of vertex cells.
pass_cell_databool, default: True: If enabled, pass the input cell data through to the output.
progress_barbool, default: False: Display a progress bar to indicate progress.

Returns:

pyvista.PolyData | pyvista.MultiBlock: Points at the cell centers of the original dataset. Every dataset gives a PolyData, and a MultiBlock gives a MultiBlock of PolyData blocks, nested blocks included.

Examples#

Download Python source code | Download Jupyter notebook

>>> import pyvista as pv
>>> mesh = pv.Plane()
>>> mesh.point_data.clear()
>>> centers = mesh.cell_centers()
>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(mesh, show_edges=True)
>>> actor = pl.add_points(
...     centers,
...     render_points_as_spheres=True,
...     color='red',
...     point_size=20,
... )
>>> pl.show()