mrhavens/intellecton
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
08b31efc466652a02fa7c35263ab56f7c7854eb0
intellecton/venv/lib/python3.12/site-packages/matplotlib/__pycache__/artist.cpython-312.pyc
T

890 lines
74 KiB
Plaintext
Raw Normal View History

feat: rigorous physics revision for Paper 1 based on adversarial review
2026-06-01 22:22:35 +00:00
Ë
†RjŽ÷ãó —ddlmZddlZddlmZmZmZddlZddlmZm Z ddl
Z
ddl m Z m
Z
ddlZddlZddlZddlZddlZddlmZmZddlmZdd lmZmZmZmZmZm Z m!Z!e
jDe#«Z$d
„Z%d „Z&d „Z'd
„Z(edd«Z)Gd„d«Z*e*«Z+Gd„d«Z,d„Z-Gd„d«Z.dd„Z/e/Z0ddœd„Z1d„Z2e,jg«y)é)Ú
namedtupleN)ÚcacheÚreduceÚwraps)Ú SignatureÚ Parameter)ÚNumberÚRealé)Ú_apiÚcbook)ÚPath)ÚBboxBaseÚBboxÚIdentityTransformÚ TransformÚTransformedBboxÚTransformedPatchPathÚTransformedPathcó<‡—t‰«ˆfd„«}d|_|S)Ncó‚•—|jdk(r#|jr|j«d|_‰||g|¢­i|¤ŽS)NrF)Ú
_raster_depthÚ _rasterizingÚstop_rasterizing)ÚartistÚrendererÚargsÚkwargsÚdraws €úT/home/antigravity/intellecton/venv/lib/python3.12/site-packages/matplotlib/artist.pyÚ draw_wrapperz,_prevent_rasterization.<locals>.draw_wrappersFø€à × !Ñ ! QÒ &¨8×+@Ò+@ð
× %Ñ %Ô 'Ø$)ˆHÔ !á�F˜HÐ6 tÒ6¨vÑ6Ð6óF©rÚ_supports_rasterization©rr!s` r Ú_prevent_rasterizationr&s+ø€ô ˆ4ƒ[ó7óð7ð,1€LÔ(Ø Ðr"có<‡—t‰«ˆfd„«}d|_|S)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.
có•— |j«rH|jdk(r#|js|j«d|_|xjdz
c_n2|jdk(r#|jr|j «d|_|j «�|j
«‰||«|j «�|j|j ««|j«r|xjdzc_|jrC|jd¬«x}r.|jr!|j «|j«SSSS#|j «�|j|j ««|j«r|xjdzc_|jrC|jd¬«x}r.|jr!|j «|j«wwwwxYw)NrTr F©Úroot)
Úget_rasterizedrrÚstart_rasterizingrÚget_agg_filterÚ start_filterÚ stop_filterÚ
get_figureÚsuppressComposite)rrÚfigrs €r r!z)allow_rasterization.<locals>.draw_wrapper5sÊø€ð -Ø×$Ñ$Ô&Ø×)Ñ)¨QÒ.°x×7LÒ7LØ×.Ñ.Ô0Ø,0�HÔ)Ø×&Ò&¨!Ñ+Ö&à×)Ñ)¨QÒ.°8×3HÒ3Hð×-Ñ-Ô/Ø,1�HÔ)à×$Ñ$Ó&Ð2Ø×%Ñ%Ô'ᘠÓ)à×$Ñ$Ó&Ð2Ø×$Ñ$ V×%:Ñ%:Ó%<Ô=Ø×$Ñ$Ô&Ø×&Ò&¨!Ñ+Õ&Ø×%Ò%°&×2CÑ2CÈÐ2CÓ2NÐ+N¨3Ð+NØ×)Ò)à×)Ñ)Ô+Ø×*Ñ*Õ,ð*ð,OÐ%øð ×$Ñ$Ó&Ð2Ø×$Ñ$ V×%:Ñ%:Ó%<Ô=Ø×$Ñ$Ô&Ø×&Ò&¨!Ñ+Õ&Ø×%Ò%°&×2CÑ2CÈÐ2CÓ2NÐ+N¨3Ð+NØ×)Ò)à×)Ñ)Ô+Ø×*Ñ*Õ,ð*ð,OÐ%ús
ƒB2EÅB%G>Tr#r%s` r Úallow_rasterizationr3,s+ø€ô ˆ4ƒ[ó-óð-ð:,0€LÔ(Ø Ðr"có.‡—t‰«ˆfd„«}|S)z”
Decorator for Artist.draw method. Needed on the outermost artist, i.e.
Figure, to finish up if the render is still in rasterized mode.
cóh•—‰||g|¢­i|¤Ž}|jr|j«d|_|S)NF)rr)rrrrÚresultrs €r r!z-_finalize_rasterization.<locals>.draw_wrapper\s;ø€á�f˜hÐ8¨Ò8°Ñ8ˆØ × Ò Ø × %Ñ %Ô 'Ø$)ˆHÔ !؈
r")rr%s` r Ú_finalize_rasterizationr7Ws#ø€ô
 ˆ4ƒ[óóðð Ðr"có@—|jr||j_yy©N)ÚaxesÚstale©ÚselfÚvals r Ú_stale_axes_callbackr?fs€Ø ‡y‚y؈� ‰ �ðr"Ú_XYPairzx ycó—eZdZd„Zy)Ú_Unsetcó—y)Nz<UNSET>©©r=s r Ú__repr__z_Unset.__repr__os€Ør"N)Ú__name__Ú
