U
    ê‹Ñh×l  ã                   @   sš   d Z ddlZddlZddlmZ ddlZddlZddlm	Z	m
Z
mZ ddlmZ e e¡ZG dd„ dƒZG dd	„ d	eƒZG d
d„ deƒZG dd„ dƒZdS )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
:doc:`/tutorials/intermediate/arranging_axes` for a guide.
é    N)ÚIntegral)Ú_apiÚ_pylab_helpersÚ_tight_layout)ÚBboxc                   @   s¼   e Zd ZdZd)dd„Zdd„ Zedd„ d	d
�Zedd„ dd
�Zdd„ Z	d*dd„Z
d+dd„Zdd„ Zdd„ Zdd„ Zdd„ Ze dd¡d,dd „ƒZed!d"„ ƒZd#d$„ Zddd%dd&œd'd(„ZdS )-ÚGridSpecBasezm
    A base class of GridSpec that specifies the geometry of the grid
    that a subplot will be placed.
    Nc                 C   sf   t |tƒr|dkr td|›�ƒ‚t |tƒr2|dkr@td|›�ƒ‚|| | _| _|  |¡ |  |¡ dS )aŸ  
        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.
        r   z/Number of rows must be a positive integer, not z2Number of columns must be a positive integer, not N)Ú
isinstancer   Ú
ValueErrorÚ_nrowsÚ_ncolsÚset_height_ratiosÚset_width_ratios)ÚselfÚnrowsÚncolsÚheight_ratiosÚwidth_ratios© r   úA/tmp/user/2202/pip-unpacked-wheel-9k0_ldo3/matplotlib/gridspec.pyÚ__init__!   s    ÿÿ
zGridSpecBase.__init__c                 C   sb   t t| jƒƒdkrd| jf nd}t t| jƒƒdkr@d| jf nd}dj| jj| j| j|| d�S )Né   z, height_ratios=%rÚ z, width_ratios=%rz&{clsname}({nrows}, {ncols}{optionals}))Zclsnamer   r   Ú	optionals)	ÚlenÚsetÚ_row_height_ratiosÚ_col_width_ratiosÚformatÚ	__class__Ú__name__r
   r   )r   Z
height_argZ	width_argr   r   r   Ú__repr__:   s    ÿÿÿÿüzGridSpecBase.__repr__c                 C   s   | j S ©N)r
   ©r   r   r   r   Ú<lambda>F   ó    zGridSpecBase.<lambda>zThe number of rows in the grid.)Údocc                 C   s   | j S r!   )r   r"   r   r   r   r#   H   r$   z"The number of columns in the grid.c                 C   s   | j | jfS )zW
        Return a tuple containing the number of rows and columns in the grid.
        )r
   r   r"   r   r   r   Úget_geometryK   s    zGridSpecBase.get_geometryc                 C   s   d S r!   r   )r   Úfigurer   r   r   Úget_subplot_paramsQ   s    zGridSpecBase.get_subplot_paramsr   c                 C   s(   |\}}| ||| …||| …f }|S )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.
        r   )r   ÚlocÚrowspanÚcolspanÚloc1Úloc2Zsubplotspecr   r   r   Únew_subplotspecU   s    zGridSpecBase.new_subplotspecc                 C   s6   |dkrdg| j  }nt|ƒ| j kr,tdƒ‚|| _dS )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)``.
        Nr   zTExpected the given number of width ratios to match the number of columns of the grid)r   r   r	   r   )r   r   r   r   r   r   e   s
    zGridSpecBase.set_width_ratiosc                 C   s   | j S )zo
        Return the width ratios.

        This is *None* if no width ratios have been set explicitly.
        )r   r"   r   r   r   Úget_width_ratioss   s    zGridSpecBase.get_width_ratiosc                 C   s6   |dkrdg| j  }nt|ƒ| j kr,tdƒ‚|| _dS )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)``.
        Nr   zRExpected 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   {   s
    zGridSpecBase.set_height_ratiosc                 C   s   | j S )zq
        Return the height ratios.

        This is *None* if no height ratios have been set explicitly.
        )r   r"   r   r   r   Úget_height_ratios‰   s    zGridSpecBase.get_height_ratiosz3.7ÚrawFc                    st  |   ¡ \}}|r*d}d}d}d}d}	d}
