You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Applications are open for the 2018 John Hunter Matplotlib Summer Fellowship. Apply now!
Version 2.2.2.post1758+gbc39b1c4a
matplotlib
Fork me on GitHub

Table Of Contents

matplotlib.patches.Ellipse

class matplotlib.patches.Ellipse(xy, width, height, angle=0, **kwargs)[source]

A scale-free ellipse.

Parameters:
xy : tuple of (scalar, scalar)

xy coordinates of ellipse centre.

width : scalar

Total length (diameter) of horizontal axis.

height : scalar

Total length (diameter) of vertical axis.

angle : scalar, optional

Rotation in degrees anti-clockwise.

Notes

Valid keyword arguments are

Property Description
agg_filter a filter function, which takes a (m, n, 3) float array and a dpi value, and 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
contains callable
edgecolor or ec color or None or 'auto'
facecolor or fc color or None
figure Figure
fill bool
gid str
hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout bool
joinstyle {'miter', 'round', 'bevel'}
label object
linestyle or ls {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth or lw float or None for default
path_effects AbstractPathEffect
picker None or bool or float or callable
rasterized bool or None
sketch_params (scale: float, length: float, randomness: float)
snap bool or None
transform Transform
url str
visible bool
zorder float
center

Return the center of the ellipse

get_center()[source]

Return the center of the ellipse

get_patch_transform()[source]

Return the Transform instance which takes patch coordinates to data coordinates.

For example, one may define a patch of a circle which represents a radius of 5 by providing coordinates for a unit circle, and a transform which scales the coordinates (the patch coordinate) by 5.

get_path()[source]

Return the vertices of the rectangle

set_center(xy)[source]

Set the center of the ellipse.

Parameters:
xy : (float, float)