h=SSKJr SSKrSSKJrJrJr SSKrSSKJrJ r SSK r SSK J r J r SSKrSSKrSSKrSSKrSSKrSSKJrJr SSKJr SS KJrJrJrJrJrJ r J!r! \ RD"\#5r$S r%S r&S r'S r(\"SS5r)"SS5r*\*"5r+"SS5r,Sr-"SS5r.SSjr/\/r0SS.Sjr1Sr2\,Rg5 g)) namedtupleN)cachereducewraps) Signature Parameter)NumberReal)_apicbook)Path)BboxBaseBboxIdentityTransform TransformTransformedBboxTransformedPatchPathTransformedPathc>^[T5U4Sj5nSUlU$)Nc>URS:Xa(UR(aUR5 SUlT"X/UQ70UD6$)NrF) _raster_depth _rasterizingstop_rasterizing)artistrendererargskwargsdraws C/var/www/html/env/lib/python3.13/site-packages/matplotlib/artist.py draw_wrapper,_prevent_rasterization..draw_wrappersD  ! !Q &8+@+@  % % '$)H !F6t6v66Fr_supports_rasterizationrr!s` r _prevent_rasterizationr's+ 4[77,1L( r#c>^[T5U4Sj5nSUlU$)a Decorator for Artist.draw method. Provides routines that run before and after the draw call. The before and after functions are useful for changing artist-dependent renderer attributes or making other setup function calls, such as starting and flushing a mixed-mode renderer. cl>UR5(aNURS:Xa(UR(dUR5 SUlU=RS- slO8URS:Xa(UR(aUR 5 SUlUR 5bUR 5 T"X5UR 5bURUR 55 UR5(aU=RS-slUR(aJURSS9=n(a3UR(a!UR 5 UR5 $$$$!UR 5bURUR 55 UR5(aU=RS-slUR(aJURSS9=n(a3UR(a!UR 5 UR5 ffff=f)NrTr Froot) get_rasterizedrrstart_rasterizingrget_agg_filter start_filter stop_filter get_figuresuppressComposite)rrfigrs r r!)allow_rasterization..draw_wrapper5s -$$&&))Q.x7L7L..0,0H)&&!+&))Q.83H3H--/,1H)$$&2%%')$$&2$$V%:%:%<=$$&&&&!+&%%&2C2C2C2N+N3+N))))+**,*,O% $$&2$$V%:%:%<=$$&&&&!+&%%&2C2C2C2N+N3+N))))+**,*,O%s CE<T"X/UQ70UD6nUR(aUR5 SUlU$)NF)rr)rrrrresultrs r r!-_finalize_rasterization..draw_wrapper\s9f888   % % '$)H ! r#)rr&s` r _finalize_rasterizationr:Ws#  4[ r#cHUR(aXRlggN)axesstaleselfvals r _stale_axes_callbackrBfs yy r#_XYPairzx yc\rSrSrSrSrg)_Unsetncg)Nzr@s r __repr___Unset.__repr__osr#rHN)__name__ __module__ __qualname____firstlineno__rJ__static_attributes__rHr#r rErEnsr#rEc\rSrSrSrSrSr/SQr\S5r Sr Sr S r S r S rS r\S 5r\R$S5r\S5r\R$S5rSXSjrSXSjrSrSrSrSrSrSrSrSrSrSrSr Sr!S r"S!r#S"r$S#r%S$r&S%r'S&r(S'r)SYS(jr*S)r+S*r,SZS+jr-S,r.\"\-\.S-S.9r/S/r0SXS0jr1S1r2S2r3S3r4S4r5S5r6S6r7S7r8S8r9S9r:S:r;S;rS>r?S?r@S@rASArBSBrCSCrDSDrESErFSFrGSGrHSHrISIrJ\SJ5rKSKrLSLrMSMrNSNrOSOrPSPrQ\RRSQ5rTS[SRjrUSSrVSTrWSUrXSVrY\"\X\Y5rZSWr[g)\Artisttz Abstract base class for objects that render into a FigureCanvas. Typically, all visible elements in a figure are subclasses of Artist. rc4[URS5(d[UR5Ul[URS5(dgSUlSURlUR S3URlUR 5 g)Nr%_autogenerated_signaturec0[R"U40UD6$r<)rRsetr@rs r *Artist.__init_subclass__..sD)CF)Cr#rWz.set)hasattrrr'rWrLrN#_update_set_signature_and_docstring)clss r __init_subclass__Artist.__init_subclass__}sxsxx!:;;-chh7CH sww :;; C "%"2"2!348 //1r#) navigate_modefigure 3d_propertiesc [[S[R5/[U5R 5Vs/sH6nU[ R ;dM[U[R[S9PM8 snQ5URl SURl S[U5-URl gs snf)z Update the signature of the set function to list all properties as keyword arguments. Property aliases are not listed in the signature for brevity, but are still accepted as keyword arguments. r@)defaultTz> ? E*3/;;=D=4fBBBGyy55vF=D E!F ,0( +Cj   Ds B> !B> cfSUlSUlSUlSUlSUlSUlSUlSUlSUlSUl SUl SUl SUl SUl SUlSUl[!U5R"[$R":gUl[(R*"S/S9UlSUlSUlSUlSUlSUl[:R<SUl[:R<SUl [C//5Ul"SUl#g![0a Nqf=f)NTFpchanged)signalsz path.sketchz path.effects)$_stalestale_callback_axes_parent_figure _transform _transformSet_visible _animated_alphaclipbox _clippath_clipon_label_picker _rasterized _agg_filtertypeget_cursor_datarR _mouseoverr CallbackRegistry _callbacksr=AttributeError_remove_method_url_gid_snapmplrcParams_sketch _path_effectsrC _sticky_edges _in_layoutrIs r __init__Artist.__init__s " ""       t*448N8NN00*F DI#   ||M2  \\.9$R_   s7D## D0/D0cDURR5nSUS'U$)Nru)__dict__copy)r@ds r __getstate__Artist.__getstate__s$ MM   " r#czURbURU5 SUlSn[US5(aPUR(a?URRR U5 SURlSUlSnURSS9=nbU(dSUlSUlgg[S5e)a Remove the artist from the figure if possible. The effect will not be visible until the figure is redrawn, e.g., with `.FigureCanvasBase.draw_idle`. Call `~.axes.Axes.relim` to update the Axes limits if desired. Note: `~.axes.Axes.relim` will not see collections even if the collection was added to the Axes with *autolim* = True. Note: there is no support for removing the artist's legend entry. NFr=Tr*zcannot remove artist) rrur[r=_mouseover_setdiscardr>r1rwNotImplementedError)r@_ax_flagr3s r remove Artist.removes$    *    %"&D HtV$$ ((006"&   E22? $CI&*#@ &&<= =r#cURnU=(a* [SURR555$)z)Return whether units are set on any axis.c3@# UHoR5v M g7fr<) have_units).0axiss r $Artist.have_units.. sN8M//++8Ms)r=any _axis_mapvalues)r@axs r rArtist.have_unitss. YYNcN 8K8K8MNNNr#cv[USS5nUb URcU$URRU5$)z Convert *x* using the unit type of the xaxis. If the artist is not contained in an Axes or if the xaxis does not have units, *x* itself is returned. r=N)getattrxaxis convert_units)r@xrs r convert_xunitsArtist.convert_xunits :T64 ( :)Hxx%%a((r#cv[USS5nUb URcU$URRU5$)z Convert *y* using the unit type of the yaxis. If the artist is not contained in an Axes or if the yaxis does not have units, *y* itself is returned. r=N)ryaxisr)r@yrs r convert_yunitsArtist.convert_yunitsrr#cUR$)z Artist.stale3s {{r#cXlUR(agU(a URbURX5 gggr<)rtr{rur?s r r>r;s6 >>  4&&2    *33r#Nc$[SS/SS//5$)a Get the artist's bounding box in display space. The bounding box' width and height are nonnegative. Subclasses should override for inclusion in the bounding box "tight" calculation. Default is to return an empty bounding box at 0, 0. Be careful when using this function, the results will not update if the artist window extent of the artist changes. The extent can change due to any changes in the transform stack, such as changing the Axes limits, the figure size, or the canvas used (as is done when saving a figure). This can lead to unexpected behavior where interactive figures will look fine on the screen, but will save incorrectly. r)rr@rs r get_window_extentArtist.get_window_extentHs$aVaV$%%r#c8URU5nUR5(asUR5nUb[R"X#5nUR 5nUb7Ub4UR 5n[R"X$R55nU$)a Like `.Artist.get_window_extent`, but includes any clipping. Parameters ---------- renderer : `~matplotlib.backend_bases.RendererBase` subclass, optional renderer that will be used to draw the figures (i.e. ``fig.canvas.get_renderer()``) Returns ------- `.Bbox` or None The enclosing bounding box (in figure pixel coordinates). Returns None if clipping results in no intersection. )r get_clip_on get_clip_boxr intersection get_clip_pathget_fully_transformed_path get_extents)r@rbboxclip_box clip_paths r get_tightbboxArtist.get_tightbbox\s %%h/     ((*H#((8**,I$)9%@@B ((/D/D/FG r#cH^^TRRSUU4Sj5$)a Add a callback function that will be called whenever one of the `.Artist`'s properties changes. Parameters ---------- func : callable The callback function. It must have the signature:: def func(artist: Artist) -> Any where *artist* is the calling `.Artist`. Return values may exist but are ignored. Returns ------- int The observer id associated with the callback. This id can be used for removing the callback with `.remove_callback` later. See Also -------- remove_callback rrc>T"T5$r<rH)funcr@sr rY%Artist.add_callback..s 4:r#)rconnect)r@rs``r add_callbackArtist.add_callbackws6&&z3EFFr#c:URRU5 g)zM Remove a callback based on its observer id. See Also -------- add_callback N)r disconnect)r@oids r remove_callbackArtist.remove_callbacks ""3'r#c:URRS5 g)z Call all of the registered callbacks. This function is triggered internally when a property is changed. See Also -------- add_callback remove_callback rrN)rprocessrIs r rrArtist.pchangeds  +r#cUR$)zt Return whether the Artist has an explicitly set transform. This is *True* after `.set_transform` has been called. )ryrIs r is_transform_setArtist.is_transform_sets !!!r#cLXlSUlUR5 SUlg)zY Set the artist transform. Parameters ---------- t : `~matplotlib.transforms.Transform` TN)rxryrrr>)r@ts r set_transformArtist.set_transforms!!  r#c2URc[5UlUR$[UR[5(dE[ URS5(a*URR UR 5UlUR$)z5Return the `.Transform` instance used by this artist._as_mpl_transform)rxr isinstancerr[rr=rIs r get_transformArtist.get_transformsk ?? "/1DOT__i88$//+>??"oo?? JDOr#c/$)z9Return a list of the child `.Artist`\s of this `.Artist`.rHrIs r get_childrenArtist.get_childrens r#c[USS5SL=(a2 URSS9=nSL=(a URURL$)a Check whether an *event* occurred on a canvas other that this artist's canvas. If this method returns True, the event definitely occurred on a different canvas; if it returns False, either it occurred on the same canvas, or we may not have enough information to know. Subclasses should start their definition of `contains` as follows:: if self._different_canvas(mouseevent): return False, {} # subclass-specific implementation follows canvasNTr*)rr1r)r@eventr3s r _different_canvasArtist._different_canvassLx.d:3 OOO66StC3LL 2 4r#c^[RSURR5 S04$)a Test whether the artist contains the mouse event. Parameters ---------- mouseevent : `~matplotlib.backend_bases.MouseEvent` Returns ------- contains : bool Whether any values are within the radius. details : dict An artist-specific dictionary of details of the event context, such as which points are contained in the pick radius. See the individual Artist subclasses for details. z%r needs 'contains' methodF)_logwarning __class__rL)r@ mouseevents r containsArtist.containss'" 14>>3J3JKbyr#cNURSS9SL=(a URSL$)zp Return whether the artist is pickable. See Also -------- .Artist.set_picker, .Artist.get_picker, .Artist.pick Fr*N)r1rrIs r pickableArtist.pickables(E*$6S4< Set the url for the artist. Parameters ---------- url : str Nr)r@urls r set_urlArtist.set_urlV  r#cUR$)zReturn the group id.rrIs r get_gidArtist.get_gid`rr#cXlg)zE Set the (group) id for the artist. Parameters ---------- gid : str Nr )r@gids r set_gidArtist.set_giddrr#cL[RS(a UR$g)z8 Return the snap setting. See `.set_snap` for details. z path.snapF)rrrrIs r get_snapArtist.get_snapns << $:: r#cXlSUlg)aU Set the snapping behavior. Snapping aligns positions with the pixel grid, which results in clearer images. For example, if a black line of 1px width was defined at a position in between two pixels, the resulting image would contain the interpolated value of that line in the pixel grid, which would be a grey value on both adjacent pixel positions. In contrast, snapping will move the line to the nearest integer pixel value, so that the resulting image will really contain a 1px wide black line. Snapping is currently only supported by the Agg and MacOSX backends. Parameters ---------- snap : bool or None Possible values: - *True*: Snap vertices to the nearest pixel center. - *False*: Do not modify vertex positions. - *None*: (auto) If the path contains only rectilinear line segments, round to the nearest pixel center. TN)rr>)r@snaps r set_snapArtist.set_snapys2  r#cUR$)a Return the sketch parameters for the artist. Returns ------- tuple or None A 3-tuple with the following elements: - *scale*: The amplitude of the wiggle perpendicular to the source line. - *length*: The length of the wiggle along the line. - *randomness*: The scale factor by which the length is shrunken or expanded. Returns *None* if no sketch parameters were set. )rrIs r get_sketch_paramsArtist.get_sketch_paramss$||r#c^UcSUlOX=(d SU=(d S4UlSUlg)a Set the sketch parameters. Parameters ---------- scale : float, optional The amplitude of the wiggle perpendicular to the source line, in pixels. If scale is `None`, or not provided, no sketch filter will be provided. length : float, optional The length of the wiggle along the line, in pixels (default 128.0) randomness : float, optional The scale factor by which the length is shrunken or expanded (default 16.0) The PGF backend uses this argument as an RNG seed and not as described above. Using the same seed yields the same random shape. .. ACCEPTS: (scale: float, length: float, randomness: float) Ng`@g0@T)rr>)r@scalelength randomnesss r set_sketch_paramsArtist.set_sketch_paramss,, =DL!?UJ4F$GDL r#cXlSUlg)z[ Set the path effects. Parameters ---------- path_effects : list of `.AbstractPathEffect` TN)rr>)r@ path_effectss r set_path_effectsArtist.set_path_effectss* r#cUR$r<)rrIs r get_path_effectsArtist.get_path_effectss!!!r#ctU(a&URbURRSS9$UR$)z Return the `.Figure` or `.SubFigure` instance the artist belongs to. Parameters ---------- root : bool, default=False If False, return the (Sub)Figure this artist is on. If True, return the root Figure for a nested tree of SubFigures. Tr*)rwr1)r@r+s r r1Artist.get_figures8 D''3&&11t1< <"""r#cURULagURb [S5eXlUR(aURULaUR5 SUlg)z Set the `.Figure` or `.SubFigure` instance the artist belongs to. Parameters ---------- fig : `~matplotlib.figure.Figure` or `~matplotlib.figure.SubFigure` Nz1Can not put single artist in more than one figureT)rw RuntimeErrorrrr>)r@r3s r set_figureArtist.set_figuresa   # %     * 67 7!   4#6#6d#B MMO r#zVThe (Sub)Figure that the artist is on. For more control, use the `get_figure` method.)docc[R"[S4US9 XR:waXlUR 5 SUlgg)a- Set the artist's clip `.Bbox`. Parameters ---------- clipbox : `~matplotlib.transforms.BboxBase` or None Will typically be created from a `.TransformedBbox`. For instance, ``TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes)`` is the default clipping for an artist added to an Axes. Nr}T)r check_isinstancerr}rrr>)r@r}s r set_clip_boxArtist.set_clip_boxs= x.@ ll ""L MMODJ #r#cSSKJnJn SnUc[X5(a<[ [ R "5UR55UlSUl SnO<[X5(a[U5Ul SnO[U[5(aUupUc SUl SnOc[U[5(a[X5Ul SnO;[U[5(a Xl SnO[U[5(aXl SnU(d7[S[U5R S[U5R 35eUR#5 SUlg)a Set the artist's clip path. Parameters ---------- path : `~matplotlib.patches.Patch` or `.Path` or `.TransformedPath` or None The clip path. If given a `.Path`, *transform* must be provided as well. If *None*, a previously set clip path is removed. transform : `~matplotlib.transforms.Transform`, optional Only used if *path* is a `.Path`, in which case the given `.Path` is converted to a `.TransformedPath` using *transform*. Notes ----- For efficiency, if *path* is a `.Rectangle` this method will set the clipping box to the corresponding rectangle and set the clipping path to ``None``. For technical reasons (support of `~.Artist.set`), a tuple (*path*, *transform*) is also accepted as a single positional parameter. .. ACCEPTS: Patch or (Path, Transform) or None r)Patch RectangleFNTz,Invalid arguments to set_clip_path, of type z and )matplotlib.patchesrKrLrrrunitrr}r~rtuplerr TypeErrorrrLrrr>)r@path transformrKrLsuccesss r set_clip_pathArtist.set_clip_paths&2 8  $**.tyy{/3/A/A/C E !%D((!5d!;D%(("& <!DNG d # #,T=DNG 2 3 3!NG o . .!NG>:&&'uT)_-E-E,FHI I  r#cUR$)zK Return the alpha value used for blending - not supported on all backends. )r|rIs r get_alphaArtist.get_alphaNs {{r#cUR$)zReturn the visibility.)rzrIs r get_visibleArtist.get_visibleUs }}r#cUR$)z&Return whether the artist is animated.)r{rIs r get_animatedArtist.get_animatedY ~~r#cUR$)z Return boolean flag, ``True`` if artist is included in layout calculations. E.g. :ref:`constrainedlayout_guide`, `.Figure.tight_layout()`, and ``fig.savefig(fname, bbox_inches='tight')``. rrIs r get_in_layoutArtist.get_in_layout]sr#cUR5nUR5nURSL=(a UR5=(a USL=(d USL=(a USL=(dA [R "UR URRR :H5=(aD USL=(d9 [U[5=(a" URURRL$)aD Return a boolean flag, ``True`` if the artist is clipped to the Axes and can thus be skipped in layout calculations. Requires `get_clip_on` is True, one of `clip_box` or `clip_path` is set, ``clip_box.extents`` is equivalent to ``ax.bbox.extents`` (if set), and ``clip_path._patch`` is equivalent to ``ax.patch`` (if set). N) rrr=rnpallextentsrrr_patchpatch)r@rrs r _fully_clipped_to_axesArtist._fully_clipped_to_axeshs$$&&&(  %>$$&>T)BYd-B>%Kx//499>>3I3IIJ > $&="9.BC="))TYY__< ?r#cUR$)z(Return whether the artist uses clipping.)rrIs r rArtist.get_clip_on ||r#cUR$)zReturn the clipbox.rFrIs r rArtist.get_clip_boxrnr#cUR$)zReturn the clip path.)r~rIs r rArtist.get_clip_pathr_r#cRURbURR5$g)z Return the clip path with the non-affine part of its transformation applied, and the remaining affine part of its transformation. )NN)r~get_transformed_path_and_affinerIs r $get_transformed_clip_path_and_affine+Artist.get_transformed_clip_path_and_affines$ >> %>>AAC Cr#c>XlUR5 SUlg)z Set whether the artist uses clipping. When False, artists will be visible outside the Axes which can lead to unexpected results. Parameters ---------- b : bool TN)rrrr>r@bs r set_clip_onArtist.set_clip_ons   r#cUR(aDURbURUR5 URUR5 gURS5 URS5 g)z!Set the clip properly for the gc.N)rr}set_clip_rectanglerTr~)r@gcs r _set_gc_clipArtist._set_gc_clipsS <<||'%%dll3   T^^ ,  ! !$ '   T "r#cUR$)z.Return whether the artist is to be rasterized.)rrIs r r,Artist.get_rasterizedr#c[URSS5nU(a!U(d[R"SUS35 Xlg)az Force rasterized (bitmap) drawing for vector graphics output. Rasterized drawing is not supported by all artists. If you try to enable this on an artist that does not support it, the command has no effect and a warning will be issued. This setting is ignored for pixel-based output. See also :doc:`/gallery/misc/rasterization_demo`. Parameters ---------- rasterized : bool r%FzRasterization of 'z' will be ignoredN)rrr warn_externalr)r@ rasterizedsupports_rasterizations r set_rasterizedArtist.set_rasterizeds@ "))BE"K 4   !3D69JK L%r#cUR$)z1Return filter function to be used for agg filter.)rrIs r r.Artist.get_agg_filterrr#cXlSUlg)a Set the agg filter. Parameters ---------- filter_func : callable A filter function, which takes a (m, n, depth) float array and a dpi value, and returns a (m, n, depth) array and two offsets from the bottom left corner of the image .. ACCEPTS: a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array and two offsets from the bottom left corner of the image TN)rr>)r@ filter_funcs r set_agg_filterArtist.set_agg_filters' r#c>UR5(dgSUlg)a, Draw the Artist (and its children) using the given renderer. This has no effect if the artist is not visible (`.Artist.get_visible` returns False). Parameters ---------- renderer : `~matplotlib.backend_bases.RendererBase` subclass. Notes ----- This method is overridden in the Artist subclasses. NF)rZr>rs r r Artist.draws!!  r#cUb,[U[5(d[S[U535eUbSUs=::aS::dO [ SUS35eXR :waXlUR 5 SUlgg)z Set the alpha value used for blending - not supported on all backends. Parameters ---------- alpha : float or None *alpha* must be within the 0-1 range, inclusive. Nz#alpha must be numeric or None, not rr zalpha (z) is outside 0-1 rangeT)rr rPrrr|rrr>r@alphas r set_alphaArtist.set_alphas|  Zt%<%<5d5k]CE E  a5oAowug-CDE E KK K MMODJ r#c[U[5(a [S5e[R"U5(d[ R X5 g[R"U5nSUR5::aUR5S::d-[SUR5SUR535eXl UR5 SUl g)z Set the alpha value used for blending - not supported on all backends. Parameters ---------- alpha : array-like or float or None All values must be within the 0-1 range, inclusive. Masked values and nans are not supported. z+alpha must be numeric or None, not a stringNrr z5alpha must be between 0 and 1, inclusive, but min is z , max is T)rstrrPreiterablerRrasarrayminmaxrr|rrr>rs r _set_alpha_for_arrayArtist._set_alpha_for_arrays eS ! !IJ J{{5!!   T )  5!UYY[ UYY[A%5++099;-y OP P   r#c^XR:waXlUR5 SUlgg)z> Set the artist's visibility. Parameters ---------- b : bool TN)rzrrr>rxs r set_visibleArtist.set_visibles( M MMODJ r#cRURU:waXlUR5 gg)ao Set whether the artist is intended to be used in an animation. If True, the artist is excluded from regular drawing of the figure. You have to call `.Figure.draw_artist` / `.Axes.draw_artist` explicitly on the artist. This approach is used to speed up animations using blitting. See also `matplotlib.animation` and :ref:`blitting`. Parameters ---------- b : bool N)r{rrrxs r set_animatedArtist.set_animated,s# >>Q N MMO r#cXlg)z Set if artist is to be included in layout calculations, E.g. :ref:`constrainedlayout_guide`, `.Figure.tight_layout()`, and ``fig.savefig(fname, bbox_inches='tight')``. Parameters ---------- in_layout : bool Nra)r@ in_layouts r set_in_layoutArtist.set_in_layout@s $r#cUR$)z4Return the label used for this artist in the legend.)rrIs r get_labelArtist.get_labelM {{r#c~Ub [U5OSnX R:waX lUR5 SUlgg)z Set a label that will be displayed in the legend. Parameters ---------- s : object *s* will be converted to a string by calling `str`. NT)rrrrr>)r@slabels r set_labelArtist.set_labelQs7-AT KK K MMODJ r#cUR$)zReturn the artist's zorder.)zorderrIs r get_zorderArtist.get_zorder`rr#cUcURRnXR:waXlUR5 SUlgg)zx Set the zorder for the artist. Artists with lower zorder values are drawn first. Parameters ---------- level : float NT)rrrrr>)r@levels r set_zorderArtist.set_zorderds< =NN))E KK K MMODJ r#cUR$)a? ``x`` and ``y`` sticky edge lists for autoscaling. When performing autoscaling, if a data limit coincides with a value in the corresponding sticky_edges list, then no margin will be added--the view limit "sticks" to the edge. A typical use case is histograms, where one usually expects no margin on the bottom edge (0) of the histogram. Moreover, margin expansion "bumps" against sticky edges and cannot cross them. For example, if the upper data limit is 1.0, the upper view limit computed by simple margin application is 1.2, but there is a sticky edge at 1.1, then the actual upper view limit will be 1.1. This attribute cannot be assigned to; however, the ``x`` and ``y`` lists can be modified in place as needed. Examples -------- >>> artist.sticky_edges.x[:] = (xmin, xmax) >>> artist.sticky_edges.y[:] = (ymin, ymax) )rrIs r sticky_edgesArtist.sticky_edgests2!!!r#crURUlURUlURUlURUlURUlUR UlUR UlURUlURUlURUl URRR5URRSS&URRR5URRSS&UR5 SUlg)z'Copy properties from *other* to *self*.NT)rxryrzr|r}rr~rrrrrrrrrr>)r@others r update_fromArtist.update_froms**"00 ll }} }} ll }} "00!&!3!3!5!5!:!:!<A!&!3!3!5!5!:!:!<A  r#c4[U5R5$)z8Return a dictionary of all the properties of the artist.)rf propertiesrIs r rArtist.propertiesst$//11r#c /n[R"USS9 UR5HupEUS:XaUR[ XU55 M([ USU3S5n[ U5(d![UR[U5US9US9eURU"U55 M SSS5 U(aUR5 SUl U$!,(df  N.=f) z Helper for `.Artist.set` and `.Artist.update`. *errfmt* is used to generate error messages for invalid property names; it gets formatted with ``type(self)`` for "{cls}" and the property name for "{prop_name}". F)eventsonr=set_N)r] prop_name)nameT) r _setattr_cmitemsappendsetattrrrrformatrrrr>)r@propserrfmtretkvrs r _update_propsArtist._update_propss   te 4 ;JJwt23"44sT:D#D>>,"MMd4jAMF!"$$JJtAw'&5  MMODJ !5 4s BC C#c&URUS5$)z\ Update this artist's properties from the dict *props*. Parameters ---------- props : dict z5{cls.__name__!r} object has no property {prop_name!r}r)r@rs r update Artist.updates!! JL Lr#c&URUS5$)z Update artist properties without prenormalizing them, but generating errors as if calling `set`. The lack of prenormalization is to maintain backcompatibility. zE{cls.__name__}.set() got an unexpected keyword argument {prop_name!r}rrXs r _internal_updateArtist._internal_updates!!  r#c LUR[R"X55$r<)rr normalize_kwargsrXs r rW Artist.sets $$U%;%;F%IJJr#c +# UVs0sHo"[USU35"5_M nnUR"S0UD6 Sv UR"S0UD6 gs snf!UR"S0UD6 f=f7f)zF `.Artist.set` context-manager that restores original values at exit. get_NrH)rrW)r@rr orig_valss r _cm_setArtist._cm_setsm >DDVQCj133V D " HH v   HH !y ! E HH !y !s%A-AA-AA-A**A-c ^TcSnOO[T[5(a[T[5(aU4SjnO[ T5(aTnO [ S5e[ [RUR5Vs/sHoDRU5PM sn/5nU(aU"U5(aURU5 U$s snf)a Find artist objects. Recursively find all `.Artist` instances contained in the artist. Parameters ---------- match A filter criterion for the matches. This can be - *None*: Return all objects contained in artist. - A function with signature ``def match(artist: Artist) -> bool``. The result will only contain artists for which the function returns *True*. - A class instance: e.g., `.Line2D`. The result will only contain artists of this class or its subclasses (``isinstance`` check). include_self : bool Include *self* in the list to be checked for a match. Returns ------- list of `.Artist` cgNTrH)rs r matchfunc!Artist.findobj..matchfuncsr#c>[UT5$r<)r)rmatchs r rrs!!U++r#zFmatch must be None, a matplotlib.artist.Artist subclass, or a callable) rr issubclassrRrrroperatoriaddrfindobjr)r@r include_selfrcartistss ` r rArtist.findobjs4 =  t $ $E6)B)B , e__I78 88<8I8I8KL8K1))I.8KLbR IdOO NN4 Ms>C cg)a Return the cursor data for a given event. .. note:: This method is intended to be overridden by artist subclasses. As an end-user of Matplotlib you will most likely not call this method yourself. Cursor data can be used by Artists to provide additional context information for a given event. The default implementation just returns *None*. Subclasses can override the method and return arbitrary data. However, when doing so, they must ensure that `.format_cursor_data` can convert the data to a string representation. The only current use case is displaying the z-value of an `.AxesImage` in the status bar of a plot window, while moving the mouse. Parameters ---------- event : `~matplotlib.backend_bases.MouseEvent` See Also -------- format_cursor_data NrH)r@rs r rArtist.get_cursor_datas:r#c[R"U5S:Xa"[US5(aURU5$US SR SU55nSU-S-$![[ 4a U/nN5f=f)a Return a string representation of *data*. .. note:: This method is intended to be overridden by artist subclasses. As an end-user of Matplotlib you will most likely not call this method yourself. The default implementation converts ints and floats and arrays of ints and floats into a comma-separated string enclosed in square brackets, unless the artist has an associated colorbar, in which case scalar values are formatted using the colorbar's formatter. See Also -------- get_cursor_data r_format_cursor_data_overridez, c3X# UH n[U[5(dMUSv M" g7f)z0.3gN)rr )ritems r r,Artist.format_cursor_data..Ns'!>DD$.tV$<"0D;Ds* *[])rendimr[rrP IndexErrorjoin)r@datadata_strs r format_cursor_dataArtist.format_cursor_data2s$ 774=A '$0N"O"O44T: : Qyy!>D!>>H>C' ' z* v sA##A98A9cUR$)zk Return whether this artist is queried for custom context information when the mouse cursor moves over it. )rrIs r get_mouseoverArtist.get_mouseoverRs r#c[U5UlURnU(aIUR(aURR U5 gURR U5 gg)z Set whether this artist is queried for custom context information when the mouse cursor moves over it. Parameters ---------- mouseover : bool See Also -------- get_cursor_data .ToolCursorPosition .NavigationToolbar2 N)boolrr=raddr)r@ mouseoverrs r set_mouseoverArtist.set_mouseoverYsOy/ YY !!%%d+!!))$/ r#)rr|r{rvrrr~rrrrrwrrrrrrrtrrxryrrzr=r}r>rurr<)NNN)Fr)\rLrMrNrOrmrr^rh classmethodr\rrrrrrpropertyr=setterr>rrrrrrrrrrrrrr rrrrr!r%r(r,r/r5r9r<r1rBrarHrTrWrZr]rbrjrrrrurzrr,rr.rrrrrrrrrrrrrrrrrrW contextlibcontextmanagerrrrrrr r rPrHr#r rRrRtsI F24%!("H $>VO ) ) [[77 \\ + +&(6G:( ," 4$(T$#L!F  8(8 " #0j*CEF$<| ?0"# &. $&&. ( $  ""4"26 L K  " "*X>(@0. 6Ir#rRcxUR"U00UESS0ED6$![a UR"U0UD6s$f=f)z Matplotlib's `.Axes.get_tightbbox` and `.Axis.get_tightbbox` support a *for_layout_only* kwarg; this helper tries to use the kwarg but skips it when encountering third-party subclasses that do not support it. for_layout_onlyT)rrP)objrrs r _get_tightbbox_for_layout_onlyrssP 2  $N*MV*M5F*MNN 2  $1&112s 99c\rSrSrSrSrSr\R"S5r Sr Sr Sr \ \S 55r\ \S 55rS r1S krS rSSjrSSjrSrSrSrg)rfiz A helper class to inspect an `~matplotlib.artist.Artist` and return information about its settable properties and their current values. c&[U[5(d;[R"U5(a [ U5n[ U5(aUSnXl[U[5(d [U5nXlUR5Ul g)z Initialize the artist inspector with an `Artist` or an iterable of `Artist`\s. If an iterable is used, we assume it is a homogeneous sequence (all `Artist`\s are of the same type) and it is your responsibility to make sure this is so. rN) rrRrerlistlenoorigro get_aliasesaliasd)r@rs r rArtistInspector.__init__si!V$${{1~~Gq66!A !T""QA&&( r#c ([UR5Vs/sHCnURS5(dM[[ URU55(dMAUPME nn0nUHn[ URU5nUR U5(dM1[ R"SUSSS3[R"U55RS5nURUSS[55RUSS5 M U$s snf)z Get a dict mapping property fullnames to sets of aliases for each alias in the :class:`~matplotlib.artist.ArtistInspector`. e.g., for lines:: {'markerfacecolor': {'mfc'}, 'linewidth' : {'lw'}, } )rrz`(Nz.*)`r )dirr startswithrris_aliasresearchinspectgetdocgroup setdefaultrWr)r@rnamesaliasesrpropnames r rArtistInspector.get_aliasess#&dff+9+$OO$45 !67+9D4664(D==&&yy2d2AhZt!4!(!577  66&#u{{1~6 6]]..q1  Z |7;YG ;;q> !r#cdSSS.nUR5Hup4URX45nM U$)zh Changes the full path to the public API path that is used in sphinx. This is needed for links to work. Axes)_base._AxesBase _axes.Axes)rreplace)r@ source_class replace_dictkeyvalues r _replace_pathArtistInspector._replace_paths< ,2&,. &,,.JC'//;L/r#c@/n[UR5HnURS5(dM[URU5n[ U5(a+UR U5S:dUR U5(aMnURUSS5 M U$)z Get the attribute strings with setters for object. For example, for a line, return ``['markerfacecolor', 'linewidth', ....]``. rrN)r rr!rrnumber_of_parametersr"r)r@settersrrs r rgArtistInspector.get_setterssKD??6**4664(DTNN006:}}T** NN48 $ r#cT[[R"U5R5$)z3Return number of parameters of the callable *func*.)rr% signature parameters)rs r rH$ArtistInspector.number_of_parameterss 7$$T*5566r#cX[R"U5nUcgURS5$)zD Return whether the object *method* is an alias for another method. Fr0)r%r&r!)methoddss r r"ArtistInspector.is_aliass)^^F # :}}\**r#c SRS[URRU/5555nX-$)z Return 'PROPNAME or alias' if *s* has an alias, else return 'PROPNAME'. For example, for the line markerfacecolor property, which has an alias, return 'markerfacecolor or mfc' and for the transform property, which does not, return 'transform'. rqc3,# UH nSU-v M g7f)z or %sNrH)rrs r r/ArtistInspector.aliased_name..sO0N1(Q,0Ns)rsortedrget)r@rr*s r aliased_nameArtistInspector.aliased_name s4''Ot{{q"7M0NOO{r#> $matplotlib.image._ImageBase.set_data%matplotlib.image._ImageBase.set_alpha%matplotlib.image._ImageBase.set_array(matplotlib.image._ImageBase.set_resample)matplotlib.image._ImageBase.set_filterrad*matplotlib.image._ImageBase.set_filternorm-matplotlib.image._ImageBase.set_interpolation3matplotlib.image._ImageBase.set_interpolation_stage3matplotlib.text._AnnotationBase.set_annotation_clipc ^TUR;aSUS3$SRU4Sj[URR U/5555nSUSTSU3$)a  Return 'PROPNAME or alias' if *s* has an alias, else return 'PROPNAME', formatted for reST. For example, for the line markerfacecolor property, which has an alias, return 'markerfacecolor or mfc' and for the transform property, which does not, return 'transform'. z``rqc36># UHnSUSTS3v M g7f)z or :meth:` <>`NrH)rr targets r r4ArtistInspector.aliased_name_rest..5s%S3Qak!Bvhb )3Qsz:meth:`rerf) _NOT_LINKABLErrVrrW)r@rrgr*s ` r aliased_name_rest!ArtistInspector.aliased_name_rest(sl T'' 's": ''S39$++//!R:P3QSS2fXRy11r#NcU(aSU-nOSnUbURU5nUUSU3$/n[UR55H=nURU5nURU5nUR UUSU35 M? U$)z If *prop* is *None*, return a list of strings of all settable properties and their valid values. If *prop* is not *None*, it is a valid property name and that property will be returned as a string of property : valid values. r1rq: )r9rVrgrXr)r@rn leadingspacepadacceptslinesrs r pprint_settersArtistInspector.pprint_setters9s  $CC  ++D1GU4&7), ,4++-.D++D1G$$T*D LLC5b 2 3/ r#c &U(aSU-nOSnUbURU5nUUSU3$/n[UR55HnURRH+n[ USU3S5nU(dMUR cM+ O [ URSU35nURXRSUR345 M UVVs/sH6upURX5RSS5RS S5PM8 n nnUVV s/sHupURU5PM nnn [S U 55n [S U55n US -S U --S -S U --n SUS-US-SU US -SRU 5-S -SRU 5-U /[X5VVs/sH1upUS -URU 5-S -URU 5-PM3 snnQU PSP$s snnfs sn nfs snnf)z If *prop* is *None*, return a list of reST-formatted strings of all settable properties and their valid values. If *prop* is not *None*, it is a valid property name and that property will be returned as a string of "property : valid" values. r1rqNrmr.r=r<r>c38# UHn[U5v M g7fr<r)rns r r6ArtistInspector.pprint_setters_rest..us-u!s1vvuc38# UHn[U5v M g7fr<rw)rr s r rryvs/w!s1vvwrzz =z .. table::z :class: property-tableProperty Description)r9rVrgr__mro__rrmrrMrNrjr?rljustzip)r@rnrnrorpprop_and_qualnamesr]rPrgr)_col0_lencol1_lentable_formatstrrxr s r pprint_setters_rest#ArtistInspector.pprint_setters_restQsj  $CC  ++D1GU4&7), ,4++-.Dvv~~ TFmT:6fnn8& !4v7  % %++,Af.A.A-BCD F/&89&8\T''5'+V4',/0&8 9 #56"4wt((."4 6-u--/w//+h6>xO  ,  - -   %K***84 4 #))(3 4   e-/-$!EkAGGH--58II-/        96 /s=H"H8H c  URn[U5Vs/sH8nURS5(dM[[ X55(dM6UPM: nnUR 5 0nUHin[ X5nUR U5(aM&[R"5 [R"S5 U"5nSSS5 WXBSS'Mk U$s snf!,(df  N =f![a Mf=f)z3Return a dictionary mapping property name -> value.rignoreNr) rr r!rrsortr"warningscatch_warnings simplefilter Exception)r@rrgettersrrrAs r rArtistInspector.propertiess JJ$'FNFDoof-2:71;K2LFN  D1#D}}T"" ",,.))(3&C/ "qr( !N/.  s:CCCC4+C# C4# C1 -C44 DDc/n[UR5R55Hup#[USS5S:wa![ U5S:a[ USS5S-nO [ U5nUR SS5n[ U5S:aUSSS-nURU5nURS US U35 M U$) z8Return the getters and actual values as list of strings.shaperHNz... r12z z = ) rVrrrrrr?rXr)r@rqrrArs r pprint_gettersArtistInspector.pprint_getterss 1 7 7 9:IDsGR(B.3s8a<BQL5(H $$A1v{crFUN$$T*D LL4vS, -; r#)rrr)NrG)Nr)rLrMrNrOrmrrr#compiler2r9rDrg staticmethodrrHr"rXrirjrrrrrrPrHr#r rfrfs )(0!jjA%N & 7 7  +  + M 2"05 n* r#rfcUc6[U5nUR5n[SRU55 g[ USU-5"5$)a Return the value of an `.Artist`'s *property*, or print all of them. Parameters ---------- obj : `~matplotlib.artist.Artist` The queried artist; e.g., a `.Line2D`, a `.Text`, or an `~.axes.Axes`. property : str or None, default: None If *property* is 'somename', this function returns ``obj.get_somename()``. If it's None (or unset), it *prints* all gettable properties from *obj*. Many properties have aliases for shorter typing, e.g. 'lw' is an alias for 'linewidth'. In the output, aliases and full property names will be listed as: property or alias = value e.g.: linewidth or lw = 2 See Also -------- setp Nrr)rfrprintrr)rr insprs r getprsJ8s#!!# diin 3) * ,,r#filec [U[5(aU/nO[[R"U55nU(dg[ US5nU(dY[ U5S:aJU(a[URUSS9US9 g[SRUR55US9 g[ U5S-(a [S5e[[USSS2USSS255nUVs/sHowRU5PM snUVs/sHowR"S 0UD6PM sn-n[[R"U55$s snfs snf) a Set one or more properties on an `.Artist`, or list allowed values. Parameters ---------- obj : `~matplotlib.artist.Artist` or list of `.Artist` The artist(s) whose properties are being set or queried. When setting properties, all artists are affected; when querying the allowed values, only the first instance in the sequence is queried. For example, two lines can be made thicker and red with a single call: >>> x = arange(0, 1, 0.01) >>> lines = plot(x, sin(2*pi*x), x, sin(4*pi*x)) >>> setp(lines, linewidth=2, color='r') file : file-like, default: `sys.stdout` Where `setp` writes its output when asked to list allowed values. >>> with open('output.log') as file: ... setp(line, file=file) The default, ``None``, means `sys.stdout`. *args, **kwargs The properties to set. The following combinations are supported: - Set the linestyle of a line to be dashed: >>> line, = plot([1, 2, 3]) >>> setp(line, linestyle='--') - Set multiple properties at once: >>> setp(line, linewidth=2, color='r') - List allowed values for a line's linestyle: >>> setp(line, 'linestyle') linestyle: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...} - List all properties that can be set, and their allowed values: >>> setp(line) agg_filter: a filter function, ... [long output listing omitted] `setp` also supports MATLAB style string/value pairs. For example, the following are equivalent: >>> setp(lines, 'linewidth', 2, 'color', 'r') # MATLAB style >>> setp(lines, linewidth=2, color='r') # Python style See Also -------- getp NrrG)rnrrz(The set args must be string, value pairsr rH)rrRrr flattenrfrrrrrrdictrrrW) rrrrobjsrfuncvalsrrs r setprsv#vuEMM#&'  47 #D c$i!m  $%%47%3$ ?  $))D//12 > 4y1}CDDCSqS 41:./H'+ ,t!88H t ,/NA/N NC  c" ## -/Ns 2EEc[U5n[RS(aSRUR SS95$SSRUR SS95-$)a Inspect an `~matplotlib.artist.Artist` class (using `.ArtistInspector`) and return information about its settable properties and their current values. Parameters ---------- artist : `~matplotlib.artist.Artist` or an iterable of `Artist`\s Returns ------- str The settable properties of *artist*, as plain text if :rc:`docstring.hardcopy` is False and as a rst table (intended for use in Sphinx) if it is True. zdocstring.hardcopyrr)rnz Properties: )rfrrrrrr)rais r rlrl(sb  B||01 IIb,,!,< =L dii(9(9q(9(IJ JLr#r<)4 collectionsrr functoolsrrrr%rrloggingnumbersr r rr#rnumpyre matplotlibrrqr r rQr transformsrrrrrrr getLoggerrLrr'r5r:rBrCrErjrRrrfrrWrrlr\rHr#r rs"**(  @@@"*(V  Y & |7|7~' 2kk\ !-H Q$hL.**,r#