"""

zorder = 1

validCap = mlines.Line2D.validCap

validJoin = mlines.Line2D.validJoin

# Whether to draw an edge by default. Set on a

# subclass-by-subclass basis.

_edge_default = False

def __init__(self,

edgecolor=None,

facecolor=None,

color=None,

linewidth=None,

linestyle=None,

antialiased=None,

hatch=None,

fill=True,

capstyle=None,

joinstyle=None,

**kwargs):

"""

artist.Artist.__init__(self)

if linewidth is None:

linewidth = mpl.rcParams['patch.linewidth']

if linestyle is None:

linestyle = "solid"

if capstyle is None:

capstyle = 'butt'

if joinstyle is None:

joinstyle = 'miter'

if antialiased is None:

antialiased = mpl.rcParams['patch.antialiased']

self._hatch_color = colors.to_rgba(mpl.rcParams['hatch.color'])

self._fill = True # needed for set_facecolor call

if color is not None:

if edgecolor is not None or facecolor is not None:

cbook._warn_external(

"Setting the 'color' property will override "

"the edgecolor or facecolor properties.")

self.set_color(color)

else:

self.set_edgecolor(edgecolor)

self.set_facecolor(facecolor)

# unscaled dashes. Needed to scale dash patterns by lw

self._us_dashes = None

self._linewidth = 0

self.set_fill(fill)

self.set_linestyle(linestyle)

self.set_linewidth(linewidth)

self.set_antialiased(antialiased)

self.set_hatch(hatch)

self.set_capstyle(capstyle)

self.set_joinstyle(joinstyle)

if len(kwargs):

self.update(kwargs)

def get_verts(self):

"""

trans = self.get_transform()

path = self.get_path()

polygons = path.to_polygons(trans)

if len(polygons):

return polygons[0]

return []

def _process_radius(self, radius):

if radius is not None:

return radius

if isinstance(self._picker, Number):

_radius = self._picker

else:

if self.get_edgecolor()[3] == 0:

_radius = 0

else:

_radius = self.get_linewidth()

return _radius

def contains(self, mouseevent, radius=None):

"""

inside, info = self._default_contains(mouseevent)

if inside is not None:

return inside, info

radius = self._process_radius(radius)

codes = self.get_path().codes

if codes is not None:

vertices = self.get_path().vertices

# if the current path is concatenated by multiple sub paths.

# get the indexes of the starting code(MOVETO) of all sub paths

idxs, = np.where(codes == Path.MOVETO)

# Don't split before the first MOVETO.

idxs = idxs[1:]

subpaths = map(

Path, np.split(vertices, idxs), np.split(codes, idxs))

else:

subpaths = [self.get_path()]

inside = any(

subpath.contains_point(

(mouseevent.x, mouseevent.y), self.get_transform(), radius)

for subpath in subpaths)

return inside, {}

def contains_point(self, point, radius=None):

"""

radius = self._process_radius(radius)

return self.get_path().contains_point(point,

self.get_transform(),

radius)

def contains_points(self, points, radius=None):

"""

radius = self._process_radius(radius)

return self.get_path().contains_points(points,

self.get_transform(),

radius)

def update_from(self, other):

# docstring inherited.

artist.Artist.update_from(self, other)

# For some properties we don't need or don't want to go through the

# getters/setters, so we just copy them directly.

self._edgecolor = other._edgecolor

self._facecolor = other._facecolor

self._original_edgecolor = other._original_edgecolor

self._original_facecolor = other._original_facecolor

self._fill = other._fill

self._hatch = other._hatch

self._hatch_color = other._hatch_color

# copy the unscaled dash pattern

self._us_dashes = other._us_dashes

self.set_linewidth(other._linewidth) # also sets dash properties

self.set_transform(other.get_data_transform())

# If the transform of other needs further initialization, then it will

# be the case for this artist too.

self._transformSet = other.is_transform_set()

def get_extents(self):

"""

return self.get_path().get_extents(self.get_transform())

def get_transform(self):

"""Return the `~.transforms.Transform` applied to the `Patch`."""

return self.get_patch_transform() + artist.Artist.get_transform(self)

def get_data_transform(self):

"""

return artist.Artist.get_transform(self)

def get_patch_transform(self):

"""

return transforms.IdentityTransform()

def get_antialiased(self):

"""Return whether antialiasing is used for drawing."""

return self._antialiased

def get_edgecolor(self):

"""Return the edge color."""

return self._edgecolor

def get_facecolor(self):

"""Return the face color."""

return self._facecolor

def get_linewidth(self):

"""Return the line width in points."""

return self._linewidth

def get_linestyle(self):

"""Return the linestyle."""

return self._linestyle

def set_antialiased(self, aa):

"""

if aa is None:

aa = mpl.rcParams['patch.antialiased']

self._antialiased = aa

self.stale = True

def _set_edgecolor(self, color):

set_hatch_color = True

if color is None:

if (mpl.rcParams['patch.force_edgecolor'] or

not self._fill or self._edge_default):

color = mpl.rcParams['patch.edgecolor']

else:

color = 'none'

set_hatch_color = False

self._edgecolor = colors.to_rgba(color, self._alpha)

if set_hatch_color:

self._hatch_color = self._edgecolor

self.stale = True

def set_edgecolor(self, color):

"""

self._original_edgecolor = color

self._set_edgecolor(color)

def _set_facecolor(self, color):

if color is None:

color = mpl.rcParams['patch.facecolor']

alpha = self._alpha if self._fill else 0

self._facecolor = colors.to_rgba(color, alpha)

self.stale = True

def set_facecolor(self, color):

"""

self._original_facecolor = color

self._set_facecolor(color)

def set_color(self, c):

"""

self.set_facecolor(c)

self.set_edgecolor(c)

def set_alpha(self, alpha):

# docstring inherited

super().set_alpha(alpha)

self._set_facecolor(self._original_facecolor)

self._set_edgecolor(self._original_edgecolor)

# stale is already True

def set_linewidth(self, w):

"""

if w is None:

w = mpl.rcParams['patch.linewidth']

if w is None:

w = mpl.rcParams['axes.linewidth']

self._linewidth = float(w)

# scale the dash pattern by the linewidth

offset, ls = self._us_dashes

self._dashoffset, self._dashes = mlines._scale_dashes(

offset, ls, self._linewidth)

self.stale = True

def set_linestyle(self, ls):

"""

if ls is None:

ls = "solid"

self._linestyle = ls

# get the unscaled dash pattern

offset, ls = self._us_dashes = mlines._get_dash_pattern(ls)

# scale the dash pattern by the linewidth

self._dashoffset, self._dashes = mlines._scale_dashes(

offset, ls, self._linewidth)

self.stale = True

def set_fill(self, b):

"""

self._fill = bool(b)

self._set_facecolor(self._original_facecolor)

self._set_edgecolor(self._original_edgecolor)

self.stale = True

def get_fill(self):

"""Return whether the patch is filled."""

return self._fill

# Make fill a property so as to preserve the long-standing

# but somewhat inconsistent behavior in which fill was an

# attribute.

fill = property(get_fill, set_fill)

def set_capstyle(self, s):

"""

mpl.rcsetup.validate_capstyle(s)

self._capstyle = s

self.stale = True

def get_capstyle(self):

"""Return the capstyle."""

return self._capstyle

def set_joinstyle(self, s):

"""

mpl.rcsetup.validate_joinstyle(s)

self._joinstyle = s

self.stale = True

def get_joinstyle(self):

"""Return the joinstyle."""

return self._joinstyle

def set_hatch(self, hatch):

r"""

self._hatch = hatch

self.stale = True

def get_hatch(self):

"""Return the hatching pattern."""

return self._hatch

@contextlib.contextmanager

def _bind_draw_path_function(self, renderer):

"""

renderer.open_group('patch', self.get_gid())

gc = renderer.new_gc()

gc.set_foreground(self._edgecolor, isRGBA=True)

lw = self._linewidth

if self._edgecolor[3] == 0:

lw = 0

gc.set_linewidth(lw)

gc.set_dashes(self._dashoffset, self._dashes)

gc.set_capstyle(self._capstyle)

gc.set_joinstyle(self._joinstyle)

gc.set_antialiased(self._antialiased)

self._set_gc_clip(gc)

gc.set_url(self._url)

gc.set_snap(self.get_snap())

gc.set_alpha(self._alpha)

if self._hatch:

gc.set_hatch(self._hatch)

gc.set_hatch_color(self._hatch_color)

if self.get_sketch_params() is not None:

gc.set_sketch_params(*self.get_sketch_params())

if self.get_path_effects():

from matplotlib.patheffects import PathEffectRenderer

renderer = PathEffectRenderer(self.get_path_effects(), renderer)

# In `with _bind_draw_path_function(renderer) as draw_path: ...`

# (in the implementations of `draw()` below), calls to `draw_path(...)`

# will occur as if they took place here with `gc` inserted as

# additional first argument.

yield functools.partial(renderer.draw_path, gc)

gc.restore()

renderer.close_group('patch')

self.stale = False

@artist.allow_rasterization

def draw(self, renderer):

# docstring inherited

if not self.get_visible():

return

# Patch has traditionally ignored the dashoffset.

with cbook._setattr_cm(self, _dashoffset=0), \

self._bind_draw_path_function(renderer) as draw_path:

path = self.get_path()

transform = self.get_transform()

tpath = transform.transform_path_non_affine(path)

affine = transform.get_affine()

draw_path(tpath, affine,

# Work around a bug in the PDF and SVG renderers, which

# do not draw the hatches if the facecolor is fully

# transparent, but do if it is None.

self._facecolor if self._facecolor[3] else None)

def get_path(self):

"""Return the path of this patch."""

raise NotImplementedError('Derived must override')

def get_window_extent(self, renderer=None):

return self.get_path().get_extents(self.get_transform())

def _convert_xy_units(self, xy):

"""Convert x and y units for a tuple (x, y)."""

x = self.convert_xunits(xy[0])

y = self.convert_yunits(xy[1])

def __str__(self):

return "Shadow(%s)" % (str(self.patch))

@cbook._delete_parameter("3.3", "props")

@docstring.dedent_interpd

def __init__(self, patch, ox, oy, props=None, **kwargs):

"""

Patch.__init__(self)

self.patch = patch

# Note: when removing props, we can directly pass kwargs to _update()

# and remove self._props

self._props = {**(props if props is not None else {}), **kwargs}

self._ox, self._oy = ox, oy

self._shadow_transform = transforms.Affine2D()

self._update()

props = cbook._deprecate_privatize_attribute("3.3")

def _update(self):

self.update_from(self.patch)

# Place the shadow patch directly behind the inherited patch.

self.set_zorder(np.nextafter(self.patch.zorder, -np.inf))

if self._props:

self.update(self._props)

else:

color = .3 * np.asarray(colors.to_rgb(self.patch.get_facecolor()))

self.set_facecolor(color)

self.set_edgecolor(color)

self.set_alpha(0.5)

def _update_transform(self, renderer):

ox = renderer.points_to_pixels(self._ox)

oy = renderer.points_to_pixels(self._oy)

self._shadow_transform.clear().translate(ox, oy)

def _get_ox(self):

return self._ox

def _set_ox(self, ox):

self._ox = ox

def _get_oy(self):

return self._oy

def _set_oy(self, oy):

self._oy = oy

def get_path(self):

return self.patch.get_path()

def get_patch_transform(self):

return self.patch.get_patch_transform() + self._shadow_transform

def draw(self, renderer):

self._update_transform(renderer)

"""

def __str__(self):

pars = self._x0, self._y0, self._width, self._height, self.angle

fmt = "Rectangle(xy=(%g, %g), width=%g, height=%g, angle=%g)"

return fmt % pars

@docstring.dedent_interpd

def __init__(self, xy, width, height, angle=0.0, **kwargs):

"""

Patch.__init__(self, **kwargs)

self._x0 = xy[0]

self._y0 = xy[1]

self._width = width

self._height = height

self._x1 = self._x0 + self._width

self._y1 = self._y0 + self._height

self.angle = float(angle)

# Note: This cannot be calculated until this is added to an Axes

self._rect_transform = transforms.IdentityTransform()

def get_path(self):

"""Return the vertices of the rectangle."""

return Path.unit_rectangle()

def _update_patch_transform(self):

"""

x0, y0, x1, y1 = self._convert_units()

bbox = transforms.Bbox.from_extents(x0, y0, x1, y1)

rot_trans = transforms.Affine2D()

rot_trans.rotate_deg_around(x0, y0, self.angle)

self._rect_transform = transforms.BboxTransformTo(bbox)

self._rect_transform += rot_trans

def _update_x1(self):

self._x1 = self._x0 + self._width

def _update_y1(self):

self._y1 = self._y0 + self._height

def _convert_units(self):

"""Convert bounds of the rectangle."""

x0 = self.convert_xunits(self._x0)

y0 = self.convert_yunits(self._y0)

x1 = self.convert_xunits(self._x1)

y1 = self.convert_yunits(self._y1)

return x0, y0, x1, y1

def get_patch_transform(self):

self._update_patch_transform()

return self._rect_transform

def get_x(self):

"""Return the left coordinate of the rectangle."""

return self._x0

def get_y(self):

"""Return the bottom coordinate of the rectangle."""

return self._y0

def get_xy(self):

"""Return the left and bottom coords of the rectangle as a tuple."""

return self._x0, self._y0

def get_width(self):

"""Return the width of the rectangle."""

return self._width

def get_height(self):

"""Return the height of the rectangle."""

return self._height

def set_x(self, x):

"""Set the left coordinate of the rectangle."""

self._x0 = x

self._update_x1()

self.stale = True

def set_y(self, y):

"""Set the bottom coordinate of the rectangle."""

self._y0 = y

self._update_y1()

self.stale = True

def set_xy(self, xy):

"""

self._x0, self._y0 = xy

self._update_x1()

self._update_y1()

self.stale = True

def set_width(self, w):

"""Set the width of the rectangle."""

self._width = w

self._update_x1()

self.stale = True

def set_height(self, h):

"""Set the height of the rectangle."""

self._height = h

self._update_y1()

self.stale = True

def set_bounds(self, *args):

"""

if len(args) == 1:

l, b, w, h = args[0]

else:

l, b, w, h = args

self._x0 = l

self._y0 = b

self._width = w

self._height = h

self._update_x1()

self._update_y1()

self.stale = True

def get_bbox(self):

"""Return the `.Bbox`."""

x0, y0, x1, y1 = self._convert_units()

return transforms.Bbox.from_extents(x0, y0, x1, y1)

"""A regular polygon patch."""

def __str__(self):

s = "RegularPolygon((%g, %g), %d, radius=%g, orientation=%g)"

return s % (self._xy[0], self._xy[1], self._numVertices, self._radius,

self._orientation)

@docstring.dedent_interpd

def __init__(self, xy, numVertices, radius=5, orientation=0,

**kwargs):

"""

self._xy = xy

self._numVertices = numVertices

self._orientation = orientation

self._radius = radius

self._path = Path.unit_regular_polygon(numVertices)

self._poly_transform = transforms.Affine2D()

self._update_transform()

Patch.__init__(self, **kwargs)

def _update_transform(self):

self._poly_transform.clear() \

.scale(self.radius) \

.rotate(self.orientation) \

.translate(*self.xy)

@property

def xy(self):

return self._xy

@xy.setter

def xy(self, xy):

self._xy = xy

self._update_transform()

@property

def orientation(self):

return self._orientation

@orientation.setter

def orientation(self, orientation):

self._orientation = orientation

self._update_transform()

@property

def radius(self):

return self._radius

@radius.setter

def radius(self, radius):

self._radius = radius

self._update_transform()

@property

def numvertices(self):

return self._numVertices

@numvertices.setter

def numvertices(self, numVertices):

self._numVertices = numVertices

def get_path(self):

return self._path

def get_patch_transform(self):

self._update_transform()

"""A general polycurve path patch."""

_edge_default = True

def __str__(self):

s = "PathPatch%d((%g, %g) ...)"

return s % (len(self._path.vertices), *tuple(self._path.vertices[0]))

@docstring.dedent_interpd

def __init__(self, path, **kwargs):

"""

Patch.__init__(self, **kwargs)

self._path = path

def get_path(self):

return self._path

def set_path(self, path):