OwlCyberSecurity - MANAGER
Edit File: table.cpython-38.pyc
U ��]wh � @ s� d Z ddlmZmZmZ ddlmZmZ ddlmZ ddl m Z ddl m Z ddl mZ G dd � d e�ZG d d � d e�ZG d d � d e�Zejje�e�d� ejddd��ZdS )a� This module provides functionality to add a table to a plot. 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. � )�artist�cbook� docstring)�Artist�allow_rasterization)� Rectangle)�Text)�Bbox)�Pathc @ s� e Zd ZdZdZd dd �Zd d � Zd d � Zdd� Zdd� Z dd� Z dd� Z e dd� �Z dd� Zdd� Zd d � Zejd d � �ZdS )!�Cella� A cell is a `.Rectangle` with some associated `.Text`. .. note: 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`. 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 : color spec The color of the cell border. facecolor : color spec The cell facecolor. fill : bool Whether the cell background is filled. text : str The cell text. loc : {'left', 'center', 'right'}, default: 'right' The alignment of the text within the cell. fontproperties : dict A dict defining the font properties of the text. Supported keys and values are the keyword arguments accepted by `.FontProperties`. g�������?�k�wT� Nc C s^ t j| ||||||d� | �d� |d kr.d}|| _t|d |d || d�| _| j�d� d S )N)�width�height�fill� edgecolor� facecolorF�right� r )�x�y�text�fontproperties)r �__init__� set_clip_on�_locr �_text) �self�xyr r r r r r �locr � r! �2/usr/lib/python3/dist-packages/matplotlib/table.pyr A s � �z Cell.__init__c C s t �| |� d| _d S �NT)r � set_transform�stale)r Ztransr! r! r" r$ V s zCell.set_transformc C s t �| |� | j�|� d S �N)r � set_figurer )r Zfigr! r! r" r' [ s zCell.set_figurec C s | j S )z!Return the cell `.Text` instance.)r �r r! r! r" �get_text_ s z Cell.get_textc C s | j �|� d| _dS )zSet the text fontsize.TN)r � set_fontsizer% )r �sizer! r! r" r* c s zCell.set_fontsizec C s | j �� S )zReturn the cell fontsize.)r � get_fontsizer( r! r! r" r, h s zCell.get_fontsizec C sH | � � }| �|�}|dkrD|| �� krD|d8 }| �|� | �|�}q|S )z9Shrink font size until the text fits into the cell width.r )r, �get_required_width� get_widthr* )r �renderer�fontsizeZrequiredr! r! r" �auto_set_font_sizel s zCell.auto_set_font_sizec C s8 | � � s d S t�| |� | �|� | j�|� d| _d S )NF)� get_visibler �draw�_set_text_positionr r% )r r/ r! r! r" r3 w s z Cell.drawc C s� | � |�}|j\}}}}| j�d� ||d }| jdkrT| j�d� ||d }nD| jdkrz| j�d� ||| j }n | j�d� ||d| j }| j�||f� dS )zlSet text up so it draws in the right place. Currently support 'left', 'center' and 'right' �center� @�leftr � �?N)�get_window_extent�boundsr Zset_verticalalignmentr Zset_horizontalalignment�PADZ set_position) r r/ �bbox�l�br �hr r r! r! r" r4 � s zCell._set_text_positionc C s | j �|�}|�| �� �}|jS )zY Return the text bounds as *(x, y, width, height)* in table coordinates. )r r9 �inverse_transformedZget_data_transformr: )r r/ r< Zbboxar! r! r" �get_text_bounds� s zCell.get_text_boundsc C s$ | � |�\}}}}|dd| j S )z/Return the minimal required width for the cell.r8 r6 )rA r; )r r/ r= r> r r? r! r! r" r- � s zCell.get_required_widthc K s | j �|� d| _dS )zX Update the text properties. Valid kwargs are %(Text)s TN)r �updater% )r �kwargsr! r! r" �set_text_props� s zCell.set_text_props)r r Tr NN)�__name__� __module__� __qualname__�__doc__r; r r$ r' r) r* r, r1 r r3 r4 rA r- r �dedent_interpdrD r! r! r! r" r s, � r c sT e Zd ZdZdZdeddd�Z� fdd�Zed d � �Zej d d � �Zd d � Z � Z S )� CustomCellz? A `.Cell` subclass with configurable edge visibility. ZBRTLr ZBTZRL)�open�closedZ horizontalZverticalc s t � j||� || _d S r& )�superr � visible_edges)r rN �argsrC �� __class__r! r" r � s zCustomCell.__init__c C s | j S )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( r! r! r" rN � s zCustomCell.visible_edgesc sr |d kr� j � _nV|� jkr*� j| � _n>t� fdd�|D ��rbtd�|d�� j�d�� j ����|� _d� _d S )Nc 3 s | ]}|� j kV qd S r& ��_edges)�.0�edger( r! r" � <genexpr>� s z+CustomCell.visible_edges.<locals>.<genexpr>z=Invalid edge param {}, must only be one of {} or string of {}z, T)rT rR � _edge_aliases�any� ValueError�format�joinr% �r �valuer! r( r" rN � s �c C s� t jg}| jD ](}|| jkr*|�t j� q|�t j� qt j|dd� krTt j|d< t ddgddgddgddgddgg|dd�S )z*Return a `.Path` for the `.visible_edges`.r N���� r8 T)�readonly)r ZMOVETOrT rR �appendZLINETOZ CLOSEPOLY)r �codesrV r! r! r" �get_path� s �zCustomCell.get_path) rE rF rG rH rT rX r �propertyrN �setterrd � __classcell__r! r! rP r" rJ � s � rJ c @ s e Zd ZdZdddddddd d d d d ddddddd�Zd ZdZdDdd�Zdd� Zdd � Z d d � Z e d d � �Z e j d!d � �Z d"d#� Zed$d%� �Zd&d'� Zd(d)� Zd*d+� Ze�d,�e�Zd-d.� Zd/d0� Zd1d2� Zd3d4� ZdEd6d7�Zd8d9� Z d:d;� Z d<d=� Z d>d?� Z d@dA� Z dBdC� Z!dS )F�TableaD 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. r r � � � � � � � � � � � � � � � � )Zbestz upper rightz upper leftz lower leftz lower rightz center leftz center rightz lower centerz upper centerr5 z top rightztop leftz bottom leftz bottom rightr r7 �top�bottomg{�G�z�?Nc K s� t �| � t|t�rJ|| jkr@tjdd�|d�| j��d� d}| j| }| � |j � || _ || _ || _ | �|j� i | _d| _g | _d| _| �|� | �d� dS ) a� Parameters ---------- ax : `matplotlib.axes.Axes` The `~.axes.Axes` to plot the table into. loc : str The position of the cell with respect to *ax*. This must be one of the `~.Table.codes`. bbox : `.Bbox` or None A bounding box to draw the table into. If this is not *None*, this overrides *loc*. Other Parameters ---------------- **kwargs `.Artist` properties. z3.1zwUnrecognized location {!r}. Falling back on 'bottom'; valid locations are {} This will raise an exception %(removal)s.z )�messagerz NTF)r r � isinstance�strrc r Zwarn_deprecatedr[ r\ r' �figure�_axesr �_bboxr$ Z transAxes�_cellsrT � _autoColumns� _autoFontsizerB r )r �axr r< rC r! r! r" r s. �� zTable.__init__c O s. d}t |f|�d| ji|��}|| ||f< |S )ac 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 : `.CustomCell` The created cell. )r r rN )rJ �edges)r �row�colrO rC r �cellr! r! r" �add_cellM s zTable.add_cellc C s� t |t�std��z|d |d }}W n tk rD td��Y nX |�| j� |�| �� � |� d� || j ||f< d| _ dS )z8 Set a custom cell in a given position. z Table only accepts CustomCellr r z0Only tuples length 2 are accepted as coordinatesFTN) r| rJ � TypeError� Exception�KeyErrorr' r~ r$ � get_transformr r� r% )r �positionr� r� r� r! r! r" � __setitem__e s zTable.__setitem__c C s | j | S )z-Retrieve a custom cell from a given position.�r� )r r� r! r! r" � __getitem__u s zTable.__getitem__c C s | j S )a� The default value of `~.CustomCell.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' rS r( r! r! r" r� y s z Table.edgesc C s || _ d| _d S r# )rT r% r] r! r! r" r� � s c C s | j d | jj | jjj d S )Ng R@g333333�?)�FONTSIZEr~ Zdpir r< r r( r! r! r" �_approx_text_height� s ��zTable._approx_text_heightc C st |d kr| j j}|d kr td��| �� s,d S |�d� | �|� t| j�D ]}| j| �|� qJ|� d� d| _ d S )NzNo renderer defined�tableF) r~ �_cachedRenderer� RuntimeErrorr2 Z open_group�_update_positions�sortedr� r3 Z close_groupr% )r r/ �keyr! r! r" r3 � s z Table.drawc s0 � fdd�| j �� D �}t�|�}|�| �� �S )zrGet a bbox, in axes co-ordinates for the cells. Only include those in the range (0,0) to (maxRow, maxCol)c s. g | ]&\\}}}|d kr|d kr|� � ��qS �r �r9 �rU r� r� r� �r/ r! r" � <listcomp>� s �z(Table._get_grid_bbox.<locals>.<listcomp>)r� �itemsr �unionr@ r� )r r/ �boxesr< r! r� r" �_get_grid_bbox� s � zTable._get_grid_bboxc sh | j d k r| � | |�S | jj� � d k r\� fdd�| j�� D �}t�|�}|�|j|j �i fS di fS d S )Nc s. g | ]&\\}}}|d kr|d kr|� � ��qS r� r� r� r� r! r" r� � s �z"Table.contains.<locals>.<listcomp>F) Z _containsr~ r� r� r� r r� �containsr r )r Z mouseeventr� r< r! r� r" r� � s � zTable.containsc C s t | j�� �S )z*Return the Artists contained by the table.)�listr� �valuesr( r! r! r" � get_children� s zTable.get_childrenz3.0c s" � fdd�| j �� D �}t�|�S )z6Return the bounding box of the table in window coords.c s g | ]}|� � ��qS r! r� �rU r� r� r! r" r� � s �z+Table.get_window_extent.<locals>.<listcomp>)r� r� r r� )r r/ r� r! r� r" r9 � s �zTable.get_window_extentc C s� i }i }| j �� D ]H\\}}}|�|d�}t||�� �||< |�|d�}t||�� �||< qd}i } t|�D ]}|| |< ||| 7 }qld} i } t|dd�D ]}| | |< | || 7 } q�| j �� D ](\\}}}|�| | � |�| | � q�dS )zV Calculate row heights and column widths; position cells accordingly. r` r T)�reverseN) r� r� � setdefault�max� get_heightr. r� �set_x�set_y) r ZwidthsZheightsr� r� r� r r ZxposZleftsZyposZbottomsr! r! r" �_do_cell_alignment� s( zTable._do_cell_alignmentc C sR z t |� W n$ ttfk r0 | j�|� Y nX |D ]}| j�|� q6d| _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. TN)�iterr� �AttributeErrorr� rb r% )r r� r� r! r! r" �auto_set_column_width� s zTable.auto_set_column_widthc sJ � fdd�| j �� D �}t�fdd�|D �dd�}|D ]}|�|� q6dS )z#Automatically set width for column.c s g | ]\}}|d � kr|�qS )r r! )rU r� r� )r� r! r" r� s z0Table._auto_set_column_width.<locals>.<listcomp>c 3 s | ]}|� � �V qd S r& )r- r� r� r! r" rW s z/Table._auto_set_column_width.<locals>.<genexpr>r )�defaultN)r� r� r� � set_width)r r� r/ �cellsZ max_widthr� r! )r� r/ r" �_auto_set_column_width s �z Table._auto_set_column_widthTc C s || _ d| _dS )z Automatically set font size.TN)r� r% r] r! r! r" r1 s zTable.auto_set_font_sizec C s� t | j�dkrd S tt| j�� ���� }g }| j�� D ]6\}}|d | jkrNq6|�|�}t ||�}|� |� q6| j�� D ]}|� |� qxd S )Nr r ) �lenr� �nextr� r� r, r� r� r1 �minrb r* )r r/ r0 r� r� r� r+ r! r! r" �_auto_set_font_size s zTable._auto_set_font_sizec C s8 | j �� D ](}|�|�� | � |�|�� | � q dS )z<Scale column widths by *xscale* and row heights by *yscale*.N)r� r� r� r. Z set_heightr� )r ZxscaleZyscale�cr! r! r" �scale# s z Table.scalec C s$ | j �� D ]}|�|� q d| _dS )a> 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)r� r� r* r% )r r+ r� r! r! r" r* ) s zTable.set_fontsizec C sB | j �� D ]2}|�� |�� }}|�|| � |�|| � q dS )z-Move all the artists by ox, oy (axes coords).N)r� r� Zget_xZget_yr� r� )r �ox�oyr� r r r! r! r" �_offsetB s z Table._offsetc C s& | j D ]}| �||� q| jr(| �|� | �� | �|�}|j\}}}}| jd k r�| j\}} } } | �| | | | � || } | | } | �� �n�t t | j ��\}}}}}}}}}}}}}}} } } } d|d | } d|d | } | j |||fkr�| j | } | j |||| |fk�r$d|| | j } | j ||||fk�rJd|| | j } | j |||fk�rf| j | } | j |||fk�r�d|d | } | j |||fk�r�d|d | } | j ||| fk�r�|| } | j ||| fk�r�d| } | j ||| fk�r�d| } | j ||| fk�r|| } | �| | � d S )Ng �?ri r r8 )r� r� r� r� r� r� r: r� r� �ranger� rc r �AXESPADr� ) r r/ r� r< r= r> r r? Zrl�rbZrwZrhr� r� ZBESTZURZULZLLZLRZCLZCRZLCZUC�CZTRZTLZBLZBR�R�L�T�Br! r! r" r� I s\ � zTable._update_positionsc C s | j S )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] r� r( r! r! r" � get_celld� s zTable.get_celld)NN)T)"rE rF rG rH rc r� r� r r� r� r� re r� rf r� r r3 r� r� r� r Z deprecatedZget_child_artistsr9 r� r� r� r1 r� r� r* r� r� r� r! r! r! r" rh � s` � . 7rh )rh Nr r7 r5 rz rL c K s� |dkr|dkrt d��|dkrDt|�}t|d �}dg| g| }t|�}t|d �}|D ] }t|�|kr\t d�|���q\|dk r�t|�|kr�t d�|���|D ] }t|�|kr�t d�|���q�nd| g| }|dkr�d | g| }d}|dk�r|dk �r&dg| }|d }n|dk�r&d| }|dk �rLt|�|k�rLt d �|���d }|dk�rv| dk �rpdg| }nd}n| dk�r�d| } |dk�r�d| g| }t| | | f|�}| |_|�� }t|�D ]F}t|�D ]6}|j|| ||| ||| | || | |d � �qҐq�|dk �rLt|�D ]*}|jd||| ||| | | | d � �q |dk �r�t|�D ]0}|j|| d |�pvd||| || |d � �q^|dk�r�|�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, 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 matplotlib color specs, optional The background colors of the cells. cellLoc : {'left', 'center', 'right'}, default: 'right' 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 matplotlib color specs, optional The colors of the row header cells. rowLoc : {'left', 'center', 'right'}, optional, default: 'left' The text alignment of the row header cells. colLabels : list of str, optional The text of the column header cells. colColours : list of matplotlib color specs, optional The colors of the column header cells. colLoc : {'left', 'center', 'right'}, optional, default: 'left' The text alignment of the column header cells. loc : str, optional The position of the cell with respect to *ax*. This must be one of the `~.Table.codes`. bbox : `.Bbox`, optional A bounding box to draw the table into. If this is not *None*, this overrides *loc*. edges : substring of 'BRTL' or {'open', 'closed', 'horizontal', 'vertical'} The cell edges to be drawn with a line. See also `~.CustomCell.visible_edges`. Other Parameters ---------------- **kwargs `.Table` properties. %(Table)s Returns ------- table : `~matplotlib.table.Table` The created table. NzZAt least one argument from "cellColours" or "cellText" must be provided to create a table.r r z+Each row in 'cellText' must have {} columnsz 'cellColours' must have {} rowsz.Each row in 'cellColours' must have {} columnsr r8 z!'rowLabels' must be of length {0}r )r r r r r r_ gV瞯�<) rZ r� r[ rh r� r� r� r� r� Z add_table)r� ZcellTextZ cellColoursZcellLocZ colWidthsZ rowLabelsZ rowColoursZrowLocZ colLabelsZ colColoursZcolLocr r< r� rC ZrowsZcolsr� Z rowLabelWidth�offsetr� r r� r! r! r" r� � s� T � � � � � r� ) NNr NNNr7 NNr5 rz NrL )rH r r r r r r Zpatchesr r r Z transformsr �pathr r rJ rh ZinterpdrB ZkwdocrI r� r! r! r! r" �<module> s: A �