hDSrSSKrSSKrSSKrSSKJr SSKrSSKrSSK r SSK J r J r JrJr SSK Jr SSKJr SSKJrJrJr SS KJrJr SS KJrJrJrJrJrJ r \RB"\"5r#S r$S r%\RL"S 5S5r'\RP\ RR"S/SS/S/S/S/S/S/S/S/S/S/S/S. 5"SS\555r*"SS 5r+"S!S"5r,"S#S$\*\,5r-\RPR]\-R^RS%9 g)&z) Classes for including text in a figure. N)Real)_apiartistcbook _docstring)Artist)FontProperties)FancyArrowPatchFancyBboxPatch Rectangle)TextPath TextToPath)Affine2DBboxBboxBaseBboxTransformToIdentityTransform Transformc*/n/n[R"UR55n[5R U*5nUR U5upgnUHSuppU upUR X45unnUU-nX-UU-nnURUU/5 URUU/5 MU [U5[U5nn[U5U- [U5U- nn[5R U5R UU45unnUUUU4$)z Calculate the bounding box of the text. The bbox position takes text rotation into account, but the width and height are those of the unrotated box (unlike `.Text.get_window_extent`). ) npdeg2rad get_rotationrrotate _get_layout transformextendminmax)textrenderer projected_xs projected_ysthetatr_partsdtwhxywhxt1yt1xt2yt2xt_boxyt_boxw_boxh_boxx_boxy_boxs A/var/www/html/env/lib/python3.13/site-packages/matplotlib/text.py _get_textboxr:sLL JJt((* +E   E6 "B""8,KAa q<<'S q7C!GSS#J'S#J'&L(9FF|$v-s 7 7 OOr;cfontfont_propertiesfamilynamesizestretchstylevariantweighthavama) colorfontproperties fontfamilyfontnamefontsize fontstretch fontstyle fontvariant fontweighthorizontalalignmentverticalalignmentmultialignmentc^\rSrSrSrSr\"5rSrSTSSSSSSSSSSSSSS . U4S jjjr SUS jr U4S jr U4S jr Sr SrSrSrSrSrSrSrSrSrU4SjrSrSrSrSrSrU4SjrSVU4SjjrU4S jrS!r S"r!S#r"S$r#S%r$S&r%\&RNS'5r(S(r)S)r*S*r+S+r,S,r-S-r.S.r/S/r0S0r1S1r2S2r3S3r4S4r5S5r6SWS6jr7S7r8S8r9S9r:S:r;S;rS>r?S?r@S@rASArBSBrCSCrDSDrESErFSFrGSGrHSHrISIrJSJrKSKrLSLrM\NR"SM5SN5rPSOrQSPrRSQrSSRrTSSrUU=rV$)XTextPzAHandle storing and drawing of text in window or data coordinates.cXSURSURSUR<S3$)NzText(, ))_x_y_textselfs r9__repr__ Text.__repr__es)twwir$''"TZZN!<[TU]5 XsUlUlSUlUR UUUU UU UUUU UU U US9 UR U5 g)a Create a `.Text` instance at *x*, *y* with string *text*. The text is aligned relative to the anchor point (*x*, *y*) according to ``horizontalalignment`` (default: 'left') and ``verticalalignment`` (default: 'baseline'). See also :doc:`/gallery/text_labels_and_annotations/text_alignment`. While Text accepts the 'label' keyword argument, by default it is not added to the handles of a legend. Valid keyword arguments are: %(Text:kwdoc)s )r rVrWrurxrvr`r_rarrrwrsrtryN)super__init__rirjrk_reset_visual_defaultsupdate)rmr+r,r rVr`r_rarWrrrsrtrurvrwrxrykwargs __class__s r9r} Text.__init__hsq@   ##)!/ 3)#9#'# $ Fr;cdURU5 UR[R"US55 UR U5 UR U5 UR [R"US55 URU5 URU5 URU5 Xl URU 5 Xl SUl SUlU cSn URU 5 UR!U 5 UR#UbU5 g[R$S5 g)Nz text.colorztext.parse_mathg333333?ztext.antialiased)set_text set_colormpl _val_or_rcset_fontproperties set_usetexset_parse_mathset_wrapset_verticalalignmentset_horizontalalignment_multialignment set_rotation_transform_rotates_text _bbox_patch _rendererset_linespacingset_rotation_modeset_antialiasedrcParams)rmr rVrWrurxrvr`r_rarrrwrsrtrys r9r~Text._reset_visual_defaultss" d s~~e\:; /  CNN:7HIJ d ""#45 $$%89- (#'=$  K [) }- K,C[ ? \\*<= ?r;cj>/n[R"U[5n[5nUR SU5nXCLa UR UR U55 UR SU5nUR[TU]%U55 XSLa UR URU55 U$)NrWbbox) rnormalize_kwargsrcobjectpopappendrrr|rset_bbox)rmrretsentinelrWrrs r9r Text.updates''58$4h?  ) JJt..~> ?zz&(+ 57>&)*   JJt}}T* + r;c.>[TU]5nSUS'U$)Nr)r| __getstate__)rmr(rs r9rText.__getstate__s G "+r;cURU5(d"UR5(a URcS04$[R U5nUR UR s=:*=(a UR:*Os =(a3 URURs=:*=(a UR:*Os n0nUR(a,URRU5upVU=(d UnXdS'X44$)z[ Return whether the mouse event occurred inside the axis-aligned bounding-box of the text. F bbox_patch) _different_canvas get_visiblerrcget_window_extentx0r+x1y0r,y1rcontains)rm mouseeventrinsidecattr patch_inside patch_cattrs r9r Text.containss  " ": . .d6F6F6H6H>>)"9 %%d+''Z\\44TWW49gg888    (,(8(8(A(A*(M %L+|F"-, }r;cfUR5upUR5RX45$)zG Get the (possibly unit converted) transformed x, y in display coords. )get_unitless_position get_transformrrmr+r,s r9_get_xy_displayText._get_xy_displays0))+!!#--qf55r;cLURb UR$UR$rF)r_horizontalalignmentrls r9_get_multialignmentText._get_multialignments&    +'' ',, ,r;cUR(dgURn[UR5nU[R;a[ 5[RU'[RUn[ U5HFnXT;dM URU5 UR5nURUR- XE'MH URU5 UR5n[R"S/UVs/sHoUPM sn-5nWUR- n[R"Xx- 5R5$s snf)z Calculate the index closest to the coordinate x in display space. The position of text[index] is assumed to be the sum of the widths of all preceding characters text[:index]. This works only on single line texts. r)rkstr_fontpropertiesrc_charsize_cachedictsetrrrrrcumsumabsargmin) rmr+r rWcharsize_cachecharbb size_accumstd_xs r9_char_index_atText._char_index_ats zzzzT112 !5!5 5376D  0--n=ID) d#++-')uuruu}$  d  # # %YYs%FAQ&7%FFG BEE z)*2244&GsE cUR5(aIUR5RUR/UR 5/5R S5$UR$)z3Return the text angle in degrees between 0 and 360.r)get_transform_rotates_textrtransform_angles _rotationritemrls r9rText.get_rotations\  * * , ,%%'88 4#=#=#?"@BBF$q' J>> !r;cUR$)zF Return whether rotations of the transform affect the text direction. )rrls r9rText.get_transform_rotates_text$s+++r;cTUcSnO[R"SUS9 XlSUlg)aM Set text rotation mode. Parameters ---------- m : {None, 'default', 'anchor'} If ``"default"``, the text will be first rotated, then aligned according to their horizontal and vertical alignments. If ``"anchor"``, then alignment occurs before rotation. Passing ``None`` will set the rotation mode to ``"default"``. Ndefault)anchorr)rtT)r check_in_list_rotation_modestale)rmms r9rText.set_rotation_mode*s, 9A   4A F r;cUR$)zReturn the text rotation mode.)rrls r9get_rotation_modeText.get_rotation_mode=s"""r;cXlSUlg)z Set whether to use antialiased rendering. Parameters ---------- antialiased : bool Notes ----- Antialiasing will be determined by :rc:`text.antialiased` and the parameter *antialiased* will have no effect if the text contains math expressions. TN) _antialiasedr)rmrys r9rText.set_antialiasedAs( r;cUR$)z-Return whether antialiased rendering is used.)rrls r9get_antialiasedText.get_antialiasedRs   r;c>[TU]U5 URUlURUlURUlUR UlUR R5UlURUlURUl URUl URUl URUl URUl SUlg)NT)r| update_from_colorr_verticalalignmentrrr@_usetexrr_picker _linespacingrr)rmotherrs r9rText.update_fromVs E"ll $44"'":":$)$>$>!$4499;}} ','D'D$}} !..!.. r;c Sup#UR5RS5n/n/n/n/n[USURUR 5(aSOSUR SS9R S9upn X- UR-n [U5HupURU5unnU(a2[XURUUR SS9R S9unnnOS =n=nn[UU 5n[UU 5nURU5 URU5 UU- U- nU S :XaUU- *nOU[U UU- UR-5-nURU5 URU5 UU-nM Wn[U5nS nUnS nUS U- n[5RUR55nUR5nUS :Xa#[!Xx5VVs/sH unnUU4PM nnnOkUS :Xa3[!XxU5VVVs/sHunnnUUS - -US - - U4PM nnnnO2US:Xa,[!XxU5VVVs/sHunnnUU-U- U4PM nnnn["R$"UU4UU4UU4UU4/5n UR'U 5n!U!SS2S 4R)5nU!SS2S 4R5nU!SS2S4R)5nU!SS2S4R5nUU- nUU- n"UR*n#UR,n$UR/5n%U%S:waSU#S :Xa UU-S - n&O U#S:XaUn&OUn&U$S :Xa UU-S - n'OU$S:XaUn'OU$S:XaUU-n'OU$S:Xa UU"-WS- - n'OxUn'OuU S un(n)U S un*n+U#S :Xa U(U*-S- n&O U#S:XaU*n&OU(n&U$S :Xa U)U+-S- n'O&U$S:XaU+n'OU$S:XaU+W- n'OU$S:Xa U+WS- - n'OU)n'UR'U&U'45un&n'UU&-nUU'-n[0R2"UUUU"5n,UR'W5U&U'4- n-U,[5[!U[!XV5/U-R6Q765U4$s snnfs snnnfs snnnf)z Return the extent (bbox) of the text together with multiple-alignment information. Note that it returns an extent of a rotated text when necessary. )r lpTeXFTroot)rBrCrrqcenterrightNrrtoprpcenter_baselineg@)_get_wrapped_textsplitrDr get_usetex get_figurerCr enumerate_preprocess_mathrrr rotate_degrrziprarrayrrrrrr from_boundslistT).rmr!thisxthisylineswshsxsysr&lp_hlp_dmin_dyiline clean_linerBr-r.r(rpdescentwidthxminxmaxymaxyminMmalignr+r, offset_layout corners_horizcorners_rotatedheighthalignvalignrtoffsetxoffsetyxmin1ymin1xmax1ymax1rxyss. r9rText._get_layoutfs  &&(..t4    5 dD00 OO--55T*..0 +!2!22 'GA!%!6!6t!< J6$*>*>!tD'A'E'EG1a  A At AAt A IIaL IIaLAHAva%Va!et/@/@%@AA IIe  IIe  QJE?(DB"v J ! !$"3"3"5 6))+ V 03B < 1aV M GW  dE6:kk-(GW+==T#eS[93559:GCCa===s'QQ! Q(cbUbUR5nURSS5nURSS5nUcSnUcSnX@R5-nOUcSn[U[5(aSU;aUSU-- n[ SU[ 5S .UD6UlOSUlUR5 g) a8 Draw a bounding box around self. Parameters ---------- rectprops : dict with properties for `.patches.FancyBboxPatch` The default boxstyle is 'square'. The mutation scale of the `.patches.FancyBboxPatch` is set to the fontsize. Examples -------- :: t.set_bbox(dict(facecolor='red', alpha=0.5)) Nboxstylepadsquareg333333?z ,pad=%0.2f)rrrr)r.r) r@rget_size isinstancerr rr_update_clip_properties)rm rectpropspropsr.r/s r9r Text.set_bboxs"  NN$EyyT2H))E4(C#;C}}&;C(C((U(-BL3..- K!->-@ KDI KD  $D  $$&r;cUR$)zN Return the bbox Patch, or None if the `.patches.FancyBboxPatch` is not made. )rrls r9get_bbox_patchText.get_bbox_patch&s r;cpUR(Ga$[URUR55n[UR UR 55nUR 5RX#45up#[X5upEpgURRSSXg5 URR[5RUR55RX$-X5-55 URUR!55nURR#U5 gg)z Update the location and the size of the bbox. This method should be used when the position and size of the bbox needs to be updated before actually drawing the bbox. rN)rfloatconvert_xunitsriconvert_yunitsrjrrr: set_bounds set_transformrrr translatepoints_to_pixelsr3set_mutation_scale) rmr!posxposyr7r8r5r6fontsize_in_pixels r9update_bbox_position_sizeText.update_bbox_position_size-s    ,,TWW56D,,TWW56D++-77 EJD)5d)E &E%    ' 'B =    * * D--/04<6 8!) 9 9$--/ J     / /0A B r;cUR(aE[URURURS9nURR U5 gg)N)clip_box clip_pathclip_on)rrclipbox _clippath_cliponr)rm clippropss r9r5Text._update_clip_propertiesDsD   dll'+~~%)\\3I    # #I . r;cD>[TU]U5 UR5 grF)r| set_clip_boxr5)rmrNrs r9rTText.set_clip_boxKs W% $$&r;cD>[TU]X5 UR5 grF)r| set_clip_pathr5)rmpathrrs r9rWText.set_clip_pathPs d. $$&r;cD>[TU]U5 UR5 grF)r| set_clip_onr5)rmbrs r9r[Text.set_clip_onUs A $$&r;cUR$)z'Return whether the text can be wrapped._wraprls r9get_wrap Text.get_wrapZ zzr;cXlg)a Set whether the text can be wrapped. Wrapping makes sure the text is confined to the (sub)figure box. It does not take into account any other artists. Parameters ---------- wrap : bool Notes ----- Wrapping does not work together with ``savefig(..., bbox_inches='tight')`` (which is also used internally by ``%matplotlib inline`` in IPython/Jupyter). The 'tight' setting rescales the canvas to accommodate all content and happens before wrapping. Nr_)rmrvs r9r Text.set_wrap^s & r;cUR5RUR55upUR5R 5nUR 5nUR S5 UR5nURXQX#5nURSU-S-XU5nUS:XaUnU$US:XaUnU$S[Xg5-nU$)zS Return the maximum line width for wrapping text based on the current orientation. rhrqrr) rr get_positionrrget_horizontalalignmentrr_get_dist_to_boxr) rmrr figure_box alignmentrrrqr line_widths r9_get_wrap_line_widthText._get_wrap_line_widthss ##%//0A0A0CD__&88: 002  x($$&$$X2B%% 8^s "BJ8  J  ' !JS--Jr;cUS:a}US- nX4R- [R"[R"U55- nURU- [R"[R"SU- 55- nGOzUS:a{US- nX$R - [R"[R"U55- nX4R- [R"[R"SU- 55- nOUS:a|US- nUR U- [R"[R"U55- nX$R - [R"[R"SU- 55- nOwURU- [R"[R"U55- nUR U- [R"[R"SU- 55- n[Xg5$)zZ Return the distance from the given points to the boundaries of a rotated box, in pixels. iZrg)rmathcosradiansrrrr)rmrrrrrlquadh1h2s r9rkText._get_dist_to_boxsn c>c>D}}$d1C(DDB--"$b4i1H(IIB ^c>D}}$d1C(DDB}}$b4i1H(IIB ]b=D--"$d1C(DDB}}$b4i1H(IIB--"$h1G(HHB--"$b8m1L(MMB2{r;cURRUUR5[R"U55up#n[ R "U5$)z5 Return the width of a given text string, in pixels. )rrGget_fontpropertiesr is_math_textrsceil)rmr r-r.r(s r9_get_rendered_text_widthText._get_rendered_text_widthsI ..>>   # # %   t $&ayy|r;c TUR5(dUR5$UR5(aUR5$UR5n/nUR5R S5nUGHnUR S5n[ U5S:dM&[ U5S:Xa"UR URS55 MB[S[ U5S-5HnSRUSU5nURU5nX:a/UR SRUSUS- 55 XVS- Sn O:U[ U5:XdMmUR SRUSU55 /n O [ U5S:aMGM SRU5$)z Return a copy of the text string with new lines added so that the text is wrapped relative to the parent figure (if `get_wrap` is True). r rrrN) raget_textrrorlenrrrangejoinr~) rmrn wrapped_linesunwrapped_linesunwrapped_line sub_wordsrr current_widths r9rText._get_wrapped_texts }}==? " ??  ==? "..0  --///5.N&,,S1Ii.1$y>Q&!((q)9:q#i.1"45A88IbqM2D$($A$A$$GM%1%,,SXXiQ6G-HI$-!ef$5 c)n,%,,SXXim-DE$& !6 i.1$$ .8yy''r;c  UbXlUR5(dgUR5S:XagURSUR 55 UR UR 5S9 URU5up#nUR5nURURpv[RRU5(a[Rn[RRU5(a[Rn[UR!U55n[UR#U55n UR%X45up[R&"U5(d[R&"U 5(a SSS5 g[R("U5(a[R("U 5(d[*R-S5 SSS5 gUR/5upUR0(a,UR3U5 UR0R5U5 UR75n U R9UR;55 U R=UR?55 U RAURB5 U REURF5 URIU 5 URK5n UHuppg[MU5S:XaUOSnXh-nXy-nURO5(aX- nURQU5unnURS5(aSSK*J+n U"URS5U5nOUnURY5(a UR[XUUUR\U US9 MUR_XUUUR\U UUS 9 M SSS5 W Ra5 URcS5 S Ul2g!,(df  N7=f) Nr{r )r z%posx and posy should be finite valuesrr)PathEffectRenderer)mtext)rBrF)3rrr open_groupget_gid_cm_setrrrrirjrrU is_maskednanr=r>r?risnanisfinite_logwarningget_canvas_width_heightrrHdrawnew_gcset_foreground get_color set_alpha get_alphaset_url_urlrr _set_gc_cliprrflipyrget_path_effectsmatplotlib.patheffectsrrdraw_texr draw_textrestore close_groupr)rmr!rinfortransr+r,rErFcanvaswcanvashgcanglerr*rrrBr textrenderers r9r Text.draws.  %N!!  ==?b FDLLN3 \\t557\ 8"&"2"28"< D&&(E77DGGquuq!!FFuuq!!FF,,Q/0D,,Q/0D$6JDxx~~$9 8 ;;t$$BKK,=,= DE%9 8& (??A G..x8  %%h/"B   dnn. / LL) * JJtyy !   t00 1   b !%%'E"&! #D QDHH>>## A%)%:%:4%@" F((**I#5--/$;L$,L??$$ ))"J*.*>*>05*7!**2!Z+/+?+?28+G+#'I9z V$ 9 8s2D#O5A O53GO55 PcUR$)zReturn the color of the text.)rrls r9rText.get_color0s {{r;cUR$)z*Return the `.font_manager.FontProperties`.)rrls r9r{Text.get_fontproperties4s###r;c6URR5$)zs Return the list of font families used for font lookup. See Also -------- .font_manager.FontProperties.get_family )r get_familyrls r9get_fontfamilyText.get_fontfamily8##..00r;c6URR5$)z\ Return the font name as a string. See Also -------- .font_manager.FontProperties.get_name )rget_namerls r9 get_fontnameText.get_fontnameBs##,,..r;c6URR5$)z^ Return the font style as a string. See Also -------- .font_manager.FontProperties.get_style )r get_stylerls r9 get_fontstyleText.get_fontstyleLs##--//r;c6URR5$)zh Return the font size as an integer. See Also -------- .font_manager.FontProperties.get_size_in_points )rget_size_in_pointsrls r9 get_fontsizeText.get_fontsizeVs##6688r;c6URR5$)zb Return the font variant as a string. See Also -------- .font_manager.FontProperties.get_variant )r get_variantrls r9get_fontvariantText.get_fontvariant`##//11r;c6URR5$)zl Return the font weight as a string or a number. See Also -------- .font_manager.FontProperties.get_weight )r get_weightrls r9get_fontweightText.get_fontweightjrr;c6URR5$)zn Return the font stretch as a string or a number. See Also -------- .font_manager.FontProperties.get_stretch )r get_stretchrls r9rText.get_stretchtrr;cUR$)z[ Return the horizontal alignment as a string. Will be one of 'left', 'center' or 'right'. )rrls r9rjText.get_horizontalalignment~s (((r;c[URUR55n[URUR55nX4$)z0Return the (x, y) unitless position of the text.)r=r>rir?rjrs r9rText.get_unitless_positions= $%%dgg. / $%%dgg. /t r;c2URUR4$)z'Return the (x, y) position of the text.)rirjrls r9riText.get_positionswwr;cUR$)zReturn the text string.)rkrls r9r Text.get_textrcr;cUR$)zx Return the vertical alignment as a string. Will be one of 'top', 'center', 'bottom', 'baseline' or 'center_baseline'. )rrls r9get_verticalalignmentText.get_verticalalignments &&&r;cUR5(d[R"5$URSS9nUc URnUR 5S:XaH[ R"X2S9 UR5upE[R"XESS5sSSS5 $UbXl URcUR5Ul URc [S5e[ R"X2S9 URUR5upgnUR5upUR5R!X45upUR#X5nUsSSS5 $!,(df  N=f!,(df  g=f)a; Return the `.Bbox` bounding the text, in display units. In addition to being used internally, this is useful for specifying clickable regions in a png file on a web page. Parameters ---------- renderer : Renderer, optional A renderer is needed to compute the bounding box. If the artist has already been drawn, the renderer is cached; thus, it is only necessary to pass this argument when calling `get_window_extent` before the first draw. In practice, it is usually easier to trigger a draw first, e.g. by calling `~.Figure.draw_without_rendering` or ``plt.show()``. dpi : float, optional The dpi value for computing the bbox, defaults to ``self.get_figure(root=True).dpi`` (*not* the renderer dpi); should be set e.g. if to match regions with a figure saved with a custom dpi value. TrNr{)rCrzoCannot get window extent of text w/o renderer. You likely want to call 'figure.draw_without_rendering()' first.)rrunitrrCrr _setattr_cmrrr _get_renderer RuntimeErrorrrrr translated) rmr!rCfigtxtyrrrr+r,s r9rText.get_window_extentsJ,!!99; oo4o( ;''C ==?b ""30--/''1510  %N >> ! ..0DN >> !HI I  s ,"&"2"24>>"B D--/DA%%'111&9DA??1(D - ,10- ,s1*E+`. See Also -------- get_math_fontfamily N)rset_math_fontfamily)rmrXs r9rText.set_math_fontfamilyrs( 00<< 6DLReturn whether mathtext parsing is considered for this `Text`.)rHrls r9r;Text.get_parse_mathQsr;c&URU5 g)z Alias for `set_fontfamily`. One-way alias only: the getter differs. Parameters ---------- fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} See Also -------- .font_manager.FontProperties.set_family N)rrs r9 set_fontnameText.set_fontnameUs H%r;)rrrrrrrrHrrrrrkrrrr`rirjr)rrr{)r{NNNNFrprqNNFNNNrFNN)W__name__ __module__ __qualname____firstlineno____doc__zorderrrrnr}r~rrrrrrrrrrrrrrrr:rHr5rTrWr[rarrorkr~rrallow_rasterizationrrr{rrrrrrrrjrrirrrrrrrrrrr rrrrrr#r r!rr2rrrrr kwarg_docrrrr;rM__static_attributes__ __classcell__rs@r9rcrcPs& L FfO=!#3#-%+ $ $!#(- !33n $"$#?J  .6- 5@", &#"! VDp&'P C./' ' ' *4. 1(f K KZ$1/09212) '/b(   0  $ :=,""   *  "00 <= >  , &&r;rcc4\rSrSrSrS SjrSrSrSrSr g) OffsetFromihz4Callable helper class for working with `Annotation`.cJXlUupEXE4UlURU5 g)a  Parameters ---------- artist : `~matplotlib.artist.Artist` or `.BboxBase` or `.Transform` The object to compute the offset from. ref_coord : (float, float) If *artist* is an `.Artist` or `.BboxBase`, this values is the location to of the offset origin in fractions of the *artist* bounding box. If *artist* is a transform, the offset origin is the transform applied to this value. unit : {'points, 'pixels'}, default: 'points' The screen units to use (pixels or points) for the offset input. N)_artist _ref_coordset_unit)rmr ref_coordrr+r,s r9r}OffsetFrom.__init__ks%$ $ dr;c>[R"SS/US9 Xlg)zr Set the unit for input to the transform used by ``__call__``. Parameters ---------- unit : {'points', 'pixels'} pointspixels)rN)rr_unit)rmrs r9r`OffsetFrom.set_units Hh/d; r;cUR$)z@Return the unit for input to the transform used by ``__call__``.)rfrls r9get_unitOffsetFrom.get_unitrcr;cj[UR[5(abURRU5nURup4UR UR U--nURURU--nO[UR[5(aSURnURup4UR UR U--nURURU--nOu[UR[5(a(URRUR5upVO.[R"[[[4URS9 URS:XaSOURS5n[!5R#U5R%WW5$)z Return the offset transform. Parameters ---------- renderer : `RendererBase` The renderer to use to compute the offset Returns ------- `Transform` Maps (x, y) in pixel or point units to screen units relative to the given artist. )rrer)r4r^r rr_rrrr"rrrrrrfrCrscalerB)rmr!rxfyfr+r,rls r9__call__OffsetFrom.__call__s8 dllF + +<<11(;D__FB$**r/)A$++**A  h / /<. 7r;r\cT\rSrSrS SjrSrSrSrSrSr S S jr SS jr S r g)_AnnotationBaseiNcXUupEXE4UlX lURU5 SUlgrF)r"xycoordsset_annotation_clip _draggable)rmr"ruannotation_clipr+r,s r9r}_AnnotationBase.__init__s. $    1r;cUupE[U[5(aUOX34upgUS:Xa[URU55nUS:Xa[UR U55nUR X5R XE45$)Ndata)r4tupler=r>r?_get_xy_transformr)rmr!r"coordsr+r,xcoordycoords r9_get_xy_AnnotationBase._get_xysy#-fe#<#<6BR V d))!,-A V d))!,-A%%h7AA1&IIr;c[U[5(a4Uup4SSKJn UR X5nUR X5nU"Xg5$[ U5(a`U"U5n[U[ 5(a [U5$[U[5(aU$[S[U5R35e[U[5(aURU5n [U 5$[U[ 5(a [U5$[U[5(aU$[U[5(d![S[U5R35eUS:XaURR $US:Xa/SSKJn U R'SS 9nXRR -n U $UR)5upS upU S :XaUR-SS 9R.nO6nO[+U <S35eUR@"U6$![*a [+U<S 35Sef=f)Nr)blended_transform_factoryz=xycoords callable must return a BboxBase or Transform, not a z^'xycoords' must be an instance of str, tuple[str, str], Artist, Transform, or Callable, not a r{polar) PolarAxesF)apply_theta_transformsz is not a valid coordinaterOfigurer subfigureaxesoffsetrdTHrerZfractionz is not a recognized unit)!r4r|matplotlib.transformsrr}callablerrr TypeErrortyperPr rrr transDatamatplotlib.projectionsrPolarTransformrr-rfigbboxrp0_get_position_xyrrlrCr3rNrB)rmr!r~rrrtr1tr2r%rrr bbox_namerbbox0xy0s r9r}!_AnnotationBase._get_xy_transforms fe $ $#NF G((:C((:C,S6 6 f  !B"h''&r**B ** SBx(()+,, ' '++H5D"4( (  ) )"6* *  * *MFC((115f1F1F0GIJ J V 99&& & w  8)))GB,,,EL P$llnOI   OOO/77E + %OOO/44E & IINNE  ((C ( "''1Cz)CDE E 8 !!T*..35B X B Z !! $//t/"<"@"@@2EGB Z !!5::.Bx'@AB B||S!!E Pz)CDE4 O Ps *L//M cXlg)aQ Set the annotation's clipping behavior. Parameters ---------- b : bool or None - True: The annotation will be clipped when ``self.xy`` is outside the Axes. - False: The annotation will always be drawn. - None: The annotation will be clipped when ``self.xy`` is outside the Axes and ``self.xycoords == "data"``. N_annotation_clip)rmr\s r9rv#_AnnotationBase.set_annotation_clips !"r;cUR$)zi Return the annotation's clipping behavior. See `set_annotation_clip` for the meaning of return values. rrls r9get_annotation_clip#_AnnotationBase.get_annotation_clip#s $$$r;cNURXRUR5$)z1Return the pixel position of the annotated point.)rr"ru)rmr!s r9r _AnnotationBase._get_position_xy+s||Hggt}}==r;cUcURSS9R5nUR5nU(dUc<URS:Xa,UR U5nUR R U5$g)z;Check whether the annotation at *xy_pixel* should be drawn.Trr{)rrrrurrcontains_point)rmr!r\xy_pixels r9 _check_xy_AnnotationBase._check_xy/si  D1??AH  $ $ & t}}6,,X6H99++H5 5r;c SSKJn URSLnUcU(+nU(a&URc U"X5UlUR$URbURR5 SUlUR$)a Set whether the annotation is draggable with the mouse. Parameters ---------- state : bool or None - True or False: set the draggability. - None: toggle the draggability. use_blit : bool, default: False Use blitting for faster image composition. For details see :ref:`func-animation`. Returns ------- DraggableAnnotation or None If the annotation is draggable, the corresponding `.DraggableAnnotation` helper is returned. r)DraggableAnnotationN)matplotlib.offsetboxrrw disconnect)rmstateuse_blitr is_draggables r9 draggable_AnnotationBase.draggable:sv& =d2  =$$E &"5d"E  ***,"DOr;)rrwr"ru)r{NrFNF) rPrQrRrSr}rr}rvrrrrrXrqr;r9rsrss5!!% JJ"X "%> "r;rsc^\rSrSrSrSrSSjrSr\S5r \ RS5r \S5r \ RS 5r S r S r \"\ \ S S 9rSrSr\R$S5rSSjrSU4SjjrSrU=r$) Annotationi_a4 An `.Annotation` is a `.Text` that can refer to a specific position *xy*. Optionally an arrow pointing from the text to *xy* can be drawn. Attributes ---------- xy The annotated position. xycoords The coordinate system for *xy*. arrow_patch A `.FancyArrowPatch` to point from *xytext* to *xy*. chSURSSSURSSSUR<S3$)Nz Annotation(rgrgrrh)r"rkrls r9__str__Annotation.__str__ns5TWWQZN"TWWQZN"TZZN!LLr;c [RUUUUS9 UcUbXT:wa[R"S5 Uc URnXPlUc UR nUupX`lUbZUR5nSU;aURSS5Ul OSHn URU S5 M [S0UD6Ul OSUl [R"X X40UD6 g) a Annotate the point *xy* with text *text*. In the simplest form, the text is placed at *xy*. Optionally, the text can be displayed in another position *xytext*. An arrow pointing from the text to the annotated point *xy* can then be added by defining *arrowprops*. Parameters ---------- text : str The text of the annotation. xy : (float, float) The point *(x, y)* to annotate. The coordinate system is determined by *xycoords*. xytext : (float, float), default: *xy* The position *(x, y)* to place the text at. The coordinate system is determined by *textcoords*. xycoords : single or two-tuple of str or `.Artist` or `.Transform` or callable, default: 'data' The coordinate system that *xy* is given in. The following types of values are supported: - One of the following strings: ==================== ============================================ Value Description ==================== ============================================ 'figure points' Points from the lower left of the figure 'figure pixels' Pixels from the lower left of the figure 'figure fraction' Fraction of figure from lower left 'subfigure points' Points from the lower left of the subfigure 'subfigure pixels' Pixels from the lower left of the subfigure 'subfigure fraction' Fraction of subfigure from lower left 'axes points' Points from lower left corner of the Axes 'axes pixels' Pixels from lower left corner of the Axes 'axes fraction' Fraction of Axes from lower left 'data' Use the coordinate system of the object being annotated (default) 'polar' *(theta, r)* if not native 'data' coordinates ==================== ============================================ Note that 'subfigure pixels' and 'figure pixels' are the same for the parent figure, so users who want code that is usable in a subfigure can use 'subfigure pixels'. - An `.Artist`: *xy* is interpreted as a fraction of the artist's `~matplotlib.transforms.Bbox`. E.g. *(0, 0)* would be the lower left corner of the bounding box and *(0.5, 1)* would be the center top of the bounding box. - A `.Transform` to transform *xy* to screen coordinates. - A function with one of the following signatures:: def transform(renderer) -> Bbox def transform(renderer) -> Transform where *renderer* is a `.RendererBase` subclass. The result of the function is interpreted like the `.Artist` and `.Transform` cases above. - A tuple *(xcoords, ycoords)* specifying separate coordinate systems for *x* and *y*. *xcoords* and *ycoords* must each be of one of the above described types. See :ref:`plotting-guide-annotation` for more details. textcoords : single or two-tuple of str or `.Artist` or `.Transform` or callable, default: value of *xycoords* The coordinate system that *xytext* is given in. All *xycoords* values are valid as well as the following strings: ================= ================================================= Value Description ================= ================================================= 'offset points' Offset, in points, from the *xy* value 'offset pixels' Offset, in pixels, from the *xy* value 'offset fontsize' Offset, relative to fontsize, from the *xy* value ================= ================================================= arrowprops : dict, optional The properties used to draw a `.FancyArrowPatch` arrow between the positions *xy* and *xytext*. Defaults to None, i.e. no arrow is drawn. For historical reasons there are two different ways to specify arrows, "simple" and "fancy": **Simple arrow:** If *arrowprops* does not contain the key 'arrowstyle' the allowed keys are: ========== ================================================= Key Description ========== ================================================= width The width of the arrow in points headwidth The width of the base of the arrow head in points headlength The length of the arrow head in points shrink Fraction of total length to shrink from both ends ? Any `.FancyArrowPatch` property ========== ================================================= The arrow is attached to the edge of the text box, the exact position (corners or centers) depending on where it's pointing to. **Fancy arrow:** This is used if 'arrowstyle' is provided in the *arrowprops*. Valid keys are the following `.FancyArrowPatch` parameters: =============== =================================== Key Description =============== =================================== arrowstyle The arrow style connectionstyle The connection style relpos See below; default is (0.5, 0.5) patchA Default is bounding box of the text patchB Default is None shrinkA In points. Default is 2 points shrinkB In points. Default is 2 points mutation_scale Default is text size (in points) mutation_aspect Default is 1 ? Any `.FancyArrowPatch` property =============== =================================== The exact starting point position of the arrow is defined by *relpos*. It's a tuple of relative coordinates of the text box, where (0, 0) is the lower left corner and (1, 1) is the upper right corner. Values <0 and >1 are supported and specify points outside the text box. By default (0.5, 0.5), so the starting point is centered in the text box. annotation_clip : bool or None, default: None Whether to clip (i.e. not draw) the annotation when the annotation point *xy* is outside the Axes area. - If *True*, the annotation will be clipped when *xy* is outside the Axes. - If *False*, the annotation will always be drawn. - If *None*, the annotation will be clipped when *xy* is outside the Axes and *xycoords* is 'data'. **kwargs Additional kwargs are passed to `.Text`. Returns ------- `.Annotation` See Also -------- :ref:`annotations` )rurxNzgYou have used the `textcoords` kwarg, but not the `xytext` kwarg. This can lead to surprising results. arrowstylerelpos)?r)r headwidth headlengthshrink)r2)rr)rsr}r warn_externalru _textcoordsr" arrowpropsr@r _arrow_relposr arrow_patchrc) rmr r"xytextru textcoordsrrxrr+r,keys r9r}Annotation.__init__qsX   !#*21@ ! B N&&    5 6  J% >WWF$  !#*Jz)%/^^Hj%I"JCNN3-J.LLD #D  dq1&1r;cURU5(aS04$[RX5up#URb(URRU5upEU=(d UnX#4$r)rrcrr)rmrrtinfoin_patchr&s r9rAnnotation.containsCsc  ! !* - -"9 --9    '**33J?KH+8Hr;cUR$rF) _xycoordsrls r9ruAnnotation.xycoordsLs ~~r;cSn[U[5(a[[X!55(d U"U5(a [ S5eXlg)NcR[U[5=(a URS5$)Nr)r4r startswith)r/s r9 is_offset&Annotation.xycoords..is_offsetRsa%@!,,x*@ @r;z'xycoords cannot be an offset coordinate)r4r|anymapr-r)rmrurs r9rurPsB A x ' 'CI0H,I,IX&&FG G!r;c"UR5$)z9 The text position. See also *xytext* in `.Annotation`. )rirls r9xyannAnnotation.xyannZs  ""r;c&URU5 grF)r#)rmrs r9rrcs &!r;cUR$)ze Return the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. rrls r9 get_anncoordsAnnotation.get_anncoordsgs r;cXlg)zb Set the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. Nr)rmr~s r9 set_anncoordsAnnotation.set_anncoordsos "r;z> The coordinate system to use for `.Annotation.xyann`.)doccURbURRU5 [R"X5 grF)r set_figurer )rmrs r9rAnnotation.set_figurezs0    '    ' ' ,$$r;c$^^URURXR55 URnUcg[R X5nUR U5=nummURSUR55nURRU5 SU;GagURSS5nURSS5nURSS 5nURS S 5n [X- X- Xu- S 9n URR"S0U D6 URS 4URUR-S - S4URS4/n URS 4URUR -S - S4UR S4/n [#U U4SjS9up[#U U4SjS9unnUU4Ul[&R("UT- U T- 5nUU-UR+S5- nU=URlURlUR0UR2UR$--nURR5UU5 SU;aUSnOUR6(a UR6nOyUR95S:XaSnObUR+S5n[;URUS - - URUS - - 4UR<U-UR>U-[A5SS9nURRCU5 g)zH Update the pixel positions of the annotation text and the arrow patch. Nmutation_scalerrrrr1r r) head_length head_width tail_widthrrrrc&>[UST- 5$Nrr)vrs r9-Annotation.update_positions..QqTBYr;)rc&>[UST- 5$rr)rrs r9rrrr;patchAr{F)r"rr"rrM)simple)"rAr} anncoordsrrcrrgetr3rrDrset_arrowstylerrrrrrrhypotrCshrinkAshrinkBrrN set_positionsrrr rr"r set_patchA)rmr!rr arrow_endmsrrrrstylekwxposyposr+relposxr,relposyr shrink_pts arrow_beginrr/rrs @@r9update_positionsAnnotation.update_positionss 411(NNKL__   %%d5!228<< FB ^^,dmmo > ++B/ z )^^Hc2FNN7A.E"{B7I# b9Jz&/n&+j2G    + + @ @WWaLDGGdgg$5#:C"@477A,ODWWaLDGGdgg$5#:C"@477A,ODT'?@JAT'?@JAw")7!3D RR(A!h&?&?&BBJBL LD   $t'7'7'?gg D,>,> >>  &&{I> z !)F   %%F ]]_ "F++A.CGGcAg%twwq'89jj3&t{{S/@+-u>F ##F+r;cUbXlUR5(aURU5(dgURU5 UR U5 UR bbUR R SS9c-UR SS9=nbUR RU5 UR RU5 [RX5 g)NFr) rrrr rHrrrrrc)rmr!rs r9rAnnotation.draws  %N!!)A)A  h' &&x0    '  +++7? OOO77SD  ++C0    ! !( + $!r;c UR5(aURU5(d[R"5$UbXlURc"UR SS9R 5UlURc [S5eURUR5 [RU5nU/nURb)URURR55 [R"U5$)NTrz)Cannot get window extent without renderer)rrrrrrrrr rcrrrunion)rmr! text_bboxbboxess r9rAnnotation.get_window_extents!!)A)A99;   %N >> !!__$_7EEGDN >> !JK K dnn-**40     ' MM$**<<> ?zz&!!r;cx>URU5(d[R"5$[TU]U5$rF)rrnullr| get_tightbbox)rmr!rs r9rAnnotation.get_tightbboxs.~~h''99; w$X..r;)rrrrrr)Nr{NNNrF)rPrQrRrSrTrr}rpropertyrusetterrrrrrr rrVrrrrXrYrZs@r9rr_s M   !% P2d__""## \\"" " numpyr matplotlibrr{rrrrr font_managerr patchesr r r textpathrr transformsrrrrrr getLoggerrPrr:rD lru_cacher=interpddefine_aliasesrcr\rsrregisterr}rqr;r9r(sN --(??*MM"$&NC TPP  U01*;;* 6f  F&6F& F&R(G7G7TjjZQ/Q/h  z':':'B'BCr;