`scipy.spatial._plotutils:voronoi_plot_2d`

source: build-install/usr/lib/python3.14/site-packages/scipy/spatial/_plotutils.py:142

Signature

def voronoi_plot_2d(vor, ax = None, **kw)

Summary

Plot the given Voronoi diagram in 2-D.

Parameters

vor : scipy.spatial.Voronoi instance

Diagram to plot

ax : matplotlib.axes.Axes instance, optional

Axes to plot on

**kw

The following options may be passed as keyword arguments:

show_points: Add the Voronoi points to the plot.
show_vertices: Add the Voronoi vertices to the plot.
line_colors: Specifies the line color for polygon boundaries
line_width: Specifies the line width for polygon boundaries
line_alpha: Specifies the line alpha for polygon boundaries
point_size: Specifies the size of points

Returns

fig : matplotlib.figure.Figure instance: Figure for the plot

Notes

Requires Matplotlib. For degenerate input, including collinearity and other violations of general position, it may be preferable to calculate the Voronoi diagram with Qhull options QJ for random joggling, or Qt to enforce triangulated output. Otherwise, some Voronoi regions may not be visible.

Array API Standard Support

voronoi_plot_2d is not in-scope for support of Python Array API Standard compatible backends other than NumPy.

See dev-arrayapi for more information.

Examples

import numpy as np
import matplotlib.pyplot as plt
from scipy.spatial import Voronoi, voronoi_plot_2d

✓

Create a set of points for the example:

rng = np.random.default_rng()
points = rng.random((10,2))

✓

Generate the Voronoi diagram for the points:

vor = Voronoi(points)

✓

Use `voronoi_plot_2d` to plot the diagram:

fig = voronoi_plot_2d(vor)

✓

Use `voronoi_plot_2d` to plot the diagram again, with some settings customized:

fig = voronoi_plot_2d(vor, show_vertices=False, line_colors='orange',
                      line_width=2, line_alpha=0.6, point_size=2)
plt.show()

✓

Aliases

scipy.spatial.voronoi_plot_2d