__module__Ú __qualname__rFrDr"r rBrBns„ór"rBcó¬—eZdZdZdZd„Zgd¢Zed„«Zd„Z d„Z
d„Z d „Z d
„Z
d „Zed „«Zej"d
„«Zed„«Zej"d„«ZdVd„ZdVd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Z d„Z!d „Z"d!„Z#d"„Z$d#„Z%d$„Z&d%„Z'd&„Z(dWd'„Z)d(„Z*d)„Z+dXd*„Z,d+„Z-ee,e-d,¬-«Z.d.„Z/dVd/„Z0d0„Z1d1„Z2d2„Z3d3„Z4d4„Z5d5„Z6d6„Z7d7„Z8d8„Z9d9„Z:d:„Z;d;„Z<d<„Z=d=„Z>d>„Z?d?„Z@d@„ZAdA„ZBdB„ZCdC„ZDdD„ZEdE„ZFdF„ZGdG„ZHdH„ZIedI„«ZJdJ„ZKdK„ZLdL„ZMdM„ZNdN„ZOdO„ZPeQj¤dP„«ZSdYdQ„ZTdR„ZUdS„ZVdT„ZWdU„ZXeeWeX«ZYy)ZÚArtistz•
Abstract base class for objects that render into a FigureCanvas.
Typically, all visible elements in a figure are subclasses of Artist.
rcó —t|jd«st|j«|_t|jd«syd„|_d|j_|j
›d�|j_|j
«y)Nr$Ú_autogenerated_signaturecó.—tj|fi|¤ŽSr9)rKÚset©r=rs r ú<lambda>z*Artist.__init_subclass__.<locals>.<lambda>’s€¬¯©°DÑ)C¸FÑ)C€r"rOz.set)Úhasattrrr&rOrGrIÚ#_update_set_signature_and_docstring)Úclss r Ú__init_subclass__zArtist.__init_subclass__}sr€ô�s—x‘xÐ!:Ô;Ü-¨c¯h©hÓ7ˆCŒHô
�s—w‘wÐ :Ô;ð
áCˆŒØ ˆ�‰ÔØ"%×"2Ñ"2Ð!3°4Ð8ˆ�‰ÔØ ×/Ñ/Õ1r")Ú
navigate_modeÚfigureÚ
3d_propertiesc ó~—ttdtj«gt|«j «D�cgc]4}|t
j vr t|tjt¬«‘Œ6c}¢«|j_
d|j_ dt|«z|j_
ycc}w)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<Set multiple properties at once.
Supported properties are
N)rrÚPOSITIONAL_OR_KEYWORDÚArtistInspectorÚ get_settersrKÚ_PROPERTIES_EXCLUDED_FROM_SETÚ KEYWORD_ONLYÚ_UNSETrOÚ
__signature__rMÚkwdocÚ__doc__)rTÚprops r rSz*Artist._update_set_signature_and_docstringžs¥€ô!*Ü
�vœy×>Ñ>Ó
?ð
Eä*¨3Ó/×;Ñ;Ó=öDØØœf×BÑBÑBô˜œy×5Ñ5¼vÖFòDð
Eó!Fˆ�‰Ôð
,0ˆ�‰Ô(ð
+ä�C‹jñ
ð �‰�ùò Ds»9B:
cóh—d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_
d|_ d|_ d|_
d|_d|_t!|«j"t$j"k7|_t)j*dg¬«|_ d|_d|_d|_d|_d|_t:j<d|_t:j<d|_ tCgg«|_"d|_#y#t0$rYŒpwxYw)NTFÚÚpchanged)Úsignalsz path.sketchz path.effects)$Ú_staleÚstale_callbackÚ_axesÚ_parent_figureÚ
_transformÚ
_transformSetÚ_visibleÚ _animatedÚ_alphaÚclipboxÚ _clippathÚ_cliponÚ_labelÚ_pickerÚ _rasterizedÚ _agg_filterÚtypeÚget_cursor_datarKÚ
_mouseoverr
ÚCallbackRegistryÚ
_callbacksr:ÚAttributeErrorÚ_remove_methodÚ_urlÚ_gidÚ_snapÚmplÚrcParamsÚ_sketchÚ
_path_effectsr@Ú
_sticky_edgesÚ
_in_layoutrEs r Ú__init__zArtist.__init__³s€ØˆŒ Ø"ˆÔ؈Œ
Ø"ˆÔàˆŒØ"ˆÔ؈Œ
؈ŒØˆŒ ؈Œ ؈ŒØˆŒ ؈Œ ؈Œ Ø ˆÔ؈Ôô˜t›*×4Ñ4¼×8NÑ8NÑNˆŒÜ×0Ñ0¸*¸ÔFˆŒð ؈DŒIð#ˆÔ؈Œ ؈Œ ؈Œ
Ü—|‘| MÑ2ˆŒ Ü Ÿ\™\¨.Ñ9ˆÔÜ$ R¨›_ˆÔ؈�øôò á ð úsÂ9D%Ä% D1Ä0D1cóD—|jj«}d|d<|S)Nrj)Ú__dict__Úcopy)r=Úds r Ú __getstate__zArtist.__getstate__×s$€Ø �M‰M× Ñ Ó ˆØ"ˆÐ
Ñ؈r"có*—|j�}|j|«d|_d}t|dd«}t|dd«}|�!|j|«d|_d|_d}|j
d¬«x}�|sd|_d|_yytd«‚)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:Ú_mouseover_setTr)zcannot remove artist) rrjÚgetattrÚdiscardr;r:r0rlÚNotImplementedError)r=Ú_ax_flagÚaxÚ
mouseover_setr2s r Úremovez
Artist.removeÜs«€ð$ × Ñ Ð *Ø × Ñ  Ô %à"&ˆDÔ ØˆHܘ˜v tÓ,ˆBÜ# BÐ(8¸$Ó?ˆMØÐ(à×%Ñ% dÔ+Ø�”Ø �” Ø�à—‘¨E�Ó2Ð2�Ð?ÙØ $�C”IØ&*�Õ#ð@ô &Ð&<Ó=Ð =r"cóv—|j}|xr*td„|jj«D««S)z)Return whether units are set on any axis.c3ó<K—|]}|j«–—Œy­wr9)Ú
have_units)Ú.0Úaxiss r ú <genexpr>z$Artist.have_units.<locals>.<genexpr> sèø€ÒN°˜$Ÿ/™/×+ÑNùs‚)r:ÚanyÚ _axis_mapÚvalues)r=r•s r ršzArtist.have_units s.€à
�Y‰YˆØÒN”cÑN¸¿ ¹ ×8KÑ8KÓ8MÔNÓNÐNr"cór—t|dd«}|� |j€|S|jj|«S)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)r‘ÚxaxisÚ
convert_units)r=Úxr•s r Úconvert_xunitszArtist.convert_xunitsó:€ô�T˜6 4Ó
(ˆØ
ˆ:˜Ÿ™Ð)؈HØ�x‰x×%Ñ% aÓ(Ð(r"cór—t|dd«}|� |j€|S|jj|«S)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)r‘Úyaxisr£)r=Úyr•s r Úconvert_yunitszArtist.convert_yunitsr¦r"có—|jS)z<The `~.axes.Axes` instance the artist resides in, or *None*.)rkrEs r r:z Artist.axes&s€ð�z‰zÐr"cóˆ—|�&|j�||jk7r td«‚||_|�||ur t|_yyy)NzoCan not reset the Axes. You are probably trying to reuse an artist in more than one Axes which is not supported)rkÚ
ValueErrorr?rj)r=Únew_axess r r:z Artist.axes+sV€à Ð  T§Z¡ZÐ%;Ø §
¡
Ò*ÜðVóWð
WàˆŒ
Ø Ð  H°DÑ$8Ü"6ˆDÕ ð%9Ð r"có—|jS)zŠ
Whether the artist is 'stale' and needs to be re-drawn for the output
to match the internal state of the artist.
)rirEs r r;z Artist.stale5s€ð �{‰{Ðr"cóp—||_|jry|r |j�|j||«yyyr9)rirprjr<s r r;z Artist.stale=s:€àˆŒ ð
�>Š>Ø á �4×&Ñ&Ð2Ø × Ñ   cÕ *ð3ˆ3r"Ncó$—tddgddgg«S)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)r©r=rs r Úget_window_extentzArtist.get_window_extentJs€ô$�a˜�V˜a ˜VÐ$Ó%Ð%r"có(—|j|«}|j«rp|j«}|�tj||«}|j «}|�6|�4|j
«}tj||j««}|S)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_pathÚget_fully_transformed_pathÚ get_extents)r=rÚbboxÚclip_boxÚ clip_paths r Ú
get_tightbboxzArtist.get_tightbbox^s�€ð ×%Ñ% hÓ/ˆØ × Ñ Ô Ø×(Ñ(Ó*ˆHØÐ#Ü×(Ñ(¨¨xÓ8�Ø×*Ñ*Ó,ˆIØÐ$¨Ð)9Ø%×@Ñ@ÓB� Ü×(Ñ(¨¨y×/DÑ/DÓ/FÓG�؈ r"cóF‡‡—‰jjdˆˆfd„«S)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
rgcó•—‰‰«Sr9rD)Úfuncr=s€€r rQz%Artist.add_callback.<locals>.<lambda>”s ø€¹4À»:€r")r}Úconnect)r=rÁs``r Ú add_callbackzArtist.add_callbackysù€ð6�‰×&Ñ& zÔ3EÓFÐFr"có:—|jj|«y)zu
Remove a callback based on its observer id.
See Also
--------
add_callback
N)r}Ú
disconnect)r=Úoids r Úremove_callbackzArtist.remove_callback–s€ð
�‰×"Ñ" 3Õ'r"có:—|jjd«y)zÒ
Call all of the registered callbacks.
This function is triggered internally when a property is changed.
See Also
--------
add_callback
remove_callback
rgN)r}ÚprocessrEs r rgzArtist.pchanged s€ð
�‰×Ñ 
Õ+r"có—|jS)zŒ
Return whether the Artist has an explicitly set transform.
This is *True* after `.set_transform` has been called.
)rnrEs r Úis_transform_setzArtist.is_transform_set­s€ð ×!Ñ!Ð!r"cóN—||_d|_|j«d|_y)z�
Set the artist transform.
Parameters
----------
t : `~matplotlib.transforms.Transform`
TN)rmrnrgr;)r=Úts r Ú
set_transformzArtist.set_transformµs#€ðˆŒØ!ˆÔØ �
‰
ŒØˆ�
r"có—|j€t«|_|jSt|jt«s@t |jd«r*|jj |j «|_|jS)z5Return the `.Transform` instance used by this artist.Ú_as_mpl_transform)rmrÚ
isinstancerrRrÐr:rEs r Ú
get_transformzArtist.get_transformÂse€à �?‰?Ð "Ü/Ó1ˆDŒOð�‰Ðô˜TŸ_™_¬iÔ8ܘ$Ÿ/™/Ð+>Ô?Ø"Ÿo™o×?Ñ?ÀÇ Á ÓJˆDŒOØ�‰Ðr"có—gS)z9Return a list of the child `.Artist`\s of this `.Artist`.rDrEs r Ú get_childrenzArtist.get_childrenËs€àˆ r"có„—t|dd«duxr0|jd¬«x}duxr|j|juS)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))r‘r0rÖ)r=Úeventr2s r Ú_different_canvaszArtist._different_canvasÏsL€ô˜˜x¨Ó.°dÐ:ò3Ø ŸO™O°˜OÓ6Ð6�S¸tÐCò3à—L‘L¨¯
©
Ð2ð 4r"có^—tjd|jj«difS)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)Ú_logÚwarningÚ __class__rG)r=Ú
mouseevents r ÚcontainszArtist.containsás'€ô"
� ‰ Ð1°4·>±>×3JÑ3JÔKØ�bˆyÐr"cóJ—|jd¬«duxr|jduS)z˜
Return whether the artist is pickable.
See Also
--------
.Artist.set_picker, .Artist.get_picker, .Artist.pick
Fr)N)r0rvrEs r ÚpickablezArtist.pickableõs(€ð�‰ EˆÓ*°$Ð6ÒS¸4¿<¹<ÈtÐ;SÐSr"cóþ—ddlm}|j«rr|j«}t |«r
|||«\}}n|j |«\}}|r4|d|j
d¬«j||fi|¤Žj«|j«D]b}t|dd«}t|tjj«s|j�|�|j|k(sŒR|j!|«Œdy)a
Process a pick event.
Each child artist will fire a pick event if *mouseevent* is over
the artist and the artist has picker set.
See Also
--------
.Artist.set_picker, .Artist.get_picker, .Artist.pickable
r )Ú PickEventÚ
pick_eventTr)r:N)Ú
backend_basesrâràÚ
get_pickerÚcallablerÞr0rÖÚ_processrÔr‘rÑrƒrWÚ SubFigureÚinaxesÚpick)r=rÝrâÚpickerÚinsiderdÚar•s r rêz Artist.pickÿsâ€õ -à �=‰=Œ?Ø—_‘_Ó&ˆFܘÔÙ% d¨JÓ7‘ �™à#Ÿ}™}¨ZÓ8‘ �˜ÙÙ˜,¨¯©¸T¨Ó(B×(IÑ(IØ$ dñ4Ø.2ñ4ß4<±H´Jð×"Ñ"Ó$ò #ˆA䘘F DÓ)ˆBܘ1œcŸj™j×2Ñ2Ô3Ø!×(Ñ(Ð0°B°JØ!×(Ñ(¨BÓ.ð—‘�zÕ"ñ #r"có—||_y)a;
Define the picking behavior of the artist.
Parameters
----------
picker : None or bool or float or callable
This can be one of the following:
- *None*: Picking is disabled for this artist (default).
- A boolean: If *True* then picking will be enabled and the
artist will fire a pick event if the mouse event is over
the artist.
- A float: If picker is a number it is interpreted as an
epsilon tolerance in points and the artist will fire
off an event if its data is within epsilon of the mouse
event. For some artists like lines and patch collections,
the artist may provide additional data to the pick event
that is generated, e.g., the indices of the data within
epsilon of the pick event
- A function: If picker is callable, it is a user supplied
function which determines whether the artist is hit by the
mouse event::
hit, props = picker(artist, mouseevent)
to determine the hit test. if the mouse event is over the
artist, return *hit=True* and props is a dictionary of
properties you want added to the PickEvent attributes.
N©rv)r=rës r Ú
set_pickerzArtist.set_picker%s €ðBˆ� r"có—|jS)zÞ
Return the picking behavior of the artist.
The possible values are described in `.Artist.set_picker`.
See Also
--------
.Artist.set_picker, .Artist.pickable, .Artist.pick
rïrEs r råzArtist.get_pickerHs€ð�|‰|Ðr"có—|jS)zReturn the url.©r€rEs r Úget_urlzArtist.get_urlTó €à�y‰yÐr"có—||_y)zf
Set the url for the artist.
Parameters
----------
url : str
Nró)r=Úurls r Úset_urlzArtist.set_urlXó €ðˆ� r"có—|jS)zReturn the group id.©r�rEs r Úget_gidzArtist.get_gidbrõr"có—||_y)zm
Set the (group) id for the artist.
Parameters
----------
gid : str
Nrû)r=Úgids r Úset_gidzArtist.set_gidfrùr"cóB—tjdr |jSy)zP
Return the snap setting.
See `.set_snap` for details.
z path.snapF)rƒr„r‚rEs r Úget_snapzArtist.get_snapps€ô �<‰<˜ Ò $Ø—:‘:Ð àr"có —||_d|_y)aí
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)r‚r;)r=Úsnaps r Úset_snapzArtist.set_snap{s€ð2ˆŒ
؈�
r"có—|jS)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.
)r…rEs r Úget_sketch_paramszArtist.get_sketch_params—s€ð$�|‰|Ðr"cóX—|€d|_d|_y||xsd|xsdf|_d|_y)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)r…r;)r=ÚscaleÚlengthÚ
randomnesss r Úset_sketch_paramszArtist.set_sketch_params«s9€ð, ˆ=؈DŒLðˆ�
ð" 6¢?¨U°JÒ4FÀ$ÐGˆDŒL؈�
r"có —||_d|_y)zƒ
Set the path effects.
Parameters
----------
path_effects : list of `.AbstractPathEffect`
TN)r†r;)r=Ú path_effectss r Úset_path_effectszArtist.set_path_effectsÇs€ð*ˆÔ؈�
r"có—|jSr9)r†rEs r Úget_path_effectszArtist.get_path_effectsÒs€Ø×!Ñ!Ð!r"cón—|r(|j�|jjd¬«S|jS)a.
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))rlr0)r=r*s r r0zArtist.get_figureÕs8€ñ �D×'Ñ'Ð3Ø×&Ñ&×1Ñ1°tÐ1Ó<Ð <à×"Ñ"Ð"r"cóÀ—|j|ury|j� td«‚||_|jr|j|ur|j«d|_y)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)rlÚ RuntimeErrorrgr;)r=r2s r Ú
set_figurezArtist.set_figureäsc€ð × Ñ  #Ñ %Ø ð × Ñ Ð *Üð 6ó7ð
7à!ˆÔØ × Ò  4×#6Ñ#6¸dÑ#BØ �M‰MŒO؈�
r"zVThe (Sub)Figure that the artist is on. For more control, use the `get_figure` method.)Údoccóš—tjtdf|¬«||jk7r||_|j «d|_yy)am
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.
N©rrT)r Úcheck_isinstancerrrrgr;)r=rrs r Ú set_clip_boxzArtist.set_clip_boxsA€ô
×Ñœx¨Ð.¸Õ@Ø �d—l‘lÒ "Ø"ˆDŒLØ �M‰MŒO؈D�Jð #r"cóx—ddlm}m}d}|€{t||«r;t t j «|j««|_d|_ d}n4t||«rt|«|_ d}nt|t«r|\}}|€
d|_ d}nWt|t«rt||«|_ d}n3t|t«r
||_ d}nt|t«r ||_ d}|s7tdt|«j ›dt|«j ›�«‚|j#«d|_y)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.patchesrrrÑrrÚunitrÒrrrsrÚtuplerrÚ TypeErrorryrGrgr;)r=ÚpathÚ transformrrÚsuccesss r Ú
set_clip_pathzArtist.set_clip_paths €÷2 8àˆØ Рܘ$  Ô*Ü.¬t¯y©y«{Ø/3×/AÑ/AÓ/Có E�” à!%�”ؑܘD %Ô(Ü!5°dÓ!;�”ؑܘD¤%Ô(Ø"&‘��ià ˆ<Ø!ˆDŒN؉GÜ
˜œdÔ
#Ü,¨T°9Ó=ˆDŒN؉GÜ
˜Ô2Ô
3Ø!ˆDŒN؉GÜ
˜œoÔ
.Ø!ˆDŒN؈GáÜØ>ܘ“:×&Ñ&Ð' u¬T°)«_×-EÑ-EÐ,FðHóIð
Ið
�
‰
ŒØˆ�
r"có—|jS)zc
Return the alpha value used for blending - not supported on all
backends.
)rqrEs r Ú get_alphazArtist.get_alphaPs€ð
�{‰{Ðr"có—|jS)zReturn the visibility.)rorEs r Ú get_visiblezArtist.get_visibleWs €à�}‰}Ðr"có—|jS)z&Return whether the artist is animated.)rprEs r Ú get_animatedzArtist.get_animated[ó €à�~‰~Ðr"có—|jS)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')``.
©rˆrEs r Ú
get_in_layoutzArtist.get_in_layout_s€ð�‰Ðr"có¢—|j«}|j«}|jduxr |j«xrŽ|duxs|duxr‚|duxs@t j
|j |jjj k(«xr:|duxs4t|t«xr"|j|jjuS)at
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) r¶r¸r:rµÚnpÚallÚextentsr»rÑrÚ_patchÚpatch)r=r¼r½s r Ú_fully_clipped_to_axeszArtist._fully_clipped_to_axesjsÍ€ð×$Ñ$Ó&ˆØ×&Ñ&Ó(ˆ Ø— ‘  Ð%ò>Ø×$Ñ$Ó&ò>à TÐ)ÒB¨Y¸dÐ-Bò>ð Ð%òKÜŸ™˜x×/Ñ/°4·9±9·>±>×3IÑ3IÑIÓJò >ð
 $Ð&ò=Ü" 9Ô.BÓCò=Ø"×)Ñ)¨T¯Y©Y¯_©_Ð<ð ?r"có—|jS)z(Return whether the artist uses clipping.)rtrEs r rµzArtist.get_clip_on‚ó €à�|‰|Ðr"có—|jS)zReturn the clipbox.rrEs r r¶zArtist.get_clip_box†r7r"có—|jS)zReturn the clip path.)rsrEs r r¸zArtist.get_clip_pathŠr+r"cóP—|j�|jj«Sy)z£
