DataSet.find_cells_intersecting_line

DataSet.find_cells_intersecting_line(

pointa: VectorLikeFloat,

pointb: VectorLikeFloat,

tolerance: float | None = None,

) → NDArray[np.int_]

Find the index of cells that intersect a line.

Line is defined from pointa to pointb.

Warning

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

Parameters:

pointaVectorLikeFloat

Length 3 coordinate of the start of the line.

pointbVectorLikeFloat

Length 3 coordinate of the end of the line.

tolerancefloat, optional

The absolute tolerance to use to find cells along line. The default value is the epsilon (eps) of float32 dtype using numpy.finfo.

Returns:

numpy.ndarray

Index or indices of the cells that intersect the line.

Examples

Download Python source code | Download Jupyter notebook

>>> import pyvista as pv
>>> mesh = pv.Sphere()
>>> cell_ids = mesh.find_cells_intersecting_line([0.0, 0, 0], [1.0, 0, 0])
>>> sorted(cell_ids.tolist())
[86, 1653]

See Also

DataSet.find_closest_point

DataSet.find_closest_cell

DataSet.find_containing_cell

DataSet.find_cells_within_bounds

DataSet.find_cells_along_line

DataSet.intersect_with_line

PolyDataFilters.ray_trace