h`lSrSSKrSSKJrJr SSKJrJr SSK J r SSK J r SSK Jr SS KJr SS KJr "S S \ 5r\r"S S\5r\R,SSj5rg)a$ Tables drawing. .. note:: The table implementation in Matplotlib is lightly maintained. For a more featureful table implementation, you may wish to try `blume `_. Use the factory function `~matplotlib.table.table` to create a ready-made table from texts. If you need more control, use the `.Table` class and its methods. The table consists of a grid of cells, which are indexed by (row, column). The cell (0, 0) is positioned at the top left. Thanks to John Gill for providing the class and table. N)_api _docstring)Artistallow_rasterization) Rectangle)Text)Bbox)Path)_is_pandas_dataframec^\rSrSrSrSrSrS\SSS.rS S S SS S SS.U4SjjrU4Sjr U4Sjr Sr Sr Sr Sr\U4Sj5rSrSrSr\R*S5r\S5r\R2S5rSrSrU=r$) Cell'z A cell is a `.Rectangle` with some associated `.Text`. As a user, you'll most likely not creates cells yourself. Instead, you should use either the `~matplotlib.table.table` factory function or `.Table.add_cell`. g?BRTLBTRL)openclosed horizontalverticalkwTrightNr) edgecolor facecolorfilltextlocfontproperties visible_edgesc >[T U]XX6XES9 URS5 XlXl[ USUSSXyUSS9Ulg)a Parameters ---------- xy : 2-tuple The position of the bottom left corner of the cell. width : float The cell width. height : float The cell height. edgecolor : :mpltype:`color`, default: 'k' The color of the cell border. facecolor : :mpltype:`color`, default: 'w' The cell facecolor. fill : bool, default: True Whether the cell background is filled. text : str, optional The cell text. loc : {'right', 'center', 'left'} The alignment of the text within the cell. fontproperties : dict, optional A dict defining the font properties of the text. Supported keys and values are the keyword arguments accepted by `.FontProperties`. visible_edges : {'closed', 'open', 'horizontal', 'vertical'} or substring of 'BRTL' The cell edges to be drawn with a line: a substring of 'BRTL' (bottom, right, top, left), or one of 'open' (no edges drawn), 'closed' (all edges drawn), 'horizontal' (bottom and top), 'vertical' (right and left). )widthheightrrrFrrcenter)xyclip_onrr horizontalalignmentverticalalignmentN)super__init__ set_clip_onr!_locr _text) selfxyr#r$rrrrrr r! __class__s B/var/www/html/env/lib/python3.13/site-packages/matplotlib/table.pyr, Cell.__init__:s^N #,  C * BqERUE#.1XO c2>[TU]U5 SUlgNT)r+ set_transformstale)r0tr2s r3r8Cell.set_transformls a  r5cZ>[TU]U5 URRU5 gN)r+ set_figurer/)r0figr2s r3r>Cell.set_figureqs" 3 c"r5cUR$)z!Return the cell `.Text` instance.)r/r0s r3get_text Cell.get_textus zzr5cHURRU5 SUlg)zSet the text fontsize.TN)r/ set_fontsizer9)r0sizes r3rFCell.set_fontsizeys % r5c6URR5$)zReturn the cell fontsize.)r/ get_fontsizerBs r3rJCell.get_fontsize~szz&&((r5cUR5nURU5nUS:aUX0R5:aBUS-nURU5 URU5nUS:aX0R5:aMBU$)z9Shrink font size until the text fits into the cell width.r)rJget_required_width get_widthrF)r0rendererfontsizerequireds r3auto_set_font_sizeCell.auto_set_font_sizesv$$&**84lx..*:: MH   h '..x8Hlx..*:: r5c>UR5(dg[TU] U5 URU5 URRU5 SUlg)NF) get_visibler+draw_set_text_positionr/r9)r0rOr2s r3rV Cell.drawsF!!   X ) ! r5cURU5nURURS- -nURR 5nUS:XaUR UR S- -nOVUS:Xa'UR UR UR--nO)UR UR SUR- --nURRXS45 g)z.Set text up so it is drawn in the right place.r%leftrN) get_window_extenty0r$r/get_horizontalalignmentx0r#PAD set_position)r0rObboxr'rr&s r3rWCell._set_text_positions%%h/ GGdkkAo %jj002 (?$**q.(A F]$**txx//A$**DHH 55A 'r5cURRU5RUR5R 55R $)zI Return the text bounds as *(x, y, width, height)* in table coordinates. )r/r\ transformedget_data_transforminvertedbounds)r0rOs r3get_text_boundsCell.get_text_boundss< ,,X6T446??AB r5cTURU5up#pEUSSUR---$)z/Return the minimal required width for the cell.?g@)rir`)r0rOlbrhs r3rMCell.get_required_widths.))(3 aC3>*++r5c HURRU5 SUlg)zK Update the text properties. Valid keyword arguments are: %(Text:kwdoc)s TN)r/_internal_updater9)r0kwargss r3set_text_propsCell.set_text_propss ##F+ r5cUR$)z The cell edges to be drawn with a line. Reading this property returns a substring of 'BRTL' (bottom, right, top, left'). When setting this property, you can use a substring of 'BRTL' or one of {'open', 'closed', 'horizontal', 'vertical'}. )_visible_edgesrBs r3r!Cell.visible_edgess"""r5c f^UcTRTlOUTR;aTRUTlOo[U4SjU55(aN[ SR USR TR5SR TR555eUTlSTlg)Nc3@># UHoTR;v M g7fr=_edges.0edger0s r3 %Cell.visible_edges..s=utt{{*usz=Invalid edge param {}, must only be one of {} or string of {}z, T)r|rw _edge_aliasesany ValueErrorformatjoinr9r0values` r3r!rxs ="&++D  d(( ("&"4"4U";D =u=== "66> #(D  r5c^[R/nURU4SjTR55 [RUSS;a[RUS'[SS/SS/SS/SS/SS//USS9$) z*Return a `.Path` for the `.visible_edges`.c3># UH5nUTR;a[RO[Rv M7 g7fr=)rwr LINETOMOVETOr}s r3r Cell.get_path..s2%# 4#6#66DKKDKK G#s=ArNrlT)readonly)r rextendr| CLOSEPOLY)r0codess` r3get_path Cell.get_paths  % % % ;;eABi 'E"I3Z#sc3Z#sc3Z H  r5)r.r/rwr9r!)__name__ __module__ __qualname____firstlineno____doc__r`r|rr,r8r>rCrFrJrRrrVrWrirMrinterpdrtpropertyr!setterr__static_attributes__ __classcell__r2s@r3rr's C- F%'%+%)%)M# $' 0O0Od # )  (,    # #    r5rcf^\rSrSrSr0SS_SS_SS_S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS _S!S"_S#S$_S%S&0ErSrS'rS?U4S(jjrS)r S*r S+r \ S,5r \ RS-5r S.r\S/5rS0rS1rS2rS@S3jrS4rS5rS6rSAS7jrS8rS9rS:rS;rS<rS=rS>r U=r!$)BTablea A table of cells. The table consists of a grid of cells, which are indexed by (row, column). For a simple table, you'll have a full grid of cells with indices from (0, 0) to (num_rows-1, num_cols-1), in which the cell (0, 0) is positioned at the top left. However, you can also add cells with negative indices. You don't have to add a cell to every grid position, so you can create tables that have holes. *Note*: You'll usually not create an empty table from scratch. Instead use `~matplotlib.table.table` to create a table from data. bestrz upper rightrz upper leftrZz lower leftz lower rightz center leftz center rightz lower centerz upper centerr% z top right ztop left z bottom left z bottom right rr[topbottomg{Gz?c ">[TU]5 [U[5(aRX R;a4[ SR USRUR555eURUnURURSS95 Xl X l X0l UR5 URUR5 0UlSUl/UlSUlUR)U5 UR+S5 g)a Parameters ---------- ax : `~matplotlib.axes.Axes` The `~.axes.Axes` to plot the table into. loc : str, optional The position of the cell with respect to *ax*. This must be one of the `~.Table.codes`. bbox : `.Bbox` or [xmin, ymin, width, height], optional A bounding box to draw the table into. If this is not *None*, this overrides *loc*. Other Parameters ---------------- **kwargs `.Artist` properties. z3Unrecognized location {!r}. Valid locations are {}z FrootNT)r+r, isinstancestrrrrrr> get_figure_axesr._bbox_unstale_viewLimr8 transAxes_cellsr| _autoColumns _autoFontsizerrr-)r0axrrbrsr2s r3r,Table.__init__s&  c3  **$ KVCTZZ!89;;**S/C  5 12     2<<(  ! f% r5cJSn[U/UQ7SUR0UD6nX`X4'U$)z Create a cell and add it to the table. Parameters ---------- row : int Row index. col : int Column index. *args, **kwargs All other parameters are passed on to `Cell`. Returns ------- `.Cell` The created cell. )rrr!)redges)r0rowcolargsrsr1cells r3add_cellTable.add_cellDs4&BB4BdjjB6BSX r5cN[R"[US9 USUSpCUR UR SS95 URUR55 URS5 X RX44'SUl g![an[ S5UeSnAff=f) z( Set a custom cell in a given position. )rrrz0Only tuples length 2 are accepted as coordinatesNFrT) rcheck_isinstancer ExceptionKeyErrorr>rr8 get_transformr-rr9)r0positionrrrerrs r3 __setitem__Table.__setitem__\s d. 3{HQK U34 4--/0  $ CH  3)*/2 3 3s B B$ BB$c URU$)z-Retrieve a custom cell from a given position.r)r0rs r3 __getitem__Table.__getitem__ls{{8$$r5cUR$)aF The default value of `~.Cell.visible_edges` for newly added cells using `.add_cell`. Notes ----- This setting does currently only affect newly created cells using `.add_cell`. To change existing cells, you have to set their edges explicitly:: for c in tab.get_celld().values(): c.visible_edges = 'horizontal' r{rBs r3r Table.edgesps"{{r5cXlSUlgr7)r|r9rs r3rrs  r5cURS- URSS9R-URRR - S-$)NgR@Trg333333?)FONTSIZErdpirrbr$rBs r3_approx_text_heightTable._approx_text_heightsG $tD'A'E'EE &&'),- .r5cUcURSS9R5nUc [S5eUR5(dgUR SUR 5S9 UR U5 [UR5H!nURURU5 M# URS5 SUl g)NTrzNo renderer definedtable)gidF) r _get_renderer RuntimeErrorrU open_groupget_gid_update_positionssortedrrV close_groupr9)r0rOkeys r3rV Table.draws  D1??AH  45 5!! G8 x($++&C KK  ! !( +' W% r5c:URR5VVVs/sH)uup#nUS:dMUS:dMURU5PM+ nnnn[R"U5nUR UR 5R55$s snnnf)zm Get a bbox, in axes coordinates for the cells. Only include those in the range (0, 0) to (maxRow, maxCol). r)ritemsr\r unionrerrg)r0rOrrrboxesrbs r3_get_grid_bboxTable._get_grid_bboxs*.):):)<+)<%Zc1H2!$2''1)< +zz%  2 2 4 = = ?@@ +sBBBcURU5(aS04$URSS9R5nUbURR 5VVVs/sH)uup4nUS:dMUS:dMUR U5PM+ nnnn[ R"U5nURURUR504$S04$s snnnf)NFTrr) _different_canvasrrrrr\r rcontainsr&r')r0 mouseeventrOrrrrrbs r3rTable.containss  ! !* - -"9 ???-;;=  -1[[->->-@/-@)#Tq6%(AX6T++H5-@ /::e$D==z||C#J 3K D"'40CCL CL D1 !% 1 1 3 JS JJuz " JJw| $!4r5c[R"U5n[R"UR[R5(d [ S5eUHnUR RU5 M SUlg)z Automatically set the widths of given columns to optimal sizes. Parameters ---------- col : int or sequence of ints The indices of the columns to auto-scale. z'col must be an int or sequence of ints.TN) np atleast_1d issubdtypedtypeinteger TypeErrorrappendr9)r0rcol1drs r3auto_set_column_widthTable.auto_set_column_widths^ c"}}U[["**55EF FD    $ $T * r5c^URR5VVs/sHup4USU:XdMUPM nnn[U4SjU5SS9nUHnURU5 M gs snnf)z#Automatically set width for column.rc3D># UHoRT5v M g7fr=)rM)r~rrOs r3r/Table._auto_set_column_width..sMut00::us r)defaultN)rrr set_width)r0rrOrrcells max_widths ` r3_auto_set_column_widthTable._auto_set_column_widthsc'+{{'8'8':L':)#c!fm':LMuM !# D NN9 %Ms A*A*cXlSUlg)zAutomatically set font size.TN)rr9rs r3rRTable.auto_set_font_sizes" r5c[UR5S:Xag[[URR 555R 5n/nURR 5HGupEUSUR;aMURU5n[X&5nURU5 MI URR 5HnURU5 M g)Nrr) lenrnextiterrrJrrrRminrrF)r0rOrPrrrrGs r3_auto_set_font_sizeTable._auto_set_font_sizes t{{ q T[[//123@@B**,IC1v*****84D8*H LL  -KK&&(D   h ')r5cURR5HGnURUR5U-5 UR UR 5U-5 MI g)z>> the_table.auto_set_font_size(False) >>> the_table.set_fontsize(20) However, there is no automatic scaling of the row height so that the text may exceed the cell boundary. TN)rrrFr9)r0rGrs r3rFTable.set_fontsize s0*KK&&(D   d #) r5cURR5HHnUR5UR5pTUR XA-5 UR XR-5 MJ g)z-Move all the artists by ox, oy (axes coords).N)rrget_xget_yrr)r0oxoyr0r&r's r3_offset Table._offset9sF##%A779aggiq GGAFO GGAFO&r5cURHnURX!5 M UR(aURU5 UR 5 UR U5nUR upEpgURbx[UR[5(aURR uppOURuppURX- X- 5 X- n X- n UR 5 GOu[[UR55upnnnnnnnnnnnnnnnnSUS- - U- n SUS- - U- n URUUU4;aURU- n URXUUU4;aSXF-UR-- n URXUU4;aSXW-UR-- n URUUU4;aURU- n URUUU4;a SUS- - U- n URUUU4;a SUS- - U- n URUUU4;aXF-*n URUUU4;aSU- n URUUU4;aSU- n URUUU4;aXW-*n UR!X5 g)Ng?rZrrl)rr!rr*r rrhrrr r1ranger&rr.AXESPADr:) r0rOrrbrmrnrrorlrbrwrhr8r9BESTURULLLLRCLCRLCUCCTRTLBLBRRLTBs r3rTable._update_positions@s $$C  ' ' 6%     $ $X . !""8,[[ a :: !$**d++!%!2!2B!% JJrvrv &BB  # # %,1TZZ+A )Tr2r2r2r1 RQ1aA+"BA+"ByyRRL(\\A%yyTr1b11!%$,,./yyTr2..!%$,,./yyRRL(\\A%yyRQK'AEkQ&yyRQK'AEkQ&yyRQK'YyyRQK'1WyyRQK'1WyyRQK'Y Rr5cUR$)z Return a dict of cells in the table mapping *(row, column)* to `.Cell`\s. Notes ----- You can also directly index into the Table object to access individual cells:: cell = table[row, col] rrBs r3 get_celldTable.get_celldzs{{r5)rrrrrr|r.r9)NNr=)T)"rrrrrrrr>r,rrrrrrrrrVrrrr\r rr!rRr*r1rFr:rrWrrrs@r3rrs  VQ  Q  Q Q Q   Q   Q  Q Q Q R R R R R R  R! "R# E&IHGG* X0 %$ \\.* A *!%>"& ($2 28t  r5rc XUcUc [S5eUc#[U5n[US5nS/U-/U-n[U5(aBUc URnO [S5eUc URnO [S5eUR n[U5n[US5nUH!n[U5U:wdM[SUS35e UbF[U5U:wa[SUS 35eUH!n[U5U:wdM[S US35e O S U-/U-nUc S U- /U-nSnUcUb S/U-nUSnOUcS U-nUb[U5U:wa[S U35eSnUc U bS/U-nO SnOU cS U-n Uc S U-/U-n[ X U 40UD6nU UlUR5n[U5H<n[U5H*nURUU-UUUUUUUUUUUS9 M, M> Ub0[U5H!nURSUUUUUUU UU S9 M# UbP[U5H*nURUU-SU=(d SUUUUUUS9 M, US:XaURS5 SU;aURUS5 URU5 U$)a Add a table to an `~.axes.Axes`. At least one of *cellText* or *cellColours* must be specified. These parameters must be 2D lists, in which the outer lists define the rows and the inner list define the column values per row. Each row must have the same number of elements. The table can optionally have row and column headers, which are configured using *rowLabels*, *rowColours*, *rowLoc* and *colLabels*, *colColours*, *colLoc* respectively. For finer grained control over tables, use the `.Table` class and add it to the Axes with `.Axes.add_table`. Parameters ---------- cellText : 2D list of str or pandas.DataFrame, optional The texts to place into the table cells. *Note*: Line breaks in the strings are currently not accounted for and will result in the text exceeding the cell boundaries. cellColours : 2D list of :mpltype:`color`, optional The background colors of the cells. cellLoc : {'right', 'center', 'left'} The alignment of the text within the cells. colWidths : list of float, optional The column widths in units of the axes. If not given, all columns will have a width of *1 / ncols*. rowLabels : list of str, optional The text of the row header cells. rowColours : list of :mpltype:`color`, optional The colors of the row header cells. rowLoc : {'left', 'center', 'right'} The text alignment of the row header cells. colLabels : list of str, optional The text of the column header cells. colColours : list of :mpltype:`color`, optional The colors of the column header cells. colLoc : {'center', 'left', 'right'} The text alignment of the column header cells. loc : str, default: 'bottom' The position of the cell with respect to *ax*. This must be one of the `~.Table.codes`. bbox : `.Bbox` or [xmin, ymin, width, height], optional A bounding box to draw the table into. If this is not *None*, this overrides *loc*. edges : {'closed', 'open', 'horizontal', 'vertical'} or substring of 'BRTL' The cell edges to be drawn with a line. See also `~.Cell.visible_edges`. Returns ------- `~matplotlib.table.Table` The created table. Other Parameters ---------------- **kwargs `.Table` properties. %(Table:kwdoc)s zZAt least one argument from "cellColours" or "cellText" must be provided to create a table.rrz3rowLabels cannot be used alongside Pandas DataFramez3colLabels cannot be used alongside Pandas DataFramez!Each row in 'cellText' must have z columnsz'cellColours' must have z rowsz$Each row in 'cellColours' must have rrlz'rowLabels' must be of length r)r#r$rrrrgV瞯"D4K=4'H%%   IRS S   ((IRS S?? x=D x{ D s8t @G''( (  { t #7vUCD DC3x4 !G$(6"344 TzlT) 4ZL4' M  !t I%aLM  4Z  y>T !=dVDE EF  !t IF  4Z TzlT)  "4 *6 *EEK  & & (FT{;C NN3<!*3 ( c 2%0%5c%:&  (;C NN1c!*3 )#*S/%  ';C NN3<!.!7% )#*S/%  ' A   ' ' +V 6*-.LL Lr5) NNrNNNr[NNr%rNr)rnumpyrrrrartistrrpatchesrrr transformsr pathr cbookr r CustomCellrrrr5r3rsst$/'B9BJ XFXv  %)%)282:)1 CCr5