+ ]iZtcsRt^RIt^RIt^RIHt^RIt^RIt^RIH t H t H t ^RI H t ]P!]4t!RR4t!RR]4t!R R ]4t!R R 4t!R R4tR#)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)Bboxcsa]tRt^toRtRRltRt]!RRR7t]!RR R7t R t RR lt RR lt R t RtRtRtRt]R4tRtRRRRRRRR/RltRtVtR#) GridSpecBaseza A base class of GridSpec that specifies the geometry of the grid that a subplot will be placed. Nc s\V\4'dV^8:d\RV: 24h\V\4'dV^8:d\RV: 24hWuVnVnVP V4VP V4R#)a7 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. z/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_ratioss&&&&&:/usr/lib64/python3.14/site-packages/matplotlib/gridspec.py__init__ZGridSpecBase.__init__ s%**eqjA%KM M%**eqjDUINP P#(  T[ }- l+cs\\\VP44^8wdRVP: 2MRp\\VP44^8wdRVP: 2MRpRP VP P VPVPW,R7#)z, height_ratios=Zz, width_ratios=z&{clsname}({nrows}, {ncols}{optionals}))Zclsnamer rZ optionals) lenZset_row_height_ratios_col_width_ratiosZformat __class____name__rr )r Z height_argZ width_arg& r__repr__ZGridSpecBase.__repr__9sS!8!89:a?))@)@(CDEG C 6 678A='t'='=&@ACE 7>>NN++++++ , ? rcVP#N)rr &rGridSpecBase.E$++rzThe number of rows in the grid.)Zdoccrr)r rrrr r!Gr"rz"The number of columns in the grid.c s2VPVP3#)zG Return a tuple containing the number of rows and columns in the grid. )rr rrr get_geometryZGridSpecBase.get_geometryJs{{DKK''rcsR#r)r figure&&rget_subplot_paramsZGridSpecBase.get_subplot_paramsPs rc sBVwrEWWB,1WUV,13,pV#)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$)r ZlocrowspancolspanZloc1Zloc2Z subplotspecs&&&& rnew_subplotspecZGridSpecBase.new_subplotspecTs,  ,d<.??@ rc Vf^.VP,pM%\V4VP8wd \R4hWnR#)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)``. NzTExpected the given number of width ratios to match the number of columns of the grid)r rrr)r rr&rr ZGridSpecBase.set_width_ratiosdsF  3,L  $++ -GH H!-rc r)zW Return the width ratios. This is *None* if no width ratios have been set explicitly. )rrrrget_width_ratiosZGridSpecBase.get_width_ratiosrs %%%rc r+)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)``. NzRExpected the given number of height ratios to match the number of rows of the grid)rrrr)r rr&rr ZGridSpecBase.set_height_ratioszsF  C$++-M  4;; .DE E"/rc r)zY Return the height ratios. This is *None* if no height ratios have been set explicitly. )rrrrget_height_ratiosZGridSpecBase.get_height_ratioss &&&rc sVP4wr#VPV4pVPpVPpVPpVP pVP p VPp We, p W, p WW^, ,,, p W,pW,\VP4, pVPUu.uF pVV,NK pp^.V.V^, ,,p\P!\P!VV.4P4pWW^, ,,, pV V,pVV,\VP4, pVPUu.uF pVV,NK pp^.V.V^, ,,p\P!\P!VV.4P4pVV, PR4P wppVV,PR4P wppVVVV3#uupiuupi)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. )ii)r#r'leftrightbottomtopwspacehspaceZsumrnpZcumsumZ column_stackflatrZreshapeZT)r figr rZsubplot_paramsr.r/r0r1r2r3Z tot_widthZ tot_heightZcell_hZsep_hZnormZrZ cell_heightsZ sep_heightsZcell_hsZcell_wZsep_wZ cell_widthsZ sep_widthsZcell_wsfig_tops fig_bottoms fig_lefts fig_rightss&& rget_grid_positionsZGridSpecBase.get_grid_positionss ((* 005""$$&&  &&&&L \ vQw'778~D$;$; <<*.*A*AB*AQD*A BceWa01 ))BOO[,,GHMMNfAg&667~D$:$: ;;)-)?)?@)?Aq4xx)? @SUGuQw/0 ))BOOZ,EFKKL!$w 7 7 @ B B+!% 8 8 A C C :Hi;;CAs H< Ic s VP4FcpVP4pVfK\VR4'dVP4P4pVP 4W38XgKaVu# \ WVR7#)zW Check if the figure already has a gridspec with these dimensions, or create a new one get_topmost_subplotspecr%)Zget_axes get_gridspechasattrr<r#GridSpec)r%r raxgss&&& r_check_gridspec_existsZ#GridSpecBase._check_gridspec_existssr //#B"B~2899 335BBDB??$6I$V44rc s2VP4wr#Rp\V\4'd1VwrV\P !T!YR^4T!Yc^4.Y#34wrMV!WV,R4wr\ WV 4# \dp\R4ThRp?ii;i)z,Create and return a `.SubplotSpec` instance.cs(Tp\V\4'd0VPV4wrEpWT8d WE^, 3#\R4hV^8d W,p^Tu;8:d V8dW3#Ve\RV RV RV 24h\RV RV 24h)rz=GridSpec slice would result in no space allocated for subplotzindex z is out of bounds for axis z with size z) is out of bounds for GridSpec with size )rZsliceZindicesZ IndexError)keysizeZaxisZorig_keystartstopZ_s&&& r _normalizeZ,GridSpecBase.__getitem__.._normalizesH#u%%!$T!2Q< (?* "9::7*C?d?8O#%$vhZ8--1F+dV&EFF%vhZ8;;?&&BCCrzUnrecognized subplot specN)r#rtuplerr4Zravel_multi_index SubplotSpec) r rDr rrHZk1Zk2Zerrnum1num2s && r __getitem__ZGridSpecBase.__getitem__s((*  C( c5 ! ! G--Bq):b+CD JD$$C=JD4t,, G !<=3F GsA:: B BBsharexFshareysqueezeT subplot_kwc  sVPpVf \R4h\V\4'g V'dRMRp\V\4'g V'dRMRp\P !.R OWR7Vf/pVP 4p\P!VPVP3\R 7p\VP4Fvp\VP4FZpRRRVR,RWg^3,RV^V3,/p W,VR &W,VR &VP!WV3,3/VBWgV3&K\ Kx VR9d&VPFp V PRR 7K VR9d&VPFp V P!RR 7K V'd2VP"^8XdVP%4#VP'4#V#)zy 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 figureallnonerowcolT)rNrO)ZdtyperNrO)Zskip_non_rectangular_axes)rRrTrUrSFT)rV)rUrR)rTrR)r%rrstrrZ check_in_listcopyr4Zemptyrr objectrangeZ add_subplotr5Z_label_outer_xaxisZ_label_outer_yaxisrEZitemrP) r rNrOrPrQr%ZaxarrrTrUZ shared_withrAs &$$$$ rsubplotsZGridSpecBase.subplotss ><= =&#&&$U&F&#&&$U&F E"( 9  J__& $++t{{36B%CT[[)%tUE$K$eFmUE!S&MK '2': 8$'2': 8$"("4"4cN#2&0#23h *& ^ #jj%%%E! ^ #jj%%%E! $)::?5::< G  GLr)rr rr)NNr)rr)r __module__ __qualname____firstlineno____doc__rrpropertyr rr#r'r*r r,r r-r; staticmethodrCrMr[__static_attributes____classdictcell__ __classdict__@rrrs ,2  -: Z get_figureZ _set_position get_position)r kwargskZvZ figmanagerrAZssr6s&, rupdateZGridSpec.updateqsLLNDA%%%#$s*@%ABB # ),,1188:J ''..33%%'3++-EEGB(D0 mmm7((););)=)J)J3)OP 4;rc  sTVfEVPUu/uF"pV\PRV,,bK$ pp\R/VBpM \P!VP 4pVP !R/VPUu/uFq"\W4bK upBV#uupiuupi)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. figure.subplot.r$)rimplrcParams SubplotParamsrX subplotparsrogetattr)r r%rnZkwrts&& rr'ZGridSpec.get_subplot_paramss >,,.,aS\\"3A"566, .'-"-K))F$6$67KN4;L;LM;La!11;LMN. Ns (B B% c sjVPUu.uFp\W4'gKVNK up#uupi)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`. )riru)r rn& rlocally_modified_subplot_paramsZ(GridSpec.locally_modified_subplot_paramss- ,,A,a0@,AAAs00c  sVfVP4p\P!WP\P!VPVR7W#WEVR7pV'dVP !R/VBR#R#)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)Z grid_spec)padh_padw_padrectr$)Z _get_rendererrZget_tight_layout_figurerkZget_subplotspec_listro)r r%Zrendererrxryrzr{rm&&&&&&& r tight_layoutZGridSpec.tight_layoutsd,  ++-H66 KK  . .v{{d K UdD  KK !& ! r)r0r%r3r.r/r1r2) NNNNNNNNNr.r0r/r1r2r3r)NgHzG?NNN)rr\r]r^r_rriror'rwr}rbrc __classcell__rre@@rr@r@/s346lJLQ8.B""rr@csJaa]tRtRtoRtRV3RlltRRltRtRtVt V;t #) GridSpecFromSubplotSpecizl GridSpec whose subplot layout parameters are inherited from the location specified by a given SubplotSpec. c s<W@nWPn\V\4'dW0nM \ R4hVPP 4PVn\SV`%WVVR7R#)a 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.rgN) _wspace_hspacerrJ _subplot_specZ TypeErrorr>r%rhr) r r rZ subplot_specr2r3rrrs &&&&&&&&rrZ GridSpecFromSubplotSpec.__init__so&  lK 0 0!- NO O((557>>  &2'4  6rc  sVPe VPM0VeVPPM\PR,pVP e VP M0VeVPP M\PR,pVPPV4pVPwrVrx\WWWhW2R7#)z1Return a dictionary of subplot layout parameters.zfigure.subplot.hspacezfigure.subplot.wspace)r.r/r0r1r2r3) rrtr3rqrrrr2rrlZextentsrs) r r%r3r2Zfigboxr.r0r/r1 && rr'Z*GridSpecFromSubplotSpec.get_subplot_paramss"&,,":$,,4:4Fv))00||$;< #',,":$,,4:4Fv))00||$;< ##008#)>> e$$*$*; ;rc s6VPP4#)zI Return the topmost `.SubplotSpec` instance associated with the subplot. )rr<rrrr<Z/GridSpecFromSubplotSpec.get_topmost_subplotspecs!!99;;r)rrrr%)NNNNr) rr\r]r^r_rr'r<rbrcrrrrrrs6@; <r(rFrGr)rrrrZSubplotSpec.__repr__"sc$$&'q<<%%&a (9(9':"<<%%&a (9(9':!= >rc sb\V4^8Xd`Vwp\V\4'dV#\V\4'g\ RV: 24h\ \ \V44wr4pM8\V4^8XdVwr4pM"\P!RR\V4R7h\PWV4pVf\W4VR7p\V\4'd^\V4^8XdN\;QJdRV4F 'dK RM R M !RV44'g\ R V 24hVwrxME\V\4'dV^8gWSV,8d\ R W4, R V: 24hT;rxWg^, V# \d\ RT: 24Rhi;i) z Construct a `.SubplotSpec` from a parent `.Figure` and either - a `.SubplotSpec` -- returned as is; - one or three numbers -- a MATLAB-style subplot specifier. z>Single argument to subplot must be a three-digit integer, not NZsubplotz1 or 3)ZtakesZgivenr=c3sB"TFp\V\4xK R#5ir)rr)Z.0ZnrvrZ Z1SubplotSpec._from_subplot_args..Fs<1z!X..sFTz3Subplot specifier tuple must contain integers, not z(num must be an integer with 1 <= num <= z, not )rrrJrrZmapZintrWrZ nargs_errorr@rCrIrR) r%ZargsZargrowscolsZnumrBZiZjrr_from_subplot_argsZSubplotSpec._from_subplot_args's t9>DC#{++ X.. $$'7,-- 7"%c3s8"4C Y!^"OD""9HCIN N  , ,V4 @ :$V4B c5 ! !c#h!m3<<333<<<< I#ODAqc8,,a3d? >tykJ'#KAA#ay3 7 $$'7,-267 7s FF.csNVPf VP#VP#r)_num2rKrrrrLSubplotSpec.num2Ws JJ.tyy>DJJ>rcsWnR#r)r)r Zvaluer&rrLr[s rcrr)rrrrr>ZSubplotSpec.get_gridspec_s ~~rc stVP4P4wrWVPVP3#)z 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``). )r>r#rKrL)r rrrrr#ZSubplotSpec.get_geometrybs2&&(557 499dii//rc sVP4Pp\VPV,VPV,^,4#)z6The rows spanned by this subplot, as a `range` object.)r>rrZrKrL)r rrvrr(ZSubplotSpec.rowspanms<!!#))TYY%'e);a)?@@rc sVP4Pp\VPV,VPV,.4wr#\ W#^,4#)z9The columns spanned by this subplot, as a `range` object.)r>rZsortedrKrLrZ)r rZc1Zc2s& rr)ZSubplotSpec.colspanssL!!#))U*DII,=>?Ra  rc4VPP^8H#rV)r(rFrrr is_first_rowZSubplotSpec.is_first_row|||!!Q&&rcdVPPVP4P8H#r)r(rGr>r rrr is_last_rowZSubplotSpec.is_last_row&||  D$5$5$7$=$===rcrr)r)rFrrr is_first_colZSubplotSpec.is_first_colrrcrr)r)rGr>rrrr is_last_colZSubplotSpec.is_last_colrrc sVP4pVP4wr4\P!VPVP .W434wrVVP V4wrxrWu,P4p W,P4p W,P4p W,P4p\P!WW4#)z: Update the subplot position from ``figure.subplotpars``. ) r>r#r4Z unravel_indexrKrLr;ZminZmaxrZ from_extents)r r%rr rrrr8r7r9r:Z fig_bottomZfig_topZfig_leftZ fig_rights&& rrlZSubplotSpec.get_positions$$&,,. %%tyy$))&r?r<)r rrvrr<Z#SubplotSpec.get_topmost_subplotspecs4$$& 86 7 7335 5Krc  sVPVPVP3\VR\ 44\VR\ 44\VR\ 4438H#)ze Two SubplotSpecs are considered equal if they refer to the same position(s) in the same `GridSpec`. rrKrL)rrKrLrurY)r Zotherr&r__eq__ZSubplotSpec.__eq__sS DII6E;9E6684E668466 7rcsZ\VPVPVP34#r)ZhashrrKrLrrr__hash__ZSubplotSpec.__hash__s T^^TYY :;;rc s\WV3/VB#)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)r r rrms&&&,r subgridspecZSubplotSpec.subgridspecsP'uTDVDDr)rrrKrLr)rr\r]r^r_rrrarr`rLZsetterr>r#r(r)rrrrrlr<rrrrbrcrdrfrrJrJ s& > **^?? [[ 0AA !!'>'>K  7<(E(ErrJcs8a]tRtRtoRtRRltRRltRtVtR#)rsizE Parameters defining the positioning of a subplots grid in a figure. Nc sRF'p\W\PRV 2,4K) VPWW4WV4R#)a 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. rpNr~)rjrqrrro)r r.r0r/r1r2r3rDr|rrZSubplotParams.__init__s:4JC Ds||ocU,CD EJ D%f=rc sJVeTM VPVeTM VP8d \R4hVeTM VPVeTM VP8d \R4hVeWnVeW0nVeW nVeW@nVeWPnVe W`nR#R#)zI Update the dimensions of the passed parameters. *None* means unchanged. Nzleft cannot be >= rightzbottom cannot be >= top)r.r/rr0r1r2r3)r r.r0r/r1r2r3s&&&&&&&rroZSubplotParams.updates %T499".EDJJ @67 7)Vt{{?C :67 7  I  J   K ?H   K   K r)r0r3r.r/r1r2)NNNNNN) rr\r]r^r_rrorbrcrdrfrrsrss><!!rrs)r_rXZloggingZnumbersrZnumpyr4Z matplotlibrqrrrZmatplotlib.transformsrZ getLoggerrZ_logrr@rrJrsr$rrrsv  ::&"RRj["|["|9