B ]t\}@s\ddlmZddlmZGdddeZGdddeZGdddeZGdd d eZ dS) Nc@steZdZdZddZddZdddZed d d Z d d Z ddZ ddZ ddZ ddZddZddZdS) Containerz Base class for containers. Containers are classes that collect semantically related Artists such as the bars of a bar plot. cCsdt|jt|S)Nz<{} object of {} artists>)formattype__name__len)selfr3lib/python3.7/site-packages/matplotlib/container.py__repr__ szContainer.__repr__cOst||dS)Nr)tuple__new__)clsklkwargsrrr r szContainer.__new__NcCs&d|_d|_i|_d|_||dS)NFr)Zeventson_oid_propobservers_remove_method set_label)rrZlabelrrr __init__s zContainer.__init__z3.0cCs ||_dS)N)r)rfrrr set_remove_methodszContainer.set_remove_methodcCs@x*tj|dddD]}|dk r|qW|jr<||dS)NcSs t|tjS)N) isinstancemartistZArtist)xrrr $sz"Container.remove..)Zscalarp)cbookflattenremover)rcrrr r"s  zContainer.removecCs|jS)zC Get the label used for this artist in the legend. )_label)rrrr get_label+szContainer.get_labelcCs(|dk rd|f|_nd|_|dS)z Set the label to *s* for auto legend. Parameters ---------- s : string or anything printable with '%s' conversion. Nz%s)rpchanged)rsrrr r1szContainer.set_labelcCs"|j}||j|<|jd7_|S)z Adds a callback function that will be called whenever one of the :class:`Artist`'s properties changes. Returns an *id* that is useful for removing the callback with :meth:`remove_callback` later. )rr)rfuncoidrrr add_callback?s zContainer.add_callbackcCs&y |j|=Wntk r YnXdS)z Remove a callback based on its *id*. .. seealso:: :meth:`add_callback` For adding callbacks N)rKeyError)rr%rrr remove_callbackLs  zContainer.remove_callbackcCs(x"t|jD]\}}||qWdS)zg Fire an event when property changed, calling all of the registered callbacks. N)listritems)rr%r$rrr r![szContainer.pchangedcCsddt|DS)NcSsg|]}|dk r|qS)Nr).0Zchildrrr dsz*Container.get_children..)rr)rrrr get_childrencszContainer.get_children)N)r __module__ __qualname____doc__r r rrZ deprecatedrrr rr&r(r!r-rrrr rs   rc@seZdZdZdddZdS) BarContainera Container for the artists of bar plots (e.g. created by `.Axes.bar`). The container can be treated as a tuple of the *patches* themselves. Additionally, you can access these and further parameters by the attributes. Attributes ---------- patches : list of :class:`~matplotlib.patches.Rectangle` The artists of the bars. errorbar : None or :class:`~matplotlib.container.ErrorbarContainer` A container for the error bar artists if error bars are present. *None* otherwise. NcKs ||_||_tj||f|dS)N)patcheserrorbarrr)rr2r3rrrr rzszBarContainer.__init__)N)rr.r/r0rrrrr r1gsr1c@seZdZdZdddZdS)ErrorbarContainera Container for the artists of error bars (e.g. created by `.Axes.errorbar`). The container can be treated as the *lines* tuple itself. Additionally, you can access these and further parameters by the attributes. Attributes ---------- lines : tuple Tuple of ``(data_line, caplines, barlinecols)``. - data_line : :class:`~matplotlib.lines.Line2D` instance of x, y plot markers and/or line. - caplines : tuple of :class:`~matplotlib.lines.Line2D` instances of the error bar caps. - barlinecols : list of :class:`~matplotlib.collections.LineCollection` with the horizontal and vertical error ranges. has_xerr, has_yerr : bool ``True`` if the errorbar has x/y errors. FcKs&||_||_||_tj||f|dS)N)lineshas_xerrhas_yerrrr)rr5r6r7rrrr rszErrorbarContainer.__init__N)FF)rr.r/r0rrrrr r4sr4c@seZdZdZddZdS) StemContainera Container for the artists created in a :meth:`.Axes.stem` plot. The container can be treated like a namedtuple ``(markerline, stemlines, baseline)``. Attributes ---------- markerline : :class:`~matplotlib.lines.Line2D` The artist of the markers at the stem heads. stemlines : list of :class:`~matplotlib.lines.Line2D` The artists of the vertical lines for all stems. baseline : :class:`~matplotlib.lines.Line2D` The artist of the horizontal baseline. cKs0|\}}}||_||_||_tj||f|dS)N) markerline stemlinesbaselinerr)rZmarkerline_stemlines_baselinerr9r:r;rrr rs  zStemContainer.__init__N)rr.r/r0rrrrr r8sr8) Zmatplotlib.cbookrZmatplotlib.artistZartistrr rr1r4r8rrrr s  b