o hZt@sdZddlZddlZddlmZddlZddlZddlm Z m Z m Z ddl m Z eeZGdddZGdd d eZGd d d eZGd d d ZGdddZdS)a :mod:`~matplotlib.gridspec` contains classes that help to layout multiple `~.axes.Axes` in a grid-like pattern within a figure. The `GridSpec` specifies the overall grid structure. Individual cells within the grid are referenced by `SubplotSpec`\s. Often, users need not access this module directly, and can use higher-level methods like `~.pyplot.subplots`, `~.pyplot.subplot_mosaic` and `~.Figure.subfigures`. See the tutorial :ref:`arranging_axes` for a guide. N)Integral)_api_pylab_helpers _tight_layout)Bboxc@seZdZdZd'ddZddZeddd d Zed dd d Zd dZ d(ddZ d)ddZ ddZ ddZ ddZddZddZeddZd d!Zd"d"d#dd$d%d&ZdS)* GridSpecBasezm A base class of GridSpec that specifies the geometry of the grid that a subplot will be placed. NcCsft|tr |dkrtd|t|tr|dkr td||||_|_||||dS)a Parameters ---------- nrows, ncols : int The number of rows and columns of the grid. width_ratios : array-like of length *ncols*, optional Defines the relative widths of the columns. Each column gets a relative width of ``width_ratios[i] / sum(width_ratios)``. If not given, all columns will have the same width. height_ratios : array-like of length *nrows*, optional Defines the relative heights of the rows. Each row gets a relative height of ``height_ratios[i] / sum(height_ratios)``. If not given, all rows will have the same height. rz/Number of rows must be a positive integer, not z2Number of columns must be a positive integer, not N) isinstancer ValueError_nrows_ncolsset_height_ratiosset_width_ratios)selfnrowsncols height_ratios width_ratiosrg/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/matplotlib/gridspec.py__init__ s zGridSpecBase.__init__cCsbtt|jdkrd|jnd}tt|jdkr d|jnd}dj|jj|j|j||dS)Nz, height_ratios=z, width_ratios=z&{clsname}({nrows}, {ncols}{optionals}))clsnamerr optionals) lenset_row_height_ratios_col_width_ratiosformat __class____name__r r )r height_arg width_argrrr__repr__9s  zGridSpecBase.__repr__cC|jSN)r rrrrEzGridSpecBase.zThe number of rows in the grid.)doccCr$r%)r r&rrrr'Gr(z"The number of columns in the grid.cCs |j|jfS)zW Return a tuple containing the number of rows and columns in the grid. )r r r&rrr get_geometryJs zGridSpecBase.get_geometrycCsdSr%r)rfigurerrrget_subplot_paramsPszGridSpecBase.get_subplot_paramsrcCs(|\}}|||||||f}|S)a[ Create and return a `.SubplotSpec` instance. Parameters ---------- loc : (int, int) The position of the subplot in the grid as ``(row_index, column_index)``. rowspan, colspan : int, default: 1 The number of rows and columns the subplot should span in the grid. r)rlocrowspancolspanloc1loc2 subplotspecrrrnew_subplotspecTs zGridSpecBase.new_subplotspeccC6|dur dg|j}n t||jkrtd||_dS)z Set the relative widths of the columns. *width_ratios* must be of length *ncols*. Each column gets a relative width of ``width_ratios[i] / sum(width_ratios)``. NrzTExpected the given number of width ratios to match the number of columns of the grid)r rr r)rrrrrr d  zGridSpecBase.set_width_ratioscCr$)zo Return the width ratios. This is *None* if no width ratios have been set explicitly. )rr&rrrget_width_ratiosrzGridSpecBase.get_width_ratioscCr4)z Set the relative heights of the rows. *height_ratios* must be of length *nrows*. Each row gets a relative height of ``height_ratios[i] / sum(height_ratios)``. NrzRExpected the given number of height ratios to match the number of rows of the grid)r rr r)rrrrrr zr5zGridSpecBase.set_height_ratioscCr$)zq Return the height ratios. This is *None* if no height ratios have been set explicitly. )rr&rrrget_height_ratiosr7zGridSpecBase.get_height_ratioscsV|\}}||}|j}|j}|j}|j}|j} |j} ||} ||} | || |d} | | }| |t|j fdd|j D}dg|g|d}t t ||gj }| || |d}| |}||t|jfdd|jD}dg|g|d}t t ||gj }||dj\}}||dj\}}||||fS)a Return the positions of the grid cells in figure coordinates. Parameters ---------- fig : `~matplotlib.figure.Figure` The figure the grid should be applied to. The subplot parameters (margins and spacing between subplots) are taken from *fig*. Returns ------- bottoms, tops, lefts, rights : array The bottom, top, left, right positions of the grid cells in figure coordinates. rcg|]}|qSrr.0rnormrr z3GridSpecBase.get_grid_positions..rcr9rrr:r=rrr?r@))r*r,leftrightbottomtopwspacehspacesumrnpcumsum column_stackflatrreshapeT)rfigrrsubplot_paramsrCrDrErFrGrH tot_width tot_heightcell_hsep_h cell_heights sep_heightscell_hscell_wsep_w cell_widths sep_widthscell_wsfig_tops fig_bottoms fig_lefts fig_rightsrr=rget_grid_positionss2   zGridSpecBase.get_grid_positionscCsZ|D]!}|}|dur%t|dr|}|||fkr%|Sqt|||dS)zo Check if the figure already has a gridspec with these dimensions, or create a new one Nget_topmost_subplotspecr+)get_axes get_gridspechasattrrcr*GridSpec)r+rraxgsrrr_check_gridspec_existss   z#GridSpecBase._check_gridspec_existsc Cs|\}}dd}t|tr._normalizezUnrecognized subplot specNrr)r*rtupler rJravel_multi_index SubplotSpec) rrorrrvk1k2errnum1num2rrr __getitem__s      zGridSpecBase.__getitem__FT)sharexshareysqueeze subplot_kwc Cs^|j}|dur tdt|ts|rdnd}t|ts!|rdnd}tjgd||d|dur1i}|}tj|j |j ft d}t |j D]8}t |j D]0}d|d||d f|d |fd } | ||d <| ||d <|j |||ffi||||f<qLqE|d vr|jD]} | jddq|dvr|jD]} | jddq|r|jdkr|S|S|S)z Add all subplots specified by this `GridSpec` to its parent figure. See `.Figure.subplots` for detailed documentation. NzIGridSpec.subplots() only works for GridSpecs created with a parent figureallnone)rrowcolrFT)rr)dtype)rrr)rrrrrr)rrT)skip_non_rectangular_axes)rrr)r+r rstrr check_in_listcopyrJemptyr r objectrange add_subplotrM_label_outer_xaxis_label_outer_yaxisrpitemr) rrrrrr+axarrrr shared_withrirrrsubplotssH          zGridSpecBase.subplots)NNr%)rr)r __module__ __qualname____doc__rr#propertyrrr*r,r3r r6r r8rb staticmethodrkrrrrrrrs0    / %rcsZeZdZdZ    dfdd ZgdZddZddd Zd d Z  dd dZ Z S)rha A grid layout to place subplots within a figure. The location of the grid cells is determined in a similar way to `.SubplotParams` using *left*, *right*, *top*, *bottom*, *wspace* and *hspace*. Indexing a GridSpec instance returns a `.SubplotSpec`. Nc sB||_||_||_||_||_| |_||_tj||| | ddS)a Parameters ---------- nrows, ncols : int The number of rows and columns of the grid. figure : `.Figure`, optional Only used for constrained layout to create a proper layoutgrid. left, right, top, bottom : float, optional Extent of the subplots as a fraction of figure width or height. Left cannot be larger than right, and bottom cannot be larger than top. If not given, the values will be inferred from a figure or rcParams at draw time. See also `GridSpec.get_subplot_params`. wspace : float, optional The amount of width reserved for space between subplots, expressed as a fraction of the average axis width. If not given, the values will be inferred from a figure or rcParams when necessary. See also `GridSpec.get_subplot_params`. hspace : float, optional The amount of height reserved for space between subplots, expressed as a fraction of the average axis height. If not given, the values will be inferred from a figure or rcParams when necessary. See also `GridSpec.get_subplot_params`. width_ratios : array-like of length *ncols*, optional Defines the relative widths of the columns. Each column gets a relative width of ``width_ratios[i] / sum(width_ratios)``. If not given, all columns will have the same width. height_ratios : array-like of length *nrows*, optional Defines the relative heights of the rows. Each row gets a relative height of ``height_ratios[i] / sum(height_ratios)``. If not given, all rows will have the same height. rrN) rCrErDrFrGrHr+superr) rrrr+rCrErDrFrGrHrrrrrr9s*  zGridSpec.__init__rCrErDrFrGrHcKs|D]\}}||jvrt|||qt|dtjjD],}|jj j D]$}| durL| }| |krL|jdd}|| |q(q!dS)a  Update the subplot parameters of the grid. Parameters that are not explicitly given are not changed. Setting a parameter to *None* resets it to :rc:`figure.subplot.*`. Parameters ---------- left, right, top, bottom : float or None, optional Extent of the subplots as a fraction of figure width or height. wspace, hspace : float, optional Spacing between the subplots as a fraction of the average subplot width / height. z is an unknown keywordNF)root)items _AllowedKeyssetattrAttributeErrorrGcffigsvaluescanvasr+axesget_subplotspecrcrf get_figure _set_position get_position)rkwargskv figmanagerrissrPrrrupdateqs     zGridSpec.updatecsX|durddjD}tdi|}nt|j}|jdifddjD|S)a: Return the `.SubplotParams` for the GridSpec. In order of precedence the values are taken from - non-*None* attributes of the GridSpec - the provided *figure* - :rc:`figure.subplot.*` Note that the ``figure`` attribute of the GridSpec is always ignored. NcSsi|] }|tjd|qS)figure.subplot.)mplrcParamsr;rrrr sz/GridSpec.get_subplot_params..csi|]}|t|qSrgetattrrr&rrrsr)r SubplotParamsr subplotparsr)rr+kwrrr&rr,s   zGridSpec.get_subplot_paramscsfddjDS)z Return a list of the names of the subplot parameters explicitly set in the GridSpec. This is a subset of the attributes of `.SubplotParams`. csg|] }t|r|qSrrrr&rrr?sz.)rr&rr&rlocally_modified_subplot_paramssz(GridSpec.locally_modified_subplot_paramsHzG?c CsT|dur|}tj||jtj|j|d|||||d}|r(|jdi|dSdS)a Adjust subplot parameters to give specified padding. Parameters ---------- figure : `.Figure` The figure. renderer : `.RendererBase` subclass, optional The renderer to be used. pad : float Padding between the figure edge and the edges of subplots, as a fraction of the font-size. h_pad, w_pad : float, optional Padding (height/width) between edges of adjacent subplots. Defaults to *pad*. rect : tuple (left, bottom, right, top), default: None (left, bottom, right, top) rectangle in normalized figure coordinates that the whole subplots area (including labels) will fit into. Default (None) is the whole figure. N) grid_spec)padh_padw_padrectr) _get_rendererrget_tight_layout_figurerget_subplotspec_listr)rr+rendererrrrrrrrr tight_layouts zGridSpec.tight_layout) NNNNNNNNNr%)NrNNN) r rrrrrrr,rr __classcell__rrrrrh/s 6  rhcs8eZdZdZ  d fdd Zd ddZddZZS) GridSpecFromSubplotSpeczx GridSpec whose subplot layout parameters are inherited from the location specified by a given SubplotSpec. NcsL||_||_t|tr||_ntd|jj|_tj ||||ddS)ak Parameters ---------- nrows, ncols : int Number of rows and number of columns of the grid. subplot_spec : SubplotSpec Spec from which the layout parameters are inherited. wspace, hspace : float, optional See `GridSpec` for more details. If not specified default values (from the figure or rcParams) are used. height_ratios : array-like of length *nrows*, optional See `GridSpecBase` for details. width_ratios : array-like of length *ncols*, optional See `GridSpecBase` for details. zVsubplot_spec must be type SubplotSpec, usually from GridSpec, or axes.get_subplotspec.rN) _wspace_hspacerry _subplot_spec TypeErrorrfr+rr)rrr subplot_specrGrHrrrrrrs   z GridSpecFromSubplotSpec.__init__c Cs|jdur|jn |dur|jjntjd}|jdur|jn |dur%|jjntjd}|j|}|j \}}}}t ||||||dS)z1Return a dictionary of subplot layout parameters.Nzfigure.subplot.hspacezfigure.subplot.wspace)rCrDrErFrGrH) rrrHrrrrGrrextentsr) rr+rHrGfigboxrCrErDrFrrrr,s z*GridSpecFromSubplotSpec.get_subplot_paramscCs |jS)zY Return the topmost `.SubplotSpec` instance associated with the subplot. )rrcr&rrrrcs z/GridSpecFromSubplotSpec.get_topmost_subplotspec)NNNNr%)r rrrrr,rcrrrrrrs rc@seZdZdZd&ddZddZeddZed d Z e j d d Z d d Z ddZ eddZ eddZddZddZddZddZddZddZd d!Zd"d#Zd$d%ZdS)'rya] The location of a subplot in a `GridSpec`. .. note:: Likely, you will never instantiate a `SubplotSpec` yourself. Instead, you will typically obtain one from a `GridSpec` using item-access. Parameters ---------- gridspec : `~matplotlib.gridspec.GridSpec` The GridSpec, which the subplot is referencing. num1, num2 : int The subplot will occupy the *num1*-th cell of the given *gridspec*. If *num2* is provided, the subplot will span between *num1*-th cell and *num2*-th cell **inclusive**. The index starts from 0. NcCs||_||_||_dSr%) _gridspecr}r~)rgridspecr}r~rrrrs zSubplotSpec.__init__c Cs6|d|jjd|jjd|jjd|jjd S)N[:z, ])rfr.rsrtr/r&rrrr#"s zSubplotSpec.__repr__c CsNt|dkr8|\}t|tr|St|tstd|z ttt|\}}}Wn%ty7td|dwt|dkrD|\}}}n tj ddt|dt |||}|dur`t |||d}t|t rt|d krt d d |Ds{td ||\}}nt|tr|dks|||krtd ||d||}}||d|S)z Construct a `.SubplotSpec` from a parent `.Figure` and either - a `.SubplotSpec` -- returned as is; - one or three numbers -- a MATLAB-style subplot specifier. rz>Single argument to subplot must be a three-digit integer, not Nsubplotz1 or 3)takesgivenrdrBcss|]}t|tVqdSr%)rr)r;nrrr Fsz1SubplotSpec._from_subplot_args..z3Subplot specifier tuple must contain integers, not z(num must be an integer with 1 <= num <= z, not )rrryrr mapintrr nargs_errorrhrkrwr) r+argsargrowscolsnumrjijrrr_from_subplot_args'sR        zSubplotSpec._from_subplot_argscCs|jdur|jS|jSr%)_num2r}r&rrrr~WszSubplotSpec.num2cCs ||_dSr%)r)rvaluerrrr~[s cCr$r%)rr&rrrrf_szSubplotSpec.get_gridspeccCs |\}}|||j|jfS)a Return the subplot geometry as tuple ``(n_rows, n_cols, start, stop)``. The indices *start* and *stop* define the range of the subplot within the `GridSpec`. *stop* is inclusive (i.e. for a single cell ``start == stop``). )rfr*r}r~)rrrrrrr*bszSubplotSpec.get_geometrycCs$|j}t|j||j|dS)z6The rows spanned by this subplot, as a `range` object.r)rfrrr}r~)rrrrrr.ms zSubplotSpec.rowspancCs4|j}t|j||j|g\}}t||dS)z9The columns spanned by this subplot, as a `range` object.r)rfrsortedr}r~r)rrc1c2rrrr/ss zSubplotSpec.colspancC |jjdkSNr)r.rsr&rrr is_first_row| zSubplotSpec.is_first_rowcC|jj|jkSr%)r.rtrfrr&rrr is_last_rowzSubplotSpec.is_last_rowcCrr)r/rsr&rrr is_first_colrzSubplotSpec.is_first_colcCrr%)r/rtrfrr&rrr is_last_colrzSubplotSpec.is_last_colcCs|}|\}}t|j|jg||f\}}||\}}} } ||} ||} | |} | |}t | | || S)zJ Update the subplot position from ``figure.subplotpars``. ) rfr*rJ unravel_indexr}r~rbminmaxr from_extents)rr+rrrrrr_r^r`ra fig_bottomfig_topfig_left fig_rightrrrrs     zSubplotSpec.get_positioncCs|}t|dr |S|S)zX Return the topmost `SubplotSpec` instance associated with the subplot. rc)rfrgrc)rrrrrrcs z#SubplotSpec.get_topmost_subplotspeccCs8|j|j|jft|dtt|dtt|dtfkS)z} Two SubplotSpecs are considered equal if they refer to the same position(s) in the same `GridSpec`. rr}r~)rr}r~rr)rotherrrr__eq__s    zSubplotSpec.__eq__cCst|j|j|jfSr%)hashrr}r~r&rrr__hash__szSubplotSpec.__hash__cKst|||fi|S)a Create a GridSpec within this subplot. The created `.GridSpecFromSubplotSpec` will have this `SubplotSpec` as a parent. Parameters ---------- nrows : int Number of rows in grid. ncols : int Number of columns in grid. Returns ------- `.GridSpecFromSubplotSpec` Other Parameters ---------------- **kwargs All other parameters are passed to `.GridSpecFromSubplotSpec`. See Also -------- matplotlib.pyplot.subplots Examples -------- Adding three subplots in the space occupied by a single subplot:: fig = plt.figure() gs0 = fig.add_gridspec(3, 1) ax1 = fig.add_subplot(gs0[0]) ax2 = fig.add_subplot(gs0[1]) gssub = gs0[2].subgridspec(1, 3) for i in range(3): fig.add_subplot(gssub[0, i]) )r)rrrrrrr subgridspecs(zSubplotSpec.subgridspecr%)r rrrrr#rrrr~setterrfr*r.r/rrrrrrcrrrrrrrry s2  /      ryc@s,eZdZdZ  dddZ  dddZdS)rzM Parameters defining the positioning of a subplots grid in a figure. NcCs:dD]}t||tjd|q|||||||dS)au Defaults are given by :rc:`figure.subplot.[name]`. Parameters ---------- left : float The position of the left edge of the subplots, as a fraction of the figure width. right : float The position of the right edge of the subplots, as a fraction of the figure width. bottom : float The position of the bottom edge of the subplots, as a fraction of the figure height. top : float The position of the top edge of the subplots, as a fraction of the figure height. wspace : float The width of the padding between subplots, as a fraction of the average Axes width. hspace : float The height of the padding between subplots, as a fraction of the average Axes height. rrN)rrrr)rrCrErDrFrGrHrorrrrszSubplotParams.__init__cCs|dur|n|j|dur|n|jkrtd|dur|n|j|dur$|n|jkr,td|dur3||_|dur:||_|durA||_|durH||_|durO||_|durX||_dSdS)zY Update the dimensions of the passed parameters. *None* means unchanged. Nzleft cannot be >= rightzbottom cannot be >= top)rCrDr rErFrGrH)rrCrErDrFrGrHrrrrs* zSubplotParams.update)NNNNNN)r rrrrrrrrrrs r)rrloggingnumbersrnumpyrJ matplotlibrrrrmatplotlib.transformsr getLoggerr _logrrhrryrrrrrs$    <S