Return the clip path with the non-affine part of its
transformation applied, and the remaining affine part of its
transformation.
)NN)rsÚget_transformed_path_and_affinerEs r Ú$get_transformed_clip_path_and_affinez+Artist.get_transformed_clip_path_and_affineŽs$€ð �>‰>Ð %Ø—>‘>×AÑAÓCÐ CØr"có@—||_|j«d|_y)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)rtrgr;©r=Úbs r Ú set_clip_onzArtist.set_clip_on˜s€ðˆŒ ð
�
‰
ŒØˆ�
r"cóæ—|jrC|j�|j|j«|j|j«y|jd«|jd«y)z!Set the clip properly for the gc.N)rtrrÚset_clip_rectangler$rs)r=Úgcs r Ú _set_gc_clipzArtist._set_gc_clip©sS€à �<Š<Ø�|‰|Ð'Ø×%Ñ% d§l¡lÔ3Ø × Ñ ˜TŸ^™^Õ ,à × !Ñ ! $Ô 'Ø × Ñ ˜TÕ "r"có—|jS)z.Return whether the artist is to be rasterized.)rwrEs r r+zArtist.get_rasterized³ó€à×ÑÐr"cóz—t|jdd«}|r|stjd|›d�«||_y)aÊ
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)r‘rr Ú
warn_externalrw)r=Ú
rasterizedÚsupports_rasterizations r Úset_rasterizedzArtist.set_rasterized·sB€ô ")¨¯©Ø)BÀEó"KÐá Ñ4Ü × Ñ Ð!3°D°6Ð9JÐKÔ Là%ˆÕr"có—|jS)z1Return filter function to be used for agg filter.)rxrEs r r-zArtist.get_agg_filterÎrFr"có —||_d|_y)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)rxr;)r=Ú filter_funcs r Úset_agg_filterzArtist.set_agg_filterÒs€ð'ˆÔ؈�
r"có4—|j«syd|_y)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)r(r;r²s r rz Artist.drawäs€ð×ÑÔ!Ø Øˆ�
r"cóî—|�'t|t«stdt|«›�«‚|�d|cxkrdksnt d|›d�«‚||j
k7r||_|j
«d|_yy)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)rÑr
r ryr­rqrgr;©r=Úalphas r Ú set_alphazArtist.set_alpha÷s}€ð Ð ¤Z°´tÔ%<ÜØ5´d¸5³k°]ÐCóEð
Eà Ð  a¨5¤o°A¤oܘw u gÐ-CÐDÓEÐ EØ �D—K‘KÒ ØˆDŒKØ �M‰MŒO؈D�Jð r"cóž—t|t«r td«‚tj|«st
j
||«ytj|«}d|j«kr|j«dks-td|j«›d|j«›�«‚||_ |j«d|_
y)a!
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)rÑÚstrr r0ÚiterablerKrTÚasarrayÚminÚmaxr­rqrgr;rRs r Ú_set_alpha_for_arrayzArtist._set_alpha_for_array
sª€ô �eœSÔ !ÜÐIÓJÐ JÜ�{‰{˜5Ô!Ü × Ñ ˜T 5Ô )Ø Ü—
‘
˜5Ó!ˆØ�U—Y‘Y“[Ò  U§Y¡Y£[°AÒ%5Üð+Ø+0¯9©9«;¨-°yÀÇÁÃÀ
ðOóPð
PàˆŒ Ø �
‰
ŒØˆ�
r"có`—||jk7r||_|j«d|_yy)zf
Set the artist's visibility.
Parameters
----------
b : bool
TN)rorgr;r>s r Ú set_visiblezArtist.set_visible!s,€ð
�—
‘
Ò ØˆDŒMØ �M‰MŒO؈D�Jð r"cóR—|j|k7r||_|j«yy)aÇ
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)rprgr>s r Ú set_animatedzArtist.set_animated.s%€ð �>‰>˜QÒ ØˆDŒNØ �M‰M�Oð r"có—||_y)a
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
Nr-)r=Ú in_layouts r Ú
set_in_layoutzArtist.set_in_layoutBs €ð$ˆ�r"có—|jS)z4Return the label used for this artist in the legend.)rurEs r Ú get_labelzArtist.get_labelOó €à�{‰{Ðr"có~—|� t|«nd}||jk7r||_|j«d|_yy)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)rVrurgr;)r=ÚsÚlabels r Ú set_labelzArtist.set_labelSs;€ð˜-”�A”¨TˆØ �D—K‘KÒ ØˆDŒKØ �M‰MŒO؈D�Jð r"có—|jS)zReturn the artist's zorder.)ÚzorderrEs r Ú
get_zorderzArtist.get_zorderbrer"có�—|€|jj}||jk7r||_|j«d|_yy)z¨
Set the zorder for the artist. Artists with lower zorder
values are drawn first.
Parameters
----------
level : float
NT)rÜrkrgr;)r=Úlevels r Ú
set_zorderzArtist.set_zorderfs@€ð ˆ=Ø—N‘N×)Ñ)ˆEØ �D—K‘KÒ ØˆDŒKØ �M‰MŒO؈D�Jð r"có—|jS)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)
)r‡rEs r Ú sticky_edgeszArtist.sticky_edgesvs€ð2×!Ñ!Ð!r"cór—|j|_|j|_|j|_|j|_|j|_|j
|_|j |_|j|_|j|_|j|_ |jjj«|jjdd|jjj«|jjdd|j«d|_y)z'Copy properties from *other* to *self*.NT)rmrnrorqrrrtrsrur…r†rqr¤rŒr©rgr;)r=Úothers r Ú update_fromzArtist.update_from‘sÞ€à×*Ñ*ˆŒØ"×0Ñ0ˆÔØŸ™ˆŒ
Ø—l‘lˆŒ Ø—}‘}ˆŒ Ø—}‘}ˆŒ ØŸ™ˆŒØ—l‘lˆŒ Ø—}‘}ˆŒ Ø"×0Ñ0ˆÔØ!&×!3Ñ!3×!5Ñ!5×!:Ñ!:Ó!<ˆ×Ñ×Ñ™AÐØ!&×!3Ñ!3×!5Ñ!5×!:Ñ!:Ó!<ˆ×Ñ×Ñ™AÐØ �
‰
ŒØˆ�
r"có4—t|«j«S)z8Return a dictionary of all the properties of the artist.)r\Ú
propertiesrEs r rvzArtist.properties¢s€ä˜tÓ$×/Ñ/Ó1Ð1r"c ó¼—g}tj|d¬«5|j«D]€\}}|dk(r|jt |||««Œ(t |d|›�d«}t
|«s't|jt|«|¬«|¬«‚|j||««Œ‚ ddd«|r|j«d|_ |S#1swYŒ$xYw) 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)rTÚ prop_name)ÚnameT) r
Ú _setattr_cmÚitemsÚappendÚsetattrr‘rær~Úformatryrgr;)r=ÚpropsÚerrfmtÚretÚkÚvrÁs r Ú
_update_propszArtist._update_props¦sЀðˆÜ
×
Ñ
˜t¨eÔ
4ñ (ØŸ ™ ›
ò
(‘��1ð˜’;Ø—J‘Jœw t¨Q°Ó2Õ3ä" 4¨4°¨s¨°TÓ:�DÜ# Dœ>Ü,Ø"ŸM™M¬d°4«jÀA˜MÓFØ!"ô$ð$ð—J‘J™t A›wÕ'ñ
(÷ (ñ Ø �M‰MŒO؈DŒJ؈
÷! (ð (ús šBCÃCcó&—|j|d«S)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=r�s r Úupdatez
Artist.updateÁs€ð×!Ñ!Ø ÐJóLð Lr"có&—|j|d«S)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}rˆrPs r Ú_internal_updatezArtist._internal_updateÌs€ð×!Ñ!Ø ðóð r"c óL—|jtj||««Sr9)r‹r
Únormalize_kwargsrPs r rOz
Artist.set×s"€ð×$Ñ$¤U×%;Ñ%;¸FÀDÓ%IÓJÐJr"c
+óÚK—|D�cic]}|t|d|›�««“Œ}} |jdi|¤Žd–—|jdi|¤Žycc}w#|jdi|¤ŽwxYw­w)zV
`.Artist.set` context-manager that restores original values at exit.
Úget_NrD)r‘rO)r=rr„Ú orig_valss r Ú_cm_setzArtist._cm_setÝsxèø€ð
>DÖD¸�QÐ1œ ¨¨Q¨C jÓ1Ó3Ñ3ÐDˆ ÐDð "Ø ˆD�H‰HÑ �vÒ Û à ˆD�H‰HÑ !�yÓ !ùò Eøð
ˆD�H‰HÑ !�yÓ !üs%‚A+‡A£A+¦A¼A+ÁA(Á(A+c ó^‡—‰€d„}n?t‰t«rt‰t«rˆfd„}nt ‰«r‰}n t d«‚t
tj|j«D�cgc]}|j|«‘Œc}g«}|r||«r|j|«|Scc}w)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`
có—y©NTrD)r¤s r Ú matchfuncz!Artist.findobj.<locals>.matchfuncs€Ør"có•—t|‰«Sr9)rÑ)r¤Úmatchs €r r•z!Artist.findobj.<locals>.matchfuncsø€Ü! ! UÓ+Ð+r"zFmatch must be None, a matplotlib.artist.Artist subclass, or a callable) rÑryÚ
issubclassrKrær­rÚoperatorÚiaddrÔÚfindobjr~)r=r—Ú include_selfr•ÚcÚartistss ` r r›zArtist.findobjésšø€ð4 ˆ=ó
ä
˜œtÔ
$¬°E¼6Ô)Bõ
,ä
�eŒ_؉Iäð7ó8ð
8ôœŸ™Ø8<×8IÑ8IÓ8KÖL°1˜!Ÿ)™) IÕ.ÒLÈbóRˆá ™I dœOØ �N‰N˜4Ô ØˆùòMsÁ-B*
có—y)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
NrD)r=r×s r rzzArtist.get_cursor_datas€ð:r"cóè—tj|«dk(rt|d«r|j|«S |ddj
d„|D««}d|zdzS#tt
f$r|g}YŒ4wxYw)ac
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, c3óDK—|]}t|t«r|d›–—Œy­w)z0.3gN)rÑr )r›Úitems r r�z,Artist.format_cursor_data.<locals>.<genexpr>Ps'èø€ò!>°DÜ$.¨t´VÔ$<ð%)¨ ;£ñ!>ùs‚ ú[ú])r0ÚndimrRr¡r Ú
IndexErrorÚjoin)r=ÚdataÚdata_strs r Úformat_cursor_datazArtist.format_cursor_data4s…€ô$ �7‰7�4‹=˜AÒ ¤'¨$Ð0NÔ"Oð×4Ñ4°TÓ:Ð :ð
Ø�Q’ð—y‘yñ!>¸Dô!>ó>ˆHà˜‘> CÑ'Ð 'øô œzÐ*ò
Ø�v’ð
ús·AÁA1Á0A1có—|jS)zƒ
Return whether this artist is queried for custom context information
when the mouse cursor moves over it.
)r{rEs r Ú
get_mouseoverzArtist.get_mouseoverTs€ð
�‰Ðr"cóÈ—t|«|_|j}|rD|jr|jj |«y|jj |«yy)a3
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)Úboolr{r:r�Úaddr’)r=Ú mouseoverr•s r Ú
set_mouseoverzArtist.set_mouseover[sO€ô˜y›/ˆŒØ
�Y‰YˆÙ
Ø�ŠØ×!Ñ!×%Ñ% dÕ+à×!Ñ!×)Ñ)¨$Õ/ð r"r9)NNN)Fr”)ZrGrHrIrcrkrUr^Ú classmethodrSr‰rŽr—ršr¥rªÚpropertyr:Úsetterr;r³r¾rÃrÇrgrËrÎrÒrÔrØrÞràrêrðrårôrørürÿrrrr rrr0rrWrr$r&r(r*r.r5rµr¶r¸r<r@rDr+rKr-rOrrTr[r]r_rbrdrirlrorqrtrvr†r‰r‹rOÚ
contextlibÚcontextmanagerr‘r›rzr«r­r²r±rDr"r rKrKtsI„ñð €Fò2ò4%Ð!ðñóðò("òHò
&>òZOò
)ò
)ðñóðð
‡[�[ñ7óð7ðñóðð ‡\�\ñ
+óð
+ó&ó(ò6Gò:(ò ,ò"ò òòò4ò$ò(Tò$#òL!òF
òòòòò òò8ó(ò8 ò"ó
#òñ0�j *ðCôE€Fòó$<ò|òòò ò?ò0òòòòò"#ò ò&ò. òò$ò&ò&ò. òò( $òò
òòð ñ"óð"ò4ò"2òò6 Lò òKð ×Ññ "óð "ó*òXò>(ò@ò0ñ.˜¨
Ó6�Ir"rKcóv— |j|ii|¥ddi¥¤ŽS#t$r|j|i|¤ŽcYSwxYw)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)r¾r )Úobjrrs r Ú_get_tightbbox_for_layout_onlyr»usT€ð 2Ø ˆs× Ñ  $ÐNÐ*M¨VÐ*MÐ5FÈÑ*MÑNÐNøÜ ò2Ø ˆs× Ñ  $Ð1¨&Ñ1Ò1ð2ús ‚š8·8có¶—eZdZdZd„Zd„Zejd«Zd„Z d„Z
d„Z e e
d„««Ze e
d „««Zd
„Zhd £Zd „Zdd„Zdd„Zd„Zd„Zy
)r\z•
A helper class to inspect an `~matplotlib.artist.Artist` and return
information about its settable properties and their current values.
có—t|t«s0tj|«rt |«}t |«r|d}||_t|t«s t|«}||_|j«|_
y)a
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) rÑrKr0rWÚlistÚlenÚoorigryÚoÚ get_aliasesÚaliasd)r=rÁs r r‰zArtistInspector.__init__‡sc€ô˜!œVÔ$Ü�{‰{˜1Œ~ܘ“G�Ü�q”6ؘ!™�AàˆŒ
ܘ!œTÔ"Ü�Q“ˆA؈Œà×&Ñ&Ó(ˆ� r"c óò—t|j«D�cgc]4}|jd«r!tt |j|««r|‘Œ6}}i}|D]˜}t |j|«}|j |«sŒ+t
jd|dd›d�tj|««jd«}|j|ddt««j|dd«Œš|Scc}w)a

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'},
}
)ryr�z`(Néz.*)`r )ÚdirrÁÚ
startswithrær‘Úis_aliasÚreÚsearchÚinspectÚgetdocÚgroupÚ
setdefaultrOr°)r=r{ÚnamesÚaliasesrÁÚpropnames r rÂzArtistInspector.get_aliases›së€ô#& d§f¡f£+ö9˜$Ø—O‘OÐ$4Ô5Ü ¤¨¯©°Ó!6Ô7òð9ˆð9ðˆØò BˆDܘ4Ÿ6™6 4Ó(ˆDØ—=‘= Ô&ØÜ—y‘y 2 d¨2¨A h Z¨tÐ!4Ü!(§¡°Ó!5ó7ß7<±u¸Q³xð
à × Ñ ˜x¨¨˜|¬S«UÓ 3× 7Ñ 7¸¸Q¸R¸Õ Að
 Bðˆùò9s˜9C4z6\n\s*(?:\.\.\s+)?ACCEPTS:\s*((?:.|\n)*?)(?:$|(?:\n\n))có0—d|z}t|j|«st|j›d|›�«‚t|j|«}t|d«r |jSt j |«}|€y|jd«ry|jj|«}|�&tjdd|jd ««S|jjd }tjd
