{:iPSrSSKrSSKrSSKrSSKJrJr SSKJ r SSK J r SSKJr SSKJr SSKJr SSKJr SSKJrJrJr SSKJrJrJr Sr S r!S r"S,S jr#S-S jr$"S S\ RJ5r&"SS\&5r'"SS\'5r("SS\'5r)"SS\&5r*"SS\&5r+"SS\&5r,"SS\&5r-"SS\&5r.Sr/"S S!\.5r0"S"S#\&5r1"S$S%\ RJ\Rd5r3"S&S'5r4"S(S)\45r5"S*S+\45r6g).ac Container classes for `.Artist`\s. `OffsetBox` The base of all container artists defined in this module. `AnchoredOffsetbox`, `AnchoredText` Anchor and align an arbitrary `.Artist` or a text relative to the parent axes or a specific anchor point. `DrawingArea` A container with fixed width and height. Children have a fixed position inside the container and may be clipped. `HPacker`, `VPacker` Containers for layouting their children vertically or horizontally. `PaddedBox` A container to add a padding around an `.Artist`. `TextArea` Contains a single `.Text` instance. N)_api _docstring)FontProperties) BboxImage)FancyBboxPatchFancyArrowPatch bbox_artist)BboxBboxBaseTransformedBboxFcV^^SS/m[R"T5UU4Sj5nU$)z Decorator for the get_offset method of OffsetBox and subclasses, that allows supporting both the new signature (self, bbox, renderer) and the old signature (self, width, height, xdescent, ydescent, renderer). c[5$Nlocals)selfwidthheightxdescentydescentrenderers W/srv/projetos/modelo_ml_acdoc/venv/lib/python3.13/site-packages/matplotlib/offsetbox.py$_compat_get_offset..3sfhc[5$rrrbboxrs rrr4src>[R"TU/UQ70UD6nSU;aUSO&[R"US*US*USUS5nT"USXCS5$)Nrrrrrrr)rselect_matching_signaturer from_bounds)rargskwargsparamsrmethsigss r get_offset&_compat_get_offset..get_offset6s{//dLTLVL"(F"2v  &"4!4vj7I6I!'&2BD F6ND*<==r) functoolswraps)r%r'r&s` @r_compat_get_offsetr+-s8 O 1 3D__T>> rc2[(a [U0UD6 ggr)DEBUG mbbox_artist)r"r#s r _bbox_artistr/As ud%f% rc[R"/SQUS9 US:Xa@[R"S/UVs/sHoDU-PM sn-5nUSSnUcUSU- nX4$US:XaiUcSn[ U5S:aU[ U5- [ U5S- - nOSn[R"S/UVs/sHoDU-PM sn-5nUSSnX4$US :Xae[ U5nUcUc [S 5eXr-[ U5-nOU[ U5- U- nXr-[R"[ U55-nX4$gs snfs snf) a Pack boxes specified by their *widths*. For simplicity of the description, the terminology used here assumes a horizontal layout, but the function works equally for a vertical layout. There are three packing *mode*\s: - 'fixed': The elements are packed tight to the left with a spacing of *sep* in between. If *total* is *None* the returned total will be the right edge of the last box. A non-*None* total will be passed unchecked to the output. In particular this means that right edge of the last box may be further to the right than the returned total. - 'expand': Distribute the boxes with equal spacing so that the left edge of the first box is at 0, and the right edge of the last box is at *total*. The parameter *sep* is ignored in this mode. A total of *None* is accepted and considered equal to 1. The total is returned unchanged (except for the conversion *None* to 1). If the total is smaller than the sum of the widths, the laid out boxes will overlap. - 'equal': If *total* is given, the total space is divided in N equal ranges and each box is left-aligned within its subspace. Otherwise (*total* is *None*), *sep* must be provided and each box is left-aligned in its subspace of width ``(max(widths) + sep)``. The total width is then calculated to be ``N * (max(widths) + sep)``. Parameters ---------- widths : list of float Widths of boxes to be packed. total : float or None Intended total length. *None* if not used. sep : float or None Spacing between boxes. mode : {'fixed', 'expand', 'equal'} The packing mode. Returns ------- total : float The total width needed to accommodate the laid out boxes. offsets : array of float The left offsets of the boxes. )fixedexpandequal)moder1rNr2r3z@total and sep cannot both be None when using layout mode 'equal') r check_in_listnpcumsumlensummax ValueErrorarange)widthstotalsepr4woffsets_offsetsmaxhs r_get_packed_offsetsrFFs`\ 3$? w99aSV#>Z3v;.E#f+%,C:3v;!77~ '$=$=s D9 .D> c[R"/SQUS9 Uc[SU55nUS:Xa6[SU55[SU554nS/[ U5-nX44$US;aSU4nUVVs/sHupVU*PM nnnX44$US ;aSU4nUVVs/sH upVX- PM nnnX44$US :Xa%SU4nUVVs/sHupVXU- - S -U- PM nnnWW4$s snnfs snnfs snnf) ad Align boxes each specified by their ``(y0, y1)`` spans. For simplicity of the description, the terminology used here assumes a horizontal layout (i.e., vertical alignment), but the function works equally for a vertical layout. Parameters ---------- yspans List of (y0, y1) spans of boxes to be aligned. height : float or None Intended total height. If None, the maximum of the heights (``y1 - y0``) in *yspans* is used. align : {'baseline', 'left', 'top', 'right', 'bottom', 'center'} The alignment anchor of the boxes. Returns ------- (y0, y1) y range spanned by the packing. If a *height* was originally passed in, then for all alignments other than "baseline", a span of ``(0, height)`` is used without checking that it is actually large enough). descent The descent of the packing. offsets The bottom offsets of the boxes. )baselinelefttoprightbottomcenter)alignc3.# UH upX!- v M g7fr.0y0y1s r '_get_aligned_offsets..s26RW6srHc3*# UH upUv M g7frrPrQs rrUrVs-fFBRfc3*# UH upUv M g7frrPrQs rrUrVs2KF&"2FrXr)rIrL)rKrJrM?)rr7r<minr:)yspansrrNyspanrDrSrTs r_get_aligned_offsetsr^s/< @O ~2622 -f--s2KF2K/KL#F # > $ $F %+,V62B3V, > " "F -34V626;V4 > ( F @FGfbF2g&",r1G '>-5Hs8C!C'C-c^\rSrSrSrU4SjrU4Sjr\RRRS5r Sr Sr \ S5rS rS rS rS rS rSrSSjrSrSrU=r$) OffsetBoxz A simple container artist. The child artists are meant to be drawn at a relative position to its parent. Being an artist itself, all parameters are passed on to `.Artist`. c>[TU]"U6 URU5 URS5 /UlSUlg)NFrr)super__init___internal_update set_clip_on _children_offset)rr"r# __class__s rreOffsetBox.__init__s< $ f%  rct>[TU]U5 UR5HnURU5 M g)zw Set the `.Figure` for the `.OffsetBox` and all its children. Parameters ---------- fig : `~matplotlib.figure.Figure` N)rd set_figure get_children)rfigcrjs rrmOffsetBox.set_figures1 3""$A LL %rc[RRRX5 UR 5HnUcMXlM gr)martistArtistaxesfsetrn)raxrps rruOffsetBox.axess9   *""$A}%rcURU5(aS04$UR5H"nURU5up4U(dMX44s $ S04$)a Delegate the mouse event contains-check to the children. As a container, the `.OffsetBox` does not respond itself to mouseevents. Parameters ---------- mouseevent : `~matplotlib.backend_bases.MouseEvent` Returns ------- contains : bool Whether any values are within the radius. details : dict An artist-specific dictionary of details of the event context, such as which points are contained in the pick radius. See the individual Artist subclasses for details. See Also -------- .Artist.contains F)_different_canvasrncontains)r mouseeventrpabs rr{OffsetBox.containssZ0  ! !* - -"9 ""$A::j)DAqt %byrcXlSUlg)a Set the offset. Parameters ---------- xy : (float, float) or callable The (x, y) coordinates of the offset in display units. These can either be given explicitly as a tuple (x, y), or by providing a function that converts the extent into the offset. This function must have the signature:: def offset(width, height, xdescent, ydescent, renderer) -> (float, float) TN)ristalerxys r set_offsetOffsetBox.set_offsets  rc[UR5(a?URURURUR*UR *U5$UR$)a Return the offset as a tuple (x, y). The extent parameters have to be provided to handle the case where the offset is dynamically determined by a callable (see `~.OffsetBox.set_offset`). Parameters ---------- bbox : `.Bbox` renderer : `.RendererBase` subclass )callablerirrx0rSrs rr'OffsetBox.get_offset#sP  %% LLT[[477(TWWHh O  rcXlSUlg)z@ Set the width of the box. Parameters ---------- width : float TN)rr)rrs r set_widthOffsetBox.set_width6s  rcXlSUlg)zB Set the height of the box. Parameters ---------- height : float TN)rr)rrs r set_heightOffsetBox.set_heightAs  rcrURVs/sHoR5(dMUPM sn$s snf)z/Return a list of the visible child `.Artist`\s.)rh get_visible)rrps rget_visible_childrenOffsetBox.get_visible_childrenLs$>>=>a]]_>===s44cUR$)z'Return a list of the child `.Artist`\s.)rhrs rrnOffsetBox.get_childrenP ~~rc[S5e)z Return the bbox of the offsetbox and the child offsets. The bbox should satisfy ``x0 <= x1 and y0 <= y1``. Parameters ---------- renderer : `.RendererBase` subclass Returns ------- bbox list of (xoffset, yoffset) pairs z:get_bbox_and_offsets must be overridden in derived classes)NotImplementedErrorrrs r_get_bbox_and_child_offsets%OffsetBox._get_bbox_and_child_offsetsTs" HJ Jrc,URU5up#U$)z:Return the bbox of the offsetbox, ignoring parent offsets.)r)rrrrDs rget_bboxOffsetBox.get_bboxfs88B  rcUcURSS9R5nURU5nURX!5up4UR X45$![a UR5up4N/f=fNTroot) get_figure _get_rendererrr' TypeError translated)rrrpxpys rget_window_extentOffsetBox.get_window_extentksv  D1??AH}}X& '__T4FBr&& '__&FB 'sAA65A6c URU5up#URX!5upE[UR5U5H0unupxUR XG-XX-45 UR U5 M2 [ XS[SS9S9 SUlg)zU Update the location of children if necessary and draw them to the given *renderer*. FpadfillpropsN) rr'ziprrdrawr/dictr rrrrDrrrpoxoys rrOffsetBox.drawvs 88B 0t88:GDKAx LL"'27+ , FF8 E T%t|D r)rhrirrrr)__name__ __module__ __qualname____firstlineno____doc__rermrsrtrusetterr{rr+r'rrrrnrrrr__static_attributes__ __classcell__rjs@rr`r`s  ^^ @$$  >J$ '  rr`c0^\rSrSrSU4SjjrSrU=r$) PackerBaseicv>[TU]5 X@lX0lX lXlX`lXPlXplg)a Parameters ---------- pad : float, default: 0.0 The boundary padding in points. sep : float, default: 0.0 The spacing between items in points. width, height : float, optional Width and height of the container box in pixels, calculated if *None*. align : {'top', 'bottom', 'left', 'right', 'center', 'baseline'}, default: 'baseline' Alignment of boxes. mode : {'fixed', 'expand', 'equal'}, default: 'fixed' The packing mode. - 'fixed' packs the given `.Artist`\s tight with *sep* spacing. - 'expand' uses the maximal available space to distribute the artists with equal spacing in between. - 'equal': Each artist an equal fraction of the available space and is left-aligned (or top-aligned) therein. children : list of `.Artist` The artists to pack. Notes ----- *pad* and *sep* are in points and will be scaled with the renderer dpi, while *width* and *height* are in pixels. N) rdrerrrArr4rNrh) rrrArrrNr4childrenrjs rrePackerBase.__init__s4H     !r)rhrNrr4rrAr)rrNNrHr1N)rrrrrerrrs@rrrs:>:>+"+"rrc\rSrSrSrSrSrg)VPackeriz VPacker packs its children vertically, automatically adjusting their relative positions at draw time. .. code-block:: none +---------+ | Child 1 | | Child 2 | | Child 3 | +---------+ cpURS5nURU-nURU-nURb[UR 5HGn[ U[ 5(dMURS:XdM,URUR5 MI UR 5Vs/sHoURU5PM nn[UVs/sHowRPM snURUR5uupn [UVs/sHowRPM snURX@R5upXUVs/sHowRPM sn-- n U Sn X- n [ R""X*X- U 5R%U5/['X5Q4$s snfs snfs snfs snf)N?r2r)points_to_pixelsrrArr isinstancerr4rrr^ intervalxrNrFrrTr r!paddedr)rrdpicorrrArpbboxesrrx1xoffsetsryoffsetsrs rr#VPacker._get_bbox_and_child_offsetssu**2.hhhh :: !..0a,,81CKK +1150I0I0KL0K1**X&0KL1(. /^^ /TZZI(.%+ ,VT[[V ,dkk3 KV(DVTV(DDEA;&   RBGV < C CC H &c(% &( (M / ,(Ds*F$F)F.F3rPNrrrrrrrrPrrrrs  (rrc\rSrSrSrSrSrg)HPackeriz HPacker packs its children horizontally, automatically adjusting their relative positions at draw time. .. code-block:: none +-------------------------------+ | Child 1 Child 2 Child 3 | +-------------------------------+ c URS5nURU-nURU-nUR5Vs/sHoUR U5PM nnU(d*[ R "SSSS5RU5/4$[UVs/sHowRPM snURUR5uupn [UVs/sHowRPM snURX@R5upUSRn XVs/sHowRPM snU - -n [ R "XXU- 5RU5/[!X5Q4$s snfs snfs snfs snf)Nrr)rrrArrr r!rr^ intervalyrrNrFrr4rr)rrrrrArprrrSrTrrrrs rr#HPacker._get_bbox_and_child_offsetssU**2.hhhh040I0I0KL0K1**X&0KL##Aq!Q/66s;R? ?1(. /^^ /djjJ(-$* +FDZZF +TZZiiIAY\\&1&$gg&1B67  R8??D*#h)*, ,M 0 +2sE2E7E<FrPNrrPrrrrs  ,rrcV^\rSrSrSrS SSS.U4SjjjrSrSrS S jrS r S r U=r $) PaddedBoxia A container to add a padding around an `.Artist`. The `.PaddedBox` contains a `.FancyBboxPatch` that is used to visualize it when rendering. .. code-block:: none +----------------------------+ | | | | | | | <--pad--> Artist | | ^ | | pad | | v | +----------------------------+ Attributes ---------- pad : float The padding in points. patch : `.FancyBboxPatch` When *draw_frame* is True, this `.FancyBboxPatch` is made visible and creates a border around the box. FN) draw_frame patch_attrsc >[TU]5 X lU/Ul[ SSSSSSSUSS9 UlUbUR R U5 g g ) a Parameters ---------- child : `~matplotlib.artist.Artist` The contained `.Artist`. pad : float, default: 0.0 The padding in points. This will be scaled with the renderer dpi. In contrast, *width* and *height* are in *pixels* and thus not scaled. draw_frame : bool Whether to draw the contained `.FancyBboxPatch`. patch_attrs : dict or None Additional parameters passed to the contained `.FancyBboxPatch`. rrrrBkr6T square,pad=0 rrr facecolor edgecolormutation_scalesnapvisibleboxstyleN)rdrerrhrpatchupdate)rchildrrrrjs rrePaddedBox.__init__sa #BS#     " JJ  k * #rcURURS5-nURSRU5R U5S/4$)Nrrrc)rrrhrr)rrrs rr%PaddedBox._get_bbox_and_child_offsets6sGhh22266q!**84;;C@6(KKrcJURU5up#URX!5upE[UR5U5HunupxUR XG-XX-45 M! UR U5 UR5HnUR U5 M SUlgNF)rr'rrrrrrrs rrPaddedBox.draw;s88B 0t88:GDKAx LL"'27+ ,E !**,A FF8 - rcURRUR5 U(aURRU5 SUlgNT)r set_boundsboundsset_mutation_scalerrrfontsizes r update_framePaddedBox.update_frameIs4 dkk*  JJ ) )( 3 rczURURU55 URRU5 gr)rrrrrs rrPaddedBox.draw_frameOs+ $00:; !r)rhrrr)rr) rrrrrrerrrrrrrs@rrrs56+Et++:L  ""rrc^\rSrSrSrSU4Sjjr\S5r\RS5rSr Sr Sr S r S r S rS rS rU=r$) DrawingAreaiUz The DrawingArea can contain any Artist as a child. The DrawingArea has a fixed width and height. The position of children relative to the parent is fixed. The children can be clipped at the boundaries of the parent. c>[TU]5 XlX lX0lX@lXPl[R"5Ul [R"5Ul g)z Parameters ---------- width, height : float Width and height of the container box. xdescent, ydescent : float Descent of the box in x- and y-direction. clip : bool Whether to clip the children to the box. N) rdrerrrr_clip_children mtransformsAffine2Doffset_transform dpi_transform)rrrrrcliprjs rreDrawingArea.__init__]sL     " + 4 4 6(113rcUR$)zT If the children of this DrawingArea should be clipped by DrawingArea bounding box. )rrs r clip_childrenDrawingArea.clip_childrenqs """rc2[U5UlSUlgr)boolrr)rvals rr r ys"3i rc4URUR-$)zH Return the `~matplotlib.transforms.Transform` applied to the children. )rrrs r get_transformDrawingArea.get_transform~s!!D$9$999rcgz set_transform is ignored. NrPrts r set_transformDrawingArea.set_transformrcXlURR5 URRUSUS5 SUlgz Set the offset of the container. Parameters ---------- xy : (float, float) The (x, y) coordinates of the offset in display units. rr6TNrirclear translaterrs rrDrawingArea.set_offset@  ##% ''1r!u5 rcUR$zReturn offset of the container.rirs rr'DrawingArea.get_offset ||rcURS5n[R"UR*U-UR*U-UR U-UR U-5$)Nr)rr r!rrrr)rrdpi_cors rrDrawingArea.get_bboxsW++B/ ]]NW $t}}nw&> JJ $++"79 9rc&URRU5 UR5(dURUR 55 UR bUR UlUR SS9nUbURU5 gg)&Add an `.Artist` to the container box.NFr)rhappendis_transform_setrrrurrm)rr}ros r add_artistDrawingArea.add_artistss a !!## OOD..0 1 99 YYAFoo5o) ? LL  rc lURS5nURR5 URRU5 [R "[ R"SS/SUR/URUR/URS//5UR55nURHXnUR(a3UR(d"UR(dURU5 UR!U5 MZ [#XS[%SS9S9 SUlg)NrrFrrr)rrrscalerTransformedPathmpathPathrrrrhrclipbox _clippath set_clip_pathrr/rr)rrr&tpathrps rrDrawingArea.draws++B/   "   ) ++ JJADKK 0T[[1Q) *    " A""AII& FF8  T%t|D r) rrirrrrrrr)rrF)rrrrrrepropertyr rrrrr'rr,rrrrs@rrrUsc4(##:  9 rrcl^\rSrSrSrSSS.U4SjjrSrSrS rS r S r S r S r Sr SrSrU=r$)TextAreaiz The TextArea is a container artist for a single Text instance. The text is placed at (0, 0) with baseline+left alignment, by default. The width and height of the TextArea instance is the width and height of its child text. NF) textpropsmultilinebaselinecd>Uc0n[R"SSU40UD6Ul[TU]5 UR/Ul[ R"5Ul[ R"5Ul URRURUR-5 X0l g)ac Parameters ---------- s : str The text to be displayed. textprops : dict, default: {} Dictionary of keyword parameters to be passed to the `.Text` instance in the TextArea. multilinebaseline : bool, default: False Whether the baseline for multiline text is adjusted so that it is (approximately) center-aligned with single-line text. Nr) mtextText_textrdrerhrrr_baseline_transformr_multilinebaseline)rsr;r<rjs rreTextArea.__init__s"  IZZ1a595  ** + 4 4 6#.#7#7#9    !6!6!%!9!9": ;"3rcHURRU5 SUlg)z&Set the text of this area as a string.TN)r@set_textrrrCs rrFTextArea.set_texts A rc6URR5$)z5Return the string representation of this area's text.)r@get_textrs rrJTextArea.get_textszz""$$rcXlSUlg)a( Set multilinebaseline. If True, the baseline for multiline text is adjusted so that it is (approximately) center-aligned with single-line text. This is used e.g. by the legend implementation so that single-line labels are baseline-aligned, but multiline labels are "center"-aligned with them. TN)rBrrs rset_multilinebaselineTextArea.set_multilinebaselines#$ rcUR$)z Get multilinebaseline. )rBrs rget_multilinebaselineTextArea.get_multilinebaselines&&&rcgrrPrs rrTextArea.set_transformrrcXlURR5 URRUSUS5 SUlgrrrs rrTextArea.set_offset rrcUR$r!r"rs rr'TextArea.get_offsetr$rc [R"USURRURR 5(aSOSUR SS9R S9up#nURRU5upVnURupURR5 [U5S:a?UR(a.SU -SX4- -- n URRS Xz- 5 U nO[X4- X- 5n X-n URR5n S U*S - U*S .U n [ R""X*X5$) NlpTeXFTr)ismathdpir6rZr)rIrMrK)r>_get_text_metrics_with_cacher@_fontproperties get_usetexrr\ _get_layoutsizerArr:rBrr<get_horizontalalignmentr r!)rr_h_d_rinfoydrBhyd_newh_dhars rrTextArea.get_bboxs$66 dDJJ66 JJ11335T*..0 r //9Byy   &&( t9q=T441Wsbg.F  $ $ . .q"+ >Bbgqv&CA ZZ / / 1A26QB 7 ;C..rc lURRU5 [XS[SS9S9 SUlgNFrrr)r@rr/rrrs rr TextArea.draw4s) !T%t|D r)rArhrBrir@rr)rrrrrrerFrJrMrPrrr'rrrrrs@rr:r:sL #(448 % '  /0rr:cV^\rSrSrSrU4SjrSrSrSrSr Sr S r S r S r U=r$) AuxTransformBoxi;aY An OffsetBox with an auxiliary transform. All child artists are first transformed with *aux_transform*, then translated with an offset (the same for all children) so the bounding box of the children matches the drawn box. (In other words, adding an arbitrary translation to *aux_transform* has no effect as it will be cancelled out by the later offsetting.) `AuxTransformBox` is similar to `.DrawingArea`, except that the extent of the box is not predetermined but calculated from the window extent of its children, and the extent of the children will be calculated in the transformed coordinate. c>Xl[TU] 5 [R"5Ul[R"5Ulgr) aux_transformrdrerrrref_offset_transform)rrtrjs rreAuxTransformBox.__init__Js8*  + 4 4 6%0$8$8$:!rcURRU5 URUR55 SUlg)r)TN)rhr*rrr)rr}s rr,AuxTransformBox.add_artistRs0 a  **,- rcNURUR-UR-$)z0Return the `.Transform` applied to the children.)rtrurrs rrAuxTransformBox.get_transformXs,""++,''( )rcgrrPrs rrAuxTransformBox.set_transform^rrcXlURR5 URRUSUS5 SUlgrrrs rrAuxTransformBox.set_offsetcrrcUR$r!r"rs rr'AuxTransformBox.get_offsetqr$rcURR5nURR5 URR5 URVs/sHo3R U5PM nn[ R"U5nURRUR*UR*5 URRU5 [ R"SSURUR5$s snfNr)r get_matrixrurrhrr unionrrrS set_matrixr!rr)rr_offrprubs rrAuxTransformBox.get_bboxus$$//1 !!'') ##%9=HA%%h/H ZZ  !!++RUUFRUUF; ((.1bhh :: IsD c ~URHnURU5 M [XS[SS9S9 SUlgro)rhrr/rr)rrrps rrAuxTransformBox.draws3A FF8  T%t|D r)rirtrrur)rrrrrrer,rrrr'rrrrrs@rrrrr;s5 ; )   ;rrrc ^\rSrSrSrSrSSSSSSS S S S S . rSSSSSSSS.U4SjjrSrSr Sr Sr Sr SSjr \S5rSSjrSrSrU=r$)AnchoredOffsetboxia An OffsetBox placed according to location *loc*. AnchoredOffsetbox has a single child. When multiple children are needed, use an extra OffsetBox to enclose them. By default, the offset box is anchored against its parent Axes. You may explicitly specify the *bbox_to_anchor*. r6r] ) z upper rightz upper leftz lower leftz lower rightrKz center leftz center rightz lower centerz upper centerrM皙?rZNT)r borderpadrpropframeonbbox_to_anchorbbox_transformc \>[T U]"S 0U D6 URXx5 URU5 [ U[ 5(a[ R"URUS9nXl X0l X l Uc [[RSS9UlOb[R "U5Ul[ U["5(a2SU;a,URR%[RS5 ['SSSSS URR)5S US S 9 Ulg)a Parameters ---------- loc : str The box location. Valid locations are 'upper left', 'upper center', 'upper right', 'center left', 'center', 'center right', 'lower left', 'lower center', 'lower right'. For backward compatibility, numeric values are accepted as well. See the parameter *loc* of `.Legend` for details. pad : float, default: 0.4 Padding around the child as fraction of the fontsize. borderpad : float, default: 0.5 Padding between the offsetbox frame and the *bbox_to_anchor*. child : `.OffsetBox` The box that will be anchored. prop : `.FontProperties` This is only used as a reference for paddings. If not given, :rc:`legend.fontsize` is used. frameon : bool Whether to draw a frame around the box. bbox_to_anchor : `.BboxBase`, 2-tuple, or 4-tuple of floats Box that is used to position the legend in conjunction with *loc*. bbox_transform : None or :class:`matplotlib.transforms.Transform` The transform for the bounding box (*bbox_to_anchor*). **kwargs All other parameters are passed on to `.OffsetBox`. Notes ----- See `.Legend` for a detailed description of the anchoring mechanism. )locNlegend.fontsizerbrbrrrBrTrrrP)rdreset_bbox_to_anchor set_childrstrr check_getitemcodesrrrrmplrcParamsr _from_anyrset_sizerget_size_in_pointsr) rrrrrrrrrr#rjs rreAnchoredOffsetbox.__init__sL "6" ? u c3  $$TZZS9C" <&CLL9J,KLDI&006DI$%%&*< ""3<<0A#BC#BS99779#   rcFXlUbURUlSUlg)zSet the child to be anchored.NT)_childrur)rrs rrAnchoredOffsetbox.set_childs  EJ rcUR$)zReturn the child.rrs r get_childAnchoredOffsetbox.get_childs {{rcUR/$)zReturn the list of children.rrs rrnAnchoredOffsetbox.get_childrens }rcURURR55nURU-nUR 5R U5R U5$r)rrrrrrr)rrrrs rrAnchoredOffsetbox.get_bboxsP,,TYY-I-I-KLhh!~~((299#>>rcURcURR$URnUc UR$[ URU5$)z,Return the bbox that the box is anchored to.)_bbox_to_anchorrur_bbox_to_anchor_transformr )r transforms rget_bbox_to_anchor$AnchoredOffsetbox.get_bbox_to_anchorsL    '99>> !66I +++&t';';YGGrc Ub[U[5(aXlO6[U5nUS:Xa USUSSS/n[ R"U6UlX lSUl g![an[ SU35UeSnAff=f)a Set the bbox that the box is anchored to. *bbox* can be a Bbox instance, a list of [left, bottom, width, height], or a list of [left, bottom] where the width and height will be assumed to be zero. The bbox will be transformed to display coordinate by the given transform. NzInvalid bbox: r]rr6T) rr rr:rr=r r!rr)rrrlerrs rr$AnchoredOffsetbox.set_bbox_to_anchors <:dH55#'  CIAvQa!Q/#'#3#3T#:D )2&  C >$!89sB Cs A$$ B.A==Bc NURURURR55-nUR 5n[ UR [R"SSURUR5XC5upVXQR- XaR- 4$r) rrrrr_get_anchored_bboxrr r!rrrrS)rrrrrrrSs rr'AnchoredOffsetbox.get_offsets~~**499+G+G+IJK002# HHd&&q!TZZE !GG|R''\))rcURRUR5 U(aURRU5 ggr)rrrrrs rrAnchoredOffsetbox.update_frame)s2 dkk*  JJ ) )( 3 rcUR5(dgURU5nURURR 55nUR X#5 UR RU5 URURU5U5upEUR5RXE45 UR5RU5 SUl gr) rrrrrrrrr'rrrr)rrrrrrs rrAnchoredOffsetbox.draw.s!! %%h/,,TYY-I-I-KL $) !x!8(C ##RH- h' r) rrrrrrrrrr)rrrrrzorderrrerrrnrrrr+r'rrrrrs@rrrsF EC$ $ $ @ @ D? H2**4 rrcf/SQUnURU*5nURXES9R$)zq Return the (x, y) position of the *bbox* anchored at the *parentbbox* with the *loc* code with the *borderpad*. ) NNENWSWSEEWrSNC) container)ranchoredp0)rr parentbboxrrprs rrr?s8 ESIA!!9*-I === 0 3 33rc8^\rSrSrSrSSSS.U4SjjrSrU=r$) AnchoredTextiKz AnchoredOffsetbox with Text. rrZN)rrrc >Uc0nSS1nU[U5-(a [S5e[XS9UlURRR 5n[ T U]"U4X4URUS.UD6 g)a Parameters ---------- s : str Text. loc : str Location code. See `AnchoredOffsetbox`. pad : float, default: 0.4 Padding around the text as fraction of the fontsize. borderpad : float, default: 0.5 Spacing between the offsetbox frame and the *bbox_to_anchor*. prop : dict, optional Dictionary of keyword parameters to be passed to the `~matplotlib.text.Text` instance contained inside AnchoredText. **kwargs All other parameters are passed to `AnchoredOffsetbox`. Nvaverticalalignmentz[T U]5 Xl[SURUUUUUUU S.U D6UlUR /UlURU5 URU5 g)N)rrrrrrrrrP) rdre_dpi_corrrimagerhset_zoomset_data) rarrrrrrrrrrr&r#rjs rreOffsetImage.__init__xst   !D$:$:$($(-:&,*4)2(0 !"( ! ** d crc[R"U5UlURR UR5 SUlgr)r8asarray_datarrr)rrs rrOffsetImage.set_datas.ZZ_  DJJ' rcUR$r)rrs rget_dataOffsetImage.get_data zzrcXlSUlgr)_zoomr)rrs rrOffsetImage.set_zooms  rcUR$r)rrs rget_zoomOffsetImage.get_zoomrrcUR$r!r"rs rr'OffsetImage.get_offsetr$rcUR/$r)rrs rrnOffsetImage.get_childrens |rcUR(aURS5OSnUR5nUR5nURSSupVX&-U-X%-U-p[ R "SSXx5$)Nrr]r)rrrrshaper r!) rrr&rdatanynxrBris rrOffsetImage.get_bboxsk37==(++B/b}}}}BQ|d"GL4$711a++rcHURRU5 SUlgr)rrrrs rrOffsetImage.draws ! r)rhrrrrr)rrrrrerrrrr'rnrrrrrs@rrrvsX# @ ,rrc \rSrSrSrSrSr\RSSSSSSSSS .S jj5r \ S 5r \ RS 5r \ S 5r \ RS5r SrSrSrSSjrSrSSjrSSjrSrSrSrg)AnnotationBboxiz Container for an `OffsetBox` referring to a specific position *xy*. Optionally an arrow pointing from the offsetbox to *xy* can be drawn. This is like `.Annotation`, but with `OffsetBox` instead of `.Text`. rcLSURSSSURSSS3$)NzAnnotationBbox(rg,r6))rrs r__str__AnnotationBbox.__str__s+ Aa 1~Q??rNTrrZrZ)rrannotation_clip box_alignment bboxprops arrowpropsrc [RRU5 [RRXXHS9 XlU bU R 5OSUlURU 5 UbUOUUl UbUOUUl Xl U b<URRSS5Ul [S 0URD6UlOSUl SUl[!SSSSSUR"R%5S US 9UlUR&R)S US 9 U (aUR&R*"S0U D6 UR-U 5 g)az Parameters ---------- offsetbox : `OffsetBox` xy : (float, float) The point *(x, y)* to annotate. The coordinate system is determined by *xycoords*. xybox : (float, float), default: *xy* The position *(x, y)* to place the text at. The coordinate system is determined by *boxcoords*. xycoords : single or two-tuple of str or `.Artist` or `.Transform` or callable, default: 'data' The coordinate system that *xy* is given in. See the parameter *xycoords* in `.Annotation` for a detailed description. boxcoords : single or two-tuple of str or `.Artist` or `.Transform` or callable, default: value of *xycoords* The coordinate system that *xybox* is given in. See the parameter *textcoords* in `.Annotation` for a detailed description. frameon : bool, default: True By default, the text is surrounded by a white `.FancyBboxPatch` (accessible as the ``patch`` attribute of the `.AnnotationBbox`). If *frameon* is set to False, this patch is made invisible. 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'. pad : float, default: 0.4 Padding around the offsetbox. box_alignment : (float, float) A tuple of two floats for a vertical and horizontal alignment of the offset box w.r.t. the *boxcoords*. The lower-left corner is (0, 0) and upper-right corner is (1, 1). bboxprops : dict, optional A dictionary of properties to set for the annotation bounding box, for example *boxstyle* and *alpha*. See `.FancyBboxPatch` for details. arrowprops: dict, optional Arrow properties, see `.Annotation` for description. fontsize: float or str, optional Translated to points and passed as *mutation_scale* into `.FancyBboxPatch` to scale attributes of the box style (e.g. pad or rounding_size). The name is chosen in analogy to `.Text` where *fontsize* defines the mutation scale as well. If not given, :rc:`legend.fontsize` is used. See `.Text.set_fontsize` for valid values. **kwargs Other `AnnotationBbox` properties. See `.AnnotationBbox.set` for a list. )xycoordsrNrelposrrrrBrT)rrrrrrrrsquarer)rc)r6r6rP)rsrtrer>_AnnotationBase offsetboxcopyr set_fontsizexybox boxcoords_box_alignmentpop _arrow_relposr arrow_patchrrrr set_boxstylerrf)rrrr rr!rrrrrrrr#s rreAnnotationBbox.__init__s9X % && x ' J#/9/E*//+4 (##/UR &/&;+  !!%!4!4Xz!JD . B15 BD "&D #D #BS99779    c2  JJNN 'Y ' f%rcUR$r)r rs rxyannAnnotationBbox.xyann7s zzrcXlSUlgr)r r)rr)s rr)r*;s  rcUR$r)r!rs r anncoordsAnnotationBbox.anncoords@rrcXlSUlgr)r!r)rcoordss rr-r.Ds rcURU5(aS04$URS5(dS04$URRU5$r)rz _check_xyrr{)rr|s rr{AnnotationBbox.containsIsK  ! !* - -"9 ~~d##"9 ~~&&z22rcURUR/nUR(aURUR5 U$r)rrr%r*)rrs rrnAnnotationBbox.get_childrenQs4NNDJJ/    OOD,, -rcURbURRU5 URRU5 [RRX5 gr)r%rmrrsrt)rros rrmAnnotationBbox.set_figureWsF    '    ' ' , !!#&!!$,rcZUc[RSn[US9UlSUlg)zS Set the fontsize in points. If *s* is not given, reset to :rc:`legend.fontsize`. NrrT)rrrrrrGs rrAnnotationBbox.set_fontsize]s+ 9 ./A"*  rc6URR5$)zReturn the fontsize in points.)rrrs r get_fontsizeAnnotationBbox.get_fontsizeisyy++--rcUcURSS9R5nURU5 [R"UR 5Vs/sHnUR U5PM sn5$s snfr)rrupdate_positionsr rrnrrrrs rr AnnotationBbox.get_window_extentmst  D1??AH h'zz(,(9(9(;=(;u!228<(;=> >=A6cUcURSS9R5nURU5 [R"UR 5Vs/sHnUR U5PM sn5$s snfr)rrr>r rrn get_tightbboxr?s rrCAnnotationBbox.get_tightbboxust  D1??AH h'zz(,(9(9(;=(;u!..x8(;=> >=rAc URXRUR5up#URR U5nUR upVURR X%UR-- UR- X6UR-- UR- 45 URRU5nURRUR5 URUR!55nURR#U5 UR$(aUR&UR(UR*--nUR-U5n UR.R1X5 SUR$;aURUR$S5nUR.R#U5 UR$R3SUR5n UR.R5U 5 gg)zHUpdate pixel positions for the annotated point, the text, and the arrow.rpatchAN)_get_xyr r!rrr"rrrrrSrrrrrr;rrrrbr$_get_position_xyr% set_positionsget set_patchA) rrox0oy0rfwfhr arrow_begin arrow_endrFs rr>AnnotationBbox.update_positions}s<<**dnnE~~&&x0$$ !! djj= 477 *CT[[.,@477,J K M~~//9 dkk*!2243D3D3FG %%n5 ?? ''DII0B0B$BBK--h7I    * *; B4??2!)!:!:OO$45"7    / / ?__((4::>F    ' ' /' rcUR5(aURU5(dgURURRUR 5S9 UR U5 URbbURRSS9c-URSS9=nbURRU5 URRU5 URRU5 URRU5 URURR5 SUlg)N)gidFr)rr2 open_grouprjrget_gidr>r%rrmrrr close_groupr)rrros rrAnnotationBbox.draws!!)A)A DNN33H h'    '  +++7? OOO77SD  ++C0    ! !( + ! H%T^^445 r) r$r"r%rr!rrrrr )NrNr)rrrrrrrrinterpdrer8r)rr-r{rnrmrr;rrCr>rrrPrrr r sF@i&3!%)  i&i&V \\3 - .>>"0Hrr c\rSrSrSrSSjr\S5r\"S5r \"S5r Sr Sr S r S rS rS rS rSrSrg) DraggableBaseiaG Helper base class for a draggable artist (legend, offsetbox). Derived classes must override the following methods:: def save_offset(self): ''' Called when the object is picked for dragging; should save the reference position of the artist. ''' def update_offset(self, dx, dy): ''' Called during the dragging; (*dx*, *dy*) is the pixel offset from the point where the mouse drag started. ''' Optionally, you may override the following method:: def finalize_offset(self): '''Called when the mouse is released.''' In the current implementation of `.DraggableLegend` and `DraggableAnnotation`, `update_offset` places the artists in display coordinates, and `finalize_offset` recalculates their position in axes coordinate and set a relevant attribute. c XlUR5(dURUR5 SUlU=(a UR R UlUR RnSUR4SUR4SUR44VVs/sH5upE[R"URURXE55PM7 snnUlgs snnf)NF pick_eventbutton_release_eventmotion_notify_event) ref_artistpickable set_picker_picker got_artistcanvas supports_blit _use_blit callbackson_pick on_release on_motionr)partial disconnect_connect_picklable_disconnectors)rr`use_blitrhnamefuncs rreDraggableBase.__init__s$""$$  ! !$,, /!?dkk&?&?KK)) t||,'9&7     $$i&B&B4&N P  s$s4??#=#=4#=#H#O#OrcdURSSVs/sHoRSPM sn$s snf)Nr]r)ror")rrms rrrys6-1-@-@!-D"F-Dz-D"F"Fs-c2UR5(GaUR(aURUR- nURUR - nUR X#5 UR(aURRUR5 URRURRSS9R55 URR5 gURR5 gggr)_check_still_parentedrdxmouse_xymouse_y update_offsetrgrerestore_region backgroundr`rrrblit)revtdxdys rrkDraggableBase.on_motions  % % ' 'DOO%B%B   r &~~ **4??;$$OO..D.9GGIK   "   "-< 'rcUR5(GaGURUR:XaMURRUlURR UlUR5 SUl UR(aUR(aURRS5 URR5 URRSS9nURRUR 5UlURRUR%55 URR'5 gggg)NTFr)r|rvr`r|r}r~rr save_offsetrdrg set_animatedrerrcopy_from_bboxrrrr)rrros rriDraggableBase.on_picks  % % ' 'zzT__,"~~// "~~//   ""&4>>,,T2   "oo00e0<"&++"<"^\rSrSrSU4SjjrSrSrSrSrU=r $)DraggableOffsetBoxi(c,>[TU]XS9 X lgN)rp)rdrer)rr`rrprjs rreDraggableOffsetBox.__init__)s 7"rcURnURSS9R5nURUR U5U5nUuUlUlURRU5 gr)rrrr'r offsetbox_x offsetbox_yr)rrroffsets rrDraggableOffsetBox.save_offset-sfNN ''T'2@@B%%i&8&8&BHM-3*$* !!&)rcvURU-URU-4nURRU5 gr)rrrr)rrr loc_in_canvass rr DraggableOffsetBox.update_offset4s4((2-t/?/?"/DD  !!-0rcURnURSS9R5nURU5nURupEXCR -XSR -4nU$r)rrrrrirrS)rrrrrrrs rget_loc_in_canvas$DraggableOffsetBox.get_loc_in_canvas8s`NN ''T'2@@B!!(+""ggrGG|4 r)rrrr) rrrrrerrrrrrs@rrr(s#*1rrc8^\rSrSrSU4SjjrSrSrSrU=r$)DraggableAnnotationiAc,>[TU]XS9 Xlgr)rdre annotation)rrrprjs rreDraggableAnnotation.__init__Bs 7$rcURnUR5RUR5uUlUlgr)rrrr)rr)ranns rrDraggableAnnotation.save_offsetFs1oo,,.88CrcURnUR5R5RURU-UR U-45Ulgr)rrinvertedrrrr))rrrrs rr!DraggableAnnotation.update_offsetJsGoo%%'002<< WWr\477R< (* r)rrrr) rrrrrerrrrrs@rrrAs%D**rr)r1)rH)7rr)numpyr8 matplotlibrrrmatplotlib.artistrvrsmatplotlib.pathpathr1matplotlib.texttextr>matplotlib.transforms transformsrmatplotlib.font_managerrmatplotlib.imagermatplotlib.patchesrrr r.r r r r-r+r/rFr^rtr`rrrrrr:rrrrrrrr r[rrrPrrrsA0'#+2&BBAA (& Nb0fwwt,","^%(j%(P,j,DU" U"pm)m`syslMiM`q qh 4($(VD)DNrW^^U%:%:rjs s l2 *- *r