G8cvdZddlZddlZddlZddlmZddlZddlZddl Z ddl m Z m Z mZmZddl mZddlmZddlmZmZmZdd lmZdd lmZmZmZmZmZmZej@e!Z"e jFd d Z$d Z%dZ&ejNddZ(ejRe jTdgdgddgdgdgdgdgdgdgdgdgdgd Gdd eZ+Gd!d"Z,Gd#d$Z-Gd%d&e+e-Z.ejRj_e.j`j'y)(z) Classes for including text in a figure. N)Real)_apiartistcbook _docstring)Artist)FontProperties)FancyArrowPatchFancyBboxPatch Rectangle)TextPath)Affine2DBboxBboxBaseBboxTransformToIdentityTransform Transform3.6c t|dzS#ttf$rX}tj|ds|Yd}~ytj|drYd}~ytdj ||d}~wwxYw)a* Return *rotation* normalized to an angle between 0 and 360 degrees. Parameters ---------- rotation : float or {None, 'horizontal', 'vertical'} Rotation angle in degrees. *None* and 'horizontal' equal 0, 'vertical' equals 90. Returns ------- float h horizontalNverticalV@zRrotation is {!r}; expected either 'horizontal', 'vertical', numeric value, or None)float ValueError TypeErrorr _str_equalformat)rotationerrs 1/usr/lib/python3/dist-packages/matplotlib/text.py get_rotationr$sv 9X$$  "9   Hl 3x7G   h 3B$fX.058 9 9s A7A2A2A22A7c0g}g}tj|j}tj | }|j |\}}}|D]W\} } } } | \} }|j | | f\}}||z}|| z||z}}|j||g|j||gYt|t|}}t||z t||z }}tj |j ||f\}}||||fS)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`). ) npdeg2radr$rrotate _get_layout transformextendminmax)textrenderer projected_xs projected_ysthetatr_partsdtwhxywhxt1yt1xt2yt2xt_boxyt_boxw_boxh_boxx_boxy_boxs r# _get_textboxrG6s*LL JJt((* +E   E6 "B""8,KAua( 2q!1<<A'S q7C!GSS#J'S#J'(&L(9FF|$v-s 7 7h OOrHcfamilyfontfont_propertieshamanamesizestretchstylevariantvaweight) color fontfamilyfontpropertieshorizontalalignmentmultialignmentfontnamefontsize fontstretch fontstyle fontvariantverticalalignment fontweightcxeZdZdZdZdZejdd dOddfd Zfd Z fd Z d Z d Z dZ dZdZdZdZfdZdZdZdZdZdZfdZdPfd ZfdZdZdZdZdZd Zd!Z e!jDd"Z#d#Z$d$Z%d%Z&d&Z'd'Z(d(Z)d)Z*d*Z+d+Z,d,Z-d-Z.d.Z/ej`d/dPd0Z1d1Z2d2Z3dQd3Z4d4Z5d5Z6d6Z7d7Z8d8Z9d9Z:d:Z;d;Zd>Z?d?Z@d@ZAdAZBdBZCdCZDdDZEdEZFdFZGdGZHdHZIdIZJdJZKdKZLdLZMdMZNdNZOxZPS)RTextzAHandle storing and drawing of text in window or data coordinates.chd|jd|jdt|jdS)NzText(z, ))_x_yrepr_textselfs r#__repr__z Text.__repr__s %)WWdggtDJJ7GHHrHrrc)r\N) parse_mathc zt|||c|_|_d|_|j ||j ||ntjd|j||j| |j||ntjd|j| |j||j|||_|j!| ||_d|_d|_| d} |j)| |j+| |j-|y)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: 'bottom'). 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 Nz text.colorztext.parse_mathg333333?)super__init__rtrurwset_text set_colormplrcParamsset_fontproperties set_usetexset_parse_mathset_wrapset_verticalalignmentset_horizontalalignment_multialignment set_rotation_transform_rotates_text _bbox_patch _rendererset_linespacingset_rotation_modeupdate)ryr9r:r.rcrmrfrgrer! linespacing rotation_modeusetexwraptransform_rotates_textr{kwargs __class__s r#rz Text.__init__sB a  d &ECLL,F H /  **@JLL):; = d ""#45 $$%89- (#'=$  K [) }- FrHc tj|t}t}|j d|}||ur|j ||j d|}t ||||ur|j|yy)Nrebbox) rnormalize_kwargsrpobjectpoprr~rset_bbox)ryrsentinelrerrs r#rz Text.updatesx''58$4h?  )  # #N 3zz&(+ v x  MM$  rHc.t|}d|d<|S)Nr)r~ __getstate__)ryr6rs r#rzText.__getstate__s G "+rHc|j|\}}|||fS|jr |jdifStj |}|j |j cxkxr|jkncxr.|j|jcxkxr|jknc}i}|jr)|jj|\}}|xs|}||d<||fS)zs Return whether the mouse event occurred inside the axis-aligned bounding-box of the text. F bbox_patch) _default_contains get_visiblerrpget_window_extentx0r9x1y0r:y1rcontains)ry mouseeventinsideinforcattr patch_inside patch_cattrs r#rz Text.containss --j9   4< !T^^%;"9  %%d+''Z\\4TWW49gg88    (,(8(8(A(A*(M %L++|F"-E, u}rHcj|j\}}|jj||fS)zW Get the (possibly unit converted) transformed x, y in display coords. )get_unitless_position get_transformr*ryr9r:s r#_get_xy_displayzText._get_xy_displays4))+1!!#--q!f55rHcJ|j |jS|jSrS)r_horizontalalignmentrxs r#_get_multialignmentzText._get_multialignments&    +'' ',, ,rHc|jrI|jj|jg|j gj dS|jS)z3Return the text angle in degrees between 0 and 360.r)get_transform_rotates_textrtransform_angles _rotationritemrxs r#r$zText.get_rotationsY  * * ,%%'88 4#=#=#?"@BBF$q' J>> !rHc|jS)zV Return whether rotations of the transform affect the text direction. )rrxs r#rzText.get_transform_rotates_texts+++rHcRtjgd|||_d|_y)aW Set text rotation mode. Parameters ---------- m : {None, 'default', 'anchor'} If ``None`` or ``"default"``, the text will be first rotated, then aligned according to their horizontal and vertical alignments. If ``"anchor"``, then alignment occurs before rotation. )anchordefaultN)rTN)r check_in_list_rotation_modestale)ryms r#rzText.set_rotation_modes$ 6aH rHc|jS)zReturn the text rotation mode.)rrxs r#get_rotation_modezText.get_rotation_modes"""rHct|||j|_|j|_|j|_|j |_|j j|_|j|_|j|_ |j|_ |j|_ |j|_ d|_ y)NT)r~ update_from_colorr_verticalalignmentr_fontpropertiesrM_usetexrr_picker _linespacingr)ryotherrs r#rzText.update_froms E"ll $44"'":":$)$>$>!$4499;}} ','D'D$}} !.. rHc d\}}|jjd}g}g}g}g}t|d|j|j rdnd|j j \} } } | | z |jz} t|D]\} }|j|\}}|r3t|||j||j j \}}}ndx}x}}t|| }t|| }|j||j|||z |z }| dk(r||z }n|t| ||z |jzz}|j||j|||z}}t|}d}|}d}|d|z }tj|j}|j}|d k(r!t!||Dcgc] \}}||f }}}ne|d k(r1t!|||Dcgc]\}}}||d z z|d z z |f}}}}n/|d k(r*t!|||Dcgc]\}}}||z|z |f}}}}t#j$||f||f||f||fg} |j'| }!|!d d dfj)}|!d d dfj}|!d d dfj)}|!d d dfj}||z }||z }"|j*}#|j,}$|j/}%|%dk7rM|#d k(r ||zd z }&n |#d k(r|}&n|}&|$d k(r ||zd z }'n|$dk(r|}'n|$dk(r||z}'n|$dk(r ||"zdz z }'nr|}'no| d\}(})| d \}*}+|#d k(r |(|*zdz }&n |#d k(r|*}&n|(}&|$d k(r |)|+zdz }'n#|$dk(r|+}'n|$dk(r|+z }'n|$dk(r |+dz z }'n|)}'|j'|&|'f\}&}'||&z}||'z}t1j2||||"},|j'|&|'fz }-|,t5t!|t!||g|-j6|fScc}}wcc}}}wcc}}}w)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. )rr lpTeXF)rOrPrleftcenterrightNrrtopbaselinecenter_baselineg@)get_textsplitrQr get_usetexfigurerPr enumerate_preprocess_mathr-appendr rotate_degr$rzipr&arrayr*r,rrrr from_boundslistT).ryr/thisxthisylineswshsxsysr4lp_hlp_dmin_dyiline clean_linerOr;r<r6rdescentwidthxminxmaxymaxyminMmalignr9r: offset_layout corners_horizcorners_rotatedheighthalignvalignroffsetxoffsetyxmin1ymin1xmax1ymax1rxyss. r#r)zText._get_layout*s  u %%d+    5 dD00 OO-55dkkooO 4+!2!22 ' GAt!%!6!6t!< J6j$*>*>!t{{81a  A At AAt A IIaL IIaLAHAva%Va!et/@/@%@AA IIe  IIe  QJE? DB"v J ! !$"3"3"5 6))+ V 03B <1aV GW  dE6:kk-(GW+==T#eSR[93559:GCCa===sP<Q=Q cN||j}|jdd}|jdd}|d}|d}||jz}n|d}t|tr d|vr|d|zz }t d|t d ||_nd|_|jy) a 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)rr*) rMrget_size isinstancestrr rr_update_clip_properties)ry rectpropspropsrrs r#rz Text.set_bboxs"  NN$EyyT2H))E4(C#;Ct}}&;C(C(U(-BL3..- K!->-@ KDI KD  $D  $$&rHc|jS)zf Return the bbox Patch, or None if the `.patches.FancyBboxPatch` is not made. )rrxs r#get_bbox_patchzText.get_bbox_patchs rHcv|jr,t|j|j}t|j |j }|j j||f\}}t||\}}}}|jjdd|||jjtj|jj||z||z|j|j!}|jj#|yy)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)rrconvert_xunitsrtconvert_yunitsrurr*rG set_bounds set_transformrrr$ translatepoints_to_pixelsrset_mutation_scale) ryr/posxposyrErFrCrDfontsize_in_pixels r#update_bbox_position_sizezText.update_bbox_position_sizes   ,,TWW56D,,TWW56D++-77t EJD$)5dH)E &E5%    ' 'Bu =    * * D--/04%<6 8!) 9 9$--/ J     / /0A B rHct|j|j|j}|jr|jj |yy)N)clip_box clip_pathclip_on)dictclipbox _clippath_cliponrr)ry clippropss r#rzText._update_clip_propertiessD$,,#'>>!%/        # #I . rHcDt|||jyrS)r~ set_clip_boxr)ryr,rs r#r1zText.set_clip_boxs W% $$&rHcFt||||jyrS)r~ set_clip_pathr)rypathr*rs r#r3zText.set_clip_paths dI. $$&rHcDt|||jyrS)r~ set_clip_onr)rybrs r#r6zText.set_clip_ons A $$&rHc|jS)z'Return whether the text can be wrapped._wraprxs r#get_wrapz Text.get_wrap zzrHc||_y)a Set whether the text can be wrapped. 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. Nr9)ryrs r#rz Text.set_wrap!s  rHc|jj|j\}}|jj }|j }|j d|j}|j||||}|jd|zdz|||}|dk(r|}|S|dk(r|}|Sdt||z}|S)zk Return the maximum line width for wrapping text based on the current orientation. rrrrr) rr* get_position get_figurerget_horizontalalignmentrr$_get_dist_to_boxr,) ryrr figure_box alignmentr!rr line_widths r#_get_wrap_line_widthzText._get_wrap_line_width3s ##%//0A0A0CDB__&88: 002  x($$&$$Xr2zB%% 8^s "BJ8  J  ' !JSu--JrHc|dkDrm|dz }|tjtj|z }|j|z tjtjd|z z }nH|dkDr_|dz }|tjtj|z }|tjtjd|z z }n|dkDrl|dz }|j|z tjtj|z }|tjtjd|z z }ns|j|z tjtj|z }|j|z tjtjd|z z }t ||S)zr Return the distance from the given points to the boundaries of a rotated box, in pixels. iZr?)mathcosradiansrrr,)ryr!rrrDquadh1h2s r#rCzText._get_dist_to_boxMsT c>c>Ddhht||D122B--"$b4i1H(IIB ^c>Ddhht||D122Bdhht||BI677B ]b=D--"$d1C(DDBdhht||BI677B--"$h1G(HHB--"$b8m1L(MMB2r{rHc|jj||jd\}}}tj|S)zE Return the width of a given text string, in pixels. F)rrTget_fontpropertiesrJceil)ryr.r;r<r6s r#_get_rendered_text_widthzText._get_rendered_text_widthds@..>>   # # % 1ayy|rHc ,|js|jS|jr|jS|j}g}|jj d}|D] }|j d}t |dkDs$t |dk(r!|j |jd>tdt |dzD]}dj|d|}|j|}||kDr0|j dj|d|dz ||dz d}n7|t |k(sl|j dj|d|g}nt |dkDrdj|S)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) r;rrrGrlenrrrangejoinrS) ryrF wrapped_linesunwrapped_linesunwrapped_line sub_wordsrr current_widths r#_get_wrapped_textzText._get_wrapped_textns }}==? " ?? ==? "..0  --///5. N&,,S1Ii.1$y>Q&!((q)9:q#i.1"45A88IbqM2D$($A$A$$GM%z1%,,SXXiQ6G-HI$-a!ef$5 c)n,%,,SXXim-DE$& ! i.1$  8yy''rHc L|||_|jsy|jdk(ry|jd|j |j |j 5|j|\}}}|j}t|j|j}t|j|j}|j||f\}}tj |rtj |st"j%d dddy|j'\}} |j(r,|j+||j(j-||j/} | j1|j3| j5|j7| j9|j:|j=| |j?} |D]\} } }}tA|dk(r|nd}||z}||z}|jCr| |z }|jE| \}}|jGrddl$m%}||jG|}n|}|jMr#|jO| ||||jP| ||jS| ||||jP| ||  ddd jU|jWdd |_,y#1swY2xYw) Nr}r.)r.z%posx and posy should be finite valuesrr)PathEffectRenderer)mtext)rOraF)-rrr open_groupget_gid_cm_setr^r)rrrrtrrur*r&isfinite_logwarningget_canvas_width_heightrr&drawnew_gcset_foreground get_color set_alpha get_alphaset_url_url _set_gc_clipr$rVflipyrget_path_effectsmatplotlib.patheffectsr`rdraw_texr draw_textrestore close_groupr)ryr/rrrtransr#r$canvaswcanvashgcanglerr8r9r:rarrOr` textrenderers r#riz Text.draws  %DN!  ==?b FDLLN3 \\t557\ 83 G"&"2"28"< D$&&(E,,TWW56D,,TWW56D$6JD$;;t$BKK,= DE3 G3 G (??A GW..x8  %%h/"B   dnn. / LL) * JJtyy !   b !%%'E"& Gb!Q #D QDHH>>#! A%)%:%:4%@" F((*I#5--/$;L$,L??$ ))"aJ*.*>*>05*7!**2q!Z+/+?+?28+G+ G93 Gj V$ o3 G3 Gs/CL> !![[668DN >> !HI I  t{{ 4 "&"2"24>>"B D$--/DAq%%'111a&9DAq??1a(D    6 6  s1+FA*FFFc|j|jt||n%|jjt||j d|_y)z Set the background color of the text by updating the bbox. Parameters ---------- color : color See Also -------- .set_bbox : To change the position of the bounding box N) facecolor edgecolor)rT)rrr+rrrryrcs r#set_backgroundcolorzText.set_backgroundcolorsO    # MM$%@ A    # #D5$9 : $$& rHctj|ds tjj | t |||_d|_ y#t $rt|}Y%wxYw)zs Set the foreground color of the text Parameters ---------- color : color auto)rcTN) rrrcolors_check_color_likerrtuplerrrs r#rzText.set_colors_v. JJ ( (u ( 5 ! K   !%LE !s AA)(A)cRtjgd|||_d|_y)z Set the horizontal alignment relative to the anchor point. See also :doc:`/gallery/text_labels_and_annotations/text_alignment`. Parameters ---------- align : {'left', 'center', 'right'} rrralignTN)rrrrryrs r#rzText.set_horizontalalignments$ 6eD$)! rHcRtjgd|||_d|_y)al Set the text alignment for multiline texts. The layout of the bounding box of all the lines is determined by the horizontalalignment and verticalalignment properties. This property controls the alignment of the text lines within that box. Parameters ---------- align : {'left', 'right', 'center'} rrTN)rrrrrs r#set_multialignmentzText.set_multialignments$ 6eD$ rHcVtjt|||_d|_y)z Set the line spacing as a multiple of the font size. The default line spacing is 1.2. Parameters ---------- spacing : float (multiple of font size) )spacingTN)rcheck_isinstancerrr)ryrs r#rzText.set_linespacings# dG4# rHcH|jj|d|_y)a Set the font family. Can be either a single string, or a list of strings in decreasing priority. Each string may be either a real font name or a generic font class name. If the latter, the specific font names will be looked up in the corresponding rcParams. If a `Text` instance is constructed with ``fontfamily=None``, then the font is set to :rc:`font.family`, and the same is done when `set_fontfamily()` is called on an existing `Text` instance. Parameters ---------- fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} See Also -------- .font_manager.FontProperties.set_family TN)r set_familyrryrhs r#set_fontfamilyzText.set_fontfamilys* ''1 rHcH|jj|d|_y)z Set the font variant. Parameters ---------- variant : {'normal', 'small-caps'} See Also -------- .font_manager.FontProperties.set_variant TN)r set_variantr)ryr`s r#set_fontvariantzText.set_fontvariants ((1 rHcH|jj|d|_y)z Set the font style. Parameters ---------- fontstyle : {'normal', 'italic', 'oblique'} See Also -------- .font_manager.FontProperties.set_style TN)r set_styler)ryrks r# set_fontstylezText.set_fontstyles &&y1 rHcH|jj|d|_y)a Set the font size. Parameters ---------- fontsize : float or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'} If a float, the fontsize in points. The string values denote sizes relative to the default font size. See Also -------- .font_manager.FontProperties.set_size TN)rset_sizer)ryris r# set_fontsizezText.set_fontsize$s %%h/ rHc6|jjS)z Return the font family name for math text rendered by Matplotlib. The default value is :rc:`mathtext.fontset`. See Also -------- set_math_fontfamily )rget_math_fontfamilyrxs r#rzText.get_math_fontfamily6s##7799rHc:|jj|y)a Set the font family for math text rendered by Matplotlib. This does only affect Matplotlib's own math renderer. It has no effect when rendering with TeX (``usetex=True``). Parameters ---------- fontfamily : str The name of the font family. Available font families are defined in the :ref:`matplotlibrc.template file `. See Also -------- get_math_fontfamily N)rset_math_fontfamily)ryrds r#rzText.set_math_fontfamilyBs( 00<< 6DL  Return whether mathtext parsing is considered for this `Text`.)rrxs r#rzText.get_parse_math!srHc$|j|S)a- Alias for `set_family`. One-way alias only: the getter differs. Parameters ---------- fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} See Also -------- .font_manager.FontProperties.set_family )rrs r# set_fontnamezText.set_fontname%s x((rH)rrr}NrrNNNNNNFFrSNN)Q__name__ __module__ __qualname____doc__zorderrzrmake_keyword_onlyrrrrrrr$rrrrr)rrr&rr1r3r6r;rrGrCrSr^rallow_rasterizationrirlrQrrrrrrrrBrr@ deprecatedrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr __classcell__rs@r#rprpls L FITE0 "#-%+ $ $!#(-6!616p   :6- ", # UDn&'P C./' ' ' $4.1(f C CJ$1/09212) T__U&'-^(*  0  $ :=,""   *  $00   , )rHrpc0eZdZdZddZdZdZdZdZy) OffsetFromz4Callable helper class for working with `Annotation`.cB||_||_|j|y)ab Parameters ---------- 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)ryr ref_coordrs r#rzOffsetFrom.__init__;s$ # drHcDtjddg|||_y)z Set the unit for input to the transform used by ``__call__``. Parameters ---------- unit : {'points', 'pixels'} pointspixels)rN)rr_unit)ryrs r#rzOffsetFrom.set_unitQs  Hh/d; rHc|jS)z@Return the unit for input to the transform used by ``__call__``.)r rxs r#get_unitzOffsetFrom.get_unit\r<rHcP|j}|dk(ry|jdS)Nrg?)r r!)ryr/rs r# _get_scalezOffsetFrom._get_scale`s)}} 8 ,,R0 0rHct|jtrc|jj|}|j\}}|j |j |zz}|j|j|zz}nt|jtrT|j}|j\}}|j |j |zz}|j|j|zz}nNt|jtr)|jj|j\}}n td|j|}tj|j!||}|S)aL 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. z unknown type)rrr rrrrrrrrr*rr rscaler ) ryr/rxfyfr9r:scr3s r#__call__zOffsetFrom.__call__gs dllF +<<11(;D__FB$**r/)A$++**A  h /<, 1!rHrcLeZdZ d dZdZdZdZdZdZdZ d d Z d d Z y)_AnnotationBaseNcP||_||_|j|d|_yrS)rxycoordsset_annotation_clip _draggable)ryrrannotation_clips r#rz_AnnotationBase.__init__s'      1rHct|tr|\}}n||}}|dk(rt|j|}|dk(rt|j |}|j ||j ||fS)Ndata)rrrrr_get_xy_transformr*)ryr/r9r:rs1s2s r#_get_xyz_AnnotationBase._get_xysx a FBB <d))!,-A <d))!,-A%%h2<tww> >>rHc||_y)a 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)ryr7s r#rz#_AnnotationBase.set_annotation_clips !"rHc|jS)z Return the annotation's clipping behavior. See `set_annotation_clip` for the meaning of return values. r?rxs r#get_annotation_clipz#_AnnotationBase.get_annotation_clips $$$rHc\|j\}}|j||||jS)z1Return the pixel position of the annotated point.)rr!rrs r#_get_position_xyz _AnnotationBase._get_position_xys(ww1||HaDMM::rHc||jj}|j}|s|;|jdk(r,|j |}|j j |Sy)z;Check whether the annotation at *xy_pixel* should be drawn.rT)rrrBrrDr'contains_point)ryr/r7xy_pixels r# _check_xyz_AnnotationBase._check_xy#sb  {{002H  $ $ & t}}6,,X6H99++H5 5rHcddlm}|jdu}|| }|r&|j||||_|jS|j|jjd|_|jS)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. Returns ------- DraggableAnnotation or None If the annotation is draggable, the corresponding `.DraggableAnnotation` helper is returned. r)DraggableAnnotationN)matplotlib.offsetboxrJr disconnect)rystateuse_blitrJ is_draggables r# draggablez_AnnotationBase.draggable.sx =d2  =$$E &"5dH"E  ***,"DOrH)rNrS)NF) rrrrr!rr2rrBrDrHrPrrHr#rrs;!!%  ERFh?" "%; rHrceZdZdZdZ ddZdZedZejdZedZ e jdZ d Z d Z ee e d Z d ZdZej"dZddZdfd ZxZS) Annotationa` 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*. cZd|jd|jd|jfzS)NzAnnotation(%g, %g, %r)rr)rrwrxs r#__str__zAnnotation.__str___s('4771:twwqz4::*NNNrHc tj||||||||k7rtjd| |j}||_| |j }|\} } ||_|V|j}d|vr|jdd|_ ndD]} |j| dtdi||_ nd|_ tj|| | |fi|y) 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 axes 'axes pixels' Pixels from lower left corner of 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 ================= ========================================= 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 key to :class:`matplotlib.patches.FancyArrowPatch` ========== ====================================================== 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 `~matplotlib.patches.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 default is 2 points shrinkB default is 2 points mutation_scale default is text size (in points) mutation_aspect default is 1. ? any key for :class:`matplotlib.patches.PathPatch` =============== ================================================== 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 `~matplotlib.text.Text`. Returns ------- `.Annotation` See Also -------- :ref:`plotting-guide-annotation` )rrNzgYou have used the `textcoords` kwarg, but not the `xytext` kwarg. This can lead to surprising results. arrowstylerelpos)?rX)r headwidth headlengthshrinkfrac)r)rr)rrr warn_externalr _textcoordsr arrowpropsrMr _arrow_relposr arrow_patchrp) ryr.rxytextr textcoordsr_rrr9r:keys r#rzAnnotation.__init__bsZ   !#*21@ ! B N&h&    5 6  J% >WWF1$  !#*Jz)%/^^Hj%I"N.CNN3-. /LLD #D  dAq$1&1rHc|j|\}}|||fStj||\}}|j$|jj|\}}|xs|}||fSrS)rrprra)ryeventrrrtinfoin_patchr4s r#rzAnnotation.contains6st--e4   4< --e4%    '**33E:KHa+8HrHc|jSrS) _xycoordsrxs r#rzAnnotation.xycoords@s ~~rHcd}t|trtt||s||r t d||_y)NcHt|txr|jdS)Nr()rr startswith)rs r# is_offsetz&Annotation.xycoords..is_offsetFsa%@!,,x*@ @rHz'xycoords cannot be an offset coordinate)rranymaprrj)ryrrns r#rzAnnotation.xycoordsDs= A x 'CIx0H,IX&FG G!rHc"|jS)zQ The text position. See also *xytext* in `.Annotation`. )r@rxs r#xyannzAnnotation.xyannNs  ""rHc&|j|yrS)r)ryrbs r#rrzAnnotation.xyannWs &!rHc|jS)z} Return the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. r^rxs r# get_anncoordszAnnotation.get_anncoords[s rHc||_y)zz Set the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. Nru)rycoordss r# set_anncoordszAnnotation.set_anncoordscs "rHz> The coordinate system to use for `.Annotation.xyann`.)docc~|j|jj|tj||yrS)ra set_figurer )ryfigs r#r|zAnnotation.set_figurens2    '    ' ' ,$$rHc^|j|j||j|j}|ytj ||}|j |x}\|jd|j}|jj|d|vr|jdd}|jdd}|jdd }d |vrtjd |jd d } t| |z ||z ||z } |jjdi| |jdf|j|j zdz df|j dfg} |j"df|j"|j$zdz df|j$dfg} t'| fd\} }t'| fd\}}||f|_t+j,|z | z }||z|j/dz }|x|j_|j_|j4|j6|j(zz}|jj9||d|vr|d}n|j:r |j:}n{|j=dk(rd}ne|j/d}t?|j|dz z |j"|dz z f|j@|z|jB|ztEd}|jjG|y)zX Update the pixel positions of the annotation text and the arrow patch. Nmutation_scalerVr[rrrrY r\zh'frac' option in 'arrowprops' is no longer supported; use 'headlength' to set the head length in points.rZ) head_length head_width tail_widthrrrXrc&t|dz SNrabs)vrs r#z-Annotation.update_positions..QqTBYrH)rdc&t|dz Srr)rrs r#rz-Annotation.update_positions..rrHpatchAr}F)rrrr*r*)simple)$rr anncoordsr_rprrDgetrrar"rr]r+set_arrowstylerrrrr,r`r&hypotr!shrinkAshrinkBr1r] set_positionsrrr rrr set_patchA)ryr/r_r arrow_endmsr[rrYrZstylekwxposyposr9relposxr:relposyr shrink_pts arrow_beginrrrrs @@r#update_positionszAnnotation.update_positionsts 411(DNNKL__   %%dH5!228<< FB ^^,dmmo > ++B/ z )^^Hc2FNN7A.E"{B7I#""JK$ b9JzB&/"n&+bj2G ,D   + + @ @WWaLDGGdgg$5#:C"@477A,ODWWaLDGGdgg$5#:C"@477A,ODT'?@JAwT'?@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+rHc|||_|jr|j|sy|j||j ||j X|j j '|j |j |j _|j j|tj||yrS) rrrHrr&rarrirpr=s r#rizAnnotation.draws  %DN!)A  h' &&x0    '&&.4;;3J*.++  '    ! !( + $!rHc|jr|j|stjS|||_|j|j j |_|j td|j|jtj|}|g}|j)|j|jjtj|S)Nz%Cannot get window extent w/o renderer)rrHrrrrrrrrprrarunion)ryr/ text_bboxbboxess r#rzAnnotation.get_window_extents!)A99;   %DN >> !![[668DN >> !FG G dnn-**40     ' MM$**<<> ?zz&!!rHcl|j|stjSt||SrS)rHrnullr~ get_tightbbox)ryr/rs r#rzAnnotation.get_tightbboxs+~~h'99; w$X..rH)NrNNNrS)rrrrrTrrpropertyrsetterrrrvryrr|rrrrirrrrs@r#rRrRPs O   !% R2h__""## \\"" " rss --(??MMw"996$&NCTPP  U*01 6f;;*  z)6z) z)z%PPfBBJW/W/t  Z%8%8%@%@ArH