| Server IP : 202.61.199.114 / Your IP : 216.73.217.139 Web Server : nginx/1.22.1 System : Linux de.arni-solutions.de 6.1.0-49-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.174-1 (2026-05-26) x86_64 User : web20 ( 1018) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/local/lib/python3.9/dist-packages/matplotlib/__pycache__/ |
Upload File : |
a
���hEt � @ s� d Z ddlZddlZddlmZ ddlZddlZddlm Z m
Z
m Z ddl m
Z
e�e�ZG dd� d�ZG dd � d e�ZG d
d � d e�ZG d d
� d
�ZG dd� 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.
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 :ref:`arranging_axes` for a guide.
� N)�Integral)�_api�_pylab_helpers�
_tight_layout)�Bboxc @ s� e Zd ZdZd'dd�Zdd� Zedd� d d
�Zed d� d d
�Zd
d� Z d(dd�Z
d)dd�Z dd� Z dd� Z
dd� Zdd� Zd d � Zed d � �Zd d!� Zd"d"d#dd$�d%d&�ZdS )*� 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|dkr td|����t |t�r2|dkr@td|����|| | _| _| �|� | �|� dS )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 �=/usr/local/lib/python3.9/dist-packages/matplotlib/gridspec.py�__init__ s ��
zGridSpecBase.__init__c C sb t t| j��dkr d| j��nd}t t| j��dkr@d| j��nd}dj| jj| j| j|| d�S )N� z, height_ratios=� z, width_ratios=z&{clsname}({nrows}, {ncols}{optionals}))Zclsnamer r � optionals) �len�set�_row_height_ratios�_col_width_ratios�format� __class__�__name__r
r )r Z
height_argZ width_argr r r �__repr__9 s �����zGridSpecBase.__repr__c C s | j S �N)r
�r r r r �<lambda>E � zGridSpecBase.<lambda>z The number of rows in the grid.)�docc C s | j S r! )r r" r r r r# G r$ z"The number of columns in the grid.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_geometryJ s zGridSpecBase.get_geometryc C s d S r! r )r �figurer r r �get_subplot_paramsP 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_subplotspecT s z GridSpecBase.new_subplotspecc C s6 |du rdg| j }nt|�| j kr,td��|| _dS )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
d 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_ratiosr s z GridSpecBase.get_width_ratiosc C s6 |du rdg| j }nt|�| j kr,td��|| _dS )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 z 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_ratiosc sV | � � \}}| �|�}|j}|j}|j}|j}|j} |j}
|| } || } | ||
|d }
|
|
}|
| t| j � � � fdd�| j D �}dg|g|d }t
� t
� ||g�j
�}| || |d }| | }|| t| j� � � fdd�| jD �}dg|g|d }t
� t
� ||g�j
�}|| �d�j\}}|| �d�j\}}||||fS )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*.
Returns
-------
bottoms, tops, lefts, rights : array
The bottom, top, left, right positions of the grid cells in
figure coordinates.
r c s g | ] }|� �qS r r ��.0�r�Znormr r �
<listcomp>� r$ z3GridSpecBase.get_grid_positions.<locals>.<listcomp>r c s g | ] }|� �qS r r r1 r4 r r r5 � r$ )���� )r& r( �left�right�bottom�top�wspace�hspace�sumr �npZcumsumZ column_stack�flatr Zreshape�T)r Zfigr r Zsubplot_paramsr8 r9 r: r; r< r= Z 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 r4 r �get_grid_positions� s2
z GridSpecBase.get_grid_positionsc C sZ | � � D ]B}|�� }|durt|d�r2|�� �� }|�� ||fkr| S qt||| d�S )zo
Check if the figure already has a gridspec with these dimensions,
or create a new one
N�get_topmost_subplotspec�r' )Zget_axes� get_gridspec�hasattrrG r& �GridSpec)r' r r �ax�gsr r r �_check_gridspec_exists� s
z#GridSpecBase._check_gridspec_existsc
C s� | � � \}}dd� }t|t�r�z |\}}W n. tyX } ztd�|�W Y d}~n
d}~0 0 t�|||d�|||d�g||f�\}} n|||| d�\}} t| || �S )z,Create and return a `.SubplotSpec` instance.c S s� | }t | t�r<| �|�\}}}||kr2||d fS td��nh| dk rL| | } d| kr`|k rln n| | fS |d ur�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 )r �slice�indices�
IndexError)�key�sizeZaxisZorig_key�start�stop�_r r r �
_normalize� s&
��
�z,GridSpecBase.__getitem__.<locals>._normalizezUnrecognized subplot specNr r )r& r �tupler r? Zravel_multi_index� SubplotSpec)
r rR r r rW Zk1Zk2�err�num1�num2r r r � __getitem__� s
�
zGridSpecBase.__getitem__FT)�sharex�sharey�squeeze�
subplot_kwc C sn | j }|du rtd��t|t�s,|r(dnd}t|t�sB|r>dnd}tjg d�||d� |du rbi }|�� }tj| j | j
ft d�}t | j �D ]p}t | j
�D ]`}d|d ||d f |d |f d
�} | | |d < | | |d < |j
| ||f fi |��|||f< q�q�|d
v �r |jD ]}
|
jdd� �q |dv �rD|jD ]}
|
jdd� �q0|�rf|jdk�r^|�� S |�� S |S dS )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)rb �row�colrc FT)r^ r_ )Zdtype)r r r )rc rb rd re r^ r_ )re rb T)Zskip_non_rectangular_axes)rd rb r )r' r r �strr Z
check_in_list�copyr? �emptyr
r �object�rangeZ add_subplotr@ Z_label_outer_xaxisZ_label_outer_yaxisrS �itemr` ) r r^ r_ r` ra r' Zaxarrrd re Z shared_withrL r r r �subplots� sF
��
��
zGridSpecBase.subplots)NN)N)r r )r �
__module__� __qualname__�__doc__r r �propertyr r r& r( r. r
r/ r r0 rF � staticmethodrN r] rl r r r r r s.
��
/
%�r c sN e Zd ZdZd� fdd� Zg d�Zdd� Zddd �Zd
d � Zdd
d�Z � Z
S )rK a
A grid layout to place subplots within a figure.
The location of the grid cells is determined in a similar way to
`.SubplotParams` using *left*, *right*, *top*, *bottom*, *wspace*
and *hspace*.
Indexing a GridSpec instance returns a `.SubplotSpec`.
Nc sB || _ || _|| _|| _|| _| | _|| _t� j|||
| d� dS )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) r8 r: r9 r; r< r= r' �superr ) r r r r' r8 r: r9 r; r< r= r r �r r r r 9 s *
�zGridSpec.__init__�r8 r: r9 r; r< r= c K s� |� � D ].\}}|| jv r(t| ||� qt|� d���qtjj�� D ]N}|jj j
D ]>}|� � durR|� � � � }|�
� | krR|�|� � �|j �� qRqDdS )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 ZGcfZfigs�valuesZcanvasr' �axesZget_subplotspecrG rI Z
_set_position� get_position)r �kwargs�k�vZ
figmanagerrL �ssr r r �updateq s
�zGridSpec.updatec sX |du r(dd� � j D �}tf i |��}n t�|j�}|jf i � fdd�� 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 jd | �qS )�figure.subplot.)�mpl�rcParams�r2 r~ r r r �
<dictcomp>� s �z/GridSpec.get_subplot_params.<locals>.<dictcomp>c s i | ]}|t � |��qS r ��getattrr� r" r r r� � r$ )rw �
SubplotParamsrg � subplotparsr� )r r' �kwr� r r" r r( � s � zGridSpec.get_subplot_paramsc s � fdd�� 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|�qS r r� r� r" r r r5 � r$ 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 sP |du r|� � }tj||jtj|j| d�|||||d�}|rL| jf i |�� dS )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 Zget_tight_layout_figurer{ Zget_subplotspec_listr� )r r' Zrendererr� r� r� r� r} r r r � tight_layout� s
�zGridSpec.tight_layout) NNNNNNNNN)N)Nr� NNN) r rm rn ro r rw r� r( r� r� �
__classcell__r r rt r rK / s �6
�rK c s4 e Zd ZdZd � fdd� Zd
dd�Zdd� Z� ZS ) �GridSpecFromSubplotSpeczx
GridSpec whose subplot layout parameters are inherited from the
location specified by a given SubplotSpec.
Nc sL || _ || _t|t�r || _ntd��| j�� j| _t� j ||||d� dS )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.
zVsubplot_spec must be type SubplotSpec, usually from GridSpec, or axes.get_subplotspec.rr N)
�_wspace�_hspacer rY �
_subplot_spec� TypeErrorrI r' rs r )r r r Z subplot_specr< r= r r rt r r r � s
�
�z GridSpecFromSubplotSpec.__init__c C s� | j dur| j n|dur |jjntjd }| jdur:| jn|durJ|jjntjd }| j�|�}|j \}}}}t
||||||d�S )z1Return a dictionary of subplot layout parameters.Nzfigure.subplot.hspacezfigure.subplot.wspace)r8 r9 r: r; r< r= ) r� r� r= r� r� r� r< r� r| Zextentsr� ) r r' r= r< Zfigboxr8 r: r9 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� rG r" r r r rG s z/GridSpecFromSubplotSpec.get_topmost_subplotspec)NNNN)N)r rm rn ro r r( rG r� r r rt r r� � s �
r� c @ s� e Zd ZdZd&dd�Zdd� Zedd� �Zed d
� �Z e j
d d
� �Z d d
� Z dd� Z edd� �Z
edd� �Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� ZdS )'rY 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 zSubplotSpec.__init__c
C s6 | � � � d| jj� d| jj� d| jj� d| jj� d�
S )N�[�:z, �])rI r* rT rU r+ r" r r r r " s
����zSubplotSpec.__repr__c C s` t |�dkrv|\}t|t�r |S t|t�s8td|����zttt|��\}}}W q� tyr td|���d�Y q�0 n,t |�dkr�|\}}}ntj ddt |�d��t
� | ||�}|du r�t
||| d�}t|t ��r t |�d k�r t
d
d � |D ���std |� ���|\}}nDt|t��r0|dk �s0||| k�rHtd
|| � 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� Zsubplotz1 or 3)Ztakes�givenrH r7 c s s | ]}t |t�V qd S r! )r r )r2 �nr r r � <genexpr>F r$ 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 rY r r �map�intrf r Z nargs_errorrK rN rX rb ) r' �args�arg�rows�cols�numrM �i�jr r r �_from_subplot_args' sP
�� ���
�
$ ��z SubplotSpec._from_subplot_argsc C s | j d u r| jS | j S r! )�_num2r[ r" r r r r\ W s zSubplotSpec.num2c C s
|| _ d S r! )r� )r �valuer r r r\ [ s c C s | j S r! )r� r" r r r rI _ 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``).
)rI r& r[ r\ )r r� r� r r r r& b s zSubplotSpec.get_geometryc C s$ | � � j}t| j| | j| d �S )z6The rows spanned by this subplot, as a `range` object.r )rI r rj r[ r\ )r r r r r r* m s
zSubplotSpec.rowspanc C s4 | � � j}t| j| | j| g�\}}t||d �S )z9The columns spanned by this subplot, as a `range` object.r )rI r �sortedr[ r\ rj )r r Zc1�c2r r r r+ s s
zSubplotSpec.colspanc C s | j jdkS �Nr )r* rT r" r r r � is_first_row| s zSubplotSpec.is_first_rowc C s | j j| �� jkS r! )r* rU rI r r" r r r � is_last_row s zSubplotSpec.is_last_rowc C s | j jdkS r� )r+ rT r" r r r � is_first_col� s zSubplotSpec.is_first_colc C s | j j| �� jkS r! )r+ rU rI r r" r r r � is_last_col� s zSubplotSpec.is_last_colc C s� | � � }|�� \}}t�| j| jg||f�\}}|�|�\}}} }
|| �� } || �� } | | �� }
|
| �� }t �
|
| || �S )zJ
Update the subplot position from ``figure.subplotpars``.
) rI r& r? Z
unravel_indexr[ r\ rF �min�maxr Z from_extents)r r' r� r r r� r� rC rB rD rE Z
fig_bottomZfig_topZfig_leftZ fig_rightr 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.
rG N)rI rJ rG )r r� r r r rG � 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� r[ r\ )r� r[ r\ r� ri )r �otherr r r �__eq__� s ��zSubplotSpec.__eq__c C s t | j| j| jf�S r! )�hashr� r[ r\ r" r r r �__hash__� s zSubplotSpec.__hash__c K s t ||| fi |��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 (zSubplotSpec.subgridspec)N)r rm rn ro r r rq r� rp r\ �setterrI r& r* r+ r� r� r� r� r| rG r� r� r� r r r r rY s0
/
rY c @ s$ e Zd ZdZddd�Zddd�ZdS ) r� zM
Parameters defining the positioning of a subplots grid in a figure.
Nc C s: dD ] }t | |tjd|� � � q| �||||||� dS )au
Defaults are given by :rc:`figure.subplot.[name]`.
Parameters
----------
left : float
The position of the left edge of the subplots,
as a fraction of the figure width.
right : float
The position of the right edge of the subplots,
as a fraction of the figure width.
bottom : float
The position of the bottom edge of the subplots,
as a fraction of the figure height.
top : float
The position of the top edge of the subplots,
as a fraction of the figure height.
wspace : float
The width of the padding between subplots,
as a fraction of the average Axes width.
hspace : float
The height of the padding between subplots,
as a fraction of the average Axes height.
ru r� N)rx r� r� r� )r r8 r: r9 r; r< r= rR r r r r � s zSubplotParams.__init__c C s� |dur |n| j |dur |n| jkr,td��|dur8|n| j|durH|n| jkrXtd��|durf|| _ |durt|| _|dur�|| _|dur�|| _|dur�|| _|dur�|| _dS )zY
Update the dimensions of the passed parameters. *None* means unchanged.
Nzleft cannot be >= rightzbottom cannot be >= top)r8 r9 r r: r; r< r= )r r8 r: r9 r; r< r= r r r r� � s( ��zSubplotParams.update)NNNNNN)NNNNNN)r rm rn ro r r� r r r r r� � s �
�r� )ro rg �logging�numbersr �numpyr? Z
matplotlibr� r r r Zmatplotlib.transformsr � getLoggerr �_logr rK r� rY r� r r r r �<module> s"
< S