hzSrSSKrSSKrSSKJrJr SSKJ r SSK J r \R"\5rSSjrSSjrSrSrSrSSSSS .S jrSSSSS .S jrSSS .S jrSrSrSrSSSSS .SjrSS.SjrSrSrg)a Adjust subplot layouts so that there are no overlapping Axes or Axes decorations. All Axes decorations are dealt with (labels, ticks, titles, ticklabels) and some dependent artists are also dealt with (colorbar, suptitle). Layout is done via `~matplotlib.gridspec`, with one constraint per gridspec, so it is possible to have overlapping Axes if the gridspecs overlap (i.e. using `~matplotlib.gridspec.GridSpecFromSubplotSpec`). Axes placed using ``figure.subplots()`` or ``figure.add_subplots()`` will participate in the layout. Axes manually placed via ``figure.add_axes()`` will not. See Tutorial: :ref:`constrainedlayout_guide` General idea: ------------- First, a figure has a gridspec that divides the figure into nrows and ncols, with heights and widths set by ``height_ratios`` and ``width_ratios``, often just set to 1 for an equal grid. Subplotspecs that are derived from this gridspec can contain either a ``SubPanel``, a ``GridSpecFromSubplotSpec``, or an ``Axes``. The ``SubPanel`` and ``GridSpecFromSubplotSpec`` are dealt with recursively and each contain an analogous layout. Each ``GridSpec`` has a ``_layoutgrid`` attached to it. The ``_layoutgrid`` has the same logical layout as the ``GridSpec``. Each row of the grid spec has a top and bottom "margin" and each column has a left and right "margin". The "inner" height of each row is constrained to be the same (or as modified by ``height_ratio``), and the "inner" width of each column is constrained to be the same (as modified by ``width_ratio``), where "inner" is the width or height of each column/row minus the size of the margins. Then the size of the margins for each row and column are determined as the max width of the decorators on each Axes that has decorators in that margin. For instance, a normal Axes would have a left margin that includes the left ticklabels, and the ylabel if it exists. The right margin may include a colorbar, the bottom margin the xaxis decorations, and the top margin the title. With these constraints, the solver then finds appropriate bounds for the columns and rows. It's possible that the margins take up the whole figure, in which case the algorithm is not applied and a warning is raised. See the tutorial :ref:`constrainedlayout_guide` for more discussion of the algorithm with examples. N)_apiartistc LUR5n[USUS9nUS(d[R"S5 g[ S5GHWn [ XXqX#US9 [ XXqUS9 [X5 XR5 Sn [X5(a[XXqX#US9 U(a[X5nXR5 [X5(a [XXqX#US9 O[R"U 5 UR=n byU R5(adU R(aSU R5upU R!XUR#5R$U-45 U R'S 5 O[R"U 5 [)X5 GMZ U$) a Do the constrained_layout. Called at draw time in ``figure.constrained_layout()`` Parameters ---------- fig : `~matplotlib.figure.Figure` `.Figure` instance to do the layout in. h_pad, w_pad : float Padding around the Axes elements in figure-normalized units. hspace, wspace : float Fraction of the figure to dedicate to space between the Axes. These are evenly spread between the gaps between the Axes. A value of 0.2 for a three-column layout would have a space of 0.1 of the figure width between each column. If h/wspace < h/w_pad, then the pads are used instead. rect : tuple of 4 floats Rectangle in figure coordinates to perform constrained layout in [left, bottom, width, height], each from 0-1. compress : bool Whether to shift Axes so that white space in between them is removed. This is useful for simple grids of fixed-aspect Axes (e.g. a grid of images). Returns ------- layoutgrid : private debugging structure N)recthasgridszhThere are no gridspecs with layoutgrids. Possibly did not call parent GridSpec with the "figure" keyword)h_padw_padhspacewspace)r r z{constrained_layout not applied because axes sizes collapsed to zero. Try making figure larger or Axes decorations smaller.bottom) _get_renderermake_layoutgridsr warn_externalrangemake_layout_marginsmake_margin_suptitlesmatch_submerged_marginsupdate_variablescheck_no_collapsed_axesreposition_axescompress_fixed_aspect _suptitle get_in_layout_autopos get_position set_positionget_inner_bboxy1set_verticalalignment reset_margins) figr r r r rcompressrenderer layoutgrids_warn_collapsedsuptitlexs P/var/www/html/env/lib/python3.13/site-packages/matplotlib/_constrained_layout.pydo_constrained_layoutr+?sH  "H"348K z " / 0  1X Kh"'v Gk$) + 1 ))+G #; 4 4 Kh"'v G3KE  113*;<<#Kh*/vO&&~6!$.X; ..00X5F5F#002DA)),;;=@@5HIK228<   ~ .k'YZ c Uc[5nSUS'[US5(d[R"USS9X'OnURR 5n[ X5nXn[R"USSSSURRURR4S 9X'URHn[XQ5nM URH#nUR 5nUcM[ X5nM% U$) z Make the layoutgrid tree. (Sub)Figures get a layoutgrid so we can have figure margins. Gridspecs that are attached to Axes get a layoutgrid so Axes can have margins. Fr_parentfiglb)parentnamepanellbT)r0r1 parent_innernrowsncols parent_pos) dicthasattr mlayoutgrid LayoutGrid _subplotspec get_gridspecmake_layoutgrids_gsrowspancolspansubfigsr _localaxes)r"r%rgsparentlbsfigaxs r*rrsf "' J 3 " "'11GL    * * ,*+: ?&111((00((002 3  &t9 nn __  >-k>K r,c ~X;d URcU$SUS'[US5(d\XRn[R"USSURUR UR 5UR5S9X'U$URnUR5nX@;a [X5nXnUS4nX`;a0[R"USSSURUR4S9X'[R"XSUR URUR 5UR5S 9X'U$) zJ Make the layoutgrid for a gridspec (and anything nested in the gridspec) Tr _subplot_specgridspec)r0r4r1r6r5 width_ratios height_ratiostopr3)r0r1r5r6r7)r0r1r5r6rJrK) figurer9r:r;_ncols_nrowsget_width_ratiosget_height_ratiosrHr=r>r?r@)r%rCr0 subplot_specparentgs subspeclbreps r*r>r>sG  BII-#K  2 ' 'YY'%00!iiryy002 224 6 < +'' ,,.  &-kDK) 5k  !*55 q(00,2F2FG  IK  &00"'iiryy002 224 6  r,cURHn[X5nU(aM g URHnUR5nXP;dMXn[ UR 5HTn[ UR 5H8nURXx5n U RS::dU RS::dM6 g MV M g)z1 Check that no Axes have collapsed to zero size. FrT) rAraxesr=rr5r6rwidthheight) r%r"rEokrFrClgijbbs r*rrs  $[ 7rhh __  B288_rxxA**10Bxx1} Q$)%  r,cSnURGH\nUR5cMUR5 UR5nUR5nUcCUn[R "UR 5n[R "UR5nOXR:wa [S5eURSS9nURSS9n URU R- n U S:a0[R"WURU 5XdR'URU R- n U S:dGM,[R"WURU 5XtR'GM_ Uc [S5e[R"W5S- n XR!SU 5 XR!S U 5 [R"W5S- n XR!S U 5 XR!S U 5 U$) NzECannot do compressed layout if Axes are notall from the same gridspecToriginalFrz>Cannot do compressed layout if no Axes are part of a gridspec.rleftrightrLr )rWget_subplotspec apply_aspectr=npzerosr6r5 ValueErrorrrXmaximumr@rYr?sumedit_margin_min)r%r"rCrFsub_gsextrawextrahorigactualdwdhwhs r*rr s Bhh    '    "  :BXXbhh'FXXbhh'F Y:; ;-%0 ZZ&,, & 6"$**VCKK-@""EF;;  [[6== ( 6"$**VCKK-@""EF;; ), z34 4 vA$$VQ/$$Wa0 vA$$UA.$$Xq1 r,r r r r c URnUR5n[US5(a7URb UROUnURb UROUnO6UR b UR OUnUR b UR OUnUS- nUS- nUR5upXX"SSSSS.n X- U:aBURRS:aX- U S'URRU :aX- U S'Xy- U:aBURRU :aXy- U S'URRS:aXy- U S'U $) Nr rr)leftcbrightcbbottomcbtopcbrbrcrLr rxryrzr{) r<r=r9r r _hspace_wspace get_geometryr@startstopr?) objr r r r ssrCr|r}r5r6margins r*get_margin_from_paddingr0s?  B  Br8 " 52996 " 52996!#!72::V!#!72::VkGkG??$LE!!%F ::  a &F8  ::??U " 'F9  ::??U "!(F:  ::  a %oF7O Mr,c  URHJnURnUR5n [XUX4XVS9 [ USSXVS9n X R X5 ML UR GHn U R5(aU R5(dM0U R5nUR5n X;a g[ XUXVS9n [X5upU S==U RUR- - ss'U S==URU R- - ss'U S==U RUR- - ss'U S==URU R- - ss'U RGHn[X5n[!U5unnUR"Sn[X5unnUS:Xa?UR$UR&R$:XaU S ==UR(U-- ss'OUS:Xa?UR*UR&R*:XaU S ==UR(U-- ss'OUS:Xa?UR*UR,R*:XaU S ==UR.U-- ss'O>UR$UR,R$:XaU S ==UR.U-- ss'US ;aUR*UR&R*:Xa>URUR:a$U S==URUR- - ss'UR$UR&R$:Xa>URUR:a$U S==URUR- - ss'US;dGMUR$UR,R$:Xa>URUR:a$U S==URUR- - ss'UR*UR,R*:XdGMURUR:dGMU S==URUR- - ss'GM X R X5 GM UR0GHnSnUR2(dMUR4bM(Uc$UR6R95R:nU"UR=U55nUR(SU--nUR.SU--nUR2nUS:XaXR?SU5 OUS:XaXR?SU5 US:XaXR?SU5 MUS:XdMXR?SU5 GM g)aa For each Axes, make a margin between the *pos* layoutbox and the *axes* layoutbox be a minimum size that can accommodate the decorations on the axis. Then make room for colorbars. Parameters ---------- layoutgrids : dict fig : `~matplotlib.figure.Figure` `.Figure` instance to do the layout in. renderer : `~matplotlib.backend_bases.RendererBase` subclass. The renderer to use. w_pad, h_pad : float, default: 0 Width and height padding (in fraction of figure). hspace, wspace : float, default: 0 Width and height padding as fraction of figure size divided by number of columns or rows. rvrNrbrcr rLlocationryrxr{rz)rLr rbrcrlowerupper) rAr<r=rredit_outer_margin_minsrBrdrget_pos_and_bboxx0x1y0r _colorbarscolorbar_get_padget_cb_parent_spans_colorbar_inforr@rXrr?rYlegends _outside_loc_bbox_to_anchor transFigureinvertedtransform_bbox get_tightbboxrk)r%r"r$r r r r rErrCmarginsrFrposbboxcbaxpad cbp_rspan cbp_cspanloccbposcbbboxleg inv_trans_figrtru legendlocs r*rrVs},     __ Kx"'#) :*$aq17H..w;nn!!##2+;+;+=+=     ! __  (06G$R2  v#&&477**w477SVV++xCFFTWW,,u 366)) MMD";5C#6t#< Iy%%j1C,T>RZZ__49%);;%??bjj&6&668$ s(::$??bjj&6&667Ov}}s'::O>>RZZ__4:&&--#*==&''OOrzz'7'77 DGG+6Ndgg &99NNNbjjoo5 DGG+7Ovyy477'::O''NNbjjoo5 DGG+8$&))(;;$OOrzz'7'77 DGG+5MVYY%88MK"N ..v:}B{{     3 3 ;$ # 8 8 : I I  !2!28!<=D QY&A a%i'A((IG# 001=g% 00:G# 00!<f$ 00;!r,r r c URR5Rn[R"SS/X4//5nURUR - RU5nUR nURnURHn [X UX4S9 M URbURR5(aURR5n [URSS5(ahURRU SSU- 45 U"URRU55n XR!SU R SU--5 UR"bUR"R5(aUR"R5n [UR"SS5(aeUR"RU SU45 U"UR"RU55n XR!SU R SU--5 UR$bUR$R5(aUR$R5n [UR$SS5(aeUR$RXS45 U"UR$RU55n XR!S U RSU--5 gggg) NrrrFr3rLrr rb)rrr mtransformsBboxtransSubfigurerYrXrArrrrgetattrrrrk _supxlabel _supylabel) r%r"r$r r rpadbox h_pad_local w_pad_localrEprs r*rrsaOO,,.==M   1v~6 7Foo  !"0."8 --K,,K k$) 8 }} S]]%@%@%B%B MM & & ( 3==*e 4 4 MM & &!a+o'> ? !>:u 5 5 NN ' '1{(; < !=!=h!GHD   , ,X-1[[1u9-D F ~~!cnn&B&B&D&D NN ' ' ) 3>>:u 5 5 NN ' 'd(; < !=!=h!GHD   , ,VTZZ!e)5K L 6'E!r,c  URHn[X5 M UR5Vs/sH/nUR5cMUR 5(dM-UPM1 nnUGHnUR5nUR 5U;aUR U5 M;XR 5n[UR5S:Ga[R"URSURSSURSURSS-5n[R"URSURSSURSURSS-5n UHn U R5n X R 5n U cM*[U R5S:dME[R"U RSU RSSU RSU RSS-5n X:aU n[R"U RSU RSSU RSU RSS-5nX:dMUn M URSSHnURSXS9 M URSSHnURSXS9 M [UR5S:dGMv[R"URS URSSURS URSS-5n[R"URS URSSURS URSS-5nUGHn U R5n X R 5n U cM+[U R5S:dMF[R"[R"U RS U RSSU RS U RSS-5U/5n[R"[R"U RS U RSSU RS U RSS-5U/5nGM URSSHnURS UUS9 M URSSHnURS UUS9 M GM gs snf) a Make the margins that are submerged inside an Axes the same size. This allows Axes that span two columns (or rows) that are offset from one another to have the same size. This gives the proper layout for something like:: fig = plt.figure(constrained_layout=True) axs = fig.subplot_mosaic("AAAB CCDD") Without this routine, the Axes D will be wider than C, because the margin width between the two columns in C has no width by default, whereas the margins between the two columns of D are set by the width of the margin between A and B. However, obviously the user would like C and D to be the same size, so we need to add constraints to these "submerged" margins. This routine makes all the interior margins the same, and the spacing between the three columns in A and the two column in C are all set to the margins between the two columns of D. See test_constrained_layout::test_constrained_layout12 for an example. Nr3rbrxrcry)cellrLr{r rz)rArget_axesrdrr=removelenr@rfmax margin_valsrkr?)r%r"rEaaxsax1ss1lg1maxsublmaxsubrax2ss2lg2maxsubl2maxsubr2r\maxsubtmaxsubbs r*rrs2  2lln En! 23//2C nC E!!#    [ 0 JJsO **,- s{{ a ff' AB8)#++ab/:;Gff(Sb)9: *3;;s+;<=G))+!"2"2"45?s3;;'7!';!vv/ AB@1#++ab/BC DH )"*!vv0Sb1AB 23;;s3CDE FH )"*[[_##FG#<%[["%##GW#=& s{{ a ff&s{{127(QR9:Gff)#++cr*:; +CKK,<=>G ))+!"2"2"45?3;;'!+"$&&"&&OOE23;;qr?COOG4S[[_EF+#*$#%#%&&"&&OOH5ckk#26FGOOJ7 CR8HIJ+#*$#%[[_##E7#;%[["%##HgA#>&} EsS: S:!S:c[Rn[R*n[Rn[R*nURSHnUR5n[ UR R U5n[UR RU5n[ URR U5n[URRU5nM [X5n[X45nXx4$)z Figure out which subplotspecs this colorbar belongs to. Parameters ---------- cbax : `~matplotlib.axes.Axes` Axes for the colorbar. parents) rfinfrrdminr?rrrr@r) rrowstartrowstopcolstartcolstopr0rr?r@s r*rrTsvvHvvgGvvHvvgG%%i0  # # %rzz''2bjjoow/rzz''2bjjoow/ 1H&GH&G  r,c"URSS9nURSS9nURURUR- 5n[ R "X5nUcUnX54$URURR55nX54$)aK Get the position and the bbox for the Axes. Parameters ---------- ax : `~matplotlib.axes.Axes` renderer : `~matplotlib.backend_bases.RendererBase` subclass. Returns ------- pos : `~matplotlib.transforms.Bbox` Position in figure coordinates. bbox : `~matplotlib.transforms.Bbox` Tight bounding box in figure coordinates. FrootTr`) get_figurer transformedrrmartist_get_tightbbox_for_layout_onlyr)rFr$r"r tightbboxrs r*rrms --U- #C //4/ (C //#,,s> ?C66rDI 9$$S__%=%=%?@ 9r,c URUR- nURH?nXR5n UR U R U5S9 [ XUX4XeS9 MA URHn U R5bU R5(dM+U R5n U R5n X;a gX RU RU RS9n URU 5n U RU 5 SSSSS.n[!U R"SSS25H*unnU UR$SS:XdM['UUUUS 9 M, M g) z> Reposition all the Axes based on the new inner bounding box. )r)r r r r Nrowscolsr)rbrcr rLrroffset)rrrAget_outer_bbox_redo_transform_rel_figrrrBrdrr=rr?r@r _set_position enumeraterrreposition_colorbar)r%r"r$r r r r trans_fig_to_subfigrErrFrrCnewbboxrnnrs r*rrs^ //C,>,>>  //1 $$!!"56 % 8 8#% 6 nn    'r/?/?/A/A    ! __  --2::35::.?&44T: ! a1Q?!"--""56HBT((3A66#Kx+137-r,rcURSnUSR5nURSS9nURUR- n[ U5upXR UU S9n XRXS9n URSn URSn URSnURS nURS n[X5unn[X5nU S ;GaU RUU5RX5nU S :XanURUR- nU RUR- US -nUUU-- nUS ==URU-- ss'URUS5nGOURUR- nU RUR- nUUR*U- U-US - - nUS ==URU-- ss'URUS5nGOU RUU5RX5nU S:XamUR UR - nU R"UR - US-nUUU-- nUS==UR$U-- ss'URSU5nOzUR UR - nU R UR - nUUR$*U- U-US- - nUS==UR$U-- ss'URSU5nUR'U5nUR)UR5 UR+U5 UR-U 5 U S;aSU- nUR/U5 UR1S5 U$)aS Place the colorbar in its new place. Parameters ---------- layoutgrids : dict cbax : `~matplotlib.axes.Axes` Axes for the colorbar. renderer : `~matplotlib.backend_bases.RendererBase` subclass. The renderer to use. offset : array-like Offset the colorbar needs to be pushed to in order to account for multiple colorbars. rrFrrranchorfractionaspectshrinkrrcrbrLr )r rLr3auto)rr=rrrrget_bbox_for_cbrrrshrunkanchoredrrrX translatedrrrYr set_transformr set_anchorset_box_aspect set_aspect)r%rr$rrrCr"r cb_rspans cb_cspans bboxparentpbrrrrrrrcbpadpbcblmargindxbmargindys r*rrsW !!),G  "B //u/ %C//C,>,>>.t4I00i6?1AJ  ' 'Y ' GB"":.H   *F"":.H   *F   *F$T4ME6 [ /E$$yy6*33F? w hh*G(6'?:B %'/ !B 7Ov||e3 3O??2q)Dhh*G(B 6<<-%''1F6NB BB 6NfllU2 2N??2q)Dyy*33F? u hh*G(6%=8B %'/ !B 5MV]]U2 2M??1b)Dhh*G(B 6==.5(72VH5EE EB 8   5 5 ??1b)D  - -d 3Ds))*tOOF$$VOOF Mr,c URHn[X5 M URHCnUR5(dMUR 5nX@;dM1XR5 ME XR5 g)z Reset the margins in the layoutboxes of *fig*. Margins are usually set as a minimum, so if the figure gets smaller the minimum needs to be zero in order for it to grow again. N)rAr!rWrr=)r%r"rErFrCs r*r!r!sh k(hh    "B --/  ""$r,cURSnUSR5n[U5upEXRXES9nURSS;a URnO UR nURSU-$)Nrrrr)rcrbr)rr=rrrXrY)r%caxrrCrr bboxoutersizes r*rrs  +G  "B.s3I..I.NI *%)::   e $t ++r,)NNrrr3r3F)r) __doc__loggingnumpyrf matplotlibrrrmatplotlib.transforms transformsrmatplotlib._layoutgrid _layoutgridr: getLogger__name___logr+rr>rrrrrrrrrrr!rr,r*rs/b.+," :F#(Zz*Z+\("J+,1#$Q#L>?a s