OwlCyberSecurity - MANAGER
Edit File: anchored_artists.cpython-38.pyc
U ��]2R � @ s� d dl mZmZ d dlmZmZmZmZmZ d dl m Z m Z m Z m Z mZ d dlmZ ddddd gZG d d� de�ZG d d� de�ZG d d� de�ZG d d� de�ZG dd � d e�ZdS )� )� docstring� transforms)�AnchoredOffsetbox�AuxTransformBox� DrawingArea�TextArea�VPacker)� Rectangle�Ellipse� ArrowStyle�FancyArrowPatch� PathPatch)�TextPath�AnchoredDrawingArea�AnchoredAuxTransformBox�AnchoredEllipse�AnchoredSizeBar�AnchoredDirectionArrowsc s e Zd Zd� fdd� Z� ZS )r 皙�����?� �?NTc s> t ||||�| _| j| _t� j|f||| jd| d�| �� dS )am An anchored container with a fixed size and fillable DrawingArea. Artists added to the *drawing_area* will have their coordinates interpreted as pixels. Any transformations set on the artists will be overridden. Parameters ---------- width, height : int or float width and height of the container, in pixels. xdescent, ydescent : int or float descent of the container in the x- and y- direction, in pixels. loc : int Location of this artist. Valid location codes are:: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int or float, optional Padding around the child objects, in fraction of the font size. Defaults to 0.4. borderpad : int or float, optional Border padding, in fraction of the font size. Defaults to 0.5. prop : `matplotlib.font_manager.FontProperties`, optional Font property used as a reference for paddings. frameon : bool, optional If True, draw a box around this artists. Defaults to True. **kwargs Keyworded arguments to pass to :class:`matplotlib.offsetbox.AnchoredOffsetbox`. Attributes ---------- drawing_area : `matplotlib.offsetbox.DrawingArea` A container for artists to display. Examples -------- To display blue and red circles of different sizes in the upper right of an axes *ax*: >>> ada = AnchoredDrawingArea(20, 20, 0, 0, ... loc='upper right', frameon=False) >>> ada.drawing_area.add_artist(Circle((10, 10), 10, fc="b")) >>> ada.drawing_area.add_artist(Circle((30, 10), 5, fc="r")) >>> ax.add_artist(ada) N��pad� borderpad�child�prop�frameon)r Zda� drawing_area�super�__init__) �self�width�heightZxdescentZydescent�locr r r r �kwargs�� __class__� �J/usr/lib/python3/dist-packages/mpl_toolkits/axes_grid1/anchored_artists.pyr s B� ��z AnchoredDrawingArea.__init__)r r NT)�__name__� __module__� __qualname__r � __classcell__r& r& r$ r' r s �c @ s e Zd Zddd�ZdS )r r r NTc K s0 t |�| _tj| |f||| j||d�|�� dS )a An anchored container with transformed coordinates. Artists added to the *drawing_area* are scaled according to the coordinates of the transformation used. The dimensions of this artist will scale to contain the artists added. Parameters ---------- transform : `matplotlib.transforms.Transform` The transformation object for the coordinate system in use, i.e., :attr:`matplotlib.axes.Axes.transData`. loc : int Location of this artist. Valid location codes are:: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int or float, optional Padding around the child objects, in fraction of the font size. Defaults to 0.4. borderpad : int or float, optional Border padding, in fraction of the font size. Defaults to 0.5. prop : `matplotlib.font_manager.FontProperties`, optional Font property used as a reference for paddings. frameon : bool, optional If True, draw a box around this artists. Defaults to True. **kwargs Keyworded arguments to pass to :class:`matplotlib.offsetbox.AnchoredOffsetbox`. Attributes ---------- drawing_area : `matplotlib.offsetbox.AuxTransformBox` A container for artists to display. Examples -------- To display an ellipse in the upper left, with a width of 0.1 and height of 0.4 in data coordinates: >>> box = AnchoredAuxTransformBox(ax.transData, loc='upper left') >>> el = Ellipse((0,0), width=0.1, height=0.4, angle=30) >>> box.drawing_area.add_artist(el) >>> ax.add_artist(box) r N)r r r r )r � transformr" r r r r r# r& r& r' r Y s > ��z AnchoredAuxTransformBox.__init__)r r NT�r( r) r* r r& r& r& r' r X s �c @ s e Zd Zddd�ZdS )r 皙�����?NTc K sN t |�| _td|||�| _| j�| j� tj| |f||| j|| d�| �� dS )a� Draw an anchored ellipse of a given size. Parameters ---------- transform : `matplotlib.transforms.Transform` The transformation object for the coordinate system in use, i.e., :attr:`matplotlib.axes.Axes.transData`. width, height : int or float Width and height of the ellipse, given in coordinates of *transform*. angle : int or float Rotation of the ellipse, in degrees, anti-clockwise. loc : int Location of this size bar. Valid location codes are:: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int or float, optional Padding around the ellipse, in fraction of the font size. Defaults to 0.1. borderpad : int or float, optional Border padding, in fraction of the font size. Defaults to 0.1. frameon : bool, optional If True, draw a box around the ellipse. Defaults to True. prop : `matplotlib.font_manager.FontProperties`, optional Font property used as a reference for paddings. **kwargs Keyworded arguments to pass to :class:`matplotlib.offsetbox.AnchoredOffsetbox`. Attributes ---------- ellipse : `matplotlib.patches.Ellipse` Ellipse patch drawn. �r r r N)r �_boxr Zellipse� add_artistr r ) r r, r r! �angler" r r r r r# r& r& r' r � s 6 ��zAnchoredEllipse.__init__)r. r. NTr- r& r& r& r' r � s �c @ s e Zd Zd dd �ZdS ) r r. � Tr �blackFNc K s� | dkr| dk} t |�| _| j�td|| | | | d�� | dkrPd|krP|�d�} | dkrbd| i}n | | d�}t|d|d �| _| r�| j| jg}n | j| jg}t|d d|d �| _t j | |f||| j| |d �|�� dS ) a� Draw a horizontal scale bar with a center-aligned label underneath. Parameters ---------- transform : `matplotlib.transforms.Transform` The transformation object for the coordinate system in use, i.e., :attr:`matplotlib.axes.Axes.transData`. size : int or float Horizontal length of the size bar, given in coordinates of *transform*. label : str Label to display. loc : int Location of this size bar. Valid location codes are:: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int or float, optional Padding around the label and size bar, in fraction of the font size. Defaults to 0.1. borderpad : int or float, optional Border padding, in fraction of the font size. Defaults to 0.1. sep : int or float, optional Separation between the label and the size bar, in points. Defaults to 2. frameon : bool, optional If True, draw a box around the horizontal bar and label. Defaults to True. size_vertical : int or float, optional Vertical length of the size bar, given in coordinates of *transform*. Defaults to 0. color : str, optional Color for the size bar and label. Defaults to black. label_top : bool, optional If True, the label will be over the size bar. Defaults to False. fontproperties : `matplotlib.font_manager.FontProperties`, optional Font properties for the label text. fill_bar : bool, optional If True and if size_vertical is nonzero, the size bar will be filled in with the color specified by the size bar. Defaults to True if `size_vertical` is greater than zero and False otherwise. **kwargs Keyworded arguments to pass to :class:`matplotlib.offsetbox.AnchoredOffsetbox`. Attributes ---------- size_bar : `matplotlib.offsetbox.AuxTransformBox` Container for the size bar. txt_label : `matplotlib.offsetbox.TextArea` Container for the label of the size bar. Notes ----- If *prop* is passed as a keyworded argument, but *fontproperties* is not, then *prop* is be assumed to be the intended *fontproperties*. Using both *prop* and *fontproperties* is not supported. Examples -------- >>> import matplotlib.pyplot as plt >>> import numpy as np >>> from mpl_toolkits.axes_grid1.anchored_artists import ( ... AnchoredSizeBar) >>> fig, ax = plt.subplots() >>> ax.imshow(np.random.random((10,10))) >>> bar = AnchoredSizeBar(ax.transData, 3, '3 data units', 4) >>> ax.add_artist(bar) >>> fig.show() Using all the optional parameters >>> import matplotlib.font_manager as fm >>> fontprops = fm.FontProperties(size=14, family='monospace') >>> bar = AnchoredSizeBar(ax.transData, 3, '3 units', 4, pad=0.5, ... sep=5, borderpad=0.5, frameon=False, ... size_vertical=0.5, color='white', ... fontproperties=fontprops) Nr r/ )ZfillZ facecolorZ edgecolorr �color)r5 �fontpropertiesF)Zminimumdescent� textprops�center)ZchildrenZalignr �sepr ) r Zsize_barr1 r �popr Z txt_labelr r0 r r )r r, �sizeZlabelr" r r r9 r Z size_verticalr5 Z label_topr6 Zfill_barr# r7 Z _box_childrenr& r& r' r � sB o � � ���zAnchoredSizeBar.__init__) r. r. r3 Tr r4 FNNr- r& r& r& r' r � s �c @ s e Zd Zdd d�Zd S )r �333333�?�{�G�z�?r3 r � r F�w�{�G�z�?N� � c K s� |dkr i }|dkri }t d|||d�}|dkrBd|krB|�d�}d|krR| |d< d|krb| |d< d|krr| |d< d|kr�| |d< |}|t�� �|� }t|�| _|}|| } td|| f||| ff|ddd �|��| _t|| df|| | ff|ddd �|��| _ | j� | j� | j� | j � t || || | f|||d �} t | fd |i|��| _ | j� | j � t || | | d | | f|||d �} t | f|�| _| j� | j� tj| |f| | | j| d �|�� dS )ar Draw two perpendicular arrows to indicate directions. Parameters ---------- transform : `matplotlib.transforms.Transform` The transformation object for the coordinate system in use, i.e., :attr:`matplotlib.axes.Axes.transAxes`. label_x, label_y : string Label text for the x and y arrows length : int or float, optional Length of the arrow, given in coordinates of *transform*. Defaults to 0.15. fontsize : int, optional Size of label strings, given in coordinates of *transform*. Defaults to 0.08. loc : int, optional Location of the direction arrows. Valid location codes are:: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 Defaults to 2. angle : int or float, optional The angle of the arrows in degrees. Defaults to 0. aspect_ratio : int or float, optional The ratio of the length of arrow_x and arrow_y. Negative numbers can be used to change the direction. Defaults to 1. pad : int or float, optional Padding around the labels and arrows, in fraction of the font size. Defaults to 0.4. borderpad : int or float, optional Border padding, in fraction of the font size. Defaults to 0.4. frameon : bool, optional If True, draw a box around the arrows and labels. Defaults to False. color : str, optional Color for the arrows and labels. Defaults to white. alpha : int or float, optional Alpha values of the arrows and labels Defaults to 1. sep_x, sep_y : int or float, optional Separation between the arrows and labels in coordinates of *transform*. Defaults to 0.01 and 0. fontproperties : `matplotlib.font_manager.FontProperties`, optional Font properties for the label text. back_length : float, optional Fraction of the arrow behind the arrow crossing. Defaults to 0.15. head_width : int or float, optional Width of arrow head, sent to ArrowStyle. Defaults to 10. head_length : int or float, optional Length of arrow head, sent to ArrowStyle. Defaults to 15. tail_width : int or float, optional Width of arrow tail, sent to ArrowStyle. Defaults to 2. text_props, arrow_props : dict Properties of the text and arrows, passed to :class:`matplotlib.text.TextPath` and `matplotlib.patches.FancyArrowPatch` **kwargs Keyworded arguments to pass to :class:`matplotlib.offsetbox.AnchoredOffsetbox`. Attributes ---------- arrow_x, arrow_y : `matplotlib.patches.FancyArrowPatch` Arrow x and y text_path_x, text_path_y : `matplotlib.text.TextPath` Path for arrow labels p_x, p_y : `matplotlib.patches.PathPatch` Patch for arrow labels box : `matplotlib.offsetbox.AuxTransformBox` Container for the arrows and labels. Notes ----- If *prop* is passed as a keyword argument, but *fontproperties* is not, then *prop* is be assumed to be the intended *fontproperties*. Using both *prop* and *fontproperties* is not supported. Examples -------- >>> import matplotlib.pyplot as plt >>> import numpy as np >>> from mpl_toolkits.axes_grid1.anchored_artists import ( ... AnchoredDirectionArrows) >>> fig, ax = plt.subplots() >>> ax.imshow(np.random.random((10,10))) >>> arrows = AnchoredDirectionArrows(ax.transAxes, '111', '110') >>> ax.add_artist(arrows) >>> fig.show() Using several of the optional parameters, creating downward pointing arrow and high contrast text labels. >>> import matplotlib.font_manager as fm >>> fontprops = fm.FontProperties(family='monospace') >>> arrows = AnchoredDirectionArrows(ax.transAxes, 'East', 'South', ... loc='lower left', color='k', ... aspect_ratio=-1, sep_x=0.02, ... sep_y=-0.01, ... text_props={'ec':'w', 'fc':'k'}, ... fontproperties=fontprops) NZSimple)� head_width� head_length� tail_widthr r5 �alphar g )� arrowstyleZshrinkAZshrinkB)r; r r, r> )r r r r )r r: r ZAffine2DZ rotate_degr Zboxr Zarrow_xZarrow_yr1 r r Zp_xZp_yr r ) r r, Zlabel_xZlabel_yZlengthZfontsizer" r2 Z aspect_ratior r r r5 rF Zsep_xZsep_yr6 Z back_lengthrC rD rE Z text_propsZ arrow_propsr# rG Zt_startZt_endZlength_xZlength_yZ text_path_xZ text_path_yr& r& r' r v s� � ��� ��� � � � ���z AnchoredDirectionArrows.__init__)r< r= r3 r r> r r Fr? r> r@ r Nr< rA rB r3 NNr- r& r& r& r' r u s( �N)Z matplotlibr r Zmatplotlib.offsetboxr r r r r Zmatplotlib.patchesr r r r r Zmatplotlib.textr �__all__r r r r r r& r& r& r' �<module> s �LHA