Matplotlib is an amazing visualization library in Python for 2D plots of arrays. Matplotlib is a multi-platform data visualization library built on NumPy arrays and designed to work with the broader SciPy stack.
matplotlib.patches.RegularPolygon
The matplotlib.patches.RegularPolygon class is used to add a regular polygon patch.
Syntax: class matplotlib.patches.RegularPolygon(xy, numVertices, radius=5, orientation=0, **kwargs)
Parameters:
- xy: A length 2 tuple (x, y) of the center.
- numVertices: It represents the number of vertices.
- radius: The distance from the center to each of the vertices.
- orientation: It is used to rotate the polygon (in radians).
The below table has a list of valid kwargs;
PROPERTY | DESCRIPTION |
---|---|
agg_filter | a filter function that takes a (m, n, 3) float array and a dpi value that returns a (m, n, 3) array |
alpha | float or None |
animated | bool |
antialiased or aa | unknown |
capstyle | {‘butt’, ’round’, ‘projecting’} |
clip_box | Bbox |
clip_on | bool |
clip_path | [(Path, Transform)|Patch|None] |
color | color or sequence of rgba tuples |
contains | callable |
edgecolor or ec or edgecolors | color or None or ‘auto’ |
facecolor or fc or facecolors | color or None |
figure | figure |
fill | bool |
gid | str |
hatch | {‘/’, ‘\’, ‘|’, ‘-‘, ‘+’, ‘x’, ‘o’, ‘O’, ‘.’, ‘*’} |
in_layout | bool |
joinstyle | {‘miter’, ’round’, ‘bevel’} |
linestyle or ls | {‘-‘, ‘–‘, ‘-.’, ‘:’, ”, (offset, on-off-seq), …} |
linewidth or linewidths or lw | float or None |
path_effects | AbstractPathEffect |
picker | None or bool or float or callable |
path_effects | AbstractPathEffect |
picker | float or callable[[Artist, Event], Tuple[bool, dict]] |
rasterized | bool or None |
sketch_params | (scale: float, length: float, randomness: float) |
snap | bool or None |
transform | matplotlib.transforms.Transform |
url | str |
visible | bool |
zorder | float |
Example 1:
Python3
import matplotlib.pyplot as plt from matplotlib.patches import RegularPolygon import numpy as np coord = [[ 0 , 0 , 0 ], [ 0 , 1 , - 1 ], [ - 1 , 1 , 0 ], [ - 1 , 0 , 1 ], [ 0 , - 1 , 1 ], [ 1 , - 1 , 0 ], [ 1 , 0 , - 1 ]] colors = [[ "Green" ], [ "Green" ], [ "Green" ], [ "Green" ], [ "Green" ], [ "Green" ], [ "Green" ]] labels = [[ '1' ], [ '2' ], [ '3' ], [ '4' ], [ '5' ], [ '6' ], [ '7' ]] # Horizontal cartesian coords hcoord = for c in coord] # Vertical cartesian coords vcoord = [ 2. * np.sin(np.radians( 60 )) * (c[ 1 ] - c[ 2 ]) / 3. for c in coord] fig, ax = plt.subplots( 1 ) ax.set_aspect( 'equal' ) # Add some coloured hexagons for x, y, c, l in zip (hcoord, vcoord, colors, labels): # matplotlib understands lower # case words for colours color = c[ 0 ].lower() hex = RegularPolygon((x, y), numVertices = 6 , radius = 2. / 3. , orientation = np.radians( 30 ), facecolor = color, alpha = 0.2 , edgecolor = 'k' ) ax.add_patch( hex ) # Also add a text label ax.text(x, y + 0.2 , l[ 0 ], ha = 'center' , va = 'center' , size = 20 ) # add scatter points in hexagon centers ax.scatter(hcoord, vcoord, c = .lower() for c in colors], alpha = 0.5 ) plt.show() |
Output:
Example 2:
Python3
import matplotlib.pyplot as plt from matplotlib.patches import RegularPolygon from matplotlib.collections import PatchCollection import numpy as np xy = np.random.random(( 10 , 2 )) z = np.random.random( 10 ) patches = [RegularPolygon((x, y), 5 , 0.1 ) for x, y in xy] collection = PatchCollection(patches, array = z, edgecolors = 'brown' , lw = 2 ) fig, ax = plt.subplots() ax.patch. set (facecolor = 'green' ) ax.add_collection(collection) ax.autoscale() plt.show() |
Output: