"""

# Axes has a second (deprecated) argument inframe for its draw method.

# args and kwargs are deprecated, but we don't wrap this in

# cbook._delete_parameter for performance; the relevant deprecation

# warning will be emitted by the inner draw() call.

@wraps(draw)

def draw_wrapper(artist, renderer, *args, **kwargs):

try:

if artist.get_rasterized():

renderer.start_rasterizing()

if artist.get_agg_filter() is not None:

renderer.start_filter()

return draw(artist, renderer, *args, **kwargs)

finally:

if artist.get_agg_filter() is not None:

renderer.stop_filter(artist.get_agg_filter())

if artist.get_rasterized():

renderer.stop_rasterizing()

draw_wrapper._supports_rasterization = True

"""

zorder = 0

def __init__(self):

self._stale = True

self.stale_callback = None

self._axes = None

self.figure = None

self._transform = None

self._transformSet = False

self._visible = True

self._animated = False

self._alpha = None

self.clipbox = None

self._clippath = None

self._clipon = True

self._label = ''

self._picker = None

self._contains = None

self._rasterized = None

self._agg_filter = None

# Normally, artist classes need to be queried for mouseover info if and

# only if they override get_cursor_data.

self._mouseover = type(self).get_cursor_data != Artist.get_cursor_data

self.eventson = False # fire events only if eventson

self._oid = 0 # an observer id

self._propobservers = {} # a dict from oids to funcs

try:

self.axes = None

except AttributeError:

# Handle self.axes as a read-only property, as in Figure.

pass

self._remove_method = None

self._url = None

self._gid = None

self._snap = None

self._sketch = mpl.rcParams['path.sketch']

self._path_effects = mpl.rcParams['path.effects']

self._sticky_edges = _XYPair([], [])

self._in_layout = True

def __getstate__(self):

d = self.__dict__.copy()

# remove the unpicklable remove method, this will get re-added on load

# (by the axes) if the artist lives on an axes.

d['stale_callback'] = None

return d

def remove(self):

"""

# There is no method to set the callback. Instead the parent should

# set the _remove_method attribute directly. This would be a

# protected attribute if Python supported that sort of thing. The

# callback has one parameter, which is the child to be removed.

if self._remove_method is not None:

self._remove_method(self)

# clear stale callback

self.stale_callback = None

_ax_flag = False

if hasattr(self, 'axes') and self.axes:

# remove from the mouse hit list

self.axes._mouseover_set.discard(self)

# mark the axes as stale

self.axes.stale = True

# decouple the artist from the axes

self.axes = None

_ax_flag = True

if self.figure:

self.figure = None

if not _ax_flag:

self.figure = True

else:

raise NotImplementedError('cannot remove artist')

# TODO: the fix for the collections relim problem is to move the

# limits calculation into the artist itself, including the property of

# whether or not the artist should affect the limits. Then there will

# be no distinction between axes.add_line, axes.add_patch, etc.

# TODO: add legend support

def have_units(self):

"""Return *True* if units are set on any axis."""

ax = self.axes

return ax and any(axis.have_units() for axis in ax._get_axis_list())

def convert_xunits(self, x):

"""

ax = getattr(self, 'axes', None)

if ax is None or ax.xaxis is None:

return x

return ax.xaxis.convert_units(x)

def convert_yunits(self, y):

"""

ax = getattr(self, 'axes', None)

if ax is None or ax.yaxis is None:

return y

return ax.yaxis.convert_units(y)

@property

def axes(self):

"""The `~.axes.Axes` instance the artist resides in, or *None*."""

return self._axes

@axes.setter

def axes(self, new_axes):

if (new_axes is not None and self._axes is not None

and new_axes != self._axes):

raise ValueError("Can not reset the axes. You are probably "

"trying to re-use an artist in more than one "

"Axes which is not supported")

self._axes = new_axes

if new_axes is not None and new_axes is not self:

self.stale_callback = _stale_axes_callback

@property

def stale(self):

"""

return self._stale

@stale.setter

def stale(self, val):

self._stale = val

# if the artist is animated it does not take normal part in the

# draw stack and is not expected to be drawn as part of the normal

# draw loop (when not saving) so do not propagate this change

if self.get_animated():

return

if val and self.stale_callback is not None:

self.stale_callback(self, val)

def get_window_extent(self, renderer):

"""

return Bbox([[0, 0], [0, 0]])

def _get_clipping_extent_bbox(self):

"""

