DataSet.find_closest_point

DataSet.find_closest_point(point: Iterable[float], n: int = 1) → int | VectorLike[int]

Find index of closest point in this mesh to the given point.

If wanting to query many points, use a KDTree with scipy or another library as those implementations will be easier to work with.

See: pyvista/pyvista-support#107

Warning

This filter internally builds and caches a vtkPointLocator. If the mesh’s geometry is modified, the cache will no longer be valid.

Parameters:

pointsequence[float]

Length 3 coordinate of the point to query.

nint, optional

If greater than 1, returns the indices of the n closest points.

Returns:

int

The index of the point in this mesh that is closest to the given point.

See also

DataSet.find_closest_cell

DataSet.find_containing_cell

DataSet.find_cells_along_line

DataSet.find_cells_within_bounds

DataSet.intersect_with_line

PolyDataFilters.ray_trace

Measure Distance Between Point Clouds

Highlight Nearest Neighbors in a Point Cloud

Examples

Download Python source code | Download Jupyter notebook

Find the index of the closest point to (0, 1, 0).

>>> import pyvista as pv
>>> mesh = pv.Sphere()
>>> index = mesh.find_closest_point((0, 1, 0))
>>> index
239

Get the coordinate of that point.

>>> mesh.points[index]
pyvista_ndarray([-0.05218758,  0.49653167,  0.02706946], dtype=float32)