Rc@sNdZddlZddlmZddljZddlmZmZddl m Z ddl j Z ddl mZddljZddl mZddljZddlmZddlZdd lmZmZmZddlZddlZddl Z d Z!d efd YZ"d dZ#ddl$j%Z&e&j'j(e"dS(sZ Module containing Axes3D, an object which can plot 3D objects on a 2D matplotlib figure. iN(t itemgetter(tAxestrcParams(tcbook(tBbox(t docstring(t Triangulation(t NormalizetcolorConvertert LightSourcecCs+ttjddgddgg}|S(Nii(Rtnptarray(tbox((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt unit_bbox s'tAxes3DcBseZdZdZejZdjdZdZ dZ dZ dZ djdjdjdjdZ dZd Zd Zdjd Zdjdjd Zdjdjd ZdZdZdZdZdZdZdZdZdZeddjdZdjdjdZdjeeedZ dZ!djdjdZ"djdjee#dZ$e$Z%djdjee#dZ&e&Z'djdjee#dZ(e(Z)d Z*e+j,j-je*_e*Z-e-jd!7_d"Z.e+j,j/je._e.Z/e/jd#7_d$Z0e0Z1d%Z2d&Z3e+j,j3jd'e3_d(Z4e+j,j4jd'e4_e5j6d)Z7d*Z8e#d+Z9d,Z:d-Z;d.Z<e#d/Z=djd0Z>d1Z?d2Z@djdjd3ZAd4ZBd5d6d7ZCd8ZDd9ZEd:ZFd;ZGd<ZHd=ZId>ZJd?ZKd@ZLdjdjdAZMdBZNdCZOdDZPdEZQdFZRedGZSdHZTddjdIZUddJZVdKZWdLZXdMZYdjdjdNZZdjdOZ[e[Z\e,j[Z]dPZ^e^Z_dQZ`dRZadSZbdTZcdUZddVZedWdXZfe#dWdYdjdZZgdYdjd[Zhd\ZieiZjd]Zkd^ZlelZmdjdYd_Znd`dYdaZod`dYdbdcddZpepZqd`dYdeZrdcdfdgZsdjdhdiZte+j,jtjet_RS(ks 3D axes object. t3dc OsLdidjgtjD]}t|^qd6|dkrXddddg}ng|_|jdd|_|jdd |_|jd d}|jd d}t |_ t |_ t |_ t |_ |j|j|jd |_||_|dk r2|jj||d |_ntj|||dt||tj||jd|_d|_|dk r|j|n|jdk r|jjjd|j|_n d|_d|_|j |j!|j"j#d |j$j%j&ddg}|d|d \|_'|_(|j)j*|dS(Ns Build an :class:`Axes3D` instance in :class:`~matplotlib.figure.Figure` *fig* with *rect=[left, bottom, width, height]* in :class:`~matplotlib.figure.Figure` coordinates Optional keyword arguments: ================ ========================================= Keyword Description ================ ========================================= *azim* Azimuthal viewing angle (default -60) *elev* Elevation viewing angle (default 30) *zscale* [%(scale)s] *sharez* Other axes to share z-limits with ================ ========================================= .. versionadded :: 1.2.1 *sharez* s | tscalegg?tazimitelevitzscaletsharezitdatalimtframeonsunits finalizei(ii(ii(+tjointmscaletget_scale_namestreprtNonet_cidstpopt initial_azimt initial_elevR t xy_viewLimt zz_viewLimt xy_dataLimt zz_dataLimt view_initt_readyt_sharezt_shared_z_axest _adjustableRt__init__tTruet set_axis_offt set_axis_ontMt fmt_zdatat set_zscaletzaxist callbackstconnecttrelimt_zcidt mouse_initt set_top_viewt axesPatcht set_linewidtht transLimitstinvertedt transformt _pseudo_wt _pseudo_htfiguretadd_axes( tselftfigtrecttargstkwargstxRRt pseudo_bbox((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR)+sL7                    cCs t|_dS(N(tFalset _axis3don(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR+yscCs t|_dS(N(R*RH(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR,|scCs+|jjp*|jjp*|jjS(sN Return *True* if units are set on the *x*, *y*, or *z* axes (txaxist have_unitstyaxisR0(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRJscCs|jj|S(s For artists in an axes, if the zaxis has units support, convert *z* using zaxis unit type .. versionadded :: 1.2.1 (R0t convert_units(R@tz((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytconvert_zunitsscCstj|d|d|d||jdksL|jdksL|jdkrPdS|dk r|jjs|jj|qn|dk r|jd|jj }||jj kr|jj ||dk r|jj|qqndS(sT Look for unit *kwargs* and update the axis instances as necessary txdatatydataRDNtzunits( Rt_process_unit_infoRIRRKR0RJt update_unitsRtunitst set_units(R@RORPtzdataRDRQ((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRRs-   cCsld|j}d|j}d|j}d|j}tj|| |ddtj|| |dddS(Ngffffff?g?tauto(tdistRtset_xlimRtset_ylim(R@txdwltxdwtydwltydw((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR6s     cCstjd|jj|jj||_|j|_tjd|jj|jj||_ |j |_ tj d|j j|j j||_|j|_x*|j|j |jfD]}|jqWdS(s4Init 3D axes; overrides creation of regular X/Y axesREtyRMN(taxis3dtXAxisR t intervalxR"tw_xaxisRItYAxist intervalytw_yaxisRKtZAxisR!R#tw_zaxisR0tinit3d(R@tax((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt _init_axiss   cCs|jgtj|S(N(R0Rt get_children(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRlsc Cs|p|j\}}}}}}||||||||g||||||||g||||||||g}} } t|| | S(N(t get_w_limstzip( R@tvalstminxtmaxxtminytmaxytminztmaxztxstystzs((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt unit_cubes $&cCs=|dkr|j}n|j|}tj||}|S(N(RR-Rytproj3dt proj_points(R@RoR-txyzsttcube((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt tunit_cubes   cCs|j||}|d|df|d|df|d|df|d|df|d|df|d|df|d|df|d|df|d|df|d|df|d|df|d|dfg }|S( Niiiiiiii(R~(R@RoR-ttctedges((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt tunit_edgessc Cs|jj|t|_|j|_|j|_|j|_|j|_|j|_g|j D]}|j ||f^qb}|j dt ddt x)t|D]\}\}}||_qWg|jD]}|j ||f^q}|j dt ddt x)t|D]\}\}}||_qW|jr|j|j|jf}x|D]}|j|qfWx|D]}|j|qWntj||dS(Ntkeyitreverse(R7tdrawRGt_frameontget_projR-tvvecteyetget_axis_positiont collectionstdo_3d_projectiontsortRR*t enumeratetzordertpatchesRHRIRKR0t draw_paneR( R@trenderertcoltzlisttiRMtpatchtaxesRj((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRs0     ( (    cCs|j}|j||j}|dd|ddk}|dd|ddk}|dd|ddk}|||fS(Niiii(RmR~R-(R@RoRtxhightyhightzhigh((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRs  cKsdS(N((R@txysRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytupdate_datalimscCstj|o|jS(s 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. (Rtget_autoscale_ontget_autoscalez_on(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRscCs|jS(s 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. (t _autoscaleZon(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR$scCs!tj|||j|dS(s Set whether autoscaling is applied on plot commands accepts: [ *True* | *False* ] .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. N(Rtset_autoscale_ontset_autoscalez_on(R@tb((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR-s cCs ||_dS(s Set whether autoscaling for the z-axis is applied on plot commands accepts: [ *True* | *False* ] .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. N(t_autoscalez_on(R@R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR9s cCs4|dks|dkr'tdn||_dS(sU 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. iismargin must be in range 0 to 1N(t ValueErrort_zmargin(R@tm((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_zmarginDs c Os| r$| r$|j|j|jfS|jdt}|jdd }|jdd }|jdd }t|dkr|d}}}nQt|dkr|\}}n0t|dkr|\}}}n td |d k r|j|n|d k r|j |n|d k r8|j |n|d k }|d k }|d k } |j d|d |d |d | d S(s 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 argument specifies xmargin, ymargin and zmargin. 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. ttightRER_RMiiiis'more than three arguments were suppliedtscalextscaleytscalezN( t_xmargint_ymarginRRR*RtlenRt set_xmargint set_ymarginRtautoscale_view( R@RCtkwRtmxtmytmzRRR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytmarginsTs0$       tbothc Cs|d kr!t}t}t}nt}t}t}|d krZt||_|j}n|d krt||_|j}n|d krt||_|j}n|jd|d|d|d|d S( s 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. Therfore, '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. RERR_RMRRRRN(RER(R_R(RMR(RR*RGtboolt _autoscaleXont _autoscaleYonRR(R@tenabletaxisRRRR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt autoscales$        cCsttj|||f\}}}y8|j|j}}|dk r[|j}nWntk rrnX|jjtj||gj | |dk r|j jtj||gj | n|j dS(N( tmapR tasarraytflattenRtAttributeErrorR"tupdate_from_data_xyR tTR#R(R@tXtYtZthad_dataRER_RM((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytauto_scale_xyzs$  & )cCs|js dS|dkrd|jp^t|jdko^t|jdko^t|jdk}nt|}|_|r|jr|j j |}g|D]}|j ^q}t j j|} |jj\} } |jj} y| j| | \} } Wn5tk r:t j| | dtdd\} } nX|jdkrr| | |j} | | 8} | | 7} n|s| j| | \} } n|j| | n|r|jr|jj |}g|D]}|j ^q}t j j|} |jj\}}|jj}y|j||\}}Wn5tk rit j||dtdd\}}nX|jdkr|||j} || 8}|| 7}n|s|j||\}}n|j||n|r|jr|j j |}g|D]}|j ^q}t j j|} |j!j\}}|j"j}y|j||\}}Wn5tk rt j||dtdd\}}nX|j#dkr|||j#} || 8}|| 7}n|s|j||\}}n|j$||ndS(s 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. Nit increasingtexpanderg?(%R%Rt_tightRtimagestlinesRRRt_shared_x_axest get_siblingstdataLimt mtransformstBboxBasetunionR"RbRItget_major_locatort nonsingularRRGRt view_limitst set_xboundRt_shared_y_axesReRKRt set_yboundRR'R#R0Rt set_zbound(R@RRRRRtxsharedRjtdltbbtx0tx1txlocatortdeltatysharedty0ty1tylocatortzsharedtz0tz1tzlocator((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRsz           cCsL|j\}}|j\}}|j\}}||||||fS(sGet 3D world limits.(t get_xlim3dt get_ylim3dt get_zlim3d(R@RpRqRrRsRtRu((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRmscOsW|dkr*tj|r*|\}}n||krM|d8}|d7}n||fS(Ng?(RRtiterable(R@txmintxmaxRCRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt_determine_lims%s    c KsJd|kr|jd}nd|kr<|jd}n|r[td|jn|d krtj|r|\}}n|jd||f|d k r|j|}n|d k r|j|}n|j\}}|d kr|}n|d kr|}n||kr9t j d||fnt j ||dt \}}|jj||\}}||f|j_|d k rt||_n|r@|jjd|x|jj|D]k}||k r|j|jjdt d ||j|jkr9|jjd k r9|jjjq9qqWn||fS( sn Set 3D x limits. See :meth:`matplotlib.axes.Axes.set_xlim` for full documentation. RRsunrecognized kwargs: %sROswAttempting to set identical left==right results in singular transformations; automatically expanding. left=%s, right=%sRt xlim_changedtemitRWN(RRtkeysRRRRRtconvert_xunitstget_xlimtwarningstwarnRRRGRItlimit_range_for_scaleR RbRRR1tprocessRRRYR>tcanvast draw_idle( R@tlefttrightRRWRtold_leftt old_righttother((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_xlim3d-sH             c KsJd|kr|jd}nd|kr<|jd}n|r[td|jn|d krtj|r|\}}n|jd||f|d k r|j|}n|d k r|j|}n|j\}}|d kr|}n|d kr|}n||kr9t j d||fnt j ||dt \}}|jj||\}}||f|j_|d k rt||_n|r@|jjd|x|jj|D]k}||k r|j|jjdt d ||j|jkr9|jjd k r9|jjjq9qqWn||fS( sn Set 3D y limits. See :meth:`matplotlib.axes.Axes.set_ylim` for full documentation. tymintymaxsunrecognized kwargs: %sRPswAttempting to set identical bottom==top results in singular transformations; automatically expanding. bottom=%s, top=%sRt ylim_changedRRWN(RRRRRRRRtconvert_yunitstget_ylimRRRRRGRKRR ReRRR1RRRRZR>RR( R@tbottomttopRRWRt old_bottomtold_topR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_ylim3ddsH             c KsJd|kr|jd}nd|kr<|jd}n|r[td|jn|d krtj|r|\}}n|jd||f|d k r|j|}n|d k r|j|}n|j\}}|d kr|}n|d kr|}n||kr9t j d||fnt j ||dt \}}|jj||\}}||f|j_|d k rt||_n|r@|jjd|x|jj|D]k}||k r|j|jjdt d ||j|jkr9|jjd k r9|jjjq9qqWn||fS( sm Set 3D z limits. See :meth:`matplotlib.axes.Axes.set_ylim` for full documentation tzmintzmaxsunrecognized kwargs: %sRVswAttempting to set identical bottom==top results in singular transformations; automatically expanding. bottom=%s, top=%sRt zlim_changedRRWN(RRRRRRRRRNtget_zlimRRRRRGR0RR!RbRRR1RR'Rtset_zlimR>RR( R@RRRRWRRR R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_zlim3dsH             cCs |jjS(N(R Rb(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRssn .. versionchanged :: 1.1.0 This function now correctly refers to the 3D x-limits cCs |jjS(N(R Re(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRsso .. versionchanged :: 1.1.0 This function now correctly refers to the 3D y-limits. cCs |jjS(sGet 3D z limits.(R!Rb(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRscCs$ddjtj|jjS(Ns Return the zaxis scale string %s .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. s, (RRRR0t get_scale(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_zscalescKs7|jj|||jdtdt|jdS(NRR(RIt _set_scaleRRGt_update_transScale(R@tvalueRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_xscalessx .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. cKs7|jj|||jdtdt|jdS(NRR(RKRRRGR(R@RRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_yscalescKs7|jj|||jdtdt|jdS(s call signature:: set_zscale(value) Set the scaling of the z-axis: %(scale)s ACCEPTS: [%(scale)s] Different kwargs are accepted, depending on the scale: %(scale_docs)s .. note :: Currently, Axes3D objects only supports linear scales. Other scales may or may not work, and support for these is improving with each release. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. RRN(R0RRRGR(R@RRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR/scOs|jj||S(s 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 (R0t set_ticks(R@RCRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_zticks s cCs|jjd|S(s 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 tminor(R0t get_ticklocs(R@R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_zticks,s cCstjd|jjS(sd Get the ztick labels as a list of Text instances .. versionadded :: 1.1.0 sText zticklabel(Rt silent_listR0tget_majorticklabels(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytget_zmajorticklabels8s cCstjd|jjS(s 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 sText zticklabel(RRR0tget_minorticklabels(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytget_zminorticklabelsAs cOs|jj||S(s 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 (R0tset_ticklabels(R@RCRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytset_zticklabelsNs cCstjd|jjd|S(s 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 sText zticklabelR(RRR0tget_ticklabels(R@R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytget_zticklabelsZs cCs|jj|dS(s 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(R0t axis_date(R@ttz((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt zaxis_dategscCs |jjS(s 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 (R0t get_ticklines(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytget_zticklinesxscOsdS(sa This function is currently not implemented for 3D axes. Returns *None*. N(R(R@RCRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytclabelscCsUd|_|dkr$|j|_n ||_|dkrH|j|_n ||_dS(s{ Set the elevation and azimuth of the axes. This can be used to rotate the axes programatically. 'elev' stores the elevation angle in the z plane. 'azim' stores the azimuth angle in the x,y plane. if elev or azim are None (default), then the initial value is used which was specified in the :class:`Axes3D` constructor. i N(RXRRRRR(R@RR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR$s    cCstj|jdtj|jd}}|j\}}|j\}}|j\}}tj||||||} tj dddg} | dtj |tj ||j } | dtj |tj ||j } | dtj ||j } tj | | | f}||_ | ||_|jtj|j|_t|tjdkr~tj d}ntj d}|j |j }}tj|| |}tj||}tj|| }tj||}|S( s 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. ig?iiii(iii(iii(R tpiRRRRRRztworld_transformationR tcosRXtsinRRtmodtabstview_transformationtpersp_transformationtdot(R@trelevtrazimRRRRR R tworldMtRtxptyptzptEtVtzfronttzbacktviewMtperspMtM0R-((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRs0 )  ++  iicCsd|_|jj}|dk ru|jd|j}|jd|j}|jd|j}|||g|_n t j dt j ||_ t j ||_dS(s"Initializes mouse button callbacks to enable 3D rotation of the axes. Also optionally sets the mouse buttons for 3D rotation and zooming. ============ ======================================================= Argument Description ============ ======================================================= *rotate_btn* The integer or list of integers specifying which mouse button or buttons to use for 3D rotation of the axes. Default = 1. *zoom_btn* The integer or list of integers specifying which mouse button or buttons to use to zoom the 3D axes. Default = 3. ============ ======================================================= tmotion_notify_eventtbutton_press_eventtbutton_release_eventscAxes3D.figure.canvas is 'None', mouse rotation disabled. Set canvas then call Axes3D.mouse_init().N(Rtbutton_pressedR>Rt mpl_connectt_on_movet _button_presst_button_releaseRRRR t atleast_1dt _rotate_btnt _zoom_btn(R@t rotate_btntzoom_btntcanvtc1tc2tc3((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR5s    cCstS(s Return *True* if this axes supports the zoom box button functionality. 3D axes objects do not use the zoom box button. (RG(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytcan_zoomscCstS(s Return *True* if this axes supports the pan/zoom button functionality. 3D axes objects do not use the pan/zoom button. (RG(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytcan_panscCs|jj|jdk r|jjj|j_|jjj|j_|jj\}}|j||dtdd|jj |jjj n|jj dt |_ d|_ tj||jtddS(s Clear axes RRWtlinearis axes3d.gridN(R0tclaR&RtmajorRRRRGRRR*RRRtgridR(R@RR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRWs    cCs4x$|jD]}|jjj|q Wg|_dS(s(Disable mouse button callbacks. N(RR>Rtmpl_disconnect(R@tcid((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytdisable_mouse_rotationscCs;|j|kr7|j|_|j|j|_|_ndS(N(tinaxestbuttonRFRORPtsxtsy(R@tevent((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRI"s cCs d|_dS(N(RRF(R@Ra((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRJ'scCsNy|j|SWn6ttfk rI|jjj}||}|SXdS(s 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(R.Rt TypeErrorR0tget_major_formattertformat_data_short(R@RMtfunctval((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt format_zdata*s  cCs|jdkrdS|j|jkr9d|j|jfS||f}|j}gt|D]-\}\}}tj ||||f^q^}|j |dd} || \}}|\} } } |\} }}t j | || |}t j | |||}||}||| |||}tj ||||j\}}}|j|}|j|}|j|}d|||fS(s 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. ts!azimuth=%d deg, elevation=%d deg iisx=%s, y=%s, z=%sN(R-RRFRLRRRRRztline2d_seg_distRR thypott inv_transformt format_xdatat format_ydataRg(R@txdtydtpRRtp0tp1tldiststedgeiRRRRRRtd0td1tdtRMRER_RvRwRx((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt format_coord6s,  =  $cCs|js dS|jdkr dS|j|j}}|dkrCdS||j||j}}|j}|j}|||_|_|j|j kr|dkr|dkrdSt j |j ||d|_ t j |j ||d|_ |j|jjjn|j|jkr|j\}} } } } } d|||}| ||}| | |}| | |}|j||| ||j| || ||j| || ||j|jjjndS(sMouse 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(). Niii(RFR-RRORPR_R`R<R=RLtart3dt norm_angleRRRR>RRRMRmRR R(R@RaRER_tdxtdytwthRpRqRrRsRtRutdftdz((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRH^s:    !!   cKs1|dk r||j_n|jj|||S(s Set zlabel. See doc for :meth:`set_ylabel` for description. .. note:: Currently, *labelpad* does not have an effect on the labels. N(RR0tlabelpadtset_label_text(R@tzlabeltfontdictRRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_zlabels cCs|jj}|jS(s Get the z-label text string. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. (R0t get_labeltget_text(R@tlabel((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_zlabelscCs|jS(s\ Get whether the 3D axes panels are drawn .. versionadded :: 1.1.0 (R(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_frame_onscCst||_dS(s Set whether the 3D axes panels are drawn ACCEPTS: [ *True* | *False* ] .. versionadded :: 1.1.0 N(RR(R@R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_frame_onscCstS(s Get whether axis below is true or not. For axes3d objects, this will always be *True* .. versionadded :: 1.1.0 This function was added for completeness. (R*(R@((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_axisbelows cCs t|_dS(s0 Set whether the axis ticks and gridlines are above or below most artists For axes3d objects, this will ignore any settings and just use *True* ACCEPTS: [ *True* | *False* ] .. versionadded :: 1.1.0 This function was added for completeness. N(R*t _axisbelow(R@R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt set_axisbelows cKs+t|rt}ntj||_dS(sa 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. N(RR*tmaxest_string_to_boolt _draw_grid(R@RRD((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRYs  c Ks|jddj}|jdd}|jdd}|jddj}|dk ry|\}}||dWqttfk rtdqXn|d d krt}nW|dkrt}|d krt} qt} td n|dkr d}n tdy~|dk r|dkrI|jj j j |n|dkrn|j j j j |n|dkr|j j j j |qn|dk r|dkr|jj j j|n|dkr|j j j j|n|dkr|j j j j|qn|dk r|dkrE|jj j j|n|dkrj|j j j j|n|dkr|j j j j|qnWntk rtdnXdS(s$ 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. tstyleRht scilimitst useOffsetRRis*scilimits must be a sequence of 2 integersitscitplaintcommascomma style remains to be addeds%s is not a valid style valueRMR_REs0This method only works with the ScalarFormatter.N(Rscomma(sbothRM(sbothR_(sbothRM(sbothRE(sbothR_(sbothRM(sbothRE(sbothR_(sbothRM(RtlowerRRRbR*RGtNotImplementedErrorRIRXt formattertset_scientificRKR0tset_powerlimitst set_useOffsetR( R@RDRRRRRtntsbtcb((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytticklabel_formats\                        c Ks|d k}|d k}|d k}|rC|jjj|n|rb|jjj|n|r|jjj|n|jd|d|d|d|d S( s 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. RERR_RMRRRRN(REsboth(R_sboth(RMsboth(RIRt set_paramsRKR0R(R@RRRDt_xt_yt_z((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytlocator_params)s   cKstj||||dkr~t|}|jdd|jdd|jdd|jdd|jj|ndS( s( 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. RMRRRtlabeltopt labelbottomN(RMsboth(Rt tick_paramstdictRRR0tset_tick_params(R@RRDtzkw((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRBs  cCs,|j\}}|j||dddS(s Invert the z-axis. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. RWN(RRR(R@RR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt invert_zaxishscCs|j\}}||kS(s Returns True if the z-axis is inverted. .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. (R(R@RR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytzaxis_invertedrscCs6|j\}}||kr(||fS||fSdS(s Returns the z-axis numerical bounds where:: lowerBound < upperBound .. versionadded :: 1.1.0 This function was added, but not tested. Please report any bugs. N(R(R@RR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_zbound|s   cCs|dkr*tj|r*|\}}n|j\}}|dkrQ|}n|dkrf|}n|jr||kr|j||ddq|j||ddn;||kr|j||ddn|j||dddS(sE 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. RWN(RRRRRR(R@Rtuppert old_lowert old_upper((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRs      cKs2tj|||||}tj||||S(s 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. (RttextRyt text_2d_to_3d(R@RER_RMtstzdirRDR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRsc Os|j}|jdd}|jdd}d}t|dkrtj|drt|t|dkrt|ddkstj|ddr||}|d7}qn<t|dkrtj|dr||}|d7}ntj|s%tjt||}ntj ||||||} x'| D]} t j | d|d|qKW|j ||||| S(so Plot 2D or 3D data. ========== ================================================ Argument Description ========== ================================================ *xs*, *ys* X, y coordinates of vertices *zs* z value(s), either one for all points or one for each point. *zdir* Which direction to use as z ('x', 'y' or 'z') when plotting a 2D set. ========== ================================================ Other arguments are passed on to :func:`~matplotlib.axes.Axes.plot` RxiRRMi( thas_dataRRRRt is_scalarR tonesRtplotRyt line_2d_to_3dR( R@RvRwRCRDRRxRtargsiRtline((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRs& %- %   c, Os|j}tj|}tj|||\}}}|j\}}|jdd} |jdd} d|kr|jd} n*tjtj|jdd} d} |j dd} |jdd}|jd d}|jd d}|j d d}|jd | dk}|jd d}|rn| dk rn| dk rn|j || |} ng}| dkr|rt tj t|d| tj t|d| }tj|df}tj|df}d}ng}xtd|d| D]}xtd|d| D]}g}x!|||fD]}|||t||| df}||dt||| dt|d|| f}|t|d|| |t||| ddfddd} ||t|d|| d|fddd}!tj||| |!f}"|j|"qMWt|}tjg}#|dggtdt|D](}$||$||$dkr||$^q}%td|%D}&|j|%| dk r|j| ||n|j|&t|%| dkr1|r1dt t|%dt dt|%d}'}(})tj|%|'tj|%|(||Gsi("RR t atleast_2dtbroadcast_arraystshapeRR Rtto_rgbaRtgett_shade_colors_lightsourcetinttceiltfloattemptytxrangetmint concatenatetappendRnRtsumtcrossRytPoly3DCollectiont _shade_colorstset_facecolorstset_edgecolorst set_arraytset_climtset_normtadd_collectionR(,R@RRRRCRDRtrowstcolsRRtfcolorsRRRRRRRRtpolysttotptstv1tv2twhich_pttcolsettrstcstpstatztoptzlefttzbasetzrightRMtlastpRtps2tavgzsumti1ti2ti3tnormalstpolyc((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt plot_surfaces  $! '!H7 O  8((      cCs|g}xo|D]g}tj|dtj|d}tj|dtj|d}|jtj||q W|S(s Generate normals for polygons by using the first three points. This normal of course might not make sense for polygons with more than three points not lying in a plane. iii(R R RR(R@tpolygonsRtvertsRR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt_generate_normalsts  $$c Cstjg|D].}tj|tj|dddg^q }tj|}t||dkrtt||t ||}t j |}|dddf}d||ddtj fd|}||dddfRMR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytadd_contourf_sets  "  cOs|jdt}|jdd}|jdd}|jdd} |j} tj||||\} } } tj|| | | ||}|j||||| |j |||| |S(sI Create a 3D contour plot. ========== ================================================ Argument Description ========== ================================================ *X*, *Y*, Data values as numpy.arrays *Z* *extend3d* Whether to extend contour in 3D (default: False) *stride* Stride (step size) for extending contour *zdir* The direction to use: x, y or z (default) *offset* If specified plot a projection of the contour lines on this position in plane normal to zdir ========== ================================================ The positional and other keyword arguments are passed on to :func:`~matplotlib.axes.Axes.contour` Returns a :class:`~matplotlib.axes.Axes.contour` R=R1iRRMR>N( RRGRRRyt rotate_axesRtcontourR?R(R@RRRRCRDR=R1RR>RtjXtjYtjZR0((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRCs !cOs|jdt}|jdd}|jdd}|jdd} |j} tj||||\} } } tj|| | | ||}|j||||| |j |||| |S(sZ Create a 3D contour plot. ========== ================================================ Argument Description ========== ================================================ *X*, *Y*, Data values as numpy.arrays *Z* *extend3d* Whether to extend contour in 3D (default: False) *stride* Stride (step size) for extending contour *zdir* The direction to use: x, y or z (default) *offset* If specified plot a projection of the contour lines on this position in plane normal to zdir ========== ================================================ Other keyword arguments are passed on to :func:`~matplotlib.axes.Axes.tricontour` Returns a :class:`~matplotlib.axes.Axes.contour` .. versionadded:: 1.1.0 R=R1iRRMR>N( RRGRRRyRBRt tricontourR?R(R@RRRRCRDR=R1RR>RRDRERFR0((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRGs !c Os|jdd}|jdd}|j}tj||||\} } } tj|| | | ||} |j| |||j||||| S(s  Create a 3D contourf plot. ========== ================================================ Argument Description ========== ================================================ *X*, *Y*, Data values as numpy.arrays *Z* *zdir* The direction to use: x, y or z (default) *offset* If specified plot a projection of the filled contour on this position in plane normal to zdir ========== ================================================ The positional and keyword arguments are passed on to :func:`~matplotlib.axes.Axes.contourf` Returns a :class:`~matplotlib.axes.Axes.contourf` .. versionchanged :: 1.1.0 The *zdir* and *offset* kwargs were added. RRMR>N( RRRRyRBRtcontourfRAR( R@RRRRCRDRR>RRDRERFR0((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRHs !c Os|jdd}|jdd}|j}tj||||\} } } tj||||||} |j| |||j||||| S(s Create a 3D contourf plot. ========== ================================================ Argument Description ========== ================================================ *X*, *Y*, Data values as numpy.arrays *Z* *zdir* The direction to use: x, y or z (default) *offset* If specified plot a projection of the contour lines on this position in plane normal to zdir ========== ================================================ Other keyword arguments are passed on to :func:`~matplotlib.axes.Axes.tricontour` Returns a :class:`~matplotlib.axes.Axes.contour` .. versionadded :: 1.1.0 RRMR>N( RRRRyRBRt tricontourfRAR( R@RRRR>RRCRDRRDRERFR0((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRI s !icCstj|}t|dkr0t|}nd}t|tjkrttj|d|d||j |n|t|tj krtj |d|d||j |n>t|tj krtj |d|d||j |ntj||dS(s) 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 - LineColleciton - PatchCollection iRxRN(R RKRRttypetmcolltPolyCollectionRyR@R-tLineCollectionR<tPatchCollectiontpatch_collection_2d_to_3dRR(R@RRxRtzvalstzsortval((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR.+s iRc Os|j} tjj|}tjj|}tjj|}|j|jkrctdn|j|jkr|jdkrtj|d|j}qtdntjj|}tj|ptj |} | stj |}|j|jkrtjj|}qntj |||||\}}}}}t j |||d|d|||} tj|st} tjt||}nt} tj| d|d||jd kr|jdkr|jd n| s |j|||| n| S( s Create a scatter plot. ========== ========================================================== Argument Description ========== ========================================================== *xs*, *ys* Positions of data points. *zs* Either an array of the same length as *xs* and *ys* or a single value to place all points in the same plane. Default is 0. *zdir* Which direction to use as z ('x', 'y' or 'z') when plotting a 2D set. *s* size in points^2. It is a scalar or an array of the same length as *x* and *y*. *c* a color. *c* can be a single color format string, or a sequence of color specifications of length *N*, or a sequence of *N* numbers to be mapped to colors using the *cmap* and *norm* specified via kwargs (see below). Note that *c* should not be a single numeric RGB or RGBA sequence because that is indistinguishable from an array of values to be colormapped. *c* can be a 2-D array in which the rows are RGB or RGBA, however. ========== ========================================================== Keyword arguments are passed on to :func:`~matplotlib.axes.Axes.scatter`. Returns a :class:`~mpl_toolkits.mplot3d.art3d.Patch3DCollection` s-Arguments 'xs' and 'ys' must be of same size.iisAArgument 'zs' must be of same size as 'xs' and 'ys' or of size 1.RtcRxRg?(RR tmatravelR RttileRtis_string_liketis_sequence_of_stringsRtdelete_masked_pointsRtscatterRR*RRRGRyRORRR( R@RvRwRxRRRRRCRDRtcstrRtis_2d((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRYLs8 *'cOsV|j}tj|||||}tj|sRtjt||}ng} g} xt||D]u\} } t j | } | | j 7} | | gt| 7} t j | | |d|krn| j |dqnqnWt| dkrt| \}}n gg}}t j||| |\}}} |j||| ||S(s Add 2D bar(s). ========== ================================================ Argument Description ========== ================================================ *left* The x coordinates of the left sides of the bars. *height* The height of the bars. *zs* Z coordinate of bars, if one value is specified they will all be placed at the same z. *zdir* Which direction to use as z ('x', 'y' or 'z') when plotting a 2D set. ========== ================================================ Keyword arguments are passed onto :func:`~matplotlib.axes.Axes.bar`. Returns a :class:`~mpl_toolkits.mplot3d.art3d.Patch3DCollection` Ri(RRtbarRRR RRRnRytget_patch_vertsttolisttpatch_2d_to_3dt set_alphat juggle_axesR(R@RtheightRxRRCRDRRRtverts_zsRpRMtvsRvRw((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR\s&   !taveragec Os|j} tj|s'|g}ntj|sB|g}ntj|s]|g}ntj|sx|g}ntj|s|g}ntj|s|g}nt|dkr|t|}nt|dkr|t|}nt|dkr|t|}nt|t|ksMt|t|kr]tjdnd \} } }d \}}}g}xjt||||||D]M\}}}}}}t|| } t|||}t|| } t|||}t||}t|||}|j |||f||||f|||||f||||ff||||f|||||f||||||f|||||ff|||f||||f|||||f||||ff||||f|||||f||||||f|||||ff|||f||||f|||||f||||ff||||f|||||f||||||f|||||ffgqWg}|dkrdgt|}nt|t|krVxi|D]}|j |gdq5WnDt t j |}t|t|kr|dt|9}n|j|}|j||}tj|d|d|| | }|j||j| |f| |f||f| dS( sr Generate a 3D bar, or multiple bars. When generating multiple bars, x, y, z have to be arrays. dx, dy, dz can be arrays or scalars. *color* 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 Keyword arguments are passed onto :func:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection` is$x, y, and z must be the same length.g@xDg@xitzsortt facecolorN(g@xDg@xDg@xD(g@xg@xg@x(RRRRRRRnRRtextendRtlistRRRRRyRRR(R@RER_RMR{R|RRRfRCRDRRpRrRtRqRsRuRtxityitzitdxitdyitdziRRRRt sfacecolorsR((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pytbar3dsz"       04'$/'$/'$:     tcentercKsNtj||d|d||}|jj\}}|jjd||S(NRtlocgq= ףp?(Rt set_titlettitlet get_positiontset_y(R@RRRsRDtretRER_((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyRt; s!N(ut__name__t __module__t__doc__tnameRtGrouperR'RR)R+R,RJRNRRR6RkRlRyR~RRRRRRRRRRR*RRRRmRRGRRYR RZRRRRRRRRRRRRRRtdedent_interpdR/RRRR!R#R%R(R*R+R$RR5RTRURWR\RIRJRgRxRHRRRRRRRYRRRRRRRRttext3Dttext2DRtplot3DRRRRRR&R:R?RARCt contour3DRGRHt contourf3DRIR.RYt scatter3DR\RqRt(((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyR$s  N         &    B  U 444            /      ( 7    ? &    :    C u 0  $ & #!!I2 qg?c Csddlm}tjdd|}}tj||\}}|||dddd}|||ddd d }||}|d }|d }|d }|||fS( s6 Return a tuple X, Y, Z with a test data set. i(tbivariate_normalgg@g?gg?g?ii i(tmatplotlib.mlabRR tarangetmeshgrid( RRRER_RRtZ1tZ2R((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt get_test_dataB s    ()R{RtoperatorRtmatplotlib.axesRRRRt matplotlibRtmatplotlib.transformst transformsRRtmatplotlib.collectionsRRKRtmatplotlib.scaleRRtmatplotlib.tri.triangulationRtnumpyR tmatplotlib.colorsRRR RyRzR`R RRtmatplotlib.projectionst projectionstprojtprojection_registrytregister(((sU/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/mpl_toolkits/mplot3d/axes3d.pyt s<      '