OwlCyberSecurity - MANAGER
Edit File: gridspec.cpython-38.pyc
U ��]�Q � @ s� d Z ddlZddlZddlZddlZddlmZmZm Z m Z ddl m Z ddl mZ e�e�ZG dd� de�ZG dd� de�ZG d d � d e�ZG d d � d �ZdS ) 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. See the tutorial :ref:`sphx_glr_tutorials_intermediate_gridspec.py` for a comprehensive usage guide. � N)�_pylab_helpers�cbook� tight_layout�rcParams)�Bboxc @ sp e Zd ZdZddd�Zdd� Zdd� Zd d d �Zd d d �Zdd� Z dd� Z dd� Z dd� Z d dd�Z dd� ZdS ) � GridSpecBasezm A base class of GridSpec that specifies the geometry of the grid that a subplot will be placed. Nc C s& || | _ | _| �|� | �|� dS )z� The number of rows and number of columns of the grid need to be set. Optionally, the ratio of heights and widths of rows and columns can be specified. N)�_nrows�_ncols�set_height_ratios�set_width_ratios)�self�nrows�ncols� height_ratios� width_ratios� r �5/usr/lib/python3/dist-packages/matplotlib/gridspec.py�__init__ s zGridSpecBase.__init__c C sN | j d k rd| j nd}| jd k r,d| j nd}dj| jj| j| j|| d�S )Nz, height_ratios=%r� z, width_ratios=%rz&{clsname}({nrows}, {ncols}{optionals}))Zclsnamer r Z optionals)�_row_height_ratios�_col_width_ratios�format� __class__�__name__r r )r Z height_argZ width_argr r r �__repr__) s � �� ��zGridSpecBase.__repr__c C s | j | jfS )zW Return a tuple containing the number of rows and columns in the grid. )r r �r r r r � get_geometry5 s zGridSpecBase.get_geometryc C s d S �Nr )r �figure�figr r r �get_subplot_params; s z GridSpecBase.get_subplot_params� c C s( |\}}| ||| �||| �f }|S )�,Create and return a `.SubplotSpec` instance.r )r ZlocZrowspanZcolspanZloc1Zloc2Z subplotspecr r r �new_subplotspec> s z GridSpecBase.new_subplotspecc C s( |d k r t |�| jkr td��|| _d S )NzTExpected the given number of width ratios to match the number of columns of the grid)�lenr � ValueErrorr )r r r r r r D s z GridSpecBase.set_width_ratiosc C s | j S r )r r r r r �get_width_ratiosJ s z GridSpecBase.get_width_ratiosc C s( |d k r t |�| jkr td��|| _d S )NzRExpected the given number of height ratios to match the number of rows of the grid)r$ r r% r )r r r r r r M s z GridSpecBase.set_height_ratiosc C s | j S r )r r r r r �get_height_ratiosS s z GridSpecBase.get_height_ratiosFc s� | � � \}}|r*d}d}d}d}d} d} n.| �|�} | j}| j}| j}| j}| j} | j} || } || } | || |d }| | }| jdk r�|| t | j� � � fdd�| jD �}n |g| }dg|g|d }t � t � ||g�j �}| || |d }| | }| jdk �r:|| t | j� � � fdd�| jD �}n |g| }dg|g|d }t � t � ||g�j �}|| �d �j\}}|| �d �j\}}||||fS ) z� Return lists of bottom and top position of rows, left and right positions of columns. If raw=True, then these are all in units relative to the container with no margins. (used for constrained_layout). g g �?r! Nc s g | ] }|� �qS r r ��.0�r�Znormr r � <listcomp>w s z3GridSpecBase.get_grid_positions.<locals>.<listcomp>r c s g | ] }|� �qS r r r( r+ r r r, � s )���� )r r �left�right�bottom�top�wspace�hspacer �sum�npZcumsumZ column_stackZflatr Zreshape�T) r r �rawr r r/ r0 r1 r2 r3 r4 Zsubplot_paramsZ tot_widthZ tot_heightZcell_hZsep_hZ cell_heightsZ sep_heightsZcell_hsZcell_wZsep_wZ cell_widthsZ sep_widthsZcell_ws�fig_tops� fig_bottoms� fig_lefts� fig_rightsr r+ r �get_grid_positionsV sH z GridSpecBase.get_grid_positionsc C s� | � � \}}dd� }t|t�rrz |\}}W n tk rF td��Y nX t�|||d�|||d�g||f�\}}n|||| d�\}}t| ||�S )r" c S s� | }t | t�r<| �|�\}}}||kr2||d fS td��nh| dk rL| | } d| kr`|k rln n| | fS |d k r�td|� d|� d|� ���ntd|� d|� ���d S )Nr! z=GridSpec slice would result in no space allocated for subplotr zindex z is out of bounds for axis z with size z) is out of bounds for GridSpec with size )� isinstance�slice�indices� IndexError)�key�sizeZaxisZorig_key�start�stop�_r r r � _normalize� s z,GridSpecBase.__getitem__.<locals>._normalizezunrecognized subplot specr r! N)r r> �tupler% r6 Zravel_multi_index� SubplotSpec) r rB r r rG Zk1Zk2�num1�num2r r r � __getitem__� s � zGridSpecBase.__getitem__)NN)NN)r! r! )F)r � __module__� __qualname__�__doc__r r r r r# r r& r r' r= rL r r r r r s 6r c @ s^ e Zd ZdZddd�Zddddd d gZd d � Zd d� Zdd� Zddd�Z dd� Z ddd�Z dS )�GridSpecz� Specifies the geometry of the grid that a subplot can be placed in. The location of grid is determined by similar way as the SubplotParams. Nc C s� || _ || _|| _|| _|| _| | _|| _tj| ||| | d� | jdksR| j� � sZd| _ n(| j� � t j | jj dt �� | d�| _ dS )a� The number of rows and number of columns of the grid need to be set. Optionally, the subplot layout parameters (e.g., left, right, etc.) can be tuned. Parameters ---------- nrows : int Number of rows in grid. ncols : int Number or columns in grid. figure : `~.figure.Figure`, optional 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. wspace : float, optional The amount of width reserved for space between subplots, expressed as a fraction of the average axis width. hspace : float, optional The amount of height reserved for space between subplots, expressed as a fraction of the average axis height. width_ratios : length *ncols* iterable, optional Width ratios of the columns. height_ratios : length *nrows* iterable, optional Height ratios of the rows. Notes ----- See `~.figure.SubplotParams` for descriptions of the layout parameters. �r r N�gridspec��parent�name�artist)r/ r1 r0 r2 r3 r4 r r r Zget_constrained_layout� _layoutboxZinit_layoutbox� layoutbox� LayoutBox�seq_id) r r r r r/ r1 r0 r2 r3 r4 r r r r r r � s& * � �zGridSpec.__init__r/ r1 r0 r2 r3 r4 c C s. | j }z|�d� W n tk r( Y nX |S �NrW ��__dict__�pop�KeyError�r �stater r r � __getstate__� s zGridSpec.__getstate__c C s || _ d | _d S r �r] rW r` r r r � __setstate__ s zGridSpec.__setstate__c K s |� � D ].\}}|| jkr(t| ||� qt|� d���qtjj�� D ]�}|jj j D ]�}t |t j j �s�t |jt j j �r�|j�� �� | kr�|j�� |�|jj� n:t |jt j j �r�|j�� �� | kr�|j�� |�|jj� qR|�� �� }|�� | krR|�� |�|j� qRqDdS )z` Update the current values. Values set to None use the rcParams value. z is an unknown keywordN)�items� _AllowedKeys�setattr�AttributeErrorr ZGcfZfigs�valuesZcanvasr �axesr> �mplZ SubplotBaseZ_sharexZget_subplotspec� get_gridspecZ update_paramsZ _set_position�figboxZ_sharey�get_topmost_subplotspec)r �kwargs�k�vZ figmanagerZaxZssr r r �update s& zGridSpec.updatec sT |dkr(dd� � j D �}tjjf |�}n t�|j�}|jf � fdd�� j D �� |S )z� Return a dictionary of subplot layout parameters. The default parameters are from rcParams unless a figure attribute is set. Nc S s i | ]}|t d | �qS )zfigure.subplot.)r �r) rp r r r � <dictcomp>- s z/GridSpec.get_subplot_params.<locals>.<dictcomp>c s i | ]}|t � |��qS r ��getattrrs r r r rt 2 s )rf rk r � SubplotParams�copy� subplotparsrr )r r �kwry r r r r ' s zGridSpec.get_subplot_paramsc s � fdd�� j D �S )Nc s g | ]}t � |�r|�qS r ru rs r r r r, 7 s z<GridSpec.locally_modified_subplot_params.<locals>.<listcomp>)rf r r r r � locally_modified_subplot_params6 s z(GridSpec.locally_modified_subplot_params�H�z�G�?c C sd t j|j| d�}d|kr"t�d� |dkr4t �|�}t j||j||||||d�}|r`| jf |� dS )ap Adjust subplot parameters to give specified padding. Parameters ---------- 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 of 4 floats, optional (left, bottom, right, top) rectangle in normalized figure coordinates that the whole subplots area (including labels) will fit into. Default is (0, 0, 1, 1). )Z grid_specNzcThis figure includes Axes that are not compatible with tight_layout, so results might be incorrect.)�pad�h_pad�w_pad�rect)r Zget_subplotspec_listrj r Z_warn_externalZ get_rendererZget_tight_layout_figurerr ) r r Zrendererr} r~ r r� Zsubplotspec_listro r r r r 9 s( � �zGridSpec.tight_layout) NNNNNNNNN)N)Nr| NNN) r rM rN rO r rf rb rd rr r r{ r r r r r rP � s. � B �rP c @ s, e Zd ZdZd dd�Zd dd�Zdd� ZdS ) �GridSpecFromSubplotSpeczx GridSpec whose subplot layout parameters are inherited from the location specified by a given SubplotSpec. Nc C s` || _ || _|| _tj| ||||d� |j}|dkr<d| _n |j||jd t� � | d�| _dS )a` The number of rows and number of columns of the grid need to be set. An instance of SubplotSpec is also needed to be set from which the layout parameters will be inherited. The wspace and hspace of the layout can be optionally specified or the default values (from the figure or rcParams) will be used. rQ Nz .gridspec)rU rV ) �_wspace�_hspace� _subplot_specr r rW Zlayout_from_subplotspecrU rX rZ ) r r r Z subplot_specr3 r4 r r Z subspeclbr r r r c s ��z GridSpecFromSubplotSpec.__init__c C s� | j dk r| j n|dk r |jjntd }| jdk r8| jn|dk rH|jjntd }| j�|�}|j\}}}}t j j ||||||d�S )z:Return a dictionary of subplot layout parameters. Nzfigure.subplot.hspacezfigure.subplot.wspace)r/ r0 r1 r2 r3 r4 ) r� ry r4 r r� r3 r� � get_positionZextentsrk r rw ) r r r4 r3 rm r/ r1 r0 r2 r r r r s �� �z*GridSpecFromSubplotSpec.get_subplot_paramsc C s | j �� S )zY Return the topmost `.SubplotSpec` instance associated with the subplot. )r� rn r r r r rn � s z/GridSpecFromSubplotSpec.get_topmost_subplotspec)NNNN)N)r rM rN rO r r rn r r r r r� ^ s � r� c @ sl e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z ddd�Z dd� Z dd� Z dd� Z dd� ZdS ) rI aL Specifies the location of a subplot in a `GridSpec`. .. note:: Likely, you'll never instantiate a `SubplotSpec` yourself. Instead you will typically obtain one from a `GridSpec` using item-access. Parameters ---------- gridspec : `~matplotlib.gridspec.GridSpec` The GridSpec, which the subplot is referencing. num1, num2 : int The subplot will occupy the num1-th cell of the given gridspec. If num2 is provided, the subplot will span between num1-th cell and num2-th cell. The index starts from 0. Nc C sN || _ || _|| _|jd k rD|j}tj||jd t�� | d�| _nd | _d S )Nz.ssrS )� _gridspecrJ rK rW rX rY rU rZ )r rR rJ rK Zglbr r r r � s � zSubplotSpec.__init__c C s. | j }z|�d� W n tk r( Y nX |S r[ r\ r` r r r rb � s zSubplotSpec.__getstate__c C s || _ d | _d S r rc r` r r r rd � s zSubplotSpec.__setstate__c C s | j S r )r� r r r r rl � s zSubplotSpec.get_gridspecc C s | � � �� \}}||| j| jfS )a 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``). )rl r rJ rK )r �rows�colsr r r r � s zSubplotSpec.get_geometryc C sX | � � }|�� \}}t| j|�\}}| jdk r@t| j|�\}}n|}|}||||||fS )z� Return the subplot row and column numbers as a tuple ``(n_rows, n_cols, row_start, row_stop, col_start, col_stop)``. N)rl r �divmodrJ rK )r rR r r Z row_startZ col_startZrow_stopZcol_stopr r r �get_rows_columns� s z SubplotSpec.get_rows_columnsFc C s� | � � }|�� \}}t�| jdkr*| jgn | j| jg||f�\}}|�|�\}} } } || �� } | | �� } | | �� }| | �� }t � || || �}|r�||d |d ||fS |S dS )zJ Update the subplot position from ``figure.subplotpars``. Nr ) rl r r6 Z unravel_indexrK rJ r= �min�maxr Z from_extents)r r Z return_allrR r r r� r� r: r9 r; r< Z fig_bottomZfig_topZfig_leftZ fig_rightrm r r r r� � s �� zSubplotSpec.get_positionc C s" | � � }t|d�r|�� S | S dS )zX Return the topmost `SubplotSpec` instance associated with the subplot. rn N)rl �hasattrrn )r rR r r r rn � s z#SubplotSpec.get_topmost_subplotspecc C s8 | j | j| jft|dt� �t|dt� �t|dt� �fkS )z} Two SubplotSpecs are considered equal if they refer to the same position(s) in the same `GridSpec`. r� rJ rK )r� rJ rK rv �object)r �otherr r r �__eq__ s ��zSubplotSpec.__eq__c C s t | j| j| jf�S r )�hashr� rJ rK r r r r �__hash__ s zSubplotSpec.__hash__c K s t ||| f|�S )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 or columns in grid. Returns ------- gridspec : `.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 r ro r r r � subgridspec s (zSubplotSpec.subgridspec)N)F)r rM rN rO r rb rd rl r r� r� rn r� r� r� r r r r rI � s rI )rO rx ZloggingZnumpyr6 Z matplotlibrk r r r r Zmatplotlib.transformsr Zmatplotlib._layoutboxrW rX Z getLoggerr Z_logr� r rP r� rI r r r r �<module> s -9