n.|  |¡}|j}|j}|j}|j}|j}	|j}
|| }|| }|||
|d    }|
| }|| t| j	ƒ ‰ ‡ fdd„| j	D ƒ}dg|g|d   }t
 t
 ||g¡j¡}|||	|d    }|	| }|| t| jƒ ‰ ‡ fdd„| jD ƒ}dg|g|d   }t
 t
 ||g¡j¡}||  d¡j\}}||  d¡j\}}||||fS )	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*.
        raw : bool, default: False
            If *True*, the subplot parameters of the figure are not taken
            into account. The grid spans the range [0, 1] in both directions
            without margins and there is no space between grid cells. This is
            used for constrained_layout.

        Returns
        -------
        bottoms, tops, lefts, rights : array
            The bottom, top, left, right positions of the grid cells in
            figure coordinates.
        g        g      ð?r   c                    s   g | ]}|ˆ  ‘qS r   r   ©Ú.0Úr©Znormr   r   Ú
<listcomp>¿   s     z3GridSpecBase.get_grid_positions.<locals>.<listcomp>r   c                    s   g | ]}|ˆ  ‘qS r   r   r2   r5   r   r   r6   Ç   s     )éÿÿÿÿé   )r&   r(   ÚleftÚrightÚbottomÚtopÚwspaceÚhspaceÚsumr   ÚnpZcumsumZcolumn_stackÚflatr   ZreshapeÚT)r   Zfigr1   r   r   r9   r:   r;   r<   r=   r>   Zsubplot_paramsZ	tot_widthZ
tot_heightZcell_hZsep_hZcell_heightsZsep_heightsZcell_hsZcell_wZsep_wZcell_widthsZ
sep_widthsZcell_wsÚfig_topsÚfig_bottomsÚ	fig_leftsÚ
fig_rightsr   r5   r   Úget_grid_positions‘   s@    
zGridSpecBase.get_grid_positionsc                 C   sZ   |   ¡ D ]B}| ¡ }|dk	rt|dƒr2| ¡  ¡ }| ¡ ||fkr|  S qt||| d�S )zo
        Check if the figure already has a gridspec with these dimensions,
        or create a new one
        NÚget_topmost_subplotspec©r'   )Zget_axesÚget_gridspecÚhasattrrH   r&   ÚGridSpec)r'   r   r   ÚaxÚgsr   r   r   Ú_check_gridspec_existsÏ   s    

z#GridSpecBase._check_gridspec_existsc           
   
   C   s¢   |   ¡ \}}dd„ }t|tƒr‚z|\}}W n, tk
rV } ztdƒ|‚W 5 d}~X Y nX t |||dƒ|||dƒg||f¡\}}	n|||| dƒ\}}	t| ||	ƒS )z,Create and return a `.SubplotSpec` instance.c                 S   s¨   | }t | tƒr<|  |¡\}}}||kr2||d fS tdƒ‚nh| dk rL| | } d|   kr`|k rln n| | fS |d k	r�td|› d|› d|› �ƒ‚ntd|› d|› �ƒ‚d S )Nr   z=GridSpec slice would result in no space allocated for subplotr   zindex z is out of bounds for axis z with size z) is out of bounds for GridSpec with size )r   ÚsliceÚindicesÚ
IndexError)ÚkeyÚsizeZaxisZorig_keyÚstartÚstopÚ_r   r   r   Ú
_normalizeè   s    

z,GridSpecBase.__getitem__.<locals>._normalizezUnrecognized subplot specNr   r   )r&   r   Útupler	   r@   Zravel_multi_indexÚSubplotSpec)
r   rS   r   r   rX   Zk1Zk2ÚerrÚnum1Únum2r   r   r   Ú__getitem__ä   s    
þ
zGridSpecBase.__getitem__T)ÚsharexÚshareyÚsqueezeÚ
subplot_kwc                C   sr  | j }|dkrtdƒ‚t|tƒs,|r(dnd}t|tƒsB|r>dnd}tjddddddg||d	� |dkrji }| ¡ }tj| j	| j
ftd
�}t| j	ƒD ]l}t| j
ƒD ]\}d|d ||df |d|f dœ}	|	| |d< |	| |d< |j| ||f f|Ž|||f< q q’|dk�r$|jD ]}
|
jdd� �q|dk�rH|jD ]}
|
jdd� �q4|�rj|jdk�rb| ¡ S | ¡ S |S dS )z‘
        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 figureÚallÚnoneÚrowÚcolFT)r_   r`   )Zdtype)r   r   r   )rd   rc   re   rf   r_   r`   )rf   rc   )Zcheck_patch)re   rc   r   )r'   r	   r   Ústrr   Zcheck_in_listÚcopyr@   Úemptyr
   r   ÚobjectÚrangeZadd_subplotrA   Z_label_outer_xaxisZ_label_outer_yaxisrT   Úitemra   )r   r_   r`   ra   rb   r'   Zaxarrre   rf   Zshared_withrM   r   r   r   Úsubplots	  sJ    

 ÿ
 
ÿ
ÿÿ



zGridSpecBase.subplots)NN)N)r   r   )F)r   Ú
__module__Ú__qualname__Ú__doc__r   r    Úpropertyr   r   r&   r(   r.   r   r/   r   r0   r   Zdelete_parameterrG   ÚstaticmethodrO   r^   rm   r   r   r   r   r      s0   
ÿÿ


=
%ÿr   c                	       sV   e Zd ZdZd‡ fdd„	Zddddd	d
gZdd„ Zddd„Zdd„ Zddd„Z	‡  Z
S )rL   a  
    A grid layout to place subplots within a figure.

    The location of the grid cells is determined in a similar way to
    `~.figure.SubplotParams` using *left*, *right*, *top*, *bottom*, *wspace*
    and *hspace*.

    Indexing a GridSpec instance returns a `.SubplotSpec`.
    Nc                    sB   || _ || _|| _|| _|| _|	| _|| _tƒ j|||
|d� dS )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.

        ©r   r   N)	r9   r;   r:   r<   r=   r>   r'   Úsuperr   )r   r   r   r'   r9   r;   r:   r<   r=   r>   r   r   ©r   r   r   r   I  s    *
þzGridSpec.__init__r9   r;   r:   r<   r=   r>   c                 K   s˜   |  ¡ D ].\}}|| jkr(t| ||ƒ qt|› d�ƒ‚qtjj ¡ D ]N}|jj	j
D ]>}| ¡ dk	rR| ¡  ¡ }| ¡ | krR| | ¡  |j	¡¡ qRqDdS )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, optional
            Spacing between the subplots as a fraction of the average subplot
            width / height.
        z is an unknown keywordN)ÚitemsÚ_AllowedKeysÚsetattrÚAttributeErrorr   ZGcfZfigsÚvaluesZcanvasr'   ÚaxesZget_subplotspecrH   rJ   Z_set_positionÚget_position)r   ÚkwargsÚkÚvZ
figmanagerrM   Ússr   r   r   Úupdate�  s    
ÿzGridSpec.updatec                    sT   |dkr(dd„ ˆ j D ƒ}tjjf |Ž}nt |j¡}|jf ‡ fdd„ˆ j D ƒŽ |S )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.
        Nc                 S   s   i | ]}|t jd |  “qS )zfigure.subplot.)ÚmplÚrcParams©r3   r~   r   r   r   Ú
