OwlCyberSecurity - MANAGER
Edit File: axes3d.cpython-38.pyc
U ��]s� � @ s& d Z ddlmZ ddlmZ ddlZddlZddlm Z ddl m Z ddl mZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z ddl m Z m Z ddlm!Z!m"Z" ddl m#Z# dd l$m%Z% d d l&m'Z' d d l&m(Z( d d l&m)Z) dd� Z*G dd� de �Z+ddd�Z,ej-�.e+� dS )aR axes3d.py, original mplot3d version by John Porter Created: 23 Sep 2005 Parts fixed by Reinier Heeres <reinier@heeres.eu> Minor additions by Ben Axelrod <baxelrod@coroware.com> Significant updates and revisions by Ben Root <ben.v.root@gmail.com> Module containing Axes3D, an object which can plot 3D objects on a 2D matplotlib figure. � )� defaultdict)�reduceN)�artist)�Axes�rcParams)� Normalize� LightSource)�Bbox)� Triangulation� )�art3d)�proj3d)�axis3dc C s t t�ddgddgg��} | S �Nr r )r �np�array)Zbox� r �=/usr/lib/python3/dist-packages/mpl_toolkits/mplot3d/axes3d.py� unit_bbox% s r c s e Zd ZdZdZe�� Zej d�dddddd�� fdd � �Z d d � Z d d � Z dd� Z dd� Zd� fdd� Z� fdd�Zdd� Zdd� Z� fdd�Zd�d d �Zd�d d �Zd�d d!�Zej� fd"d#��Zd$d%� Zd�d'd(�Zd)d*� Z � fd+d,�Z d-d.� Z � fd/d0�Z d1d2� Z d3d4� Z!dddd5d6�d7d8�Z"d�d:d;�Z#d�d<d=�Z$d�d>d?�Z%d@dA� Z&d�dBdC�Z'd�dddD�dEdF�Z(e(Z)d�dddG�dHdI�Z*e*Z+d�dddJ�dKdL�Z,e,Z-dMdN� Z.e/j0j1je._e.Z1e1jdk �r�e1 jdO7 _dPdQ� Z2e/j0j3je2_e2Z3e3jdk �r�e3 jdR7 _dSdT� Z4e4Z5dUdV� Z6dWdX� Z7e/j0j7jdk �r0e/j0j7jdY e7_dZd[� Z8e/j0j8jdk �rXe/j0j8jdY e8_d\d]� Z9d^d_� Z:d�d`da�Z;dbdc� Z<ddde� Z=dfdg� Z>d�dhdi�Z?d�djdk�Z@dldm� ZAdndo� ZBd�dpdq�ZCdrds� ZDdtdu� ZEd�dxdy�ZFdzd{� ZGd|d}� ZH� fd~d�ZId�d�� ZJd�d�� ZKd�d�� ZLd�d�� ZMd�d�� ZNd�d�� ZOd�d�d��ZPd�d�� ZQd�d�� ZRd�d�� ZSd�d�d��ZTd�ddd9d��d�d��ZUd�d�d��ZVd� fd�d�� ZWd�d�� ZXd�d�� ZYd�d�� ZZd�d�d��Z[d�� fd�d�� Z\e\Z]e0j\Z^d�d��� fd�d�� Z_e_Z`ddddd��d�d��Zad�d�� Zbd�d�d��Zcd�d�� Zddddddd��d�d��Zed�d�d��Zfd�d�d��Zgd�d�d��Zhd&d�d�dd��� fd�d�� ZieiZjd&d�d�dd��� fd�dÄ Zkd�ddĜ� fd�dƄ ZlelZmd�ddĜ� fd�dȄ Znd�� fd�d˄ Zod�� fd�d΄ ZpepZqd�� fd�dЄ Zrd�d�dӄZsd�� fd�dք Ztdvd�d�d&dٜd�dۄZueuZvddd5ddܜd�dބZw� ZxS ( �Axes3Dz 3D axes object. Z3dNi���� �persp)�azim�elev�zscale�sharez� proj_typec s� |dkrddddg}g � _ |� _|� _� �|� t� � _t� � _t� � _t� � _� � � j� j� d� _ |� _ |dk r�� j � � |� d� _t� j||f|�ddi| �� t� �� � �� d� _d� _|dk rֈ �|� � jdk r�� jj�d� fd d ��� _nd� _d � _ � �� � �� � j � d� � j � � � d d g�} | d | d \� _!� _"� j#�$� � � j%�&� D ]} � j%| �'d� �qfdS )a Parameters ---------- fig : Figure The parent figure. rect : (float, float, float, float) The ``(left, bottom, width, height)`` axes position. azim : float, optional Azimuthal viewing angle, defaults to -60. elev : float, optional Elevation viewing angle, defaults to 30. zscale : [%(scale)s], optional The z scale. Note that currently, only a linear scale is supported. sharez : Axes3D, optional Other axes to share z-limits with. proj_type : {'persp', 'ortho'} The projection type, default 'persp'. Notes ----- .. versionadded:: 1.2.1 The *sharez* parameter. Ng g �?r ZdatalimZframeonTzunits finalizec s � j dd�S )NT)�scalez)�_on_units_changedr ��selfr r �<lambda>t � z!Axes3D.__init__.<locals>.<lambda>r )r r )r r F)(�_cids� initial_azim� initial_elev� set_proj_typer � xy_viewLim� zz_viewLim� xy_dataLim� zz_dataLim� view_init�_ready�_sharez�_shared_z_axes�joinZ _adjustable�super�__init__� set_axis_off� set_axis_on�M� fmt_zdata� set_zscale�zaxis� callbacksZconnectZ_zcid� mouse_init� set_top_view�patchZ set_linewidthZ transLimits�invertedZ transform� _pseudo_w� _pseudo_h�figureZadd_axesZspines�keysZ set_visible) r ZfigZrectr r r r r �args�kwargsZ pseudo_bbox�k�� __class__r r r1 1 sL � zAxes3D.__init__c C s d| _ d| _d S )NFT�� _axis3don�staler r r r r2 � s zAxes3D.set_axis_offc C s d| _ d| _d S )NTrF r r r r r3 � s zAxes3D.set_axis_onc C s | j �� p | j�� p | j�� S )zN Return *True* if units are set on the *x*, *y*, or *z* axes )�xaxis� have_units�yaxisr7 r r r r rJ � s �zAxes3D.have_unitsc C s | j �|�S )z� For artists in an axes, if the zaxis has units support, convert *z* using zaxis unit type .. versionadded :: 1.2.1 )r7 Z convert_units)r �zr r r �convert_zunits� s zAxes3D.convert_zunitsc s� t � j|||d� | jdks0| jdks0| jdkr4dS |dk rR| j�� sR| j�|� |dk r�|�d| jj�}|| jjkr�| j� |� |dk r�| j�|� dS )zT Look for unit *kwargs* and update the axis instances as necessary )�xdata�ydatarB N�zunits) r0 �_process_unit_inforI rK r7 rJ Z update_units�popZunitsZ set_units)r rN rO �zdatarB rP rD r r rQ � s zAxes3D._process_unit_infoc sT d| j }d| j }d| j }d| j }t� j| |d d� t� j| |d d� d S )Ngffffff�?g�������?��auto)�distr0 �set_xlim�set_ylim)r ZxdwlZxdwZydwlZydwrD r r r: � s zAxes3D.set_top_viewc C s� t �d| jj| jj| �| _t �d| jj| jj| �| _t � d| j j| j j| �| _ | j| _ | j| _| j | _| j| j| j fD ] }|�� qvdS )z4Init 3D axes; overrides creation of regular X/Y axes�x�yrL N)r ZXAxisr' � intervalxr) rI ZYAxis� intervalyrK ZZAxisr( r* r7 Zw_xaxisZw_yaxisZw_zaxisZinit3d)r Zaxr r r � _init_axis� s" � � �zAxes3D._init_axisc C s | j S )z0Return the ``ZAxis`` (`~.axis3d.Axis`) instance.)r7 r r r r � get_zaxis� s zAxes3D.get_zaxisc s t � �� | jf S �N)r0 �_get_axis_listr7 r rD r r r` � s zAxes3D._get_axis_listc C s\ |p | � � \}}}}}}|||f|||f|||f|||f|||f|||f|||f|||fgS r_ )� get_w_lims)r �vals�minx�maxx�miny�maxy�minz�maxzr r r � unit_cube� s �zAxes3D.unit_cubec C s( |d kr| j }| �|�}t�||�}|S r_ )r4 ri r Z proj_points)r rb r4 ZxyzsZtcuber r r � tunit_cube� s zAxes3D.tunit_cubec C s� | � ||�}|d |d f|d |d f|d |d f|d |d f|d |d f|d |d f|d |d f|d |d f|d |d f|d |d f|d |d f|d |d fg }|S ) Nr r � � � � � � )rj )r rb r4 �tcZedgesr r r � tunit_edges� s �zAxes3D.tunit_edgesc s* | j �� � d| _| �� }|r4|| � �}| �|� n| �� | �� | _| j� _| j� _| j� _| j � _ t dd� | � � D ��d }t t | j� fdd�dd��D ]\}}|| |_q�t t | j� fd d�dd��D ]\}}|| |_q�| j�r| � � D ]}|�� � q�| � � D ]}|�� � �qt� �� � d S ) NFc s s | ]}|� � V qd S r_ )Z get_zorder)�.0�axisr r r � <genexpr> s �z Axes3D.draw.<locals>.<genexpr>r c s | � � �S r_ �Zdo_3d_projection)�col��rendererr r r! # r" z Axes3D.draw.<locals>.<lambda>T)�key�reversec s | � � �S r_ rv )r; rx r r r! ( r" )r; �draw�_frameonZget_axes_locatorZ apply_aspect�get_projr4 �vvec�eye�get_axis_position�maxr` � enumerate�sorted� collectionsZzorder�patchesrG Z draw_paner0 ) r ry Zlocator�posZ zorder_offset�irw r; rt rD rx r r| sJ �� �� �� z Axes3D.drawc C sh | � � }| �|| j�}|d d |d d k}|d d |d d k}|d d |d d k}|||fS )Nr rk rl r )ra rj r4 )r rb rq ZxhighZyhighZzhighr r r r� 7 s zAxes3D.get_axis_positionFc C s | � � | j|||d� dS )z� Callback for processing changes to axis units. Currently forces updates of data limits and view limits. )�scalex�scaleyr N)Zrelim�autoscale_view)r r� r� r r r r r ? s zAxes3D._on_units_changedc K s d S r_ r )r ZxysrB r r r �update_datalimH s zAxes3D.update_datalimc s t � �� o| �� S )z� Get whether autoscaling is applied for all axes on plot commands .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. )r0 �get_autoscale_on�get_autoscalez_onr rD r r r� K s zAxes3D.get_autoscale_onc C s | j S )z� Get whether autoscaling for the z-axis is applied on plot commands .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. �� _autoscaleZonr r r r r� T s zAxes3D.get_autoscalez_onc s t � �|� | �|� dS )z� Set whether autoscaling is applied on plot commands .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. Parameters ---------- b : bool N)r0 �set_autoscale_on�set_autoscalez_on�r �brD r r r� ] s zAxes3D.set_autoscale_onc C s || _ dS )z� Set whether autoscaling for the z-axis is applied on plot commands .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. Parameters ---------- b : bool Nr� r� r r r r� k s zAxes3D.set_autoscalez_onc C s( |dk s|dkrt d��|| _d| _dS )aU Set padding of Z data limits prior to autoscaling. *m* times the data interval will be added to each end of that interval before it is used in autoscaling. accepts: float in range 0 to 1 .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. r r z margin must be in range 0 to 1TN)� ValueError�_zmarginrH )r �mr r r � set_zmarginx s zAxes3D.set_zmarginT)rY rZ rL �tightc G s |r&|dk r&|dk r&|dk r&t d��nBt|�dkrD|d } }}n$t|�dkr\|\}}}n |rht d��|dkr�|dkr�|dkr�|dk r�t�d|�d �� | j| j| jfS |dk r�| �|� |dk r�| �|� |dk r�| � |� | j ||dk |dk |dk d � dS ) aS Convenience method to set or retrieve autoscaling margins. signatures:: margins() returns xmargin, ymargin, zmargin :: margins(margin) margins(xmargin, ymargin, zmargin) margins(x=xmargin, y=ymargin, z=zmargin) margins(..., tight=False) All forms above set the xmargin, ymargin and zmargin parameters. All keyword parameters are optional. A single positional argument specifies xmargin, ymargin and zmargin. Passing both positional and keyword arguments for xmargin, ymargin, and/or zmargin is invalid. The *tight* parameter is passed to :meth:`autoscale_view`, which is executed after a margin is changed; the default here is *True*, on the assumption that when margins are specified, no additional padding to match tick marks is usually desired. Setting *tight* to *None* will preserve the previous setting. Specifying any margin changes only the autoscaling; for example, if *xmargin* is not None, then *xmargin* times the X data interval will be added to each end of that interval before it is used in autoscaling. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. NzECannot pass both positional and keyword arguments for x, y, and/or z.r r rl zYMust pass a single positional argument for all margins, or one for each margin (x, y, z).Tzignoring tight=z in get mode�r� r� r� r ) � TypeError�len�cbook�_warn_external�_xmargin�_ymarginr� Z set_xmarginZ set_ymarginr� r� )r rY rZ rL r� �marginsr r r r� � s0 ( �zAxes3D.margins�bothc C s� |dkrd}d}d}nT|dkr.t |� | _}nd}|dkrJt |� | _}nd}|dkrft |� | _}nd}| j||||d� dS )a� Convenience method for simple axis view autoscaling. See :meth:`matplotlib.axes.Axes.autoscale` for full explanation. Note that this function behaves the same, but for all three axes. Therefore, 'z' can be passed for *axis*, and 'both' applies to all three axes. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. NT�rY r� F�rZ r� �rL r� r� )�bool� _autoscaleXon� _autoscaleYonr� r� )r �enablert r� r� r� r r r r � autoscale� s �zAxes3D.autoscalec C sl t �|d�}t �|d�}| j�t �||g�| � |d k r`t �|d�}| j�t �||g�| � | �� d S )N���)r �reshaper) Zupdate_from_data_xy� column_stackr* r� )r �X�Y�Z�had_datar r r �auto_scale_xyz� s � �zAxes3D.auto_scale_xyzc C s� | j s dS |dkrL| jpHt| j�dkoHt| j�t| j� koDdkn }nt|� }| _|r�| jr�| j� � | j j \}}| j � � }|�||�\}}| jdkr�|| | j } || 8 }|| 7 }|s�|�||�\}}| �||� |�rf| j�rf| j� � | j j\} } | j� � } | �| | �\} } | jdk�rD| | | j } | | 8 } | | 7 } |�sZ| �| | �\} } | �| | � |�r�| j�r�| j� � | jj \} }| j� � }|�| |�\} }| j dk�r�|| | j } | | 8 } || 7 }|�s�|�| |�\} }| � | |� dS )a Autoscale the view limits using the data limits. See :meth:`matplotlib.axes.Axes.autoscale_view` for documentation. Note that this function applies to the 3D axes, and as such adds the *scalez* to the function arguments. .. versionchanged :: 1.1.0 Function signature was changed to better match the 2D version. *tight* is now explicitly a kwarg and placed first. .. versionchanged :: 1.2.1 This is now fully functional. Nr ) r, �_tightr� Zimages�linesr� r� r� �_shared_x_axesZcleanr) r[ rI �get_major_locator� nonsingularr� Z view_limitsZ set_xboundr� �_shared_y_axesr\ rK r� Z set_yboundr� r. r* r7 r� � set_zbound)r r� r� r� r r� �x0�x1Zxlocator�delta�y0�y1Zylocator�z0�z1Zzlocatorr r r r� � sX "� zAxes3D.autoscale_viewc C s4 | � � \}}| �� \}}| �� \}}||||||fS )zGet 3D world limits.)� get_xlim3d� get_ylim3d� get_zlim3d)r rc rd re rf rg rh r r r ra > s zAxes3D.get_w_limsc O s: |d krt �|�r|\}}||kr2|d8 }|d7 }||fS )N皙�����?)r �iterable)r �xmin�xmaxrA rB r r r �_determine_limsE s zAxes3D._determine_lims)r� r� c C s� |dkrt �|�r|\}}|dk rHtjddddd� |dk rDtd��|}|dk rvtjddd dd� |dk rrtd ��|}| j||fd � | �|| j�}| �|| j�}| �� \}}|dkr�|}|dkr�|}||kr�t� d |� d �� ||k} | j � � � ||�\}}| j � ||�\}}t||gt| �d�\}}||f| j_|dk �rHt|�| _|�r�| j�d| � | j�| �D ]>} | | k �rh| j| jjd|d� | j| jk�rh| jj�� �qhd| _||fS )zn Set 3D x limits. See :meth:`matplotlib.axes.Axes.set_xlim` for full documentation. N�3.0z`xmin`z`left`�argument��nameZ alternativeZobj_typez"Cannot pass both `xmin` and `left`z`xmax`z`right`z#Cannot pass both `xmax` and `right`)rN z-Attempting to set identical left == right == �> results in singular transformations; automatically expanding.)r{ Z xlim_changedF��emitrU T) r r� r� �warn_deprecatedr� rQ �_validate_converted_limitsZconvert_xunits�get_xlimr� rI r� r� �limit_range_for_scaler� r� r' r[ r� r8 �processr� � get_siblingsrW r? �canvas� draw_idlerH ) r �left�rightr� rU r� r� Zold_leftZ old_rightr{ �otherr r r � set_xlim3dM sb � � � �zAxes3D.set_xlim3d)�ymin�ymaxc C s� |dkrt �|�r|\}}|dk rHtjddddd� |dk rDtd��|}|dk rvtjddd dd� |dk rrtd ��|}| j||fd � | �|| j�}| �|| j�}| �� \}}|dkr�|}|dkr�|}||kr�t� d |� d �� ||k} | j � � � ||�\}}| j � ||�\}}| �r || }}||f| j_|dk �r@t|�| _|�r�| j�d| � | j�| �D ]>} | | k �r`| j| jjd|d� | j| jk�r`| jj�� �q`d| _||fS )zn Set 3D y limits. See :meth:`matplotlib.axes.Axes.set_ylim` for full documentation. Nr� z`ymin`�`bottom`r� r� z$Cannot pass both `ymin` and `bottom`z`ymax`�`top`z!Cannot pass both `ymax` and `top`)rO �-Attempting to set identical bottom == top == r� Z ylim_changedFr� T)r r� r� r� r� rQ r� Zconvert_yunits�get_ylimr� rK r� r� r� r' r\ r� r� r8 r� r� r� rX r? r� r� rH ) r �bottom�topr� rU r� r� � old_bottom�old_top�swappedr� r r r � set_ylim3d� sd � � � �zAxes3D.set_ylim3d)�zmin�zmaxc C s� |dkrt �|�r|\}}|dk rHtjddddd� |dk rDtd��|}|dk rvtjddd dd� |dk rrtd ��|}| j||fd � | �|| j�}| �|| j�}| �� \}}|dkr�|}|dkr�|}||kr�t� d |� d �� ||k} | j � � � ||�\}}| j � ||�\}}| �r || }}||f| j_|dk �r@t|�| _|�r�| j�d| � | j�| �D ]>} | | k �r`| j| jjd|d� | j| jk�r`| jj�� �q`d| _||fS )zm Set 3D z limits. See :meth:`matplotlib.axes.Axes.set_ylim` for full documentation Nr� z`zmin`r� r� r� z$Cannot pass both `zmin` and `bottom`z`zmax`r� z!Cannot pass both `zmax` and `top`)rS r� r� Z zlim_changedFr� T)r r� r� r� r� rQ r� rM �get_zlimr� r7 r� r� r� r( r[ r� r� r8 r� r. r� �set_zlimr? r� r� rH ) r r� r� r� rU r� r� r� r� r� r� r r r � set_zlim3d� sd � � � �zAxes3D.set_zlim3dc C s t | jj�S r_ )�tupler' r[ r r r r r� s zAxes3D.get_xlim3dzn .. versionchanged :: 1.1.0 This function now correctly refers to the 3D x-limits c C s t | jj�S r_ )r� r' r\ r r r r r� s zAxes3D.get_ylim3dzo .. versionchanged :: 1.1.0 This function now correctly refers to the 3D y-limits. c C s t | jj�S )zGet 3D z limits.)r� r( r[ r r r r r� s zAxes3D.get_zlim3dc C s dd� t�� � | j�� S )Nz3 Return the zaxis scale string %s z, )r/ �mscaleZget_scale_namesr7 � get_scaler r r r � get_zscale s �zAxes3D.get_zscalec K s* | j j|f|� | jddd� | �� d S )NF)r� r )rI � _set_scaler� �_update_transScale�r �valuerB r r r � set_xscale% s zAxes3D.set_xscalezw .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. c K s0 | j j|f|� | jddd� | �� d| _d S )NF)r� r T)rK r� r� r� rH r� r r r � set_yscale/ s zAxes3D.set_yscalec K s0 | j j|f|� | jddd� | �� d| _dS )a� Set the z-axis scale. Parameters ---------- value : {"linear", "log", "symlog", "logit", ...} The axis scale type to apply. **kwargs Different keyword arguments are accepted, depending on the scale. See the respective class keyword arguments: - `matplotlib.scale.LinearScale` - `matplotlib.scale.LogScale` - `matplotlib.scale.SymmetricalLogScale` - `matplotlib.scale.LogitScale` Notes ----- Currently, Axes3D objects only supports linear scales. Other scales may or may not work, and support for these is improving with each release. By default, Matplotlib supports the above mentioned scales. Additionally, custom scales may be registered using `matplotlib.scale.register_scale`. These scales may then also be used here as support is added. F)r� r� TN)r7 r� r� r� rH r� r r r r6 : s zAxes3D.set_zscalec O s | j j||�S )z� Set z-axis tick locations. See :meth:`matplotlib.axes.Axes.set_yticks` for more details. .. note:: Minor ticks are not supported. .. versionadded:: 1.1.0 )r7 Z set_ticks�r rA rB r r r � set_zticks\ s zAxes3D.set_zticksc C s | j j|d�S )z� Return the z ticks as a list of locations See :meth:`matplotlib.axes.Axes.get_yticks` for more details. .. note:: Minor ticks are not supported. .. versionadded:: 1.1.0 ��minor)r7 Z get_ticklocs�r r� r r r � get_zticksh s zAxes3D.get_zticksc C s t �d| j�� �S )zd Get the ztick labels as a list of Text instances .. versionadded :: 1.1.0 �Text zticklabel)r� � silent_listr7 Zget_majorticklabelsr r r r �get_zmajorticklabelst s �zAxes3D.get_zmajorticklabelsc C s t �d| j�� �S )z� Get the ztick labels as a list of Text instances .. note:: Minor ticks are not supported. This function was added only for completeness. .. versionadded :: 1.1.0 r� )r� r� r7 Zget_minorticklabelsr r r r �get_zminorticklabels} s �zAxes3D.get_zminorticklabelsc O s | j j||�S )z� Set z-axis tick labels. See :meth:`matplotlib.axes.Axes.set_yticklabels` for more details. .. note:: Minor ticks are not supported by Axes3D objects. .. versionadded:: 1.1.0 )r7 Zset_ticklabelsr� r r r �set_zticklabels� s zAxes3D.set_zticklabelsc C s t �d| jj|d��S )z� Get ztick labels as a list of Text instances. See :meth:`matplotlib.axes.Axes.get_yticklabels` for more details. .. note:: Minor ticks are not supported. .. versionadded:: 1.1.0 r� r� )r� r� r7 Zget_ticklabelsr� r r r �get_zticklabels� s �zAxes3D.get_zticklabelsc C s | j �|� dS )a� Sets up z-axis ticks and labels that treat the z data as dates. *tz* is a timezone string or :class:`tzinfo` instance. Defaults to rc value. .. note:: This function is merely provided for completeness. Axes3D objects do not officially support dates for ticks, and so this may or may not work as expected. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. N)r7 Z axis_date)r Ztzr r r � zaxis_date� s zAxes3D.zaxis_datec C s | j �� S )z� Get ztick lines as a list of Line2D instances. Note that this function is provided merely for completeness. These lines are re-calculated as the display changes. .. versionadded:: 1.1.0 )r7 Z get_ticklinesr r r r �get_zticklines� s zAxes3D.get_zticklinesc O s dS )za This function is currently not implemented for 3D axes. Returns *None*. Nr r� r r r �clabel� s z Axes3D.clabelc C s: d| _ |dkr| j| _n|| _|dkr0| j| _n|| _dS )a� Set the elevation and azimuth of the axes in degrees (not radians). This can be used to rotate the axes programmatically. 'elev' stores the elevation angle in the z plane (in degrees). 'azim' stores the azimuth angle in the x,y plane (in degrees). if elev or azim are None (default), then the initial value is used which was specified in the :class:`Axes3D` constructor. � N)rV r% r r$ r )r r r r r r r+ � s zAxes3D.view_initc C s4 |dkrt j| _n |dkr$t j| _n td| ��dS )z� Set the projection type. Parameters ---------- proj_type : str Type of projection, accepts 'persp' and 'ortho'. r Zorthozunrecognized projection: %sN)r Zpersp_transformation� _projectionZortho_transformationr� )r r r r r r& � s zAxes3D.set_proj_typec C sl t j| j d t j| j d }}| �� \}}| �� \}}| �� \}}t�||||||�} t � dddg�} | d t � |�t � |� | j } | d t � |�t � |� | j } | d t � |�| j } t � | | | f�}|| _ | | | _| jt j�| j� | _t|�t jd k�r t � d�}n t � d�}| j | j }}t�|| |�}| �||�}t �|| �}t �||�}|S )a Create the projection matrix from the current viewing position. elev stores the elevation angle in the z plane azim stores the azimuth angle in the x,y plane dist is the distance of the eye viewing point from the object point. � � �?r r rk )r r r� �r r r )r �pir r r� r� r� r Zworld_transformationr �cosrV �sinr� r �linalg�norm�absZview_transformationr �dot)r ZrelevZrazimr� r� r� r� r� r� ZworldM�RZxpZypZzp�E�VZzfrontZzbackZviewMZprojMZM0r4 r r r r~ � s6 " �"" zAxes3D.get_projr rl c C s` d| _ | jj�d| j�| jj�d| j�| jj�d| j�g| _t� |�� � | _ t� |�� � | _ dS )a� Initializes mouse button callbacks to enable 3D rotation of the axes. Also optionally sets the mouse buttons for 3D rotation and zooming. Parameters ---------- rotate_btn : int or list of int The mouse button or buttons to use for 3D rotation of the axes; defaults to 1. zoom_btn : int or list of int The mouse button or buttons to use to zoom the 3D axes; defaults to 3. NZmotion_notify_eventZbutton_press_eventZbutton_release_event) �button_pressedr? r� Z mpl_connect�_on_move� _button_press�_button_releaser# r � atleast_1d�tolist� _rotate_btn� _zoom_btn)r Z rotate_btnZzoom_btnr r r r9 s � � �� zAxes3D.mouse_initc C s dS )z� Return *True* if this axes supports the zoom box button functionality. 3D axes objects do not use the zoom box button. Fr r r r r �can_zoom; s zAxes3D.can_zoomc C s dS )z� Return *True* if this axes supports the pan/zoom button functionality. 3D axes objects do not use the pan/zoom button. Fr r r r r �can_panC s zAxes3D.can_panc s� t � �� | j�� | jdk rp| jjj| j_| jjj| j_| j�� \}}| j||ddd� | j�| jj� � � n2| j�d� z| �dd� W n t k r� Y nX d| _ d| _ | � td � dS ) z Clear axes NFr� Zlinearr r Tz axes3d.grid)r0 �clar7 r- �majorr� r� r� r� r� r� r� r� �gridr )r r� r� rD r r r K s z Axes3D.clac C s$ | j D ]}| jj�|� qg | _ dS )z(Disable mouse button callbacks. N)r# r? r� Zmpl_disconnect)r Zcidr r r �disable_mouse_rotationg s z Axes3D.disable_mouse_rotationc C s( |j | kr$|j| _|j|j | _| _d S r_ )ZinaxesZbuttonr rN rO �sx�sy�r �eventr r r r p s zAxes3D._button_pressc C s d | _ d S r_ )r r% r r r r u s zAxes3D._button_releasec C sB z | � |�W S ttfk r< | j�� j}||�}| Y S X dS )z� Return *z* string formatted. This function will use the :attr:`fmt_zdata` attribute if it is callable, else will fall back on the zaxis major formatter N)r5 �AttributeErrorr� r7 Zget_major_formatterZformat_data_short)r rL �func�valr r r � format_zdatax s zAxes3D.format_zdatac s� | j dkrdS | j| jkr*d�| j| j�S t| �� � �fdd�d�\}}|\}}}|\}} } t� |� |� �} t� |� | � �} | | } | | | | | | }t � � �|| j �\}}}| � |�}| � |�}| �|�}d|||f S )z� Given the 2D view coordinates attempt to guess a 3D coordinate. Looks for the nearest edge to the point and then assumes that the point is at the same z location as the nearest point on the edge. N� z)azimuth={:.0f} deg, elevation={:.0f} deg c s t �| d | d � �f�S r )r Z_line2d_seg_dist)Zedge��xd�ydr r r! � s �z%Axes3D.format_coord.<locals>.<lambda>)rz zx=%s, y=%s, z=%s)r4 r r �formatr r �minrr r Zhypotr Z inv_transformZ format_xdataZ format_ydatar* )r r- r. �p0�p1r� r� r� r� r� r� Zd0Zd1ZdtrL rY rZ �xs�ys�zsr r, r � format_coord� s* � � zAxes3D.format_coordc C s| | j s dS | jdkrdS |j|j }}|dkr2dS || j || j }}| j}| j}|| | _| _| j | jkr�|dkr�|dkr�dS t � | j || d �| _ t � | j || d �| _ | � � d| _| jj�� n�| j | jk�rx| �� \}} } } } } d|| | }| | | }| | | }| | | }| �|| | | � | �| | | | � | �| | | | � | � � | jj�� dS )z�Mouse moving button-1 rotates by default. Can be set explicitly in mouse_init(). button-3 zooms by default. Can be set explicitly in mouse_init(). Nr r Tr )r r4 rN rO r# r$ r= r> r r Z _norm_angler r r~ rH r? r� r� r ra r� r� r� )r r& rY rZ �dx�dy�w�hrc rd re rf rg rh Zdf�dzr r r r � s< zAxes3D._on_movec K s" |dk r|| j _| j j||f|�S )zN Set zlabel. See doc for :meth:`set_ylabel` for description. N)r7 �labelpadZset_label_text)r Zzlabel�fontdictr< rB r r r � set_zlabel� s zAxes3D.set_zlabelc C s | j �� }|�� S )z� Get the z-label text string. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. )r7 Z get_labelZget_text)r �labelr r r � get_zlabel� s zAxes3D.get_zlabelc C s | j S )z] Get whether the 3D axes panels are drawn. .. versionadded :: 1.1.0 )r} r r r r � get_frame_on� s zAxes3D.get_frame_onc C s t |�| _d| _dS )z� Set whether the 3D axes panels are drawn. .. versionadded :: 1.1.0 Parameters ---------- b : bool TN)r� r} rH r� r r r � set_frame_on� s zAxes3D.set_frame_onc K s t |�r d}|| _d| _dS )aa Set / unset 3D grid. .. note:: Currently, this function does not behave the same as :meth:`matplotlib.axes.Axes.grid`, but it is intended to eventually support that behavior. .. versionchanged :: 1.1.0 This function was changed, but not tested. Please report any bugs. TN)r� Z _draw_gridrH )r r� rB r r r r! s z Axes3D.gridr+ )�style� scilimits� useOffsetrt c C s� |� � }|� � }|dk rRz|\}}|| d W n ttfk rP td��Y nX |dd� dkrhd}n$|dkrvd}n|d kr�d}ntd ���z|dk r�|d kr�| jjj�|� |d kr�| jjj�|� |d kr�| jjj�|� |dk �r8|d k�r| jjj� |� |d k�r | jjj� |� |d k�r8| jjj� |� |dk �r�|d k�r\| jjj� |� |d k�rv| jjj� |� |d k�r�| jjj� |� W n t k �r� t d��Y nX dS )a$ Convenience method for manipulating the ScalarFormatter used by default for linear axes in Axed3D objects. See :meth:`matplotlib.axes.Axes.ticklabel_format` for full documentation. Note that this version applies to all three axes of the Axes3D object. Therefore, the *axis* argument will also accept a value of 'z' and the value of 'both' will apply to all three axes. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. Nr z*scilimits must be a sequence of 2 integersrl ZsciTZplainFr+ z %s is not a valid style value)r� rL )r� rZ )r� rY z0This method only works with the ScalarFormatter.) �lowerr� r� rI r Z formatterZset_scientificrK r7 Zset_powerlimitsZ set_useOffsetr' )r rC rD rE rt r� �nZsbr r r �ticklabel_format sR �zAxes3D.ticklabel_formatc K sp |dk}|dk}|dk}|r.| j �� jf |� |rD| j�� jf |� |rZ| j�� jf |� | j||||d� dS )a Convenience method for controlling tick locators. See :meth:`matplotlib.axes.Axes.locator_params` for full documentation. Note that this is for Axes3D objects, therefore, setting *axis* to 'both' will result in the parameters being set for all three axes. Also, *axis* can also take a value of 'z' to apply parameters to the z axis. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. r� r� r� r� N)rI r� Z set_paramsrK r7 r� )r rt r� rB Z_xZ_yZ_zr r r �locator_paramsU s zAxes3D.locator_paramsc s� t jddddg|d� |dkr.t� j|f|� |dkr|t|�}|�dd � |�d d � |�d d � |�d d � | jjf |� d S ) a( Convenience method for changing the appearance of ticks and tick labels. See :meth:`matplotlib.axes.Axes.tick_params` for more complete documentation. The only difference is that setting *axis* to 'both' will mean that the settings are applied to all three axes. Also, the *axis* parameter also accepts a value of 'z', which would mean to apply to only the z-axis. Also, because of how Axes3D objects are drawn very differently from regular 2D axes, some of these settings may have ambiguous meaning. For simplicity, the 'z' axis will accept settings as if it was like the 'y' axis. .. note:: While this function is currently implemented, the core part of the Axes3D object may ignore some of these settings. Future releases will fix this. Priority will be given to those who file bugs. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. rY rZ rL r� �rt )rY rZ r� r� r� Nr� ZlabeltopZ labelbottom)r� Z_check_in_listr0 � tick_params�dictrR r7 Zset_tick_params)r rt rB ZzkwrD r r rK n s zAxes3D.tick_paramsc C s | � � \}}| j||dd� dS )z� Invert the z-axis. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. NrT )r� r� �r r� r� r r r � invert_zaxis� s zAxes3D.invert_zaxisc C s | � � \}}||k S )z� Returns True if the z-axis is inverted. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. �r� rM r r r �zaxis_inverted� s zAxes3D.zaxis_invertedc C s( | � � \}}||k r ||fS ||fS dS )z� Returns the z-axis numerical bounds where:: lowerBound < upperBound .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. NrO rM r r r � get_zbound� s zAxes3D.get_zboundc C s� |dkrt �|�r|\}}| �� \}}|dkr2|}|dkr>|}| �� rr||k r`| j||dd� q�| j||dd� n*||k r�| j||dd� n| j||dd� dS )aE Set the lower and upper numerical bounds of the z-axis. This method will honor axes inversion regardless of parameter order. It will not change the :attr:`_autoscaleZon` attribute. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. NrT )r r� rQ rP r� )r rF �upperZ old_lowerZ old_upperr r r r� � s zAxes3D.set_zboundc s& t � j|||f|�}t�|||� |S )z� Add text to the plot. kwargs will be passed on to Axes.text, except for the `zdir` keyword, which sets the direction to be used as the z direction. )r0 �textr Z text_2d_to_3d)r rY rZ rL �s�zdirrB rS rD r r rS � s z Axes3D.textrL �rU c s� | � � }|r@t|d t�s@|d }|dd� }d|krLtd��n |�dd�}t�|t|��}t� j ||f|�|�}|D ]} t j | ||d� qvt � ||||�\}}}| � ||||� |S )a@ Plot 2D or 3D data. Parameters ---------- xs : 1D array-like x coordinates of vertices. ys : 1D array-like y coordinates of vertices. zs : scalar or 1D array-like z coordinates of vertices; either one for all points or one for each point. zdir : {'x', 'y', 'z'} When plotting 2D data, the direction to use as z ('x', 'y' or 'z'); defaults to 'z'. **kwargs Other arguments are forwarded to `matplotlib.axes.Axes.plot`. r r Nr5 z+plot() for multiple values for argument 'z'�r5 rU )�has_data� isinstance�strr� rR r � broadcast_tor� r0 �plotr Z line_2d_to_3d� juggle_axesr� ) r r3 r4 rU rA rB r� r5 r� �linerD r r r\ � s z Axes3D.plot)r �vmin�vmax� lightsourcec sF | � � } |jdkrtd��t�t�|��r4t�d� t�|||�\}}}|j \} } d| kp`d| k} d| kppd| k}| r�|r�td��| � dd �}| � dd �}| � dd �}| � dd �}t d r�|}n| }|r�t t t�| | �d ��}t t t�| | �d ��}d | k�r| � d �}n4| � dd�}|dk�r0| j�� }t�t�|��}d}| �dd�}| � d|dk�}|dk�rxtjddd� ttd| d |��| d g }ttd| d |��| d g }g }g }t|dd� |d d� �D ]�\��t|dd� |d d� �D ]Z\� �� ���fdd�|||fD �} t�| �j} |�| � |dk �r�|�|� � � �q��q�tj |f|�| �} |dk �r�|�r�| � || � |�|�}| � |� | � |� n�|�r�t�dd� |D ��} | �!| � |dk �s�|dk �r�| �"||� |dk �r(| �#|� n*|�r| � || � |�|�}n|}| � |� | �$| � | �%|||| � | S )a� Create a surface plot. By default it will be colored in shades of a solid color, but it also supports color mapping by supplying the *cmap* argument. .. note:: The *rcount* and *ccount* kwargs, which both default to 50, determine the maximum number of samples used in each direction. If the input data is larger, it will be downsampled (by slicing) to these numbers of points. Parameters ---------- X, Y, Z : 2d arrays Data values. rcount, ccount : int Maximum number of samples used in each direction. If the input data is larger, it will be downsampled (by slicing) to these numbers of points. Defaults to 50. .. versionadded:: 2.0 rstride, cstride : int Downsampling stride in each direction. These arguments are mutually exclusive with *rcount* and *ccount*. If only one of *rstride* or *cstride* is set, the other defaults to 10. 'classic' mode uses a default of ``rstride = cstride = 10`` instead of the new default of ``rcount = ccount = 50``. color : color-like Color of the surface patches. cmap : Colormap Colormap of the surface patches. facecolors : array-like of colors. Colors of each individual patch. norm : Normalize Normalization for the colormap. vmin, vmax : float Bounds for the normalization. shade : bool Whether to shade the facecolors. Defaults to True. Shading is always disabled when `cmap` is specified. lightsource : `~matplotlib.colors.LightSource` The lightsource to use when `shade` is True. **kwargs Other arguments are forwarded to `.Poly3DCollection`. rk �!Argument Z must be 2-dimensional.z>Z contains NaN values. This may result in rendering artifacts.�rstride�cstride�rcount�ccount�.Cannot specify both stride and count argumentsr �2 �_internal.classic_moder � facecolors�colorN�cmap�shadez3.1z�Passing shade=None to Axes3D.plot_surface() is deprecated since matplotlib 3.1 and will change its semantic or raise an error in matplotlib 3.3. Please use shade=False instead.)�messager r� c s. g | ]&}t �|��d �� �d �f ��qS )r )r� Z_array_perimeter)rs �a�ZcsZcs_nextZrsZrs_nextr r � <listcomp>� s �z'Axes3D.plot_surface.<locals>.<listcomp>c S s g | ]}|d d �df � � �qS )Nrk )�mean)rs �psr r r rq � s )&rX �ndimr� r �any�isnanr� r� �broadcast_arrays�shaperR r �intr� �ceil� _get_lines�get_next_colorr �mcolors�to_rgba�getr� �list�range�zip�T�appendr �Poly3DCollection� _shade_colors�_generate_normals�set_facecolorsZset_edgecolors� set_array�set_clim�set_norm�add_collectionr� ) r r� r� r� r r_ r` ra rA rB r� �rows�cols� has_stride� has_countrc rd re rf Zcompute_stridesZfcolorsrk rl rm Zrow_indsZcol_inds�colset�polysrs �polyc�avg_zr rp r � plot_surface s� = � � ""� � � zAxes3D.plot_surfacec C s: t |tj�r||jd }d|d d| d }}}|d|dd�f |d|dd�f }|d|dd�f |d|dd�f }n�t�t|�df�}t�t|�df�}t|�D ]�\}} t| �}d|d d| d }}}| |dd�f | |dd�f ||dd�f< | |dd�f | |dd�f ||dd�f< q�t�||�S )a� Takes a list of polygons and return an array of their normals. Normals point towards the viewer for a face with its vertices in counterclockwise order, following the right hand rule. Uses three points equally spaced around the polygon. This normal of course might not make sense for polygons with more than three points not lying in a plane, but it's a plausible and fast approximation. Parameters ---------- polygons: list of (M_i, 3) array_like, or (..., M, 3) array_like A sequence of polygons to compute normals for, which can have varying numbers of vertices. If the polygons all have the same number of vertices and array is passed, then the operation will be vectorized. Returns ------- normals: (..., 3) array_like A normal vector estimated for the polygon. ���r rl rk .N)rY r Zndarrayrx �emptyr� r� Zcross) r �polygonsrG �i1�i2Zi3Zv1Zv2Zpoly_irs r r r r� � s $& ,.zAxes3D._generate_normalsc s� |dkrt ddd�}tjdd��" |tjj|ddd � |j }W 5 Q R X t�|� }|�� r�td d�� td d�j �� �fd d �}d|| < t � |�}|dd�df }||�dd�tj f | }||dd�df< nt� |��� }|S )z� Shade *color* using normal vectors given by *normals*. *color* can also be an array of the same length as *normals*. N�� g �-��x3@)ZazdegZaltdeg�ignore)Zinvalidr T)rt Zkeepdimsr� �333333�?c s �� | ��S r_ r )rY �Zin_normZout_normr r r � s z"Axes3D._shade_colors.<locals>.normr rl )r r Zerrstater r � directionrv ru r Zinverser} � to_rgba_array�newaxisZ asanyarray�copy) r rk �normalsra rm �maskr �alpha�colorsr r� r r� � s$ � zAxes3D._shade_colorsc s� | � � }�jdkrtd��t�� ���\� ���j\}}d|kpFd|k} d|kpVd|k} | rh| rhtd��|�dd�} |�dd�} |�dd �} |�dd �}td r�| r�| r�tt t� || �d��nd } |r�tt t� || �d��nd } nJ| �s0| �r tt t� || �d��nd } |�r,tt t� || �d��nd } t� � �t� ��t� �� ���| �r�t t d || ��}|d k�r�|d |d k�r�||d g7 }ng }| �r�t t d || ��}|d k�r�|d |d k�r�||d g7 }ng }| d k�r�| d k�r�td ���jd k�rg }g }� fdd�|D �}�fdd�|D �}�fdd�|D �}�fdd�|D �}�fdd�|D �}�fdd�|D �}dd� t|||�D �dd� t|||�D � }tj|f|�|�}| �|� | �� ��|� |S )a� Plot a 3D wireframe. .. note:: The *rcount* and *ccount* kwargs, which both default to 50, determine the maximum number of samples used in each direction. If the input data is larger, it will be downsampled (by slicing) to these numbers of points. Parameters ---------- X, Y, Z : 2d arrays Data values. rcount, ccount : int Maximum number of samples used in each direction. If the input data is larger, it will be downsampled (by slicing) to these numbers of points. Setting a count to zero causes the data to be not sampled in the corresponding direction, producing a 3D line plot rather than a wireframe plot. Defaults to 50. .. versionadded:: 2.0 rstride, cstride : int Downsampling stride in each direction. These arguments are mutually exclusive with *rcount* and *ccount*. If only one of *rstride* or *cstride* is set, the other defaults to 1. Setting a stride to zero causes the data to be not sampled in the corresponding direction, producing a 3D line plot rather than a wireframe plot. 'classic' mode uses a default of ``rstride = cstride = 1`` instead of the new default of ``rcount = ccount = 50``. **kwargs Other arguments are forwarded to `.Line3DCollection`. rk rb rc rd re rf rg r rh ri r r� z*Either rstride or cstride must be non zeroc s g | ] }� | �qS r r �rs r� )r� r r rq m s z)Axes3D.plot_wireframe.<locals>.<listcomp>c s g | ] }� | �qS r r r� )r� r r rq n s c s g | ] }� | �qS r r r� )r� r r rq o s c s g | ] }� | �qS r r r� )�tXr r rq q s c s g | ] }� | �qS r r r� )�tYr r rq r s c s g | ] }� | �qS r r r� )�tZr r rq s s c S s" g | ]\}}}t t|||���qS r �r� r� �rs ZxlZylZzlr r r rq u s �c S s" g | ]\}}}t t|||���qS r r� r� r r r rq w s �)rX rt r� r rw rx rR r ry r� rz Z transposer� r� �sizer� r �Line3DCollectionr� r� )r r� r� r� rA rB r� r� r� r� r� rc rd re rf ZriiZciiZxlinesZylinesZzlinesZtxlinesZtylinesZtzlinesr� �linecr )r� r� r� r� r� r� r �plot_wireframe sj ( """" � �� zAxes3D.plot_wireframe)rk r r_ r` ra c O s� | � � }|dkr| j�� }t�t�|��}|�dd�} |�d| dk�} t j ||�\} }}d|krrt� |�d��} nt� |d �} |dd� }| � � } | j | }| j| }| | }tj|||fdd�}tj|f|�|�}| �r:|dd�dd�d f jdd�}|�|� |dk �s|dk �r$|�||� |dk �rh|�|� n.| �rZ| �|�}| �|||�}n|}|�|� | �|� | �| j | j| |� |S ) a� Plot a triangulated surface. The (optional) triangulation can be specified in one of two ways; either:: plot_trisurf(triangulation, ...) where triangulation is a :class:`~matplotlib.tri.Triangulation` object, or:: plot_trisurf(X, Y, ...) plot_trisurf(X, Y, triangles, ...) plot_trisurf(X, Y, triangles=triangles, ...) in which case a Triangulation object will be created. See :class:`~matplotlib.tri.Triangulation` for a explanation of these possibilities. The remaining arguments are:: plot_trisurf(..., Z) where *Z* is the array of values to contour, one per point in the triangulation. Parameters ---------- X, Y, Z : array-like Data values as 1D arrays. color Color of the surface patches. cmap A colormap for the surface patches. norm : Normalize An instance of Normalize to map values to colors. vmin, vmax : scalar, optional, default: None Minimum and maximum value to map. shade : bool Whether to shade the facecolors. Defaults to True. Shading is always disabled when *cmap* is specified. lightsource : `~matplotlib.colors.LightSource` The lightsource to use when *shade* is True. **kwargs All other arguments are passed on to :class:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection` Examples -------- .. plot:: gallery/mplot3d/trisurf3d.py .. plot:: gallery/mplot3d/trisurf3d_2.py .. versionadded:: 1.2.0 This plotting function was added for the v1.2.0 release. Nrl rm r� r r r� rJ rk )rX r{ r| r r r} r~ r rR r �get_from_args_and_kwargsZasarrayZget_masked_trianglesrY rZ �stackr r� rr r� r� r� r� r� r� r� r� )r rk r r_ r` ra rA rB r� rl rm �trirL � trianglesZxtZytZzt�vertsr� r� r� r� r r r � plot_trisurf� sB ; � zAxes3D.plot_trisurfrn c C s� |j }|j}|d |d d }t||�D �]^\}}|�� }|sBq*t�||| �} t�||| �} |�� d } g } g } t�t | d �| �}|dkr�t | d �dkr*d}nq*t | d �d |d }t t t�|��d �D ]^}t t�|| ��}t t�|d | ��}| � | d | | d | | d | | d | g� q�t� | �} | �| �} | �| | �}| �| | �}tj| ||d�}|�|� | �|� q*|D ]}| j�|� �q�dS )z4 Extend a contour in 3D by creating r r rk �rj � edgecolorsN)�levelsr� r� Z get_pathsr Z_paths_to_3d_segmentsZ get_colorr �roundr� r� ry r� r r� r� r� � set_sort_zpos�add_collection3d�remove)r �cset�strider� Zcollsr; rL r� �pathsZtopvertsZbotvertsrk Z polyvertsr� ZnstepsZstepsizer� r� r� r� Zcolors2Zpolycolrw r r r �_3d_extend_contour� sL � � zAxes3D._3d_extend_contourc C sR d| }|r| � ||� n4t|j|j�D ]$\}}|d k r<|}tj|||d� q(d S �N�-rV )r� r� r� r� r �line_collection_2d_to_3d)r r� �extend3dr� rU �offsetrL r� r r r �add_contour_set s zAxes3D.add_contour_setc C sJ d| }t |j|j�D ].\}}|d k r*|}tj|||d� |�|� qd S r� )r� r� r� r �poly_collection_2d_to_3dr� )r r� rU r� rL r� r r r �add_contourf_set) s zAxes3D.add_contourf_set)r� r� rU r� c s\ | � � } t�||||�\} } } t� j| | | f|�| �}| �|||||� | �|||| � |S )a� Create a 3D contour plot. Parameters ---------- X, Y, Z : array-likes Input data. extend3d : bool Whether to extend contour in 3D; defaults to False. stride : int Step size for extending contour. zdir : {'x', 'y', 'z'} The direction to use; defaults to 'z'. offset : scalar If specified, plot a projection of the contour lines at this position in a plane normal to zdir *args, **kwargs Other arguments are forwarded to `matplotlib.axes.Axes.contour`. Returns ------- matplotlib.contour.QuadContourSet )rX r � rotate_axesr0 �contourr� r� )r r� r� r� r� r� rU r� rA rB r� �jX�jY�jZr� rD r r r� 1 s zAxes3D.contourc s� | � � }tj||�\}}}|j} |j} d|kr:|�d�} n|d } |dd� }t�| | | |�\} } }t| | |j|j �}t � j ||f|�|�}| � |||||� | � | | | |� |S )a� Create a 3D contour plot. .. versionchanged:: 1.3.0 Added support for custom triangulations .. note:: This method currently produces incorrect output due to a longstanding bug in 3D PolyCollection rendering. Parameters ---------- X, Y, Z : array-likes Input data. extend3d : bool Whether to extend contour in 3D; defaults to False. stride : int Step size for extending contour. zdir : {'x', 'y', 'z'} The direction to use; defaults to 'z'. offset : scalar If specified, plot a projection of the contour lines at this position in a plane normal to zdir *args, **kwargs Other arguments are forwarded to `matplotlib.axes.Axes.tricontour`. Returns ------- matplotlib.tri.tricontour.TriContourSet r� r r N)rX r r� rY rZ rR r r� r� r� r0 � tricontourr� r� )r r� r� rU r� rA rB r� r� r� r� r� r� r� r� r� rD r r r� U s" � zAxes3D.tricontour)rU r� c sX | � � }t�||||�\} } } t� j| | | f|�|�} | �| ||� | �||||� | S )a� Create a 3D filled contour plot. Parameters ---------- X, Y, Z : array-likes Input data. zdir : {'x', 'y', 'z'} The direction to use; defaults to 'z'. offset : scalar If specified, plot a projection of the contour lines at this position in a plane normal to zdir *args, **kwargs Other arguments are forwarded to `matplotlib.axes.Axes.contourf`. Returns ------- matplotlib.contour.QuadContourSet Notes ----- .. versionadded:: 1.1.0 The *zdir* and *offset* parameters. )rX r r� r0 �contourfr� r� ) r r� r� r� rU r� rA rB r� r� r� r� r� rD r r r� � s zAxes3D.contourfc s� | � � }tj||�\}}}|j}|j}d|kr:|�d�} n|d } |dd� }t�||| |�\} } } t| | |j|j �}t � j || f|�|�} | � | ||� | � ||| |� | S )a� Create a 3D filled contour plot. .. note:: This method currently produces incorrect output due to a longstanding bug in 3D PolyCollection rendering. Parameters ---------- X, Y, Z : array-likes Input data. zdir : {'x', 'y', 'z'} The direction to use; defaults to 'z'. offset : scalar If specified, plot a projection of the contour lines at this position in a plane normal to zdir *args, **kwargs Other arguments are forwarded to `matplotlib.axes.Axes.tricontourf`. Returns ------- matplotlib.tri.tricontour.TriContourSet Notes ----- .. versionadded:: 1.1.0 The *zdir* and *offset* parameters. .. versionchanged:: 1.3.0 Added support for custom triangulations r� r r N)rX r r� rY rZ rR r r� r� r� r0 � tricontourfr� r� )r rU r� rA rB r� r� r� r� r� r� r� r� r� rD r r r� � s" � zAxes3D.tricontourfr c s� t �|�}|jrt �|�nd}t|�tjkrHtj|||d� |� |� nRt|�tj krrtj |||d� |� |� n(t|�tj kr�tj |||d� |� |� t� �|� dS )a) Add a 3D collection object to the plot. 2D collection types are converted to a 3D version by modifying the object and adding z coordinate information. Supported are: - PolyCollection - LineCollection - PatchCollection r rW N)r r r� r0 �type�mcollZPolyCollectionr r� r� ZLineCollectionr� ZPatchCollection�patch_collection_2d_to_3dr0 r� )r rw r5 rU ZzvalsZzsortvalrD r r r� � s � zAxes3D.add_collection3d� c s� | � � } tjdd� |||fD �� \}}}tj�|�}t�|||||�\}}}}}t� j||f|�||d�| ��} t j | |||d� | j dk r�|j dkr�| � d� | �|||| � | S )a� Create a scatter plot. Parameters ---------- xs, ys : array-like The data positions. zs : float or array-like, optional, default: 0 The z-positions. Either an array of the same length as *xs* and *ys* or a single value to place all points in the same plane. zdir : {'x', 'y', 'z', '-x', '-y', '-z'}, optional, default: 'z' The axis direction for the *zs*. This is useful when plotting 2D data on a 3D Axes. The data must be passed as *xs*, *ys*. Setting *zdir* to 'y' then plots the data to the x-z-plane. See also :doc:`/gallery/mplot3d/2dcollections3d`. s : scalar or array-like, optional, default: 20 The marker size in points**2. Either an array of the same length as *xs* and *ys* or a single value to make all markers the same size. c : color, sequence, or sequence of color, optional The marker color. Possible values: - A single color format string. - A sequence of color specifications of length n. - A sequence of n numbers to be mapped to colors using *cmap* and *norm*. - A 2-D array in which the rows are RGB or RGBA. For more details see the *c* argument of `~.axes.Axes.scatter`. depthshade : bool, optional, default: True Whether to shade the scatter markers to give the appearance of depth. **kwargs All other arguments are passed on to `~.axes.Axes.scatter`. Returns ------- paths : `~matplotlib.collections.PathCollection` c S s" g | ]}t �t j�|t j���qS r )r �ravel�ma�filled�nan)rs �tr r r rq 3 s z"Axes3D.scatter.<locals>.<listcomp>)rT �c)r5 rU � depthshader� r )rX r rw r� r� r� Zdelete_masked_pointsr0 �scatterr r� r� r� r� r� ) r r3 r4 r5 rU rT r� r� rA rB r� r� rD r r r� s ,� � zAxes3D.scatterc s� | � � }t� j||f|�|�}t�|t|��}g } g } t||�D ]T\} } t�| �} | | � � 7 } | | gt| � 7 } t� | | |� d|kr@| � |d � q@t| �dkr�t| � \}}n g g }}t� ||| |�\}}} | � ||| |� |S )a� Add 2D bar(s). Parameters ---------- left : 1D array-like The x coordinates of the left sides of the bars. height : 1D array-like The height of the bars. zs : scalar or 1D array-like Z coordinate of bars; if a single value is specified, it will be used for all bars. zdir : {'x', 'y', 'z'} When plotting 2D data, the direction to use as z ('x', 'y' or 'z'); defaults to 'z'. **kwargs Other arguments are forwarded to `matplotlib.axes.Axes.bar`. Returns ------- mpl_toolkits.mplot3d.art3d.Patch3DCollection r� r )rX r0 �barr r[ r� r� r Z_get_patch_vertsr Zpatch_2d_to_3dZ set_alphar] r� )r r� Zheightr5 rU rA rB r� r� r� Zverts_zs�prL Zvsr3 r4 rD r r r� E s$ z Axes3D.bar�averagec O s | � � } t�t�|�|||||�\}}}}}}t�|�} t�|| �}t�|�}t�|| �}t�|�}t�|| �}t�ddddddg�}t�|j|j �}d||fd||fd ||ffD ]J\}}}|d tj tj f }|d tj tj f }|||d |f |d |f< q�|� d |jd d � �}g }|d k�r8| j � � g}t |�t |�k�rh|D ]}|�|gd � �qNn0tt�|��}t |�t |�k �r�|d t |� 9 }| �r�| �|�}| �||�}n|}tj|f| �||d�| ��} | �| � | �| |f||f||f| � | S )a Generate a 3D barplot. This method creates three dimensional barplot where the width, depth, height, and color of the bars can all be uniquely set. Parameters ---------- x, y, z : array-like The coordinates of the anchor point of the bars. dx, dy, dz : scalar or array-like The width, depth, and height of the bars, respectively. color : sequence of valid color specifications, optional The color of the bars can be specified globally or individually. This parameter can be: - A single color value, to color all bars the same color. - An array of colors of length N bars, to color each bar independently. - An array of colors of length 6, to color the faces of the bars similarly. - An array of colors of length 6 * N bars, to color each face independently. When coloring the faces of the boxes specifically, this is the order of the coloring: 1. -Z (bottom of box) 2. +Z (top of box) 3. -Y 4. +Y 5. -X 6. +X zsort : str, optional The z-axis sorting scheme passed onto `~.art3d.Poly3DCollection` shade : bool, optional (default = True) When true, this shades the dark sides of the bars (relative to the plot's source of light). **kwargs Any additional keyword arguments are passed onto `~.art3d.Poly3DCollection`. Returns ------- collection : `~.art3d.Poly3DCollection` A collection of three dimensional polygons representing the bars. )�r r r �r r r �r r r �r r r )r �r r r �r r r �r r r )r� r� r� r )r� r� r� r� )r� r r� r� )r� r� r� r� r r rk .)r� Nro )�zsort� facecolor)rX r rw r r0 r� r r� rx r� r� �_get_patches_for_fillr| r� �extendr� r} r� r� r� r r� r� r� ) r rY rZ rL r7 r8 r; rk r� rm rA rB r� rc rd re rf rg rh Zcuboidr� r� r� Zdprj r� r� Z sfacecolorsrw r r r �bar3dy sj 7 � �.& ��� z Axes3D.bar3d�centerc s< t � j|f||d�|��}| j�� \}}| j�d| � |S )N)r= �locgq= ףp�?)r0 � set_title�titleZ get_positionZset_y)r r? r= r� rB ZretrY rZ rD r r r� s zAxes3D.set_titler� �tail)�length�arrow_length_ratio�pivot� normalizec s� ddd�� | � � }d}t|�|k r6td|t|�f ��|d|� } dd� | D �} tj| | �� } | d|� } | |d� } | r�ttj| ���fd d�| D �} nd d� | D �} td d � | D ��r�tj g f||d� �|�} | � | � | S t� d |g�} | | }|dk�r | |8 } n2|dk�r$| |d 8 } n|dk�r>tdt |� ��t� | dd� �}t� | d|� ��t�}tjj|dd�}|d k�|� }|�r�|� |� �d� }n|� }t|�d k�r6|tj�| |� �d d�}t� � fdd�|D ��}|dd�dd�f tj�||� }t|�ddf|_|�d d�}||�}ng }tj |f||d� �|�} | � | � | �|dd�d f |dd�df |dd�df |� | S )a� ax.quiver(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=.3, pivot='tail', normalize=False, **kwargs) Plot a 3D field of arrows. The arguments could be array-like or scalars, so long as they they can be broadcast together. The arguments can also be masked arrays. If an element in any of argument is masked, then that corresponding quiver element will not be plotted. Parameters ---------- X, Y, Z : array-like The x, y and z coordinates of the arrow locations (default is tail of arrow; see *pivot* kwarg) U, V, W : array-like The x, y and z components of the arrow vectors length : float The length of each quiver, default to 1.0, the unit is the same with the axes arrow_length_ratio : float The ratio of the arrow head with respect to the quiver, default to 0.3 pivot : {'tail', 'middle', 'tip'} The part of the arrow that is at the grid point; the arrow rotates about this point, hence the name *pivot*. Default is 'tail' normalize : bool When True, all of the arrows will be the same length. This defaults to False, where the arrows will be different lengths depending on the values of u,v,w. **kwargs Any additional keyword arguments are delegated to :class:`~matplotlib.collections.LineCollection` � c S s t j�| dd� �}|dkr8| d | }| d | }nd\}}t�|�}t�|�}t�|�}t �||d d| || d| || g|| d| ||d d| | | g| | || |gg�}|�� } | ddddgddddgf | ddddgddddgf< |� | �| � | �fS )zu To calculate the arrow head. uvw should be a unit vector. We normalize it here: Nrk r r �r r ) r r r �mathZradiansr r r r� r ) ZuvwZangler rY rZ Zrar� rT ZRposZRnegr r r � calc_arrowI s ,*� �z!Axes3D.quiver.<locals>.calc_arrowro z-Wrong number of arguments. Expected %d got %dNc S s g | ]}t |tjj�r|j�qS r )rY r r� Z MaskedArrayr� �rs rC r r r rq s s �z!Axes3D.quiver.<locals>.<listcomp>c s g | ]}t jj|� d ��� �qS )�r� )r r� r Z compressedr� r� r r rq } s �c S s g | ]}t �|��qS r )r r� r� r r r rq � s c s s | ]}t |�d kV qdS )r N)r� )rs �vr r r ru � s z Axes3D.quiver.<locals>.<genexpr>r r� Zmiddleg @ZtipzInvalid pivot argument: rl r rJ )r� r c s g | ] }� |��qS r r )rs �d)r� r r rq � s r� rk )r� )rX r� r� r rw r Z logical_orru r r� r� r rZ r� Zastype�floatr r r� ZmultiplyZouterZswapaxesrx r� )r r� r� r� r� rA rB r� ZargiZ input_argsZmasksZbcastr� Zshaft_dtZarrow_dtZXYZZUVWr ZshaftsZ head_dirsZheadsr� r )r� r� r �quiver sd - � � " 4z Axes3D.quiver)rj r� rm ra c 2 s� t |�dkrdd� }ndd� }|||�\}�}�jdkr@td��tj�jtjd�} t| d �� |dkrxt�� �\} } } n� fd d �|D �\} } } �fd d �} |dkr�| j � � }| |d �}| |d�}| � | | | � tjdddgdddgdddgdddggtjd�}t t �}dd� }|d�D �]�}|j�| �\}}}t�|�}t�|�}t�|�}|�|j�}|ddd� }|D �]4}|D �]&}|�||dg�} t| �} �| �r�|| �| | � t|dd� |dd� �D ]�\} } |�||| g�} |�||| g�}!t| �}"t|!�}#�|" �r*�|# �s*||" �|!| � n&�|" �sʈ|# �r�||# �|!| � �q�|�|||d g�}$|�|||g�}%t|$�}&�|& �rv||& �|%| � �qv�ql�qi }'|�� D �]\}(})|dk�r�|)}*n�g }*|)D ]�}+|+dd�df |+dd�df |+dd�df f},t�|+j�}-| |, |-dd�df< | |, |-dd�df< | |, |-dd�df< |*�|-� �q�||( }.||( }/|�r�| �|*�}0| �|.|0|�}.|/dk �r�| �|/|0|�}/tj|*f|.|/d�|��}1| �|1� |1|'|(< �q�|'S )a& ax.voxels([x, y, z,] /, filled, facecolors=None, edgecolors=None, **kwargs) Plot a set of filled voxels All voxels are plotted as 1x1x1 cubes on the axis, with filled[0,0,0] placed with its lower corner at the origin. Occluded faces are not plotted. .. versionadded:: 2.1 Parameters ---------- filled : 3D np.array of bool A 3d array of values, with truthy values indicating which voxels to fill x, y, z : 3D np.array, optional The coordinates of the corners of the voxels. This should broadcast to a shape one larger in every dimension than the shape of `filled`. These can be used to plot non-cubic voxels. If not specified, defaults to increasing integers along each axis, like those returned by :func:`~numpy.indices`. As indicated by the ``/`` in the function signature, these arguments can only be passed positionally. facecolors, edgecolors : array_like, optional The color to draw the faces and edges of the voxels. Can only be passed as keyword arguments. This parameter can be: - A single color value, to color all voxels the same color. This can be either a string, or a 1D rgb/rgba array - ``None``, the default, to use a single color for the faces, and the style default for the edges. - A 3D ndarray of color names, with each item the color for the corresponding voxel. The size must match the voxels. - A 4D ndarray of rgb/rgba data, with the components along the last axis. shade : bool Whether to shade the facecolors. Defaults to True. Shading is always disabled when *cmap* is specified. .. versionadded:: 3.1 lightsource : `~matplotlib.colors.LightSource` The lightsource to use when *shade* is True. .. versionadded:: 3.1 **kwargs Additional keyword arguments to pass onto :func:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection` Returns ------- faces : dict A dictionary indexed by coordinate, where ``faces[i,j,k]`` is a `Poly3DCollection` of the faces drawn for the voxel ``filled[i,j,k]``. If no faces were drawn for a given voxel, either because it was not asked to be drawn, or it is fully occluded, then ``(i,j,k) not in faces``. Examples -------- .. plot:: gallery/mplot3d/voxels.py .. plot:: gallery/mplot3d/voxels_rgb.py .. plot:: gallery/mplot3d/voxels_torus.py .. plot:: gallery/mplot3d/voxels_numpy_logo.py rl c [ s | ||f||fS r_ r )Z _Axes3D__xZ _Axes3D__yZ _Axes3D__zr� rB r r r �voxels s z Axes3D.voxels.<locals>.voxelsc [ s d | |fS r_ r )r� rB r r r r s z%Argument filled must be 3-dimensional�Zdtyper Nc 3 s | ]}t �|� �V qd S r_ )r r[ )rs r� )� coord_shaper r ru s z Axes3D.voxels.<locals>.<genexpr>c sp t �| �dkr&t �| � jt �| � �S t �| �dkr^t �| �d d� � jkrZtd�|���| S td�|���d S )Nr� )rl rm rl z8When multidimensional, {} must match the shape of filledzInvalid {} argument)r rt r[ rx r� r/ )rk r� )r� r r �_broadcast_color_arg s ��z+Axes3D.voxels.<locals>._broadcast_color_argrj r� r c s s8 t j| t jd�}t| �D ]}|V t j|ddd�}qdS )z)Generator of cyclic permutation matrices.r r r rJ N)r r� �intpr� Zroll)rG Zmatr� r r r �permutation_matrices@ s z+Axes3D.voxels.<locals>.permutation_matricesr� rk r� )r� rt r� r r rx r r� �indicesr� r| r� r r� r� r �aranger� r� �itemsr� r� r� r r� r� )2r rj r� rm ra rA rB r Zxyzr� rY rZ rL r ZsquareZ voxel_facesr ZpermuteZpcZqcZrcZpindsZqindsZrindsZsquare_rot_posZsquare_rot_negr� �qr1 Zi0Zr1Zr2r2 Zp2r� r� ZpkZpk2Zikr� ZcoordZ faces_indsZfacesZ face_indsZindZfacer� Z edgecolorr� Zpolyr )r r� r r � s� N �� " . ��� z Axes3D.voxels)N)NNNN)N)NN)NN)FFF)Tr� N)NN)NTTT)NN)NNTF)NNTF)NNTF)F)F)N)NN)r rl )NN)T)r� N)r� )NN)N)N)rn )Frn rL N)rL N)r rL )r rL r� NT)r rL )Nr� T)Nr� )y�__name__� __module__� __qualname__�__doc__r� r� ZGrouperr. � docstringZdedent_interpdr1 r2 r3 rJ rM rQ r: r] r^ r` ri rj rr r Zallow_rasterizationr| r� r r� r� r� r� r� r� r� r� r� r� ra r� r� rW r� rX r� r� r� �maxesr r� r� r� r� r� r� r� r� r6 r� r� r� r r r r r r r+ r& r~ r9 r r r r" r r r* r6 r r> r@ rA rB r! rH rI rK rN rP rQ r� rS Ztext3DZtext2Dr\ Zplot3Dr� r� r� r� r� r� r� r� r� Z contour3Dr� r� Z contourf3Dr� r� r� Z scatter3Dr� r� r� r� Zquiver3Dr � __classcell__r r rD r r * s\ � �V � 2 D � D � : � ; � ; " / #8 � 9 ( + � *, $x� k 4 � �" �6"6 ?4 � � �r r� c C s� t �dd| � }}t �||�\}}t �|d |d d �dt j }t �|d d d |d d d d �dt j d d }|| }|d }|d }|d }|||fS ) z6 Return a tuple X, Y, Z with a test data set. g �g @rk r g �?r r i� )r r ZmeshgridZexpr )r� rY rZ r� r� ZZ1ZZ2r� r r r � get_test_data� s &*�r )r� )/r r� r � functoolsr r� Znumpyr Z matplotlibr Zmatplotlib.axesZaxesr Zmatplotlib.cbookr� Zmatplotlib.collectionsr� Zmatplotlib.colorsr� r} Zmatplotlib.docstringr Zmatplotlib.projectionsZ projectionsZprojZmatplotlib.scaleZscaler� Zmatplotlib.transformsZ transformsZ mtransformsr r r r r Z matplotlib.tri.triangulationr r+ r r r r r r Zprojection_registry�registerr r r r �<module> s^