scipy 1.8.0 Pypi GitHub Homepage
Other Docs
AttributesNotesParametersRaisesBackRef
Voronoi(points, furthest_site=False, incremental=False, qhull_options=None)

Attributes

points : ndarray of double, shape (npoints, ndim)

Coordinates of input points.

vertices : ndarray of double, shape (nvertices, ndim)

Coordinates of the Voronoi vertices.

ridge_points : ndarray of ints, shape ``(nridges, 2)``

Indices of the points between which each Voronoi ridge lies.

ridge_vertices : list of list of ints, shape ``(nridges, *)``

Indices of the Voronoi vertices forming each Voronoi ridge.

regions : list of list of ints, shape ``(nregions, *)``

Indices of the Voronoi vertices forming each Voronoi region. -1 indicates vertex outside the Voronoi diagram.

point_region : list of ints, shape (npoints)

Index of the Voronoi region for each input point. If qhull option "Qc" was not specified, the list will contain -1 for points that are not associated with a Voronoi region.

furthest_site :

True if this was a furthest site triangulation and False if not.

versionadded
versionadded

Notes

The Voronoi diagram is computed using the Qhull library.

Parameters

points : ndarray of floats, shape (npoints, ndim)

Coordinates of points to construct a Voronoi diagram from

furthest_site : bool, optional

Whether to compute a furthest-site Voronoi diagram. Default: False

incremental : bool, optional

Allow adding new points incrementally. This takes up some additional resources.

qhull_options : str, optional

Additional options to pass to Qhull. See Qhull manual for details. (Default: "Qbb Qc Qz Qx" for ndim > 4 and "Qbb Qc Qz" otherwise. Incremental mode omits "Qz".)

Raises

QhullError

Raised when Qhull encounters an error condition, such as geometrical degeneracy when options to resolve are not enabled.

ValueError

Raised if an incompatible array is given as input.

Voronoi diagrams in N dimensions.

Examples

Voronoi diagram for a set of point:

>>> points = np.array([[0, 0], [0, 1], [0, 2], [1, 0], [1, 1], [1, 2],
...  [2, 0], [2, 1], [2, 2]])
... from scipy.spatial import Voronoi, voronoi_plot_2d
... vor = Voronoi(points)

Plot it:

>>> import matplotlib.pyplot as plt
... fig = voronoi_plot_2d(vor)
... plt.show()

The Voronoi vertices:

>>> vor.vertices
array([[0.5, 0.5],
       [0.5, 1.5],
       [1.5, 0.5],
       [1.5, 1.5]])

There is a single finite Voronoi region, and four finite Voronoi ridges:

>>> vor.regions
[[], [-1, 0], [-1, 1], [1, -1, 0], [3, -1, 2], [-1, 3], [-1, 2], [0, 1, 3, 2], [2, -1, 0], [3, -1, 1]]
>>> vor.ridge_vertices
[[-1, 0], [-1, 0], [-1, 1], [-1, 1], [0, 1], [-1, 3], [-1, 2], [2, 3], [-1, 3], [-1, 2], [1, 3], [0, 2]]

The ridges are perpendicular between lines drawn between the following input points:

>>> vor.ridge_points
array([[0, 3],
       [0, 1],
       [2, 5],
       [2, 1],
       [1, 4],
       [7, 8],
       [7, 6],
       [7, 4],
       [8, 5],
       [6, 3],
       [4, 5],
       [4, 3]], dtype=int32)
See :

Back References

The following pages refer to to this document either explicitly or contain code examples using this.

scipy.spatial._qhull.Voronoi scipy.spatial._plotutils.voronoi_plot_2d

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


GitHub : /scipy/spatial/_qhull.cpython-39-darwin.so#None
type: <class 'type'>
Commit: