o îÇ h«zã@südZddlZddlZddlmZmZddlm Z ddl m Z e e¡Z  d'dd„Zd(dd „Zd d „Zd d „Zdd„Zdddddœdd„Zdddddœdd„Zdddœdd„Zdd„Zdd„Zdd„Zdddddœdd„Zdd œd!d"„Zd#d$„Zd%d&„ZdS))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)Ú_apiÚartist©rrérFc CsJ| ¡}t|d|d}|dst d¡dStdƒD]ˆ} t|||||||dt|||||dt||ƒ|| ¡d} t ||ƒr˜t |||||||d|r—t ||ƒ}|| ¡t ||ƒrkt |||||||dnt | ¡|j } dur—|   ¡r—| jr—|  ¡\} } |  | || ¡j|f¡|  d ¡nt | ¡t||ƒq|S) a3 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)ÚrectÚhasgridszhThere are no gridspecs with layoutgrids. Possibly did not call parent GridSpec with the "figure" keywordé)Úh_padÚw_padÚhspaceÚwspace)r r z{constrained_layout not applied because axes sizes collapsed to zero. Try making figure larger or Axes decorations smaller.Úbottom)Ú _get_rendererÚmake_layoutgridsrÚ warn_externalÚrangeÚmake_layout_marginsÚmake_margin_suptitlesÚmatch_submerged_marginsÚupdate_variablesÚcheck_no_collapsed_axesÚreposition_axesÚcompress_fixed_aspectÚ _suptitleÚ get_in_layoutÚ_autoposÚ get_positionÚ set_positionÚget_inner_bboxÚy1Úset_verticalalignmentÚ reset_margins) Úfigr r r r rÚcompressÚrendererÚ layoutgridsÚ_Úwarn_collapsedÚsuptitleÚx©r*úr/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/matplotlib/_constrained_layout.pyÚdo_constrained_layout?sR$   ÿ ÿ    ÿ    ÿ ÿÿ ÿ €  r,cCs¶|dur tƒ}d|d<t|dƒstj|dd||<n!|j ¡}t||ƒ}||}tj|ddd d |jj|jjfd ||<|j D]}t ||ƒ}q>|j D]}| ¡}|durXt||ƒ}qI|S) 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. NFrÚ_parentÚfiglb)ÚparentÚnameÚpanellbTr)r/r0Ú parent_innerÚnrowsÚncolsÚ parent_pos) ÚdictÚhasattrÚ mlayoutgridÚ LayoutGridÚ _subplotspecÚ get_gridspecÚmake_layoutgrids_gsÚrowspanÚcolspanÚsubfigsrÚ _localaxes)r"r%rÚgsÚparentlbÚsfigÚaxr*r*r+rœs2    ÿ û    €rc Csä||vs |jdur |Sd|d<t|dƒs/||j}tj|dd|j|j| ¡| ¡d||<|S|j}|  ¡}||vr?t ||ƒ}||}|df}||vr[tj|ddd|j |j fd ||<tj||d|j|j| ¡| ¡d ||<|S) zR Make the layoutgrid for a gridspec (and anything nested in the gridspec) NTrÚ _subplot_specÚgridspec)r/r2r0r4r3Ú width_ratiosÚ height_ratiosÚtopr)r/r0r3r4r5)r/r0r3r4rGrH) Úfigurer7r8r9Ú_ncolsÚ_nrowsÚget_width_ratiosÚget_height_ratiosrEr;r<r=r>)r%rAr/Ú subplot_specÚparentgsÚ subspeclbÚrepr*r*r+r<ÉsF   úë   ü ûr<c Cs’|jD] }t||ƒ}|sdSq|jD]3}| ¡}||vrF||}t|jƒD]}t|jƒD]}| ||¡} | jdks?| j dkrDdSq-q&qdS)z9 Check that no Axes have collapsed to zero size. FrT) r?rÚaxesr;rr3r4rÚwidthÚheight) r%r"rCÚokrDrAÚlgÚiÚjÚbbr*r*r+r÷s$  ÿ   ÿþ€rcCsLd}|jD]h}| ¡durq| ¡| ¡}| ¡}|dur-|}t |j¡}t |j¡}n||kr5tdƒ‚|j dd}|j dd} |j | j } | dkrWt  ||j | ¡||j <|j | j } | dkrmt  ||j| ¡||j<q|durvtdƒ‚t |¡d} || d| ¡|| d | ¡t |¡d} || d | ¡|| d | ¡|S) NzECannot do compressed layout if Axes are notall from the same gridspecT©ÚoriginalFrz>Cannot do compressed layout if no Axes are part of a gridspec.rÚleftÚrightrIr )rSÚget_subplotspecÚ apply_aspectr;ÚnpÚzerosr4r3Ú ValueErrorrrTÚmaximumr>rUr=ÚsumÚedit_margin_min)r%r"rArDÚsubÚ_gsÚextrawÚextrahÚorigÚactualÚdwÚdhÚwÚhr*r*r+r s>       €r©r r r r c Cs|j}| ¡}t|dƒr!|jdur|jn|}|jdur|jn|}n|jdur)|jn|}|jdur3|jn|}|d}|d}| ¡\} } ||||dddddœ} || |krl|jj dkr`|| | d<|jj | krl|| | d<|| |krŠ|j j | kr~|| | d<|j j dkrŠ|| | d<| S) Nr rr)ÚleftcbÚrightcbÚbottomcbÚtopcbr]r^rIr rrrsrtru) r:r;r7r r Ú_hspaceÚ_wspaceÚ get_geometryr>ÚstartÚstopr=) Úobjr r r r ÚssrArvrwr3r4Úmarginr*r*r+Úget_margin_from_padding0s4  ý          r~c CsÒ|jD]%}|j}| ¡} t|||||||dt|dd||d} ||  | |¡q|jD]L} |  ¡r7|  ¡s8q,|  ¡}| ¡} | |vrGdSt| ||||d} t | |ƒ\} }| d| j |j 7<| d|j | j 7<| d| j |j 7<| d|j | j 7<| jD]æ}t||ƒ}t|ƒ\}}|jd}t ||ƒ\}}|dkrº|j|jjkr¹| d |j|7<n@|dkrÑ|j|jjkrÐ| d |j|7<n)|dkrè|j|jjkrç| d |j|7<n|j|jjkrú| d |j|7<|d vr5|j|jjkr|j |j kr| d|j |j 7<|j|jjkr5|j |j kr5| d|j |j 7<|dvrp|j|jjkrU|j |j krU| d|j |j 7<|j|jjkrp|j |j krp| d|j |j 7<qŠ||  | |¡q,|jD]i}d}|jrå|jdurå|dur–|j ¡j}|| |¡ƒ}|jd|}|jd|}|j}|dkr¼|| d|¡n |dkrÉ|| d|¡|dkrØ|| d|¡q}|dkrå|| d|¡q}dS)a¥ 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. rqrNr]r^r rIÚlocationrsrrrurt)rIr ©r]r^rÚlowerÚupper) r?r:r;rr~Úedit_outer_margin_minsr@r_rÚget_pos_and_bboxÚx0Úx1Úy0rÚ _colorbarsÚcolorbar_get_padÚget_cb_parent_spansÚ_colorbar_inforzr>rTryr=rUÚlegendsÚ _outside_locÚ_bbox_to_anchorÚ transFigureÚinvertedÚtransform_bboxÚ get_tightbboxrf)r%r"r$r r r r rCr|rAÚmarginsrDr}ÚposÚbboxÚcbaxÚpadÚ cbp_rspanÚ cbp_cspanÚlocÚcbposÚcbbboxÚlegÚ inv_trans_figrorpÚ legendlocr*r*r+rVs  þÿ ÿ    €€€  €       €ðr©r r c Cs°|j ¡j}t ddg||gg¡}|j|j |¡}|j}|j}|jD] } t || |||dq#|j durf|j   ¡rf|j   ¡} t |j ddƒrf|j  | dd|f¡||j  |¡ƒ} || d| jd|¡|jdur›|j  ¡r›|j  ¡} t |jddƒr›|j | d|f¡||j |¡ƒ} || d| jd|¡|jdurÒ|j  ¡rÔ|j  ¡} t |jddƒrÖ|j || df¡||j |¡ƒ} || d | jd|¡dSdSdSdS) Nrr rFrrIrr r])rrr‘Ú mtransformsÚBboxÚtransSubfigurerUrTr?rrrrÚgetattrrr’rfÚ _supxlabelÚ _supylabel) r%r"r$r r ržÚpadboxÚ h_pad_localÚ w_pad_localrCÚpr•r*r*r+rÌsF ÿÿ ÿ    ÿ ûrc Cs`|jD]}t||ƒqdd„| ¡Dƒ}|D]–}| ¡}| ¡|vr)| |¡q|| ¡}t|jƒdkrìt  |j d|jdd…|j d|jdd…¡}t  |j d|jdd…|j d |jdd…¡}|D]Y} |  ¡} ||  ¡} | durÇt| jƒdkrÇt  | j d| jdd…| j d| jdd…¡} | |kr¦| }t  | j d| jdd…| j d | jdd…¡} | |krÇ| }qn|jdd…D] }|j d||d qÏ|jdd…D] }|j d||d qát|j ƒdkr­t  |j d |j dd…|j d |j dd…¡}t  |j d |j dd…|j d|j dd…¡}|D]Z} |  ¡} ||  ¡} | dur…t| j ƒdkr…t  t  | j d | j dd…| j d | j dd…¡|g¡}t  t  | j d | j dd…| j d| j dd…¡|g¡}q,|j dd…D] }|j d ||d qŽ|j dd…D] }|j d ||d q¡qdS)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. cSs$g|]}| ¡dur| ¡r|‘qS)N)r_r)Ú.0Úar*r*r+Ú sÿz+match_submerged_margins..rr]Nrrr^éÿÿÿÿrs)ÚcellrIrur rt) r?rÚget_axesr_r;ÚremoveÚlenr>raÚmaxÚ margin_valsrfr=)r%r"rCÚaxsÚax1Úss1Úlg1ÚmaxsublÚmaxsubrÚax2Úss2Úlg2Úmaxsubl2Úmaxsubr2rXÚmaxsubtÚmaxsubbr*r*r+rós       ÿÿÿÿ ÿÿÿÿ€ÿÿÿÿ  ÿÿýÿÿý€€Árc Csˆtj}tj }tj}tj }|jdD]"}| ¡}t|jj|ƒ}t|jj|ƒ}t|j j|ƒ}t|j j|ƒ}qt ||ƒ}t ||ƒ}||fS)z¢ Figure out which subplotspecs this colorbar belongs to. Parameters ---------- cbax : `~matplotlib.axes.Axes` Axes for the colorbar. Úparents) raÚinfr‹r_Úminr=ryr³rzr>r) r–ÚrowstartÚrowstopÚcolstartÚcolstopr/r|r=r>r*r*r+rŠTs   rŠcCsb|jdd}|jdd}| |j|j¡}t ||¡}|dur%|}||fS| |j ¡¡}||fS)a{ 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. F©ÚrootTr[N)Ú get_figurerÚ transformedr£rÚmartistÚ_get_tightbbox_for_layout_onlyr)rDr$r"r”Ú tightbboxr•r*r*r+r„ms   ÿr„c Cs|j|j}|jD]}|| ¡} |j|  |¡dt|||||||dq |jD]X} |  ¡dus5|   ¡s6q)|  ¡} |   ¡} | |vrEdS|| j | j | j d} | | ¡} |  | ¡dddddœ}t| jddd…ƒD]\}}| |jddkr€t||||d qkq)dS) zF Reposition all the Axes based on the new inner bounding box. )r•)r r r r N©ÚrowsÚcolsr)r]r^r rIr®r©Úoffset)rr£r?Úget_outer_bboxÚ_redo_transform_rel_figrÌrr@r_rr;rr=r>r‘Ú _set_positionÚ enumeraterˆr‹Úreposition_colorbar)r%r"r$r r r r Útrans_fig_to_subfigrCr•rDr|rAÚnewbboxrÔÚnnr–r*r*r+r‰s>   ÿþ  ÿ  ÿ€þêrrÓcCsŠ|jd}|d ¡}|jdd}|j|j}t|ƒ\}} ||j|| d} ||j|| d} |jd} |jd} |jd}|jd }|jd }t||ƒ\}}t ||ƒ}| d vrº|   ||¡  | | ¡}| d krŽ|j |j }| j |j |d }|||7}|d |j|7<| |d¡}n|j |j }| j |j }||j |||d 7}|d |j|7<| |d¡}na|   ||¡  | | ¡}| dkrð|j|j}| j|j|d}|||7}|d|j|7<| d|¡}n+|j|j}| j|j}||j |||d7}|d|j|7<| d|¡}| |¡}| |j¡| |¡| | ¡| dvr9d|}| |¡| d¡|S)aƒ 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. rÂrFrÉrÐrÚanchorÚfractionÚaspectÚshrinkr€r^r]rIr )r rIrÚauto)r‹r;rËrr£rŠÚget_bbox_for_cbrr„r‰ÚshrunkÚanchoredr…r†rTÚ translatedr‡rrUr‘Ú set_transformr×Ú set_anchorÚset_box_aspectÚ set_aspect)r%r–r$rÔrÂrAr"rÚÚ cb_rspansÚ cb_cspansÚ bboxparentÚpbrrÝrÞrßràr›rœÚcbpadÚpbcbÚlmarginÚdxÚbmarginÚdyr*r*r+rÙ³sd      ÿ                      rÙcCsV|jD]}t||ƒq|jD]}| ¡r"| ¡}||vr"|| ¡q|| ¡dS)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)r?r!rSrr;)r%r"rCrDrAr*r*r+r!s    €r!cCs^|jd}|d ¡}t|ƒ\}}||j||d}|jddvr%|j}n|j}|jd|S)NrÂrrÐr)r^r]r—)r‹r;rŠrrTrU)r%ÚcaxrÂrArêrëÚ bboxouterÚsizer*r*r+r‰s   r‰)NNrF)r) Ú__doc__ÚloggingÚnumpyraÚ matplotlibrrrÍÚmatplotlib.transformsÚ transformsr¡Úmatplotlib._layoutgridÚ _layoutgridr8Ú getLoggerÚ__name__Ú_logr,rr<rrr~rrrrŠr„rrÙr!r‰r*r*r*r+Ús:1    þ ]-.% ÿ& ÿv'a ÿ*Q