bbox = None

if self.get_clip_on():

clip_box = self.get_clip_box()

if clip_box is not None:

bbox = clip_box

clip_path = self.get_clip_path()

if clip_path is not None and bbox is not None:

clip_path = clip_path.get_fully_transformed_path()

bbox = Bbox.intersection(bbox, clip_path.get_extents())

return bbox

def get_tightbbox(self, renderer):

"""

bbox = self.get_window_extent(renderer)

if self.get_clip_on():

clip_box = self.get_clip_box()

if clip_box is not None:

bbox = Bbox.intersection(bbox, clip_box)

clip_path = self.get_clip_path()

if clip_path is not None and bbox is not None:

clip_path = clip_path.get_fully_transformed_path()

bbox = Bbox.intersection(bbox, clip_path.get_extents())

return bbox

def add_callback(self, func):

"""

oid = self._oid

self._propobservers[oid] = func

self._oid += 1

return oid

def remove_callback(self, oid):

"""

try:

del self._propobservers[oid]

except KeyError:

pass

def pchanged(self):

"""

for oid, func in self._propobservers.items():

func(self)

def is_transform_set(self):

"""

return self._transformSet

def set_transform(self, t):

"""

self._transform = t

self._transformSet = True

self.pchanged()

self.stale = True

def get_transform(self):

"""Return the `.Transform` instance used by this artist."""

if self._transform is None:

self._transform = IdentityTransform()

elif (not isinstance(self._transform, Transform)

and hasattr(self._transform, '_as_mpl_transform')):

self._transform = self._transform._as_mpl_transform(self.axes)

return self._transform

def get_children(self):

r"""Return a list of the child `.Artist`\s of this `.Artist`."""

return []

def _default_contains(self, mouseevent, figure=None):

"""

if callable(self._contains):

return self._contains(self, mouseevent)

if figure is not None and mouseevent.canvas is not figure.canvas:

return False, {}

return None, {}

def contains(self, mouseevent):

"""

inside, info = self._default_contains(mouseevent)

if inside is not None:

return inside, info

_log.warning("%r needs 'contains' method", self.__class__.__name__)

return False, {}

@cbook.deprecated("3.3", alternative="set_picker")

def set_contains(self, picker):

"""

if not callable(picker):

raise TypeError("picker is not a callable")

self._contains = picker

@cbook.deprecated("3.3", alternative="get_picker")

def get_contains(self):

"""

return self._contains

def pickable(self):

"""

return self.figure is not None and self._picker is not None

def pick(self, mouseevent):

"""

# Pick self

if self.pickable():

picker = self.get_picker()

if callable(picker):

inside, prop = picker(self, mouseevent)

else:

inside, prop = self.contains(mouseevent)

if inside:

self.figure.canvas.pick_event(mouseevent, self, **prop)

# Pick children

for a in self.get_children():

# make sure the event happened in the same axes

ax = getattr(a, 'axes', None)

if (mouseevent.inaxes is None or ax is None

or mouseevent.inaxes == ax):

# we need to check if mouseevent.inaxes is None

# because some objects associated with an axes (e.g., a

# tick label) can be outside the bounding box of the

# axes and inaxes will be None

# also check that ax is None so that it traverse objects

# which do no have an axes property but children might

a.pick(mouseevent)

def set_picker(self, picker):

"""

self._picker = picker

def get_picker(self):

"""

return self._picker

def get_url(self):

"""Return the url."""

return self._url

def set_url(self, url):

"""

self._url = url

def get_gid(self):

"""Return the group id."""

return self._gid

def set_gid(self, gid):

"""

self._gid = gid

def get_snap(self):

"""

if mpl.rcParams['path.snap']:

return self._snap

else:

return False

def set_snap(self, snap):

"""

self._snap = snap

self.stale = True

def get_sketch_params(self):

"""

return self._sketch

def set_sketch_params(self, scale=None, length=None, randomness=None):

"""

if scale is None:

self._sketch = None

else:

self._sketch = (scale, length or 128.0, randomness or 16.0)

self.stale = True

def set_path_effects(self, path_effects):

"""

self._path_effects = path_effects

self.stale = True

def get_path_effects(self):

return self._path_effects

def get_figure(self):

"""Return the `.Figure` instance the artist belongs to."""

return self.figure

def set_figure(self, fig):

"""

# if this is a no-op just return

if self.figure is fig:

return

# if we currently have a figure (the case of both `self.figure`

# and *fig* being none is taken care of above) we then user is

# trying to change the figure an artist is associated with which

# is not allowed for the same reason as adding the same instance

# to more than one Axes

if self.figure is not None:

raise RuntimeError("Can not put single artist in "

"more than one figure")

self.figure = fig

if self.figure and self.figure is not self:

self.pchanged()

self.stale = True

def set_clip_box(self, clipbox):

"""

self.clipbox = clipbox

self.pchanged()

self.stale = True

def set_clip_path(self, path, transform=None):

"""

from matplotlib.patches import Patch, Rectangle

success = False

if transform is None:

if isinstance(path, Rectangle):

self.clipbox = TransformedBbox(Bbox.unit(),

path.get_transform())

self._clippath = None

success = True

elif isinstance(path, Patch):

self._clippath = TransformedPatchPath(path)

success = True

elif isinstance(path, tuple):

path, transform = path

if path is None:

self._clippath = None

success = True

elif isinstance(path, Path):

self._clippath = TransformedPath(path, transform)

success = True

elif isinstance(path, TransformedPatchPath):

self._clippath = path

success = True

elif isinstance(path, TransformedPath):

self._clippath = path

success = True

if not success:

raise TypeError(

"Invalid arguments to set_clip_path, of type {} and {}"

.format(type(path).__name__, type(transform).__name__))

# This may result in the callbacks being hit twice, but guarantees they

# will be hit at least once.

self.pchanged()

self.stale = True

def get_alpha(self):

"""

return self._alpha

def get_visible(self):

"""Return the visibility."""

return self._visible

def get_animated(self):

"""Return whether the artist is animated."""

return self._animated

def get_in_layout(self):

"""

return self._in_layout

def get_clip_on(self):

"""Return whether the artist uses clipping."""

return self._clipon

def get_clip_box(self):

"""Return the clipbox."""

return self.clipbox

def get_clip_path(self):

"""Return the clip path."""

return self._clippath

def get_transformed_clip_path_and_affine(self):

"""

if self._clippath is not None:

return self._clippath.get_transformed_path_and_affine()

return None, None

def set_clip_on(self, b):

"""

self._clipon = b

# This may result in the callbacks being hit twice, but ensures they

# are hit at least once

self.pchanged()

self.stale = True

def _set_gc_clip(self, gc):

"""Set the clip properly for the gc."""

if self._clipon:

if self.clipbox is not None:

gc.set_clip_rectangle(self.clipbox)

gc.set_clip_path(self._clippath)

else:

gc.set_clip_rectangle(None)

gc.set_clip_path(None)

def get_rasterized(self):

"""Return whether the artist is to be rasterized."""

return self._rasterized

def set_rasterized(self, rasterized):

"""

if rasterized and not hasattr(self.draw, "_supports_rasterization"):

cbook._warn_external(

"Rasterization of '%s' will be ignored" % self)

self._rasterized = rasterized

def get_agg_filter(self):

"""Return filter function to be used for agg filter."""

return self._agg_filter

def set_agg_filter(self, filter_func):

"""

self._agg_filter = filter_func

self.stale = True

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

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

def draw(self, renderer, *args, **kwargs):

"""

if not self.get_visible():

return

self.stale = False

def set_alpha(self, alpha):

"""

if alpha is not None and not isinstance(alpha, Number):

raise TypeError('alpha must be a float or None')

self._alpha = alpha

self.pchanged()

self.stale = True

def set_visible(self, b):

"""

self._visible = b

self.pchanged()

self.stale = True

def set_animated(self, b):

"""

if self._animated != b:

self._animated = b

self.pchanged()

def set_in_layout(self, in_layout):

"""

self._in_layout = in_layout

def update(self, props):

"""

ret = []

with cbook._setattr_cm(self, eventson=False):

for k, v in props.items():

if k != k.lower():

cbook.warn_deprecated(

"3.3", message="Case-insensitive properties were "

"deprecated in %(since)s and support will be removed "

"%(removal)s")

k = k.lower()

# White list attributes we want to be able to update through

# art.update, art.set, setp.

if k == "axes":

ret.append(setattr(self, k, v))

else:

func = getattr(self, f"set_{k}", None)

if not callable(func):

raise AttributeError(f"{type(self).__name__!r} object "

f"has no property {k!r}")

ret.append(func(v))

if ret:

self.pchanged()