B ]”t\?ã@s¶dZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z m Z ddl m Z ddlmZddlmZddlmZmZmZdd lmZdd lmZmZmZmZmZmZe e ¡Z!d,d d „Z"ej#d d„ƒZ$dd„Z%dd„Z&e  'dgdgdgdgdgdgdgdgdgdgdgdœ ¡Gdd „d e ƒƒZ(e j)j*e  +e(¡d!e  ,e(j-¡Gd"d#„d#e(ƒZ.e j)j*e  +e.¡d$Gd%d&„d&e/ƒZ0Gd'd(„d(e/ƒZ1Gd)d*„d*e(e1ƒZ2e j)j*e2j-jd+dS)-z) Classes for including text in a figure. éNé)ÚartistÚcbookÚ docstringÚrcParams)ÚArtist)ÚFontProperties)ÚLine2D)ÚFancyArrowPatchÚFancyBboxPatchÚ Rectangle)ÚTextPath)ÚAffine2DÚBboxÚBboxBaseÚBboxTransformToÚIdentityTransformÚ TransformcKs |dk r| |¡| |¡|S)z@Return an override dict. See `~pyplot.text' docstring for info.N)Úupdate)ÚoverrideZfontdictÚkwargs©rú.lib/python3.7/site-packages/matplotlib/text.pyÚ_process_text_argss  rc csB| ¡r8| ¡}z| | ¡¡|VWd| |¡Xn|VdS)zLTemporarily inserts newlines to the text if the wrap option is enabled. N)Úget_wrapÚget_textÚset_textÚ_get_wrapped_text)ÚtextobjZold_textrrrÚ _wrap_text$s rc Cs`y t|ƒdSttfk rZt |d¡s4|dkr8dSt |d¡rHdStd |¡ƒ‚YnXdS)z“ Return the text angle as float between 0 and 360 degrees. *rotation* may be 'horizontal', 'vertical', or a numeric value in degrees. ihZ horizontalNgZverticalg€V@zRrotation is {!r}; expected either 'horizontal', 'vertical', numeric value, or None)ÚfloatÚ ValueErrorÚ TypeErrorrZ _str_equalÚformat)ÚrotationrrrÚ get_rotation4s  r%cCsìg}g}t | ¡¡}tƒ | ¡}| |¡\}}}xd|D]\\} } } } | \} }| | | f¡\}}||8}|| ||}}| ||g¡| ||g¡q:Wt|ƒt|ƒ}}t |ƒ|t |ƒ|}}tƒ |¡ ||f¡\}}||||fS)z® Calculate the bounding box of the text. Unlike :meth:`matplotlib.text.Text.get_extents` method, The bbox size of the text before the rotation is calculated. ) ÚnpÚdeg2radr%rÚrotateÚ _get_layoutÚtransform_pointÚextendÚminÚmax)ÚtextÚrendererZ projected_xsZ projected_ysÚthetaÚtrÚ_ÚpartsÚdÚtÚwhÚxÚyÚwÚhZxt1Zyt1Zxt2Zyt2Zxt_boxZyt_boxÚw_boxÚh_boxÚx_boxÚy_boxrrrÚ _get_textboxGs r?ZfamilyZfont_propertiesZhaZmaÚnameÚsizeÚstretchZstyleÚvariantZvaÚweight) Z fontfamilyÚfontpropertiesÚhorizontalalignmentÚmultialignmentÚfontnameÚfontsizeZ fontstretchÚ fontstyleZ fontvariantÚverticalalignmentZ fontweightc sReZdZdZdZe d¡Zdd„ZdŒd d „Z ‡fdd„Z ‡fdd„Z dd„Z dd„Z dd„Zdd„Zdd„Zdd„Zdd„Zd d!„Zd"d#„Zd$d%„Zd&d'„Zd(d)„Zd*d+„Z‡fd,d-„Zd‡fd.d/„ Z‡fd0d1„Zd2d3„Zd4d5„Zd6d7„Zd8d9„Zd:d;„Z dd?„ƒZ$d@dA„Z%dBdC„Z&dDdE„Z'dFdG„Z(dHdI„Z)dJdK„Z*dLdM„Z+dNdO„Z,dPdQ„Z-dRdS„Z.dTdU„Z/dVdW„Z0dŽdXdY„Z1dZd[„Z2d\d]„Z3dd^d_„Z4d`da„Z5dbdc„Z6ddde„Z7dfdg„Z8dhdi„Z9djdk„Z:dldm„Z;dndo„Zdtdu„Z?dvdw„Z@dxdy„ZAdzd{„ZBd|d}„ZCd~d„ZDd€d„ZEeFdd‚dƒ„ƒZGd„d…„ZHd†d‡„ZIdˆd‰„ZJdŠd‹„ZK‡ZLS)‘ÚTextzAHandle storing and drawing of text in window or data coordinates.éé2cCsd|j|jt|jƒfS)NzText(%s, %s, %s))Ú_xÚ_yÚreprÚ_text)ÚselfrrrÚ__repr__€sz Text.__repr__rÚNÚbaselineÚleftFcKsÔt |¡|||_|_|dkr(td}|dkr8tƒ}nt|tƒrJt|ƒ}d|_|  |¡|  |¡|  | ¡|  | ¡|  |¡| |¡||_| |_||_d|_d|_| dkr¶d} | |_| | ¡| |¡dS)zv Create a `.Text` instance at *x*, *y* with string *text*. Valid kwargs are %(Text)s Nz text.colorrUg333333ó?)rÚ__init__rOrPrrÚ isinstanceÚstrrRrÚ set_colorÚ set_usetexÚset_wrapÚset_verticalalignmentÚset_horizontalalignmentÚ_multialignmentÚ _rotationÚ_fontpropertiesÚ _bbox_patchÚ _rendererÚ _linespacingÚset_rotation_moder)rSr7r8r.ÚcolorrKrFrGrEr$Ú linespacingÚ rotation_modeÚusetexÚwraprrrrrXƒs2         z Text.__init__cs4tƒ}| d|¡}tƒ |¡||k r0| |¡dS)z6 Update properties from a dictionary. ÚbboxN)ÚobjectÚpopÚsuperrÚset_bbox)rSrÚsentinelrl)Ú __class__rrr´s   z Text.updatecstƒ ¡}d|d<|S)Nrd)roÚ __getstate__)rSr4)rrrrrs¿s zText.__getstate__cCsÄt|jƒr| ||¡S| ¡r(|jdkr0difS| ¡j\}}}}||||}}|j|j}} ||kot|kno|| koŒ|kn} i} |jr¼|j  |¡\} } | p²| } | | d<| | fS)zäTest whether the mouse event occurred in the patch. In the case of text, a hit is true anywhere in the axis-aligned bounding-box containing the text. Returns ------- bool : bool NFZ bbox_patch) ÚcallableZ _containsÚ get_visiblerdÚget_window_extentÚboundsr7r8rcÚcontains)rSZ mouseeventÚlÚbr9r:Úrr5r7r8ZinsideZcattrZ patch_insideZ patch_cattrrrrrxÅs  0z Text.containscCs| ¡\}}| ¡ ||f¡S)zW Get the (possibly unit converted) transformed x, y in display coords. )Úget_unitless_positionÚ get_transformr*)rSr7r8rrrÚ_get_xy_displayås zText._get_xy_displaycCs|jdk r|jS|jSdS)N)r`Ú_horizontalalignment)rSrrrÚ_get_multialignmentìs zText._get_multialignmentcCs t|jƒS)z*Return the text angle as float in degrees.)r%ra)rSrrrr%òszText.get_rotationcCs2|dks|dkr||_ntdt|ƒƒ‚d|_dS)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. N)ÚanchorÚdefaultzUnknown rotation_mode : %sT)Ú_rotation_moder!rQÚstale)rSÚmrrrrfös zText.set_rotation_modecCs|jS)zGet the text rotation mode.)rƒ)rSrrrÚget_rotation_modeszText.get_rotation_modecCsZt ||¡|j|_|j|_|j|_|j|_|j ¡|_|j|_|j |_ |j |_ d|_ dS)z#Copy properties from other to self.TN) rÚ update_fromÚ_colorr`Ú_verticalalignmentrrbÚcopyraZ_pickerrer„)rSÚotherrrrr‡ s  zText.update_fromc/CsÈ|j|d}||jkr |j|Sg}d\}}d\}}d\}} | ¡ d¡} t t| ƒdf¡} t t| ƒdf¡}|jd|jdd\} } }| ||j }d }xºt | ƒD]®\}}|  ||  ¡¡\}}|rÜ|j||j|d\}}}n d \}}}t || ƒ}t ||ƒ}||f| |<|||}|t ||||j ƒ8}||||f||<||8}t ||ƒ}|}q¢W|d d }|d d |d d }||} ||}tƒ | ¡¡}t t| ƒdf¡}|dd…d d…f|dd…<t| ƒd krJ| ¡}|dkr|dd…d f|d|dd…dfd7<n2|dkrJ|dd…d f||dd…df7<t ||f||f||f||fgt¡}|dd…d f|8<| |¡}|dd…d f} |dd…d f}!|  ¡|   ¡}}|! ¡|!  ¡}}||}||} |j}"|j}#| ¡}$|$dkr˜|"dkr||d}%n|"dkr.||}%n|}%|#dkrJ|| d}nL|#dkr^|| }n8|#dkrv|| |}n |#dkr’|| |d}n|}n²|d \}&}'|d\}(})|"dkrÈ|&|(d}%n|"dkrØ|(}%n|&}%|#dkrô|'|)d}nD|#dkr|)}n4|#dkr|)|}n |#dkr4|'|)|d}n|'}| |%|f¡\}%}||%8}||8}t |||| ¡}*| |¡}+|+|%|f8}+|+dd…d f|+dd…d f},}-|*tt| | |,|-ƒƒ|f}.|.|j|<|.S)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/)ggÚ ééZlpF)Úismathr)rrréÿÿÿÿrrMNÚcenterg@ÚrightrÚtoprVÚcenter_baseline)Ú get_prop_tupÚ_cachedrÚsplitr&ZzerosÚlenÚget_text_width_height_descentrbreÚ enumerateÚ is_math_textÚ get_usetexr-rZ rotate_degr%r€Úarrayr Ú transformr,rr‰r†r*rÚ from_boundsÚlistÚzip)/rSr/ÚkeyZ horizLayoutZthisxZthisyZxminZyminÚwidthÚheightÚlinesZwhsZtmpZlp_hZlp_blZoffsetyrVÚiÚlineÚ clean_linerr9r:r4ÚdescentZymaxZxmaxÚMZ offsetLayoutZmalignZ cornersHorizZcornersRotatedZtxsZtysZhalignZvalignriZoffsetxZxmin1Zymin1Zxmax1Zymax1rlZxysZxsZysZretrrrr)sÄ           2 (                      " zText._get_layoutcCs²|dk r | ¡}| dd¡}| dd¡}|dkrNd}|dkr@d}|| ¡}n |dkrZd}t|tƒrxd|krx|d|7}| dd¡}td ||tƒd œ|—Ž|_nd|_| ¡dS) 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)) NÚboxstyleÚpadZsquarerŽg333333Ó?z ,pad=%0.2fÚbbox_transmuter©ggçð?)r«r­rž)r®r¯r¯) rŠrnÚget_sizerYrZr rrcÚ_update_clip_properties)rSZ rectpropsÚpropsr«r¬r­rrrrp±s.     z Text.set_bboxcCs|jS)zf Return the bbox Patch, or None if the `.patches.FancyBboxPatch` is not made. )rc)rSrrrÚget_bbox_patchászText.get_bbox_patchc Cs¼|jr¸| ¡}t| |j¡ƒ}t| |j¡ƒ}| ||f¡\}}t||ƒ\}}}}|j  dd||¡t   |  ¡¡} t ƒ | ¡} |  ||||¡} |j | ¡| | ¡¡} |j | ¡dS)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. gN)rcr}r Úconvert_xunitsrOÚconvert_yunitsrPr*r?Ú set_boundsr&r'r%rr(Ú translateÚ set_transformÚpoints_to_pixelsr°Úset_mutation_scale) rSr/ÚtransÚposxÚposyr=r>r;r<r0r1Úfontsize_in_pixelrrrÚupdate_bbox_position_sizeès  zText.update_bbox_position_sizec Csˆt||ƒ\}}}}|j dd||¡t | ¡¡}tƒ |¡} |  ||||¡} |j  | ¡|  |  ¡¡} |j  | ¡|j  |¡dS)zi Update the location and size of the bbox (`.patches.FancyBboxPatch`), and draw. gN)r?rcr¶r&r'r%rr(r·r¸r¹r°rºÚdraw) rSr/r¼r½r=r>r;r<r0r1r¾rrrÚ _draw_bboxs   zText._draw_bboxcCs*t|j|j|jd}|jr&|j |¡}dS)N)Zclip_boxZ clip_pathZclip_on)ÚdictÚclipboxZ _clippathZ_cliponrcr)rSZ clippropsrlrrrr±s  zText._update_clip_propertiescstƒ |¡| ¡dS)z’ Set the artist's clip `~.transforms.Bbox`. Parameters ---------- clipbox : `matplotlib.transforms.Bbox` N)roÚ set_clip_boxr±)rSrÃ)rrrrrÄs zText.set_clip_boxcstƒ ||¡| ¡dS)aÍ Set the artist's clip path, which may be: * a `~matplotlib.patches.Patch` (or subclass) instance * a `~matplotlib.path.Path` instance, in which case an optional `~matplotlib.transforms.Transform` instance may be provided, which will be applied to the path before using it for clipping. * *None*, to remove the clipping path For efficiency, if the path happens to be an axis-aligned rectangle, this method will set the clipping box to the corresponding rectangle and set the clipping path to *None*. ACCEPTS: { (`.path.Path`, `.transforms.Transform`), `.patches.Patch`, None } N)roÚ set_clip_pathr±)rSÚpathrž)rrrrrÅ&szText.set_clip_pathcstƒ |¡| ¡dS)zÛ Set whether artist uses clipping. When False, artists will be visible outside of the axes, which can lead to unexpected results. Parameters ---------- b : bool N)roÚ set_clip_onr±)rSrz)rrrrrÇ=s zText.set_clip_oncCs|jS)z'Return the wrapping state for the text.)Ú_wrap)rSrrrrKsz Text.get_wrapcCs ||_dS)zhSet the wrapping state for the text. Parameters ---------- wrap : bool N)rÈ)rSrkrrrr]Osz Text.set_wrapc Cs’| ¡ | ¡¡\}}| ¡ ¡}| ¡}| d¡| ¡}| ||||¡}| d|d|||¡}|dkrr|}n|dkr€|}ndt ||ƒ}|S)zk Return the maximum line width for wrapping text based on the current orientation. ré´ihrWr’r) r}ržÚ get_positionÚ get_figurervÚget_horizontalalignmentrfr%Ú_get_dist_to_boxr,) rSÚx0Úy0Ú figure_boxZ alignmentr$rWr’Ú line_widthrrrÚ_get_wrap_line_widthXs  zText._get_wrap_line_widthcCs|dkrD|d}|t t |¡¡}|j|t t d|¡¡}nº|dkr‚|d}|t t |¡¡}|t t d|¡¡}n||dkrÆ|d}|j|t t |¡¡}|t t d|¡¡}n8|j|t t |¡¡}|j|t t d|¡¡}t||ƒS)zr Return the distance from the given points to the boundaries of a rotated box, in pixels. iéZrÉ)ÚmathÚcosZradiansÚx1Úy1r,)rSr$rÎrÏrÐZquadZh1Zh2rrrrÍrs zText._get_dist_to_boxcCs$|j || ¡d¡\}}}t |¡S)zE Return the width of a given text string, in pixels. F)rdr™Úget_fontpropertiesrÔZceil)rSr.r9r:r4rrrÚ_get_rendered_text_width‰s  zText._get_rendered_text_widthcCs¸| ¡r| ¡S| ¡}d}d}xŽ| ¡ d¡D]|}| d¡}xltt|ƒƒD]\}| |d||¡}||ksv|dkr†||d7}d}|dkr˜||}qL|d||7}qLWq0W||S)z„ Return a copy of the text with new lines added, so that the text is wrapped relative to the parent figure. rUú rŒr)rœrrÒr—Úranger˜rÙ)rSrÑZ wrapped_strr§ZwordZ sub_wordsr¦Z current_widthrrrr“s"   zText._get_wrapped_textc Cs |dk r||_| ¡sdS| ¡dkr*dS| d| ¡¡t|ƒ¤}| |¡\}}}| ¡}t|  |j ¡ƒ}t|  |j ¡ƒ}|  ||f¡\}}t |¡r¤t |¡s²t d¡dS| ¡\} } |jrÒ| |||¡| ¡} |  | ¡¡|  | ¡¡|  |j¡| | ¡| ¡} xÎ|D]Æ\} }}}t|ƒdkr8|nd}||}||}| ¡r^| |}|  | | !¡¡\}}| "¡r˜ddl#m$}|| "¡|ƒ}n|}| !¡rÂ|j%| ||||j&| |dn|j'| ||||j&| ||d qWWdQRX|  (¡| )d¡d |_*dS) zC Draws the `.Text` object to the given *renderer*. NrUr.z%posx and posy should be finite valuesrr)ÚPathEffectRenderer)Úmtext)rrÝF)+rdrurZ open_groupZget_gidrr)r}r r´rOrµrPr*r&ZisfiniteÚ_logZwarningZget_canvas_width_heightrcrÁZnew_gcZset_foregroundÚ get_colorZ set_alphaZ get_alphaZset_urlZ_urlZ _set_gc_clipr%r˜Zflipyr›rœZget_path_effectsZmatplotlib.patheffectsrÜZdraw_texrbZ draw_textZrestoreZ close_groupr„)rSr/rrlÚinfor©r»r¼r½ZcanvaswZcanvashÚgcÚangler§r6r7r8rÝr¨rrÜZ textrendererrrrrÀ¶s`              z Text.drawcCs|jS)zReturn the color of the text)rˆ)rSrrrrßüszText.get_colorcCs|jS)z0Return the `.font_manager.FontProperties` object)rb)rSrrrrØszText.get_fontpropertiescCs |j ¡S)zš Return the list of font families used for font lookup See Also -------- .font_manager.FontProperties.get_family )rbZ get_family)rSrrrÚget_fontfamilyszText.get_fontfamilycCs |j ¡S)z Return the font name as string See Also -------- .font_manager.FontProperties.get_name )rbZget_name)rSrrrÚ get_fontnameszText.get_fontnamecCs |j ¡S)zƒ Return the font style as string See Also -------- .font_manager.FontProperties.get_style )rbZ get_style)rSrrrÚ get_fontstyleszText.get_fontstylecCs |j ¡S)zŒ Return the font size as integer See Also -------- .font_manager.FontProperties.get_size_in_points )rbZget_size_in_points)rSrrrÚ get_fontsize"szText.get_fontsizecCs |j ¡S)z‰ Return the font variant as a string See Also -------- .font_manager.FontProperties.get_variant )rbZ get_variant)rSrrrÚget_fontvariant,szText.get_fontvariantcCs |j ¡S)zŒ Get the font weight as string or number See Also -------- .font_manager.FontProperties.get_weight )rbZ get_weight)rSrrrÚget_fontweight6szText.get_fontweightcCs |j ¡S)z Get the font stretch as a string or number See Also -------- .font_manager.FontProperties.get_stretch )rbÚ get_stretch)rSrrrré@szText.get_stretchcCs|jS)zq Return the horizontal alignment as string. Will be one of 'left', 'center' or 'right'. )r)rSrrrrÌJszText.get_horizontalalignmentcCs(t| |j¡ƒ}t| |j¡ƒ}||fS)z>Return the unitless position of the text as a tuple (*x*, *y*))r r´rOrµrP)rSr7r8rrrr|QszText.get_unitless_positioncCs |j|jfS)z5Return the position of the text as a tuple (*x*, *y*))rOrP)rSrrrrÊYszText.get_positionc CsR| ¡\}}|p|j}||| ¡|j|j|jt|jƒ|j|j |j j t   |¡|jf S)z÷ Return a hashable tuple of properties. Not intended to be human readable, but useful for backends who want to cache derived information about text (e.g., layouts) and need to know if the text has changed. )r|rdrrˆr‰rÚhashrbrarƒÚfigureÚdpiÚweakrefÚrefre)rSr/r7r8rrrr•_s  zText.get_prop_tupcCs|jS)zGet the text as string)rR)rSrrrrqsz Text.get_textcCs|jS)z{ Return the vertical alignment as string. Will be one of 'top', 'center', 'bottom' or 'baseline'. )r‰)rSrrrÚget_verticalalignmentuszText.get_verticalalignmentc CsØ| ¡st ¡S|dk r(|jj}||j_| ¡dkrP| ¡\}}t ||dd¡S|dk r^||_|jdkrr|jj |_|jdkr„t dƒ‚|  |j¡\}}}|  ¡\} } |  ¡ | | f¡\} } | | | ¡}|dk rÔ||j_|S)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 saving the figure). dpi : float, optional The dpi value for computing the bbox, defaults to ``self.figure.dpi`` (*not* the renderer dpi); should be set e.g. if to match regions with a figure saved with a custom dpi value. NrUrz%Cannot get window extent w/o renderer)rurÚunitrërìrr~rŸrdÚ_cachedRendererÚ RuntimeErrorr)r|r}r*Z translated) rSr/rìZdpi_origZtxZtyrlràr©r7r8rrrrv|s*       zText.get_window_extentcCsB|jdkr| t||d¡n|j t|d¡| ¡d|_dS)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)Ú facecolorZ edgecolor)róT)rcrprÂrr±r„)rSrgrrrÚset_backgroundcolorªs zText.set_backgroundcolorcCs:y t|ƒWntk r(t|ƒ}YnX||_d|_dS)zs Set the foreground color of the text Parameters ---------- color : color TN)rêr"Útuplerˆr„)rSrgrrrr[¾s  zText.set_colorcCs,d}||krtdt|ƒƒ‚||_d|_dS)z‹ Set the horizontal alignment to one of Parameters ---------- align : {'center', 'right', 'left'} )r‘r’rWz&Horizontal alignment must be one of %sTN)r!rZrr„)rSÚalignÚlegalrrrr_Îs  zText.set_horizontalalignmentcCs,d}||krtdt|ƒƒ‚||_d|_dS)aS Set the alignment for multiple lines layout. The layout of the bounding box of all the lines is determined bu the horizontalalignment and verticalalignment properties, but the multiline text within that box can be Parameters ---------- align : {'left', 'right', 'center'} )r‘r’rWz&Horizontal alignment must be one of %sTN)r!rZr`r„)rSrör÷rrrÚset_multialignmentÝs  zText.set_multialignmentcCs||_d|_dS)zµ Set the line spacing as a multiple of the font size. Default is 1.2. Parameters ---------- spacing : float (multiple of font size) TN)rer„)rSZspacingrrrÚset_linespacingïs zText.set_linespacingcCs|j |¡d|_dS)a Set the font family. May 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. Parameters ---------- fontname : {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'} See Also -------- .font_manager.FontProperties.set_family TN)rbÚ set_familyr„)rSrHrrrÚset_fontfamilyûs zText.set_fontfamilycCs|j |¡d|_dS)zî Set the font variant, either 'normal' or 'small-caps'. Parameters ---------- variant : {'normal', 'small-caps'} See Also -------- .font_manager.FontProperties.set_variant TN)rbZ set_variantr„)rSrCrrrÚset_fontvariants zText.set_fontvariantcCs|j |¡d|_dS)zÒ Set the font style. Parameters ---------- fontstyle : {'normal', 'italic', 'oblique'} See Also -------- .font_manager.FontProperties.set_style TN)rbZ set_styler„)rSrJrrrÚ set_fontstyles zText.set_fontstylecCs|j |¡d|_dS)aw Set the font size. May be either a size string, relative to the default font size, or an absolute font size in points. Parameters ---------- fontsize : {size in points, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'} See Also -------- .font_manager.FontProperties.set_size TN)rbZset_sizer„)rSrIrrrÚ set_fontsize,s zText.set_fontsizecCs|j |¡d|_dS)ab Set the font weight. Parameters ---------- weight : {a numeric value in range 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'} See Also -------- .font_manager.FontProperties.set_weight TN)rbZ set_weightr„)rSrDrrrÚset_fontweight=s zText.set_fontweightcCs|j |¡d|_dS)a Set the font stretch (horizontal condensation or expansion). Parameters ---------- stretch : {a numeric value in range 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'} See Also -------- .font_manager.FontProperties.set_stretch TN)rbZ set_stretchr„)rSrBrrrÚset_fontstretchNs zText.set_fontstretchcCs | |d¡| |d¡dS)z} Set the (*x*, *y*) position of the text. Parameters ---------- xy : (float, float) rrN)Úset_xÚset_y)rSÚxyrrrÚ set_position_szText.set_positioncCs||_d|_dS)zl Set the *x* position of the text. Parameters ---------- x : float TN)rOr„)rSr7rrrrjsz Text.set_xcCs||_d|_dS)zl Set the *y* position of the text. Parameters ---------- y : float TN)rPr„)rSr8rrrrusz Text.set_ycCs||_d|_dS)z Set the rotation of the text. Parameters ---------- s : {angle in degrees, 'vertical', 'horizontal'} TN)rar„)rSÚsrrrÚ set_rotation€szText.set_rotationcCs,d}||krtdt|ƒƒ‚||_d|_dS)zž Set the vertical alignment Parameters ---------- align : {'center', 'top', 'bottom', 'baseline', 'center_baseline'} )r“Zbottomr‘rVr”z$Vertical alignment must be one of %sTN)r!rZr‰r„)rSrör÷rrrr^‹s  zText.set_verticalalignmentcCs,|dkr d}||jkr(d|f|_d|_dS)zâ Set the text string *s*. It may contain newlines (``\n``) or math in LaTeX syntax. Parameters ---------- s : string or object castable to string (but ``None`` becomes ``''``) NrUz%sT)rRr„)rSrrrrr›s   z Text.set_textcCsN|dkrtd}|r(|dkr d}|dfSt |¡r:|dfS| dd¡d fSdS) aS Returns a cleaned string and a boolean flag. The flag indicates if the given string *s* contains any mathtext, determined by counting unescaped dollar signs. If no mathtext is present, the cleaned string has its dollar signs unescaped. If usetex is on, the flag always has the value "TeX". Nz text.usetexrÚz\ ZTeXTz\$ú$F)rrr›Úreplace)rrjrrrr›«s  zText.is_math_textcCs&t|tƒrt|ƒ}| ¡|_d|_dS)z“ Set the font properties that control the text. Parameters ---------- fp : `.font_manager.FontProperties` TN)rYrZrrŠrbr„)rSÚfprrrÚset_fontpropertiesÂs  zText.set_fontpropertiescCs(|dkrtd|_n t|ƒ|_d|_dS)z« Parameters ---------- usetex : bool or None Whether to render using TeX, ``None`` means to use :rc:`text.usetex`. Nz text.usetexT)rÚ_usetexÚboolr„)rSrjrrrr\Ïs  zText.set_usetexcCs|jdkrtdS|jSdS)z« Return whether this `Text` object uses TeX for rendering. If the user has not manually set this value, it defaults to :rc:`text.usetex`. Nz text.usetex)r r)rSrrrrœÝs zText.get_usetexcCs | |¡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 )rú)rSrHrrrÚ set_fontnameészText.set_fontname) rrrUNrVrWNNNNNNF)N)N)NN)N)MÚ__name__Ú __module__Ú __qualname__Ú__doc__ZzorderrÚmaxdictr–rTrXrrsrxr~r€r%rfr†r‡r)rpr³r¿rÁr±rÄrÅrÇrr]rÒrÍrÙrrÚallow_rasterizationrÀrßrØrãrärårærçrèrérÌr|rÊr•rrïrvrôr[r_rørùrûrürýrþrÿrrrrrr^rÚ staticmethodr›r r\rœr Ú __classcell__rr)rrrrLms   &   0    #F         .        rL)rLc@sÚeZdZdZdZdd„Zd9d d „Zd d„Zdd„Zd:dd„Zdd„Z dd„Z d;dd„Z dd„Z dd„Z dd„Zdd „Zd!d"„Zd#d$„Zd%d&„Zd'd(„Zd)d*„Zd+d,„Zd-d.„Zd/d0„Zd1d2„Zd3d4„Zd5d6„Zd7d8„ZdS)<Ú TextWithDashab This is basically a :class:`~matplotlib.text.Text` with a dash (drawn with a :class:`~matplotlib.lines.Line2D`) before/after it. It is intended to be a drop-in replacement for :class:`~matplotlib.text.Text`, and should behave identically to it when *dashlength* = 0.0. The dash always comes between the point specified by :meth:`~matplotlib.text.Text.set_position` and the text. When a dash exists, the text alignment arguments (*horizontalalignment*, *verticalalignment*) are ignored. *dashlength* is the length of the dash in canvas units. (default = 0.0). *dashdirection* is one of 0 or 1, where 0 draws the dash after the text and 1 before. (default = 0). *dashrotation* specifies the rotation of the dash, and should generally stay *None*. In this case :meth:`~matplotlib.text.TextWithDash.get_dashrotation` returns :meth:`~matplotlib.text.Text.get_rotation`. (i.e., the dash takes its rotation from the text's rotation). Because the text center is projected onto the dash, major deviations in the rotation cause what may be considered visually unappealing results. (default = *None*) *dashpad* is a padding length to add (or subtract) space between the text and the dash, in canvas units. (default = 3) *dashpush* "pushes" the dash and text away from the point specified by :meth:`~matplotlib.text.Text.set_position` by the amount in canvas units. (default = 0) .. note:: The alignment of the two objects is based on the bounding box of the :class:`~matplotlib.text.Text`, as obtained by :meth:`~matplotlib.artist.Artist.get_window_extent`. This, in turn, appears to depend on the font metrics as given by the rendering backend. Hence the quality of the "centering" of the label text with respect to the dash varies depending on the backend used. .. note:: I'm not sure that I got the :meth:`~matplotlib.text.TextWithDash.get_window_extent` right, or whether that's sufficient for providing the object bounding box. Z textwithdashcCsd|j|j|jfS)NzTextWithDash(%g, %g, %r))rOrPrR)rSrrrÚ__str__8szTextWithDash.__str__rrUNr‘çrMc Csptj|||||||||| | d t||f||fddd|_t|ƒ|_t|ƒ|_| |_| |_| |_ ||_ ||_ dS)N) r7r8r.rgrKrFrGrEr$rhÚkú-)ZxdataZydatargZ linestyle) rLrXr Údashliner Ú_dashxÚ_dashyÚ _dashlengthÚ_dashdirectionÚ _dashrotationÚ_dashpadÚ _dashpush)rSr7r8r.rgrKrFrGrEr$rhÚ dashlengthÚ dashdirectionÚ dashrotationÚdashpadÚdashpushrrrrX;s$   zTextWithDash.__init__cCs(t| |j¡ƒ}t| |j¡ƒ}||fS)z>Return the unitless position of the text as a tuple (*x*, *y*))r r´rrµr)rSr7r8rrrr|fsz"TextWithDash.get_unitless_positioncCs |j|jfS)z5Return the position of the text as a tuple (*x*, *y*))rr)rSrrrrÊnszTextWithDash.get_positionc CsFdd„tj||dDƒ}| |j|j|j|j|j|j|j g¡t |ƒS)z÷ Return a hashable tuple of properties. Not intended to be human readable, but useful for backends who want to cache derived information about text (e.g., layouts) and need to know if the text has changed. cSsg|]}|‘qSrr)Ú.0Úprrrú |sz-TextWithDash.get_prop_tup..)r/) rLr•r+rOrPrrr r!r"rõ)rSr/r²rrrr•ts   zTextWithDash.get_prop_tupcCs8| |¡t ||¡| ¡dkr.|j |¡d|_dS)zP Draw the :class:`TextWithDash` object to the given *renderer*. gFN)Ú update_coordsrLrÀÚget_dashlengthrr„)rSr/rrrrÀ‚s     zTextWithDash.drawc! Cs,| ¡\}}| ¡}|dkr.|||_|_dS| ¡}| ¡}| ¡}| ¡}t|ƒ} t j | d|d} t   | ¡t   | ¡} } |  ¡} |  ||f¡}t  | | g¡}|||}||||}|  ¡}| t|ƒ¡\}}| t|ƒ¡\}}|j ||f||f¡tj||d}|j|j}}| dkr4|}d}nJ| dkrHd}|}n6| | }|}||}||ksr|| kr~|}||}t  ||g¡d}|d|t  t  ||¡¡9}||dd|}| t|ƒ¡\}} || |_|_tj||d}| ¡|_|j t  |g¡d¡t |d¡t |d¡dS) zò Computes the actual *x*, *y* coordinates for text based on the input *x*, *y* and the *dashlength*. Since the rotation is with respect to the actual canvas's coordinates we need to map back and forth. gNg€f@r)r/rFr‘)r|r,rOrPÚget_dashrotationÚget_dashdirectionÚ get_dashpadÚ get_dashpushr%r&ZpirÕZsinr}r*rÚinvertedrõrÚset_datarLrvr£r¤ZsqrtÚdotÚfrozenÚ_twd_window_extentZupdate_from_data_xyr_r^)!rSr/ZdashxZdashyr#r%r$r&r'râr0Z cos_thetaZ sin_thetaržZcxyZcdZc1Zc2ZinverserÖr×Úx2Úy2Zwer9r:ZdxZdyZ tan_thetaÚcwdZcwZnewxZnewyrrrr+ŒsZ      zTextWithDash.update_coordscCs.| |¡| ¡dkr$tj||dS|jSdS)ao Return a :class:`~matplotlib.transforms.Bbox` object 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. *renderer* defaults to the _renderer attribute of the text object. This is not assigned until the first execution of :meth:`draw`, so you must use this kwarg if you want to call :meth:`get_window_extent` prior to the first :meth:`draw`. For getting web page regions, it is simpler to call the method after saving the figure. g)r/N)r+r,rLrvr5)rSr/rrrrvàs  zTextWithDash.get_window_extentcCs|jS)z- Get the length of the dash. )r)rSrrrr,õszTextWithDash.get_dashlengthcCs||_d|_dS)zx Set the length of the dash, in canvas units. Parameters ---------- dl : float TN)rr„)rSZdlrrrÚset_dashlengthûszTextWithDash.set_dashlengthcCs|jS)zO Get the direction dash. 1 is before the text and 0 is after. )r)rSrrrr.szTextWithDash.get_dashdirectioncCs||_d|_dS)a9 Set the direction of the dash following the text. 1 is before the text and 0 is after. The default is 0, which is what you'd want for the typical case of ticks below and on the left of the figure. Parameters ---------- dd : int (1 is before, 0 is after) TN)rr„)rSZddrrrÚset_dashdirection s zTextWithDash.set_dashdirectioncCs|jdkr| ¡S|jSdS)z: Get the rotation of the dash in degrees. N)r r%)rSrrrr-s zTextWithDash.get_dashrotationcCs||_d|_dS)zu Set the rotation of the dash, in degrees. Parameters ---------- dr : float TN)r r„)rSZdrrrrÚset_dashrotation"szTextWithDash.set_dashrotationcCs|jS)zW Get the extra spacing between the dash and the text, in canvas units. )r!)rSrrrr/-szTextWithDash.get_dashpadcCs||_d|_dS)zÁ Set the "pad" of the TextWithDash, which is the extra spacing between the dash and the text, in canvas units. Parameters ---------- dp : float TN)r!r„)rSÚdprrrÚ set_dashpad3s zTextWithDash.set_dashpadcCs|jS)zr Get the extra spacing between the dash and the specified text position, in canvas units. )r")rSrrrr0?szTextWithDash.get_dashpushcCs||_d|_dS)zÐ Set the "push" of the TextWithDash, which is the extra spacing between the beginning of the dash and the specified position. Parameters ---------- dp : float TN)r"r„)rSr<rrrÚ set_dashpushFs zTextWithDash.set_dashpushcCs | |d¡| |d¡dS)zŽ Set the (*x*, *y*) position of the :class:`TextWithDash`. Parameters ---------- xy : (float, float) rrN)rr)rSrrrrrRszTextWithDash.set_positioncCst|ƒ|_d|_dS)z} Set the *x* position of the :class:`TextWithDash`. Parameters ---------- x : float TN)r rr„)rSr7rrrr]s zTextWithDash.set_xcCst|ƒ|_d|_dS)z} Set the *y* position of the :class:`TextWithDash`. Parameters ---------- y : float TN)r rr„)rSr8rrrrhs zTextWithDash.set_ycCs"t ||¡|j |¡d|_dS)z» Set the :class:`matplotlib.transforms.Transform` instance used by this artist. Parameters ---------- t : matplotlib.transforms.Transform TN)rLr¸rr„)rSr5rrrr¸ss  zTextWithDash.set_transformcCs|jS)z0return the figure instance the artist belongs to)rë)rSrrrrË€szTextWithDash.get_figurecCst ||¡|j |¡dS)zŽ Set the figure instance the artist belongs to. Parameters ---------- fig : matplotlib.figure.Figure N)rLÚ set_figurer)rSÚfigrrrr?„s zTextWithDash.set_figure)rrrUNr‘r‘NNNNrrNrMr)N)N)rrrrrrXr|rÊr•rÀr+rvr,r9r.r:r-r;r/r=r0r>rrrr¸rËr?rrrrrsL5   T           r)rc@s:eZdZdZddd„Zdd„Zdd„Zd d „Zd d „Zd S)Ú OffsetFromz3Callable helper class for working with `Annotation`ÚpointscCs||_||_| |¡dS)aY Parameters ---------- artist : `Artist`, `BboxBase`, or `Transform` The object to compute the offset from. ref_coord : length 2 sequence 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'} The screen units to use (pixels or points) for the offset input. N)Ú_artistÚ _ref_coordÚset_unit)rSrZ ref_coordrðrrrrX”szOffsetFrom.__init__cCs|dkrtdƒ‚||_dS)z• The unit for input to the transform used by ``__call__`` Parameters ---------- unit : {'points', 'pixels'} )rBÚpixelsz-'unit' must be one of [ 'points' | 'pixels' ]N)r!Ú_unit)rSrðrrrrE¬szOffsetFrom.set_unitcCs|jS)z8The unit for input to the transform used by ``__call__``)rG)rSrrrÚget_unit¸szOffsetFrom.get_unitcCs"| ¡}|dkrdS| d¡SdS)NrFgð?)rHr¹)rSr/rðrrrÚ _get_scale¼szOffsetFrom._get_scalec CsÚt|jtƒrL|j |¡}|j\}}}}|j\}}||||||} } njt|jtƒrŽ|jj\}}}}|j\}}||||||} } n(t|jtƒr®|j |j¡\} } nt dƒ‚|  |¡} t ƒ  | | ¡  | | ¡} | S)aX Return the offset transform. Parameters ---------- renderer : `RendererBase` The renderer to use to compute the offset Returns ------- transform : `Transform` Maps (x, y) in pixel or point units to screen units relative to the given artist. z unknown type)rYrCrrvrwrDrrr*ròrIrÚscaler·) rSr/rlryrzr9r:ZxfZyfr7r8Zscr1rrrÚ__call__Ãs       zOffsetFrom.__call__N)rB) rrrrrXrErHrIrKrrrrrA’s   rAc@sXeZdZddd„Zdd„Zdd„Zd d „Zd d „Zd d„Zdd„Z dd„Z ddd„Z dS)Ú_AnnotationBaseÚdataNcCs ||_||_| |¡d|_dS)N)rÚxycoordsÚset_annotation_clipÚ _draggable)rSrrNÚannotation_cliprrrrXçs z_AnnotationBase.__init__c Cspt|tƒr|\}}n ||}}|dkr4t| |¡ƒ}|dkrJt| |¡ƒ}| ||¡}| ||f¡\}} || fS)NrM)rYrõr r´rµÚ_get_xy_transformr*) rSr/r7r8rÚs1Ús2r1rÖr×rrrÚ_get_xyòs    z_AnnotationBase._get_xycCstt|tƒrD|\}}ddlm}| ||¡}| ||¡}|||ƒ}|St|ƒr~||ƒ}t|tƒrft|ƒSt|tƒrt|St dƒ‚nRt|t ƒrš|  |¡} t| ƒSt|tƒr¬t|ƒSt|tƒrº|St|t ƒsÐt d|ƒ‚|dkrà|j jS|dkrddlm} |  ¡}||j j} | S| ¡} t| ƒdkr0td |ƒ‚d \} }| \}}|d krT|jj} n|d krf|j j} | dk r€| jdd…}n|d kr”| |¡}|dk rd|\}}ddlm}|dkrÚ|j ¡d}|ƒ ||¡}n~|dkrì|ƒ}nl|dkr | ¡}||j ¡d}|ƒ ||¡}n8|dkrL| jdd…\}}|ƒ ||¡}n td |ƒ‚| ||¡Std |ƒ‚dS)Nr)Úblended_transform_factoryzunknown return type ...zunknown coordinate type : %srMZpolar)Ú PolarAxesrz!%s is not a recognized coordinate)NNrëÚaxesÚoffset)rrBgR@rFrIZfraction)rYrõZmatplotlib.transformsrVrRrtrrrròrrvrZrXZ transDataZmatplotlib.projectionsrWZPolarTransformr—r˜r!rërlrwÚ _get_ref_xyrZget_dpirJr°r·)rSr/rrSrTrVZtr1Ztr2r1rlrWr»Zs_Zbbox0Zxy0Z bbox_namerðZref_xZref_yrZdpprIr9r:rrrrRsz                                z!_AnnotationBase._get_xy_transformc Cs¤dd„}t|jtƒrp|j\}}||ƒs.||ƒr6tdƒ‚|j\}}| ||||¡\}}| ||||¡\} } || fS||jƒr„tdƒ‚n|j\}}| ||||j¡SdS)zy return x, y (in display coordinate) that is to be used for a reference of any offset coordinate cSst|tƒo| ¡ddkS)NrrY)rYrZr—)rrrrÚ is_offsetYsz._AnnotationBase._get_ref_xy..is_offsetz+xycoords should not be an offset coordinateN)rYrNrõr!rrU) rSr/r[rSrTr7r8rÖr×r6r7rrrrZTs      z_AnnotationBase._get_ref_xycCs ||_dS)aK set *annotation_clip* attribute. * True: the annotation will only be drawn when self.xy is inside the axes. * False: the annotation will always be drawn regardless of its position. * None: the self.xy will be checked only if *xycoords* is "data" N)Ú_annotation_clip)rSrzrrrrOus z#_AnnotationBase.set_annotation_clipcCs|jS)z Return *annotation_clip* attribute. See :meth:`set_annotation_clip` for the meaning of return values. )r\)rSrrrÚget_annotation_clipsz#_AnnotationBase.get_annotation_clipcCs|j\}}| ||||j¡S)z1Return the pixel position of the annotated point.)rrUrN)rSr/r7r8rrrÚ_get_position_xyˆs z _AnnotationBase._get_position_xycCs2| ¡}|s|dkr.|jdkr.|j |¡s.dSdS)zb given the xy pixel coordinate, check if the annotation need to be drawn. NrMFT)r]rNrXZcontains_point)rSr/Úxy_pixelrzrrrÚ _check_xys  z_AnnotationBase._check_xyFcCs`ddlm}|jdk }|dkr$| }|r@|jdkrZ|||ƒ|_n|jdk rT|j ¡d|_|jS)ac Set the draggable state -- if state is * None : toggle the current state * True : turn draggable on * False : turn draggable off If draggable is on, you can drag the annotation on the canvas with the mouse. The DraggableAnnotation helper instance is returned if draggable is on. r)ÚDraggableAnnotationN)Zmatplotlib.offsetboxrarPZ disconnect)rSÚstateZuse_blitraZ is_draggablerrrÚ draggableœs     z_AnnotationBase.draggable)rMN)NF) rrrrXrUrRrZrOr]r^r`rcrrrrrLæs S! rLc@sÒeZdZdZdd„Zd#dd„Zdd „Zed d „ƒZej d d „ƒZed d„ƒZ e j dd„ƒZ e j Z de _e j Zde_dd„Zdd„Zdd„Zejdd„ƒZd$dd„Zeejddddd „ƒe d¡d!d „ƒd"ZdS)%Ú 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*. cCsd|jd|jd|jfS)NzAnnotation(%g, %g, %r)rr)rrR)rSrrrrËszAnnotation.__str__NrMcKsìtj||||d|dkr4|dk r4||kr4t d¡|dkrB|j}||_|dkrV|j}|\} } tj|| | |f|Ž||_|dk râd|kr¢|j  ¡}|  dd¡|_ n2d} t ƒ}x&|j  ¡D]\} } | | kr¸| || <q¸Wtd |Ž|_nd|_dS) a] Annotate the point *xy* with text *s*. 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 ---------- s : str The text of the annotation. xy : (float, float) The point *(x,y)* to annotate. xytext : (float, float), optional The position *(x,y)* to place the text at. If *None*, defaults to *xy*. xycoords : str, `.Artist`, `.Transform`, callable or tuple, optional 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 '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 ================= ============================================= - An `.Artist`: *xy* is interpreted as a fraction of the artists `~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. Defaults to 'data'. textcoords : str, `.Artist`, `.Transform`, callable or tuple, optional 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 ================= ========================================= Defaults to the value of *xycoords*, i.e. use the same coordinate system for annotation point and text position. arrowprops : dict, optional The properties used to draw a `~matplotlib.patches.FancyArrowPatch` arrow between the positions *xy* and *xytext*. 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` ========== ====================================================== If *arrowprops* contains the key 'arrowstyle' the above keys are forbidden. The allowed values of ``'arrowstyle'`` are: ============ ============================================= Name Attrs ============ ============================================= ``'-'`` None ``'->'`` head_length=0.4,head_width=0.2 ``'-['`` widthB=1.0,lengthB=0.2,angleB=None ``'|-|'`` widthA=1.0,widthB=1.0 ``'-|>'`` head_length=0.4,head_width=0.2 ``'<-'`` head_length=0.4,head_width=0.2 ``'<->'`` head_length=0.4,head_width=0.2 ``'<|-'`` head_length=0.4,head_width=0.2 ``'<|-|>'`` head_length=0.4,head_width=0.2 ``'fancy'`` head_length=0.4,head_width=0.4,tail_width=0.4 ``'simple'`` head_length=0.5,head_width=0.5,tail_width=0.2 ``'wedge'`` tail_width=0.3,shrink_factor=0.5 ============ ============================================= Valid keys for `~matplotlib.patches.FancyArrowPatch` are: =============== ================================================== Key Description =============== ================================================== arrowstyle the arrow style connectionstyle the connection style relpos 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` =============== ================================================== Defaults to None, i.e. no arrow is drawn. annotation_clip : bool or None, optional Whether to draw the annotation when the annotation point *xy* is outside the axes area. - If *True*, the annotation will only be drawn when *xy* is within the axes. - If *False*, the annotation will always be drawn. - If *None*, the annotation will only be drawn when *xy* is within the axes and *xycoords* is 'data'. Defaults to *None*. **kwargs Additional kwargs are passed to `~matplotlib.text.Text`. Returns ------- annotation : `.Annotation` See Also -------- :ref:`plotting-guide-annotation`. )rNrQNzgYou have used the `textcoords` kwarg, but not the `xytext` kwarg. This can lead to surprising results.Ú arrowstyleÚrelpos)gà?gà?)r£Ú headwidthÚ headlengthÚshrinkÚfrac©rr©rr)rkrl)rLrXÚwarningsÚwarnrNÚ _textcoordsrrLÚ arrowpropsrŠrnÚ _arrow_relposrÂÚitemsr Ú arrow_patch)rSrrÚxytextrNZ textcoordsrprQrr7r8Z shapekeysr¢ÚvalrrrrXÎs:-    zAnnotation.__init__cCs:t ||¡\}}|jdk r2|j |¡\}}|p0|}||fS)N)rLrxrs)rSZeventrxZtinfoZin_patchr2rrrrx¥s  zAnnotation.containscCs| ¡S)zU The the text position. See also *xytext* in `.Annotation`. )rÊ)rSrrrÚxyann­szAnnotation.xyanncCs| |¡dS)N)r)rSrtrrrrv¶scCs|jS)z5The coordinate system to use for `.Annotation.xyann`.)ro)rSrrrÚ anncoordsºszAnnotation.anncoordscCs ||_dS)N)ro)rSZcoordsrrrrw¿szq Return the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. zn Set the coordinate system to use for `.Annotation.xyann`. See also *xycoords* in `.Annotation`. cCs&|jdk r|j |¡t ||¡dS)N)rsr?r)rSr@rrrr?Ñs  zAnnotation.set_figurecCs| |¡}| ||¡dS)z?Update the pixel positions of the annotated point and the text.N)r^Ú_update_position_xytext)rSr/r_rrrÚupdate_positionsÖs zAnnotation.update_positionsc"sð| | ||j¡¡| ¡\}}|\}}|jdk rì|\‰‰t ||¡j\}}} } || } || } d|| } d|| }|j ¡}|  d|  ¡¡}|j   |¡d|krÈ|  dd¡}|  dd¡}|  d d ¡}|  d d¡}|dk rìt  d ¡|  d d ¡}t||||||d}|j jd|Ž|df| df| dff}|df|df| dff}t‡fdd„|Dƒƒ\}\}}t‡fdd„|Dƒƒ\}\}}||f|_t |ˆ|ˆ¡} || | d¡}||j _||j _|j}t ||¡} | j| j|d}| j| j|d}|j  ||f||f¡d|kr6|j  |  d¡¡n¶|jrN|j  |j¡nž| d¡}!| ¡dkrv|j  d¡dSt ||¡} | j\}}} } ||!d8}||!d8}| |!7} | |!7} t ||f| | d} |  t!ƒ¡|  "d¡|j  | ¡dS)zX Update the pixel positions of the annotation text and the arrow patch. Ngà?Zmutation_scalererigr£rŽrgé rjzh'frac' option in 'arrowprops' is no longer supported; use 'headlength' to set the head length in points.rh)Z head_lengthZ head_widthZ tail_widthÚsimplerrc3s"|]}t|dˆƒ|fVqdS)rN)Úabs)r(ru)rÎrrú sz5Annotation._update_position_xytext..c3s"|]}t|dˆƒ|fVqdS)rN)r|)r(ru)rÏrrr} sZpatchArUg@)rr£r¤F)r{)#r¸rRrwr~rprLrvrwrŠrnr°rsrºrmrnrÂZset_arrowstyler,rqr&Zhypotr¹ZshrinkAZshrinkBrÎr£rÏr¤Z set_positionsZ set_patchArcrr rrÇ)"rSr/r_Zox0Zoy0Zox1Zoy1ryrzr9r:r{r5ZxcZycr4Zmsrir£rgrjrhZstylekwZxposZyposr2r7Zrelposxr8ZrelposyZ shrink_ptsrfrlr¬r)rÎrÏrrxÛsx                       z"Annotation._update_position_xytextcCs|dk r||_| ¡sdS| |¡}| ||¡s4dS| ||¡| |¡|jdk r€|jjdkrt|jdk rt|j|j_|j |¡t  ||¡dS)zN Draw the :class:`Annotation` object to the given *renderer*. N) rdrur^r`rxr¿rsrërÀrL)rSr/r_rrrrÀ@ s       zAnnotation.drawcCs„| ¡st ¡S|dk r||_|jdkr2|jj|_|jdkrDtdƒ‚| |j¡t  |¡}|g}|j dk rz|  |j   ¡¡t  |¡S)a Return the `Bbox` bounding the text and arrow, in display units. 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 saving the figure). Nz%Cannot get window extent w/o renderer) rurrðrdrërñròryrLrvrsÚappendÚunion)rSr/Z text_bboxZbboxesrrrrv[ s      zAnnotation.get_window_extentz3.0z[arrow was deprecated in Matplotlib 3.0 and will be removed in 3.2. Use arrow_patch instead.)ÚmessagecCsdS)Nr)rSrrrÚ€ szAnnotation.cCsdS)Nr)rSÚvaluerrrr s)ÚfgetÚfset)NrMNNN)N)rrrrrrXrxÚpropertyrvÚsetterrwrƒZ get_anncoordsr„Z set_anncoordsr?ryrxrrrÀrvrZ deprecatedZarrowrrrrrd¼s4  S  e " rd)rd)N)3rÚ contextlibZloggingrÔrmríZnumpyr&rUrrrrrZ font_managerrr¥r Zpatchesr r r Ztextpathr Z transformsrrrrrrZ getLoggerrrÞrÚcontextmanagerrr%r?Z_define_aliasesrLZinterpdrZkwdocZdedent_interpdrXrrmrArLrdrrrrÚsn       &  TWK