<dictcomp>ª  s   ÿ z/GridSpec.get_subplot_params.<locals>.<dictcomp>c                    s   i | ]}|t ˆ |ƒ“qS r   ©Úgetattrr„   r"   r   r   r…   °  s      )rw   r‚   r'   ÚSubplotParamsrh   Úsubplotparsr�   )r   r'   Úkwr‰   r   r"   r   r(   �  s    ÿzGridSpec.get_subplot_paramsc                    s   ‡ fdd„ˆ j D ƒS )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`.
        c                    s   g | ]}t ˆ |ƒr|‘qS r   r†   r„   r"   r   r   r6   »  s     
 z<GridSpec.locally_modified_subplot_params.<locals>.<listcomp>)rw   r"   r   r"   r   Úlocally_modified_subplot_params´  s    z(GridSpec.locally_modified_subplot_paramsçHáz®Gñ?c              
   C   sL   |dkr|  ¡ }tj||jtj|j| d�|||||d�}|rH| jf |Ž dS )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)Z	grid_spec)ÚpadÚh_padÚw_padÚrect)Z_get_rendererr   Zget_tight_layout_figurer{   Zget_subplotspec_listr�   )r   r'   Zrendererr�   rŽ   r�   r�   r}   r   r   r   Útight_layout½  s         ýzGridSpec.tight_layout)	NNNNNNNNN)N)NrŒ   NNN)r   rn   ro   rp   r   rw   r�   r(   r‹   r‘   Ú__classcell__r   r   ru   r   rL   ?  s*   	              ý6
	        ÿrL   c                       s4   e Zd ZdZd	‡ fdd„	Zd
dd„Zdd„ Z‡  ZS )ÚGridSpecFromSubplotSpeczx
    GridSpec whose subplot layout parameters are inherited from the
    location specified by a given SubplotSpec.
    Nc                    s8   || _ || _|| _| j ¡ j| _tƒ j||||d� dS )ak  
        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.
        rs   N)Ú_wspaceÚ_hspaceÚ_subplot_specrJ   r'   rt   r   )r   r   r   Zsubplot_specr=   r>   r   r   ru   r   r   r   â  s    
þz GridSpecFromSubplotSpec.__init__c           	      C   s†   | j dk	r| j n|dk	r |jjntjd }| jdk	r:| jn|dk	rJ|jjntjd }| j |¡}|j	\}}}}tj
j||||||d�S )z1Return a dictionary of subplot layout parameters.Nzfigure.subplot.hspacezfigure.subplot.wspace)r9   r:   r;   r<   r=   r>   )r•   r‰   r>   r‚   rƒ   r”   r=   r–   r|   Zextentsr'   rˆ   )	r   r'   r>   r=   Zfigboxr9   r;   r:   r<   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–   rH   r"   r   r   r   rH     s    z/GridSpecFromSubplotSpec.get_topmost_subplotspec)NNNN)N)r   rn   ro   rp   r   r(   rH   r’   r   r   ru   r   r“   Ý  s         ý
r“   c                   @   s¸   e Zd ZdZd&dd„Zdd„ Zedd„ ƒZed	d
„ ƒZ	e	j
dd
„ ƒZ	dd„ Zdd„ Zedd„ ƒZedd„ ƒZdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zd d!„ Zd"d#„ Zd$d%„ ZdS )'rZ   a]  
    The location of a subplot in a `GridSpec`.

    .. note::

        Likely, you will 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 **inclusive**.

        The index starts from 0.
    Nc                 C   s   || _ || _|| _d S r!   )Ú	_gridspecr\   r]   )r   Úgridspecr\   r]   r   r   r   r   (  s    zSubplotSpec.__init__c              
   C   s6   |   ¡ › d| jj› d| jj› d| jj› d| jj› d�
S )Nú[ú:z, ú])rJ   r*   rU   rV   r+   r"   r   r   r   r    -  s    zSubplotSpec.__repr__c           	      C   sb  t |ƒdkrx|\}t|tƒr |S t|tƒs8td|›�ƒ‚zttt|ƒƒ\}}}W q¤ tk
rt   td|›�ƒd‚Y q¤X n,t |ƒdkr�|\}}}ntj	ddt |ƒd�‚t
 | ||¡}|dkrÈt
||| d�}t|tƒ�rt |ƒd	k�rtd
d„ |D ƒƒ�std|› �ƒ‚|\}}nDt|tƒ�r2|dk �s2||| k�rJtd|| › d|›�ƒ‚| }}||d |… S )zÂ
        Construct a `.SubplotSpec` from a parent `.Figure` and either

        - a `.SubplotSpec` -- returned as is;
        - one or three numbers -- a MATLAB-style subplot specifier.
        r   z>Single argument to subplot must be a three-digit integer, not Né   Zsubplotz1 or 3)ZtakesÚgivenrI   r8   c                 s   s   | ]}t |tƒV  qd S r!   )r   r   )r3   Únr   r   r   Ú	<genexpr>Q  s     z1SubplotSpec._from_subplot_args.<locals>.<genexpr>z3Subplot specifier tuple must contain integers, not z(num must be an integer with 1 <= num <= z, not )r   r   rZ   r   r	   ÚmapÚintrg   r   Znargs_errorrL   rO   rY   rc   )	r'   ÚargsÚargÚrowsÚcolsÚnumrN   ÚiÚjr   r   r   Ú_from_subplot_args2  sD    

ÿÿþ
ÿ
$ÿzSubplotSpec._from_subplot_argsc                 C   s   | j d kr| jS | j S r!   )Ú_num2r\   r"   r   r   r   r]   b  s    zSubplotSpec.num2c                 C   s
   || _ d S r!   )rª   )r   Úvaluer   r   r   r]   f  s    c                 C   s   | j S r!   )r—   r"   r   r   r   rJ   j  s    zSubplotSpec.get_gridspecc                 C   s    |   ¡  ¡ \}}||| j| jfS )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``).
        )rJ   r&   r\   r]   )r   r¤   r¥   r   r   r   r&   m  s    zSubplotSpec.get_geometryc                 C   s$   |   ¡ j}t| j| | j| d ƒS )z6The rows spanned by this subplot, as a `range` object.r   )rJ   r   rk   r\   r]   )r   r   r   r   r   r*   x  s    
zSubplotSpec.rowspanc                 C   s4   |   ¡ j}t| j| | j| gƒ\}}t||d ƒS )z9The columns spanned by this subplot, as a `range` object.r   )rJ   r   Úsortedr\   r]   rk   )r   r   Zc1Úc2r   r   r   r+   ~  s    
zSubplotSpec.colspanc                 C   s   | j jdkS ©Nr   )r*   rU   r"   r   r   r   Úis_first_row‡  s    zSubplotSpec.is_first_rowc                 C   s   | j j|  ¡ jkS r!   )r*   rV   rJ   r   r"   r   r   r   Úis_last_rowŠ  s    zSubplotSpec.is_last_rowc                 C   s   | j jdkS r®   )r+   rU   r"   r   r   r   Úis_first_col�  s    zSubplotSpec.is_first_colc                 C   s   | j j|  ¡ jkS r!   )r+   rV   rJ   r   r"   r   r   r   Úis_last_col�  s    zSubplotSpec.is_last_colc                 C   s‚   |   ¡ }| ¡ \}}t | j| jg||f¡\}}| |¡\}}}	}
||  ¡ }||  ¡ }|	|  ¡ }|
|  ¡ }t	 
||||¡S )zJ
        Update the subplot position from ``figure.subplotpars``.
        )rJ   r&   r@   Zunravel_indexr\   r]   rG   ÚminÚmaxr   Zfrom_extents)r   r'   r˜   r   r   r¤   r¥   rD   rC   rE   rF   Z
fig_bottomZfig_topZfig_leftZ	fig_rightr   r   r   r|   “  s    ÿ
zSubplotSpec.get_positionc                 C   s"   |   ¡ }t|dƒr| ¡ S | S dS )zX
        Return the topmost `SubplotSpec` instance associated with the subplot.
        rH   N)rJ   rK   rH   )r   r˜   r   r   r   rH   £  s    
z#SubplotSpec.get_topmost_subplotspecc                 C   s8   | j | j| jft|dtƒ ƒt|dtƒ ƒt|dtƒ ƒfkS )z}
        Two SubplotSpecs are considered equal if they refer to the same
        position(s) in the same `GridSpec`.
        r—   r\   r]   )r—   r\   r]   r‡   rj   )r   Úotherr   r   r   Ú__eq__­  s    þÿzSubplotSpec.__eq__c                 C   s   t | j| j| jfƒS r!   )Úhashr—   r\   r]   r"   r   r   r   Ú__hash__¸  s    zSubplotSpec.__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 of columns in grid.

        Returns
        -------
        `.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   r}   r   r   r   Úsubgridspec»  s    (zSubplotSpec.subgridspec)N)r   rn   ro   rp   r   r    rr   r©   rq   r]   ÚsetterrJ   r&   r*   r+   r¯   r°   r±   r²   r|   rH   r¶   r¸   r¹   r   r   r   r   rZ     s0   

/




rZ   )rp   rh   ÚloggingZnumbersr   Znumpyr@   Z
matplotlibr‚   r   r   r   Zmatplotlib.transformsr   Ú	getLoggerr   Ú_logr   rL   r“   rZ   r   r   r   r   Ú<module>   s   
  & 7