Plotter.add_points

Plotter.add_points(

points: MatrixLike[float] | VectorLike[float] | DataSet,

style: Literal['points', 'points_gaussian'] = 'points',

**kwargs,

) → Actor

Add points to a mesh.

Parameters:

pointsnumpy.ndarray or pyvista.DataSet

Array of points or the points from a pyvista object.

stylestr, default: ‘points’

Visualization style of the mesh. One of the following: style='points', style='points_gaussian'. 'points_gaussian' can be controlled with the emissive and render_points_as_spheres options.

**kwargsdict, optional

See pyvista.Plotter.add_mesh() for optional keyword arguments.

Returns:

pyvista.Actor

Actor of the mesh.

See also

Scaled Gaussian Points

Examples

Download Python source code | Download Jupyter notebook

Add a numpy array of points to a mesh.

>>> import numpy as np
>>> import pyvista as pv
>>> rng = np.random.default_rng(seed=0)
>>> points = rng.random((10, 3))
>>> pl = pv.Plotter()
>>> actor = pl.add_points(
...     points, render_points_as_spheres=True, point_size=100.0
... )
>>> pl.show()

Static Scene

Interactive Scene

Plot using the 'points_gaussian' style

>>> points = rng.random((10, 3))
>>> pl = pv.Plotter()
>>> actor = pl.add_points(points, style='points_gaussian')
>>> pl.show()

Static Scene

Interactive Scene