pyvista.DataSet.find_cells_along_line

DataSet.find_cells_along_line(

pointa: VectorLike[float],

pointb: VectorLike[float],

tolerance: float = 0.0,

) → NumpyArray[int]

Find the index of cells whose bounds intersect a line.

Line is defined from pointa to pointb.

Parameters:

pointaVector

Length 3 coordinate of the start of the line.

pointbVector

Length 3 coordinate of the end of the line.

tolerancefloat, default: 0.0

The absolute tolerance to use to find cells along line.

Returns:

numpy.ndarray

Index or indices of the cell(s) whose bounds intersect the line.

Warning

This method returns cells whose bounds intersect the line. This means that the line may not intersect the cell itself. To obtain cells that intersect the line, use pyvista.DataSet.find_cells_intersecting_line().

See also

DataSet.find_closest_point

DataSet.find_closest_cell

DataSet.find_containing_cell

DataSet.find_cells_within_bounds

DataSet.find_cells_intersecting_line

Examples

>>> import pyvista as pv
>>> mesh = pv.Sphere()
>>> mesh.find_cells_along_line([0.0, 0, 0], [1.0, 0, 0])
array([  86,   87, 1652, 1653])