j1wSrSSKrSSKrSSKJr SSKrSSKrSSKJ r J r J r SSK J r SSKJr \R""\5r"SS5r"S S \5r"S S \5r"S S5r"SS5rg)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)UNSET)Bboxc\rSrSrSrSSjrSr\"SSS9r\"S S S9r S r SS jr SS jr Sr SrSrSrSr\S5rSrSSSSS.SjrSrg) GridSpecBaseza A base class of GridSpec that specifies the geometry of the grid that a subplot will be placed. Nc [U[5(aUS::a[SU<35e[U[5(aUS::a[SU<35eXsUlUlUR U5 UR U5 g)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. 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_ratioss ڡC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\matplotlib/gridspec.py__init__GridSpecBase.__init__!s%**eqjA%KM M%**eqjDUINP P#(  T[ }- l+cJ[[UR55S:waSUR<3OSn[[UR55S:waSUR<3OSnSR UR R URURX-S9$)Nz, height_ratios=z, width_ratios=z&{clsname}({nrows}, {ncols}{optionals}))clsnamerr optionals) lenset_row_height_ratios_col_width_ratiosformat __class____name__rr)r height_arg width_args r__repr__GridSpecBase.__repr__:sS!8!89:a?))@)@(CDEG C 6 678A='t'='=&@ACE 7>>NN++++++ , ? rcUR$N)rrs rGridSpecBase.F$++rzThe number of rows in the grid.)doccUR$r-)rr.s rr/r0Hr1rz"The number of columns in the grid.c2URUR4$)zG Return a tuple containing the number of rows and columns in the grid. )rrr.s r get_geometryGridSpecBase.get_geometryKs{{DKK''rcgr-)rfigures rget_subplot_paramsGridSpecBase.get_subplot_paramsQs rc*UupEXXB-2XUU-24nU$)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. r8)rlocrowspancolspanloc1loc2 subplotspecs rnew_subplotspecGridSpecBase.new_subplotspecUs,  ,d<.??@ rcUcS/UR-nO$[U5UR:wa [S5eXlg)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)rr!rr$)rrs rrGridSpecBase.set_width_ratiosesF  3,L  $++ -GH H!-rcUR$)zW Return the width ratios. This is *None* if no width ratios have been set explicitly. )r$r.s rget_width_ratiosGridSpecBase.get_width_ratiosss %%%rcUcS/UR-nO$[U5UR:wa [S5eXlg)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)rr!rr#)rrs rrGridSpecBase.set_height_ratios{sF  C$++-M  4;; .DE E"/rcUR$)zY Return the height ratios. This is *None* if no height ratios have been set explicitly. )r#r.s rget_height_ratiosGridSpecBase.get_height_ratioss &&&rcUR5up#URU5nURnURnURnUR nUR n URn Xe- n X- n XXS- --- n X-nX-[UR5- nURVs/sHnUU-PM nnS/U/US- --n[R"[R"UU/5R5nXXS- --- nU U-nUU-[UR5- nURVs/sHnUU-PM nnS/U/US- --n[R"[R"UU/5R5nUU- RS5R unnUU-RS5R unnUUUU4$s snfs snf)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. rr))r5r:leftrightbottomtopwspacehspacesumr#npcumsum column_stackflatr$reshapeT)rfigrrsubplot_paramsrRrSrTrUrVrW tot_width tot_heightcell_hsep_hnormr cell_heights sep_heightscell_hscell_wsep_w cell_widths sep_widthscell_wsfig_tops fig_bottoms fig_lefts fig_rightss rget_grid_positionsGridSpecBase.get_grid_positionss ((* 005""$$&&  &&&&L \ vQw'778~D$;$; <<*.*A*AB*AQD*A BceWa01 ))BOO[,,GHMMNfAg&667~D$:$: ;;)-)?)?@)?Aq4x)? @SUGuQw/0 ))BOOZ,EFKKL!$w 7 7 @ B B+!% 8 8 A C C :Hi;;CAs ,G:GcUR5H`nUR5nUcM[US5(aUR5R5nUR 5X4:XdM^Us $ [ XUS9$)zW Check if the figure already has a gridspec with these dimensions, or create a new one get_topmost_subplotspecr9)get_axes get_gridspechasattrrvr5GridSpec)r9rraxgss r_check_gridspec_exists#GridSpecBase._check_gridspec_existssr //#B"B~2899 335BBDB??$6I$V44rc&UR5up#Sn[U[5(a0UupV[R "U"XRS5U"XcS5/X#45upOU"XU-S5up[ XU 5$![an[S5UeSnAff=f)z,Create and return a `.SubplotSpec` instance.c Un[U[5(a*URU5upEnXT:aXES- 4$[S5eUS:aX-nSUs=::a U:aX4$ Ub[SUSUSU35e[SUSU35e)Nrz=GridSpec slice would result in no space allocated for subplotrzindex z is out of bounds for axis z with size z) is out of bounds for GridSpec with size )r sliceindices IndexError)keysizeaxisorig_keystartstop_s r _normalize,GridSpecBase.__getitem__.._normalizesH#u%%!$T!2Q< (?* "9::7*C?d?8O#%$vhZ8--1F+dV&EFF%vhZ8;;?&&BCCrzUnrecognized subplot specNrr)r5r tuplerrYravel_multi_index SubplotSpec) rrrrrk1k2errnum1num2s r __getitem__GridSpecBase.__getitem__s((*  C( c5 ! ! G--Bq):b+CD JD$$C=JD4t,, G !<=3F GsA55 B? B  BFT)sharexshareysqueeze subplot_kwcfURnUc [S5e[U[5(d U(aSOSn[U[5(d U(aSOSn[R "/SQXS9 Uc0nUR 5n[R"URUR4[S9n[UR5H[n[UR5H?nSUSXgS 4US U4S .n XUS 'XUS 'UR"XU440UD6XgU4'MA M] US ;a"URHn U RSS9 M US;a"URHn U R!SS9 M U(a0UR"S:XaUR%5$UR'5$U$)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 figureallnone)rrowcolrFT)rr)dtype)rrr)rrrrrr)rrT)skip_non_rectangular_axes)rrr)r9rr strr check_in_listcopyrYemptyrrobjectrange add_subplotr\_label_outer_xaxis_label_outer_yaxisritemr) rrrrrr9axarrrr shared_withr|s rsubplotsGridSpecBase.subplotss ><= =&#&&$U&F&#&&$U&F E"( 9  J__& $++t{{36B%CT[[)'+E$K&+FmE!S&MK '2': 8$'2': 8$"("4"4cN#2&0#23h *& ^ #jj%%%E! ^ #jj%%%E! $)::?5::< G  GLr)r$rrr#)NNr-)rr)r' __module__ __qualname____firstlineno____doc__rr*propertyrrr5r:rCrrHrrMrs staticmethodr~rr__static_attributes__r8rrr r s ,2  -: X@lXPlX`lXplXlXlX0l[T U]!XU U S9 g)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) rRrTrSrUrVrWr9superr) rrrr9rRrTrSrUrVrWrrr&s rrGridSpec.__init__:sCT       &2'4  6rrRrTrSrUrVrWclU[LaXlU[LaX lU[LaX0lU[LaX@lU[LaXPlU[LaX`l[RRR5HnURRRHnUR5cMUR5R5n U R!5U:XdMJUR#SS9n UR%UR5R'U 55 M M g)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 or None, optional Spacing between the subplots as a fraction of the average subplot width / height. NF)root)_UNSETrRrTrSrUrVrWrGcffigsvaluescanvasr9axesget_subplotspecrvry get_figure _set_position get_position) rrRrTrSrUrVrW figmanagerr|ssr_s rupdateGridSpec.updaters v I   K  J f H   K   K(,,1188:J ''..33%%'3++-EEGB(D0 mmm7((););)=)J)J3)OP 4;rc FUc=URVs0sHnU[RSU-_M nn[S0UD6nO [R"UR 5nUR "S0URVs0sHo"[X5_M snD6 U$s snfs snf)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.r8) _AllowedKeysmplrcParams SubplotParamsr subplotparsrgetattr)rr9kkwrs rr:GridSpec.get_subplot_paramss >,,.,aS\\"3A"566, .'-"-K))F$6$67KN4;L;LM;La!11;LMN. Ns !B=B cjURVs/sHn[X5(dMUPM sn$s snf)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`. )rr)rrs rlocally_modified_subplot_params(GridSpec.locally_modified_subplot_paramss+ ,,A,a0@,AAAs00c UcUR5n[R"XR[R"URUS9X#XEUS9nU(aUR "S0UD6 gg)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_padrectr8) _get_rendererrget_tight_layout_figurerget_subplotspec_listr)rr9rendererrrrrkwargss r tight_layoutGridSpec.tight_layoutsd,  ++-H66 KK  . .v{{d K UdD  KK !& ! r)rTr9rWrRrSrUrV) NNNNNNNNNr-)NgHzG?NNN)r'rrrrrrrrr:rrr __classcell__r&s@rr{r{0sV-19=%)2646lJL#F&fV#QJ.B-1<@""rr{cD^\rSrSrSrSU4SjjrSSjrSrSrU=r $) GridSpecFromSubplotSpecizl GridSpec whose subplot layout parameters are inherited from the location specified by a given SubplotSpec. c>X@lXPl[U[5(aX0lO [ S5eURR 5RUl[TU]%XUUS9 g)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.rN) _wspace_hspacer r _subplot_spec TypeErrorryr9rr) rrr subplot_specrVrWrrr&s rr GridSpecFromSubplotSpec.__init__so&  lK 0 0!- NO O((557>>  &2'4  6rc URb URO+UbURRO[RSnUR b UR O+UbURR O[RSnURRU5nURupVpx[XWXhX2S9$)z1Return a dictionary of subplot layout parameters.zfigure.subplot.hspacezfigure.subplot.wspace)rRrSrTrUrVrW) rrrWrrrrVrrextentsr) rr9rWrVfigboxrRrTrSrUs rr:*GridSpecFromSubplotSpec.get_subplot_paramss"&,,":$,,4:4Fv))00||$;< #',,":$,,4:4Fv))00||$;< ##008#)>> e$$*$*; ;rc6URR5$)zI Return the topmost `.SubplotSpec` instance associated with the subplot. )rrvr.s rrv/GridSpecFromSubplotSpec.get_topmost_subplotspec s!!99;;r)rrrr9)NNNNr-) r'rrrrrr:rvrrrs@rrrs% &*266@; <rrr?r.s rr*SubplotSpec.__repr__,sc$$&'q<<%%&a (9(9':"<<%%&a (9(9':!= >rc[U5S:Xa]Uun[U[5(aU$[U[5(d[ SU<35e[ [ [U55up4nO4[U5S:XaUup4nO[R"SS[U5S9e[RXU5nUc [X4US9n[U[5(a9[U5S :Xa*[S U55(d[ S U35eUupxO:[U[5(aUS:dXSU-:a[ S X4-S U<35eU=pxXgS- U$![a [ SU<35Sef=f)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)takesgivenrwrQc3B# UHn[U[5v M g7fr-)r r).0ns r 1SubplotSpec._from_subplot_args..Ps<1z!X..sz3Subplot specifier tuple must contain integers, not z(num must be an integer with 1 <= num <= z, not )r!r rrrmapintrr nargs_errorr{r~rr) r9argsargrowscolsnumr}ijs r_from_subplot_argsSubplotSpec._from_subplot_args1s t9>DC#{++ X.. $$'7,-- 7"%c3s8"4C Y!^"OD""9HCIN N  , ,V4 @ :$V4B c5 ! !c#h!m<<<< I#ODAqc8,,a3d? >tykJ'#KAA#ay3 7 $$'7,-267 7s EE.cLURc UR$UR$r-)_num2rr.s rrSubplotSpec.num2as JJ.tyy>DJJ>rcXlgr-)r)rvalues rrres rcUR$r-)rr.s rrySubplotSpec.get_gridspecis ~~rctUR5R5upXURUR4$)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``). )ryr5rr)rrrs rr5SubplotSpec.get_geometryls2&&(557 499dii//rcUR5Rn[URU-URU-S-5$)z6The rows spanned by this subplot, as a `range` object.r)ryrrrr)rrs rr>SubplotSpec.rowspanws<!!#))TYY%'e);a)?@@rcUR5Rn[URU-URU-/5up#[ X#S-5$)z9The columns spanned by this subplot, as a `range` object.r)ryrsortedrrr)rrc1c2s rr?SubplotSpec.colspan}sL!!#))U*DII,=>?Ra  rc4URRS:H$Nr)r>rr.s r is_first_rowSubplotSpec.is_first_row||!!Q&&rcdURRUR5R:H$r-)r>rryrr.s r is_last_rowSubplotSpec.is_last_row&||  D$5$5$7$=$===rc4URRS:H$r+)r?rr.s r is_first_colSubplotSpec.is_first_colr.rcdURRUR5R:H$r-)r?rryrr.s r is_last_colSubplotSpec.is_last_colr2rcUR5nUR5up4[R"URUR /X445upVUR U5upxpXuR5n XR5n XR5n XR5n[R"XX5$)z: Update the subplot position from ``figure.subplotpars``. ) ryr5rY unravel_indexrrrsminmaxr from_extents)rr9rrrrrrprorqrr fig_bottomfig_topfig_left fig_rights rrSubplotSpec.get_positions$$&,,. %%tyy$))&r?r,r0r4r7rrvrGrKrNrr8rrrrs& > **^?? [[ 0AA !!'>'>K  7<(Errc@\rSrSrSrS SjrS SjrSrSrSr g) rizE Parameters defining the positioning of a subplots grid in a figure. Nc|SH#n[X[RSU35 M% URXX4XV5 g)a Defaults are given by :rc:`figure.subplot.[name]`. Parameters ---------- left : float, optional The position of the left edge of the subplots, as a fraction of the figure width. right : float, optional The position of the right edge of the subplots, as a fraction of the figure width. bottom : float, optional The position of the bottom edge of the subplots, as a fraction of the figure height. top : float, optional The position of the top edge of the subplots, as a fraction of the figure height. wspace : float, optional The width of the padding between subplots, as a fraction of the average Axes width. hspace : float, optional The height of the padding between subplots, as a fraction of the average Axes height. rrN)setattrrrr)rrRrTrSrUrVrWrs rrSubplotParams.__init__s:4JC Ds||ocU,CD EJ D%f=rc.UbUO URUbUO UR:a [S5eUbUO URUbUO UR:a [S5eUbXlUbX0lUbX lUbX@lUbXPlUbX`lgg)zI Update the dimensions of the passed parameters. *None* means unchanged. Nzleft cannot be >= rightzbottom cannot be >= top)rRrSrrTrUrVrW)rrRrTrSrUrVrWs rrSubplotParams.updates %T499".EDJJ @67 7)Vt{{?C :67 7  I  J   K ?H   K   K rcrUR5H#n[X[RSU35 M% g)zIRestore the subplot positioning parameters to the default rcParams valuesrN)to_dictrSrr)rrs rresetSubplotParams.reset s,<<>C Ds||ocU,CD E"rc6URR5$)z2Return a copy of the subplot parameters as a dict.)__dict__rr.s rrXSubplotParams.to_dict%s}}!!##r)rTrWrRrSrUrV)NNNNNN) r'rrrrrrrYrXrr8rrrrs/@D%)><>B#'!0F $rr)rrloggingnumbersrnumpyrY matplotlibrrrrmatplotlib._apirrmatplotlib.transformsr getLoggerr'_logr r{rrrr8rrrfs{  ::+&"RRjd"|d"N9