o iN@sjddlZddlZddlmZmZmZddlmZddlm Z ddl m Z ddlmZGddde jZdS)N)cbook docstringrcParams)allow_rasterizationcseZdZdZddZejfddZe dddZ e dd d Z d d Z d dZ ddZddZfddZd6fdd ZddZddZddZddZd d!Zefd"d#Zd$d%Zd&d'Zd(d)Zd7d*d+Zd,d-Zed.d/Zed0d1Z ed2d3Z!d4d5Z"Z#S)8SpineaI An axis spine -- the line noting the data area boundaries. Spines are the lines connecting the axis tick marks and noting the boundaries of the data area. They can be placed at arbitrary positions. See `~.Spine.set_position` for more information. The default position is ``('outward', 0)``. Spines are subclasses of `.Patch`, and inherit much of their behavior. Spines draw a line, a circle, or an arc depending if `~.Spine.set_patch_line`, `~.Spine.set_patch_circle`, or `~.Spine.set_patch_arc` has been called. Line-like is the default. cCsdS)NrselfrrL/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/matplotlib/spines.py__str__sz Spine.__str__c stjd i|||_||jj||_|d|td| td| dd|_ | d| |jjd|_d|_d|_tjtjj|d||_d |_t|_dS) a Parameters ---------- axes : `~matplotlib.axes.Axes` The `~.axes.Axes` instance containing the spine. spine_type : str The spine type. path : `~matplotlib.path.Path` The `.Path` instance used to draw the spine. Other Parameters ---------------- **kwargs Valid keyword arguments are: %(Patch)s nonezaxes.edgecolorzaxes.linewidth projectingNg@F)pathliner)super__init__axes set_figurefigure spine_type set_facecolor set_edgecolorr set_linewidth set_capstyleaxis set_zorder set_transform transData_bounds _smart_bounds _positionr_check_isinstance matplotlibrPath_path _patch_type mtransformsIdentityTransform_patch_transform)r rrrkwargs __class__rr rs$   zSpine.__init__z3.2cCsB||_|jdvr|jj|n |jdvr|jj|d|_dS)z7Set the spine and associated axis to have smart bounds.leftrighttopbottomTN)rrryaxisset_smart_boundsxaxisstale)r valuerrr r3Us    zSpine.set_smart_boundscC|jS)z*Return whether the spine has smart bounds.)rrrrr get_smart_boundsaszSpine.get_smart_boundscCsTd|_||_|d|_|d|_||_||_tj|||_ | |j j d|_ dS)zSet the spine to be arc-like.arcTN)r%_center_width_height_theta1_theta2mpathr#r9r$rr transAxesr5)r centerradiustheta1theta2rrr set_patch_arcfs   zSpine.set_patch_arccCs8d|_||_|d|_|d|_||jjd|_dS)zSet the spine to be circular.circler:TN)r%r;r<r=rrrAr5)r rBrCrrr set_patch_circless    zSpine.set_patch_circlecCsd|_d|_dS)zSet the spine to be linear.rTN)r%r5rrrr set_patch_line}s zSpine.set_patch_linecCsj|jdvsJ||jd||jdf}||j}||j}t|d|dj ||_ dS)a! Notes ----- This cannot be called until after this has been added to an Axes, otherwise unit conversion will fail. This makes it very important to call the accessor method and not directly access the transformation member variable. r9rGr?N) r%convert_xunitsr;convert_yunitsr<r=r&Affine2Dscale translater()r rBwidthheightrrr _recompute_transforms    zSpine._recompute_transformcs"|jdvr ||jStS)NrJ)r%rTr(rget_patch_transformrr*rr rUs  zSpine.get_patch_transformNc s|tj|d}|jdur|S|g}|jjdg}t|jjdkr-||jjd|D]}|}|j }|j }|dkrDd} d} n |dkrMd} d} nd} d} | |d|j j } | |d|j j } |j r|jd kr||j| |_|j| |_n|jd kr|j| |_|j| |_|jr|jd kr|j| |_|j| |_n|jd kr|j| |_|j| |_||q/tj|S) a Return the window extent of the spines in display space, including padding for ticks (but not their labels) See Also -------- matplotlib.axes.Axes.get_tightbbox matplotlib.axes.Axes.get_window_extent )rendererNrrKoutinrLHr-r1r.r0)_adjust_locationrget_window_extentr majorTickslen minorTicksappendfrozen_size_tickdirrdpi tick1line get_visiblerx0x1y0y1 tick2liner&Bboxunion) r rVbbbboxes tickstochecktickbb0tickltickdirpadoutpadinr*rr r[sL                zSpine.get_window_extentcCr7N)r$rrrr get_pathszSpine.get_pathcCs$|jdurd|_||jdSdS)N)outward)r set_positionrrrr _ensure_position_is_sets zSpine._ensure_position_is_setcCs$||_|jdur |jd|_dS)z Register an axis. An axis should be registered with its corresponding spine from the Axes instance. This allows the spine to clear any axis properties when needed. NT)rclar5)r rrrr register_axiss   zSpine.register_axiscCs"d|_|jdur|jdSdS)zClear the current spine.N)r rr|rrrr r|s z Spine.clacCs|jdkrdS|jdur|jdvr|jjj\}}n|jdvr&|jjj\}}ntd|j|jrt||g\}}|jdvrJ|jj j\}}|j }n|jdvr[|jj j\}}|j }t |}t||g\}}||kro|}n||k||k@}||} t| r| d}n|}t||}||kr|}n"||k||k@}||} t| r| d}n|}t||}n|j\}}|jdkrC|jd vr ('axes', 0.5) * 'zero' -> ('data', 0.0) )rBzeror:z&position should be 'center' or 2-tupler)rxrdataz:position[0] should be one of 'outward', 'axes', or 'data' NT)r]rr rget_spine_transformr reset_ticksr5)r positionrrr rzcs     zSpine.set_positioncCs||jS)zReturn the spine position.)r{r rrrr get_positionszSpine.get_positioncCs||j}t|tr|dkrd}n|dkrd}t|dks#Jd|\}}tjgd|d|jd vr=|jj d d }n|jd vrJ|jj d d }nt d |j|dkr}|dkr\|Sddddd|j}|t |d}|tjg||jjRS|dkr|jd vrtjdddd|d|S|jdvrtjddddd||SdS|dkr|jdvr|d8}|jd vrtt|d|jj|jjS|jdvrt|jjtd||jjSdSdS)zReturn the spine transform.rB)rrLr)rrr:zposition should be 2-tuple)rrxr) position_typer,grid)whichr/zunknown spine spine_type: rxr)r~rr)rr~r)r-r.r1r0rYrrKrr)r.r0N)r{r isinstancestrr]r_check_in_listrrget_yaxis_transformget_xaxis_transformrrarrayr&ScaledTranslationrdpi_scale_transrO from_valuesblended_transform_factoryrQr)r rramountbase_transform offset_vec offset_dotsrrr rs|          zSpine.get_spine_transformcCsh|jdkr td|durt|r|\}}|pd\}}|dur$|}|dur*|}||f|_d|_dS)a Set the spine bounds. Parameters ---------- low : float or None, optional The lower spine bound. Passing *None* leaves the limit unchanged. The bounds may also be passed as the tuple (*low*, *high*) as the first positional argument. .. ACCEPTS: (low: float, high: float) high : float or None, optional The higher spine bound. Passing *None* leaves the limit unchanged. rGz5set_bounds() method incompatible with circular spinesNNNT)rrriterable get_boundsrr5)r rrold_lowold_highrrr set_boundss   zSpine.set_boundscCr7)zGet the bounds of the spine.)rrrrr rszSpine.get_boundscKs|dkr tddg}n*|dkrtddg}n|dkr$tddg}n|dkr0tddg}ntd |||||fi|}|td ||S) z#Create and return a linear `Spine`.r-)ry+?r.)?rr1)rryr0)rrz"unable to make path for spine "%s"zaxes.spines.{0})r@r#r set_visiblerformat)clsrrr)rresultrrr linear_spines zSpine.linear_spinec Ks6tj||}||||fi|} | ||||| S)z!Create and return an arc `Spine`.)r@r#r9rF) rrrrBrCrDrEr)rrrrr arc_spineszSpine.arc_spinecKs2tj}d}||||fi|}||||S)z%Create and return a circular `Spine`.rG)r@r# unit_circlerH)rrrBrCr)rrrrrr circular_spines  zSpine.circular_spinecCs||d|_dS)aL Set the edgecolor. Parameters ---------- c : color Notes ----- This method does not modify the facecolor (which defaults to "none"), unlike the `.Patch.set_color` method defined in the parent class. Use `.Patch.set_facecolor` to set the facecolor. TN)rr5)r crrr set_color s  zSpine.set_colorrvr)$__name__ __module__ __qualname____doc__r rdedent_interpdrr deprecatedr3r8rFrHrIrTrUr[rwr{r}r|rZrrrzrrrr classmethodrrrr __classcell__rrr*r r sD5     8 l ;   r)numpyrr"rrrmatplotlib.artistrmatplotlib.transforms transformsr&matplotlib.patchespatchesmpatchesmatplotlib.pathrr@Patchrrrrr s