o h`l@sdZddlZddlmZmZddlmZmZddl m Z ddl m Z ddl mZdd lmZdd lmZGd d d e ZeZGd ddeZej     dddZdS)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_dataframecseZdZdZdZ dZdedddZdd d dd d d dfdd ZfddZfddZ ddZ ddZ ddZ ddZ efddZdd Zd!d"Zd#d$Zejd%d&Zed'd(Zejd)d(Zd*d+ZZS),Cellz 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 sRtj||||||d|d| |_||_t|d|dd|| |dd|_dS)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_onrrhorizontalalignmentverticalalignmentN)super__init__ set_clip_onr_locr_text) selfxyrr rrrrrrr __class__d/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/matplotlib/table.pyr(:s'  z Cell.__init__cst|d|_dSNT)r' set_transformstale)r,tr.r0r1r3ls  zCell.set_transformcst||j|dSN)r' set_figurer+)r,figr.r0r1r7qs zCell.set_figurecC|jS)z!Return the cell `.Text` instance.)r+r,r0r0r1get_textusz Cell.get_textcC|j|d|_dS)zSet the text fontsize.TN)r+ set_fontsizer4)r,sizer0r0r1r=ys  zCell.set_fontsizecCs |jS)zReturn the cell fontsize.)r+ get_fontsizer:r0r0r1r?~ zCell.get_fontsizecCsZ|}||}|dkr+||kr+|d8}||||}|dkr+||ks|S)z9Shrink font size until the text fits into the cell width.r)r?get_required_width get_widthr=)r,rendererfontsizerequiredr0r0r1auto_set_font_sizes   zCell.auto_set_font_sizecs8|sdSt||||j|d|_dS)NF) get_visibler'draw_set_text_positionr+r4r,rCr.r0r1rHs     z Cell.drawcCs||}|j|jd}|j}|dkr|j|jd}n|dkr-|j|j|j}n |j|jd|j}|j||fdS)z.Set text up so it is drawn in the right place.r!leftrN) get_window_extenty0r r+get_horizontalalignmentx0rPAD set_position)r,rCbboxr#rr"r0r0r1rIs  zCell._set_text_positioncCs|j||jS)zY Return the text bounds as *(x, y, width, height)* in table coordinates. )r+rM transformedget_data_transforminvertedboundsrJr0r0r1get_text_boundss zCell.get_text_boundscCs$||\}}}}|dd|jS)z/Return the minimal required width for the cell.?g@)rXrQ)r,rClbrhr0r0r1rAszCell.get_required_widthcKr<)zk Update the text properties. Valid keyword arguments are: %(Text:kwdoc)s TN)r+_internal_updater4)r,kwargsr0r0r1set_text_propss zCell.set_text_propscCr9)a" 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_edgesr:r0r0r1rs zCell.visible_edgescsr|dur j_n+|jvrj|_ntfdd|Dr1td|djdj|_d_dS)Nc3s|]}|jvVqdSr6_edges.0edger:r0r1 z%Cell.visible_edges..z=Invalid edge param {}, must only be one of {} or string of {}z, T)rbr` _edge_aliasesany ValueErrorformatjoinr4r,valuer0r:r1rs     csjtjg}|fddjDtj|ddvrtj|d<tddgddgddgddgddgg|dd S) z*Return a `.Path` for the `.visible_edges`.c3s&|]}|jvr tjntjVqdSr6)r`r LINETOMOVETOrcr:r0r1rfs  z Cell.get_path..rNrYT)readonly)r rpextendrb CLOSEPOLY)r,codesr0r:r1get_paths  z Cell.get_path)__name__ __module__ __qualname____doc__rQrbrhr(r3r7r;r=r?rFrrHrIrXrArinterpdr_propertyrsetterrw __classcell__r0r0r.r1r 'sF 2      r csZeZdZdZidddddddd d d d d ddddddddddddddddddd d!d"d#d$d%iZ dZd&Z dTfd(d) Zd*d+Zd,d-Z d.d/Z e d0d1Z e j d2d1Z d3d4Zed5d6Zd7d8Zd9d:Zd;d<ZdUd=d>Zd?d@ZdAdBZdCdDZdVdFdGZdHdIZdJdKZdLdMZdNdOZdPdQZdRdSZZS)WTableaD 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 leftrKz lower leftz lower rightz center leftz center rightz lower centerz upper centerr! z top right ztop left z bottom left z bottom right rrLtopbottomg{Gz?Nc stt|tr ||jvrtd|d|j|j|}||j dd||_ ||_ ||_ | ||ji|_d|_g|_d|_|||ddS)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( isinstancestrrvrjrkrlr7 get_figure_axesr*_bbox_unstale_viewLimr3 transAxes_cellsrb _autoColumns _autoFontsizer]r))r,axrrSr^r.r0r1r(s(      zTable.__init__cOs0d}t|g|Rd|ji|}||||f<|S)aV 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)r edges)r,rowcolargsr^r-cellr0r0r1add_cellDs zTable.add_cellc Cstjt|dz |d|d}}Wnty#}ztd|d}~ww||jdd||| d||j ||f<d|_ dS) z8 Set a custom cell in a given position. )rrrz0Only tuples length 2 are accepted as coordinatesNFrT) rcheck_isinstancer ExceptionKeyErrorr7rr3 get_transformr)rr4)r,positionrrrerrr0r0r1 __setitem__\s  zTable.__setitem__cCs |j|S)z-Retrieve a custom cell from a given position.r)r,rr0r0r1 __getitem__lr@zTable.__getitem__cCr9)a 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' rar:r0r0r1rpsz Table.edgescCs||_d|_dSr2)rbr4rmr0r0r1r cCs&|jd|jddj|jjjdS)NgR@Trg333333?)FONTSIZErdpirrSr r:r0r0r1_approx_text_heights zTable._approx_text_heightcCs|dur |jdd}|durtd|sdS|jd|d||t|jD] }|j| |q-| dd|_ dS)NTrzNo renderer definedtable)gidF) r _get_renderer RuntimeErrorrG open_groupget_gid_update_positionssortedrrH close_groupr4)r,rCkeyr0r0r1rHs   z Table.drawcs4fdd|jD}t|}||S)z Get a bbox, in axes coordinates for the cells. Only include those in the range (0, 0) to (maxRow, maxCol). c.g|]\\}}}|dkr|dkr|qSrrMrdrrrrCr0r1   z(Table._get_grid_bbox..)ritemsr unionrTrrV)r,rCboxesrSr0rr1_get_grid_bboxs  zTable._get_grid_bboxcsh||r difS|jdddur0fdd|jD}t|}||j|j ifSdifS)NFTrcrrrrrr0r1rrz"Table.contains..) _different_canvasrrrrr rcontainsr"r#)r, mouseeventrrSr0rr1rs   zTable.containscCst|jS)z*Return the Artists contained by the table.)listrvaluesr:r0r0r1 get_childrenszTable.get_childrencsDdur |jdd|fdd|jD}t|S)NTrcsg|]}|qSr0rrdrrr0r1rsz+Table.get_window_extent..)rrrrrr r)r,rCrr0rr1rMs   zTable.get_window_extentc Csi}i}|jD]$\\}}}||d}t||||<||d}t||||<q d}i} t|D] }|| |<|||7}q6d} i} t|ddD] }| | |<| ||7} qM|jD]\\}}}|| ||| |q_dS)zV Calculate row heights and column widths; position cells accordingly. rrrT)reverseN) rr setdefaultmax get_heightrBrset_xset_y) r,widthsheightsrrrr rxposleftsyposbottomsr0r0r1_do_cell_alignments*   zTable._do_cell_alignmentcCsBt|}t|jtjstd|D]}|j|qd|_dS)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 TypeErrorrappendr4)r,rcol1drr0r0r1auto_set_column_widths  zTable.auto_set_column_widthcsJfdd|jD}tfdd|Ddd}|D]}||qdS)z#Automatically set width for column.cs g|] \}}|dkr|qS)rr0)rdrr)rr0r1rs z0Table._auto_set_column_width..c3s|]}|VqdSr6)rArrr0r1rfrgz/Table._auto_set_column_width..r)defaultN)rrr set_width)r,rrCcells max_widthrr0)rrCr1_auto_set_column_widths zTable._auto_set_column_widthTcCs||_d|_dS)zAutomatically set font size.TN)rr4rmr0r0r1rFrzTable.auto_set_font_sizecCst|jdkr dStt|j}g}|jD]\}}|d|jvr'q||}t ||}| |q|jD]}| |qr0r0r1_auto_set_font_sizes    zTable._auto_set_font_sizecCs8|jD]}||||||qdS)z Set the font size, in points, of the cell text. Parameters ---------- size : float Notes ----- As long as auto font size has not been disabled, the value will be clipped such that the text fits horizontally into the cell. You can disable this behavior using `.auto_set_font_size`. >>> 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)rrr=r4)r,r>rr0r0r1r= s  zTable.set_fontsizecCsB|jD]}||}}||||||qdS)z-Move all the artists by ox, oy (axes coords).N)rrget_xget_yrr)r,oxoyrr"r#r0r0r1_offset9s z Table._offsetc Cs4|jD]}|||q|jr|||||}|j\}}}}|jdurVt|jt r8|jj\}} } } n|j\}} } } | | || |||} | |} |nt t |j \}}}}}}}}}}}}}}}}}}d|d|} d|d|} |j|||fvr|j|} |j|||||fvrd|||j} |j||||fvrd|||j} |j|||fvr|j|} |j|||fvrd|d|} |j|||fvrd|d|} |j|||fvr|| } |j|||fvrd|} |j|||fvrd|} |j|||fvr|| } || | dS)Ng?rKrrY)rrrrrrrWrrr rrangerrvr*AXESPADr) r,rCrrSrZr[rr\rlrbrwrhrrBESTURULLLLRCLCRLCUCCTRTLBLBRRLTBr0r0r1r@sR           zTable._update_positionscCr9)a 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] rr:r0r0r1 get_celldzs zTable.get_celld)NNr6)T) rxryrzr{rvrrr(rrrr}rr~rrrHrrrrMrrrrFrrr=rrrrr0r0r.r1rs     ,       :rrrLr!rrc Ks|dur |dur td|dur"t|}t|d}dg|g|}t|rA|dur.|j}ntd|dur:|j}ntd|j}t|}t|d}|D]}t||kr]td|dqM|durt||krptd |d |D]}t||krtd |dqrnd |g|}|durd |g|}d}|dur|durdg|}|d}n|durd |}|durt||krtd|d}|dur| durdg|}n d}n| durd |} |durd |g|}t|| | fi|}| |_|}t |D]"}t |D]}|j |||||||||||||dqq|dur@t |D]}|j d||||||| || dq*|durlt |D]}|j ||d|pUd||||||dqI|dkrl| dd|vrx| |d| ||S)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 NzZAt 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 rrYz'rowLabels' must be of length r)rr rrrrqgV瞯s.     F