|›d �|«}|r|jd «Sy) a/
Get the legal arguments for the setter associated with *attr*.
This is done by querying the docstring of the setter for a line that
begins with "ACCEPTS:" or ".. ACCEPTS:", and then by looking for a
numpydoc-style documentation for the setter's first argument.
zset_%sz has no function Ú
_kwarg_docNÚunknownú
Alias for z
*ú r z
(?m)^ *\*?z : (.+))rRrÁr~r‘rÓrËrÌrÇÚ_get_valid_values_regexrÊrÉÚsubrÍÚ__code__Ú co_varnames)r=Úattrr{rÁÚ docstringr—Ú
param_names r Úget_valid_valuesz ArtistInspector.get_valid_values·sþ€ð˜$‰ˆÜ�t—v‘v˜tÔ$Ü  D§F¡F 8Ð+<¸T¸FÐ!CÓDÐ DÜ�t—v‘v˜tÓ$ˆä �4˜Ô &Ø—?‘?Ð "ä—N‘N 4Ó(ˆ Ø Ð Øà × Ñ   Ô -Øà×,Ñ,×3Ñ3°IÓ>ˆØ Ð Ü—6‘6˜& # u§{¡{°1£~Ó6Ð 6ð—]‘]×.Ñ.¨qÑ1ˆ
ô— ‘ ˜Z¨
 |°7Ð;¸YÓGˆÙ Ø—;‘;˜q“>Ð !àr"cód—dddœ}|j«D]\}}|j||«}Œ|S)z€
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)r}Úreplace)r=Ú source_classÚ replace_dictÚkeyÚvalues r Ú
_replace_pathzArtistInspector._replace_pathÞsE€ð
,2Ø&,ñ.ˆ à&×,Ñ,Ó.ò <‰JˆC�Ø'×/Ñ/°°UÓ;‰Lð <àÐr"có—g}t|j«D]o}|jd«sŒt|j|«}t |«r%|j |«dks|j
|«rŒ\|j|dd«Œq|S)z¡
Get the attribute strings with setters for object.
For example, for a line, return ``['markerfacecolor', 'linewidth',
....]``.
ryérÅN)rÆrÁrÇr‘ræÚnumber_of_parametersrÈr~)r=Úsettersr{rÁs r r]zArtistInspector.get_settersés�€ðˆÜ˜Ÿ™“Kò %ˆDØ—?‘? 6Ô*Øܘ4Ÿ6™6 4Ó(ˆDܘT”NØ×0Ñ0°Ó6¸Ò:Ø—}‘} TÔ*ØØ �N‰N˜4  ˜8Õ $ð %ðˆr"cóR—ttj|«j«S)z3Return number of parameters of the callable *func*.)r¿rËÚ signatureÚ
parameters)rÁs r rëz$ArtistInspector.number_of_parametersüs €ô”7×$Ñ$ TÓ*×5Ñ5Ó6Ð6r"cóT—tj|«}|€y|jd«S)zT
Return whether the object *method* is an alias for another method.
FrÕ)rËrÌrÇ)ÚmethodÚdss r rÈzArtistInspector.is_aliass)€ô�^‰^˜FÓ
#ˆØ
ˆ:Øà�}‰}˜\Ó*Ð*r"c ó‚—djd„t|jj|g««D««}||zS)a
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'.
rfc3ó&K—|] }d|z–—Œ y­w)z or %sNrD)r›r¤s r r�z/ArtistInspector.aliased_name.<locals>.<genexpr>sèø€ÒO¨1˜( Q�,ÑOùs‚)r¨ÚsortedrÃÚget)r=rgrÐs r Ú aliased_namezArtistInspector.aliased_names6€ð—'‘'ÑO´°t·{±{·±ÀqÈ"Ó7MÓ0NÔOÓOˆØ�7‰{Ð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_interpolationú3matplotlib.image._ImageBase.set_interpolation_stageú3matplotlib.text._AnnotationBase.set_annotation_clipc 󼇗‰|jvrd|›d�Sdjˆfd„t|jj |g««D««}d|›d‰›d|›�S)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``rfc3ó0•K—|]
}d|›d‰›d�–—Œy­w)z or :meth:`ú <ú>`NrD)r›ríÚtargets €r r�z4ArtistInspector.aliased_name_rest.<locals>.<genexpr>7s'øèø€òSØ./ˆk˜!˜˜B˜v˜h bÔ )ñSùsƒz:meth:`rr)Ú
_NOT_LINKABLEr¨rõrÃrö)r=rgrrÐs ` r Úaliased_name_restz!ArtistInspector.aliased_name_rest*slø€ð �T×'Ñ'Ñ 'ؘ�s˜"�:Ð à—'‘'óSÜ39¸$¿+¹+¿/¹/È!ÈRÓ:PÓ3QôSóSˆà˜˜˜2˜f˜X R¨ yÐ1Ð1r"Ncó—|rd|z}nd}|�|j|«}|›|›d|›�Sg}t|j««D]<}|j|«}|j|«}|j |›|›d|›�«Œ>|S)a
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.
rÖrfú: )rÞrõr]r÷r~)r=rdÚ leadingspaceÚpadÚacceptsÚlinesr{s r Úpprint_setterszArtistInspector.pprint_setters;s¥€ñ ؘ Ñ$‰CàˆCØ Ð Ø×+Ñ+¨DÓ1ˆGØ�U˜4˜&  7 )Ð,Ð ,àˆÜ˜4×+Ñ+Ó-Ó.ò 4ˆDØ×+Ñ+¨DÓ1ˆGØ×$Ñ$ TÓ*ˆDØ �L‰L˜C˜5   b¨¨ Ð2Õ 3ð 4ðˆ r"c óþ—|rd|z}nd}|�|j|«}|›|›d|›�Sg}t|j««D]ƒ}|jjD]#}t |d|›�d«}|sŒ|j €Œ#nt |jd|›�«}|j||j›d|j›�f«Œ…|D��cgc]7\}}|j||«jdd«jd d«‘Œ9} }}|D��
cgc]\}}
|j|«‘Œ}}}
td
„| D««} td „|D««} |d zd
| zzd zd
| zz}
d|dz|dzd|
|d zdj| «zd zdj| «z|
gt| |«D��cgc]1\}}|d z|j| «zd z|j| «z‘Œ3c}}¢|
‘d‘Scc}}wcc}
}wcc}}w)a$
Reference in New Issue Copy Permalink