l0j dZddlZddlmZmZddlZddlZddl m Z m Z ddl m Z ddlmZmZddlmZmZed \ ZZZZZZZZZZZZ e ej!d Z"Gd d Z#dS) a Functions to handle markers; used by the marker functionality of `~matplotlib.axes.Axes.plot`, `~matplotlib.axes.Axes.scatter`, and `~matplotlib.axes.Axes.errorbar`. All possible markers are defined here: ============================== ====== ========================================= marker symbol description ============================== ====== ========================================= ``"."`` |m00| point ``","`` |m01| pixel ``"o"`` |m02| circle ``"v"`` |m03| triangle_down ``"^"`` |m04| triangle_up ``"<"`` |m05| triangle_left ``">"`` |m06| triangle_right ``"1"`` |m07| tri_down ``"2"`` |m08| tri_up ``"3"`` |m09| tri_left ``"4"`` |m10| tri_right ``"8"`` |m11| octagon ``"s"`` |m12| square ``"p"`` |m13| pentagon ``"P"`` |m23| plus (filled) ``"*"`` |m14| star ``"h"`` |m15| hexagon1 ``"H"`` |m16| hexagon2 ``"+"`` |m17| plus ``"x"`` |m18| x ``"X"`` |m24| x (filled) ``"D"`` |m19| diamond ``"d"`` |m20| thin_diamond ``"|"`` |m21| vline ``"_"`` |m22| hline ``0`` (``TICKLEFT``) |m25| tickleft ``1`` (``TICKRIGHT``) |m26| tickright ``2`` (``TICKUP``) |m27| tickup ``3`` (``TICKDOWN``) |m28| tickdown ``4`` (``CARETLEFT``) |m29| caretleft ``5`` (``CARETRIGHT``) |m30| caretright ``6`` (``CARETUP``) |m31| caretup ``7`` (``CARETDOWN``) |m32| caretdown ``8`` (``CARETLEFTBASE``) |m33| caretleft (centered at base) ``9`` (``CARETRIGHTBASE``) |m34| caretright (centered at base) ``10`` (``CARETUPBASE``) |m35| caretup (centered at base) ``11`` (``CARETDOWNBASE``) |m36| caretdown (centered at base) ``"none"`` or ``"None"`` nothing ``" "`` or ``""`` nothing ``"$...$"`` |m37| Render the string using mathtext. E.g ``"$f$"`` for marker showing the letter ``f``. ``verts`` A list of (x, y) pairs used for Path vertices. The center of the marker is located at (0, 0) and the size is normalized, such that the created path is encapsulated inside the unit cell. ``path`` A `~matplotlib.path.Path` instance. ``(numsides, 0, angle)`` A regular polygon with ``numsides`` sides, rotated by ``angle``. ``(numsides, 1, angle)`` A star-like symbol with ``numsides`` sides, rotated by ``angle``. ``(numsides, 2, angle)`` An asterisk with ``numsides`` sides, rotated by ``angle``. ============================== ====== ========================================= Note that special symbols can be defined via the :ref:`STIX math font `, e.g. ``"$\u266B$"``. For an overview over the STIX font symbols refer to the `STIX font table `_. Also see the :doc:`/gallery/text_labels_and_annotations/stix_fonts_demo`. Integer numbers from ``0`` to ``11`` create lines and triangles. Those are equally accessible via capitalized variables, like ``CARETDOWNBASE``. Hence the following are equivalent:: plt.plot([1, 2, 3], marker=11) plt.plot([1, 2, 3], marker=matplotlib.markers.CARETDOWNBASE) Markers join and cap styles can be customized by creating a new instance of MarkerStyle. A MarkerStyle can also have a custom `~matplotlib.transforms.Transform` allowing it to be arbitrarily rotated or offset. Examples showing the use of markers: * :doc:`/gallery/lines_bars_and_markers/marker_reference` * :doc:`/gallery/lines_bars_and_markers/scatter_star_poly` * :doc:`/gallery/lines_bars_and_markers/multivariate_marker_plot` .. |m00| image:: /_static/markers/m00.png .. |m01| image:: /_static/markers/m01.png .. |m02| image:: /_static/markers/m02.png .. |m03| image:: /_static/markers/m03.png .. |m04| image:: /_static/markers/m04.png .. |m05| image:: /_static/markers/m05.png .. |m06| image:: /_static/markers/m06.png .. |m07| image:: /_static/markers/m07.png .. |m08| image:: /_static/markers/m08.png .. |m09| image:: /_static/markers/m09.png .. |m10| image:: /_static/markers/m10.png .. |m11| image:: /_static/markers/m11.png .. |m12| image:: /_static/markers/m12.png .. |m13| image:: /_static/markers/m13.png .. |m14| image:: /_static/markers/m14.png .. |m15| image:: /_static/markers/m15.png .. |m16| image:: /_static/markers/m16.png .. |m17| image:: /_static/markers/m17.png .. |m18| image:: /_static/markers/m18.png .. |m19| image:: /_static/markers/m19.png .. |m20| image:: /_static/markers/m20.png .. |m21| image:: /_static/markers/m21.png .. |m22| image:: /_static/markers/m22.png .. |m23| image:: /_static/markers/m23.png .. |m24| image:: /_static/markers/m24.png .. |m25| image:: /_static/markers/m25.png .. |m26| image:: /_static/markers/m26.png .. |m27| image:: /_static/markers/m27.png .. |m28| image:: /_static/markers/m28.png .. |m29| image:: /_static/markers/m29.png .. |m30| image:: /_static/markers/m30.png .. |m31| image:: /_static/markers/m31.png .. |m32| image:: /_static/markers/m32.png .. |m33| image:: /_static/markers/m33.png .. |m34| image:: /_static/markers/m34.png .. |m35| image:: /_static/markers/m35.png .. |m36| image:: /_static/markers/m36.png .. |m37| image:: /_static/markers/m37.png N)HashableSized)_apicbook)Path)IdentityTransformAffine2D) JoinStyleCapStyle )rceZdZdZidddddddd d d d d ddddddddddddddddddd d!d"d#id$d%d&d&d'd(d)d*d+d,d-d.d/d0d1d2ed3ed4ed5ed6ed7e d8e d9e d:e d;e dd?d@dAd@dBd@dCd@iZdDZdEZdFZ ddHZdIZdJZdKZdLZdMZdNZdOZdPZdQZdRZdSZdTZ dUZ!dVZ"dWZ#dXZ$dGdGdYdZZ%dd[Z&d\Z'd]Z(d^Z)d_Z*d`Z+daZ,dbZ-dddZ.deZ/dfZ0e1j2dgdhgdidigdhdiggZ3e1j2dgdhgdjdkgdldkggZ4e1j2djdkgdldkgdhdigdidiggZ5e1j2dgdhgdgdigdidiggZ6e1j2dgdhgdgdigdhdiggZ7dmZ8dnZ9doZ:dpZ;dqZdtZ?duZ@dvZAdwZBdxZCdyZDe1dzd{gdzdcggZEd|ZFd}ZGe1dzdzgdcdzggZHd~ZIdZJe1ddzgddcggZKdZLdZMe1dzdzgdzd{gdzdzgddgdzdzgddgge1jNe1jOe1jNe1jOe1jNe1jOgZPdZQdZRdZSdZTe1d{dgdzdzgdcdggZUdZVdZWdZXdZYe1d{dzgdzdgdcdgggZZdZ[dZ\dZ]dZ^e1d{dzgdcdzgdzd{gdzdcgge1jNe1jOe1jNe1jOgZ_dZ`e1d{d{gdcdcgd{dcgdcd{gge1jNe1jOe1jNe1jOgZadZbe1j2ecjdgddz Zee1j2ecjdgddz ZfdZge1j2ecjdgddz Zhe1j2ecjdgddz ZidZjdGS) MarkerStyleag A class representing marker types. Instances are immutable. If you need to change anything, create a new instance. Attributes ---------- markers : dict All known markers. filled_markers : tuple All known filled markers. This is a subset of *markers*. fillstyles : tuple The supported fillstyles. .point,pixelocirclev triangle_down^ triangle_up< triangle_left>triangle_right1tri_down2tri_up3tri_left4 tri_right8octagonssquareppentagon*starhhexagon1Hhexagon2+plusxDdiamondd thin_diamond|vline_hlineP plus_filledXx_filledtickleft tickrighttickuptickdown caretleft caretrightcaretup caretdown caretleftbasecaretrightbase caretupbase caretdownbaseNonenothingnone )rrrrrrr'r)r+r-r/r1r6r8r>r@)fullleftrightbottomtoprP)rTrUrVrWNcd|_||_|t|nd|_|t |nd|_||||dS)a] Parameters ---------- marker : str, array-like, Path, MarkerStyle - Another instance of `MarkerStyle` copies the details of that *marker*. - For other possible marker values, see the module docstring `matplotlib.markers`. fillstyle : str, default: :rc:`markers.fillstyle` One of 'full', 'left', 'right', 'bottom', 'top', 'none'. transform : `~matplotlib.transforms.Transform`, optional Transform that will be combined with the native transform of the marker. capstyle : `.CapStyle` or %(CapStyle)s, optional Cap style that will override the default cap style of the marker. joinstyle : `.JoinStyle` or %(JoinStyle)s, optional Join style that will override the default join style of the marker. N)_marker_function_user_transformr _user_capstyler _user_joinstyle_set_fillstyle _set_marker)selfmarker fillstyle transformcapstyle joinstyles U/home/wildlama/miniconda3/envs/lam/lib/python3.11/site-packages/matplotlib/markers.py__init__zMarkerStyle.__init__sw.!%(4<4Hhx000d7@7Ly333RV I&&&      c|jdSt|_t|_d|_d|_d|_tj |_ |j p tj |_|jdk|_|dS)NrP)rY _empty_path_pathr _transform _alt_path_alt_transform_snap_thresholdr round _joinstyler[r butt _capstyle _fillstyle_filledr_s re_recachezMarkerStyle._recaches}  ( F  +--"##/,= &0  rgcNtt|jjSN)boollenrjverticesrus re__bool__zMarkerStyle.__bool__ sC +,,---rgc|jSrxrtrus re is_filledzMarkerStyle.is_filled  |rgc|jSrx)rsrus re get_fillstylezMarkerStyle.get_fillstyles rgcttj|d}tj|j|||_dS)z Set the fillstyle. Parameters ---------- fillstyle : {'full', 'left', 'right', 'bottom', 'top', 'none'} The part of the marker surface that is colored with markerfacecolor. zmarkers.fillstyle)raN)mpl _val_or_rcr check_in_list fillstylesrs)r_ras rer]zMarkerStyle._set_fillstyles9N9.ABB  4?i@@@@#rgc|jjSrx)rpnamerus re get_joinstylezMarkerStyle.get_joinstyle!s ##rgc|jjSrx)rrrrus re get_capstylezMarkerStyle.get_capstyle$s ~""rgc|jSrx)_markerrus re get_markerzMarkerStyle.get_marker'rrgct|tr"tj|r|j|_n[t|t r.||jvr%t|d|j|z|_nt|tj r)|j dkr|j ddkr |j |_nt|tr |j|_nt|t r(t#|dvr|ddvr |j|_nvt|t&rt)j|j|_nB t||j |_n%#t.$r}t/d||d}~wwxYwt|t&s||_|dSdS)a= Set the marker. Parameters ---------- marker : str, array-like, Path, MarkerStyle - Another instance of `MarkerStyle` copies the details of that *marker*. - For other possible marker values see the module docstring `matplotlib.markers`. _set_rr)r)rrrzUnrecognized marker style N) isinstancestrr is_math_text_set_mathtext_pathrYrmarkersgetattrnpndarrayndimshape _set_verticesr_set_path_markerrrz_set_tuple_markerrcopydeepcopy__dict__ ValueErrorrrv)r_r`errs rer^zMarkerStyle._set_marker*s fc " " Fu'9&'A'A F$($;D ! !  ) ) Ff .D.D$+D'DL>FFHH Hrgc|jSrx)rnrus reget_snap_thresholdzMarkerStyle.get_snap_thresholdus ##rgcF|j|jSdS)z.Return user supplied part of marker transform.N)rZrrus reget_user_transformzMarkerStyle.get_user_transformxs(   +'..00 0 , +rgcbt|}|j|xj|z c_n||_|S)z Return a new version of this marker with the transform applied. Parameters ---------- transform : `~matplotlib.transforms.Affine2D` Transform will be combined with current user supplied transform. )rrZ)r_rb new_markers re transformedzMarkerStyle.transformed}s?!&&  % 1  & &) 3 & & &)2J &rg)degradc||td||tdt|}|jt|_||j|||j||S)aB Return a new version of this marker rotated by specified angle. Parameters ---------- deg : float, optional Rotation angle in degrees. rad : float, optional Rotation angle in radians. .. note:: You must specify exactly one of deg or rad. NzOne of deg or rad is requiredz'Only one of deg and rad can be supplied)rrrZr rotate_degrotate)r_rrrs rerotatedzMarkerStyle.rotateds ;3;<== = ?sFGG G &&  % -)1J & ?  & 1 1# 6 6 6 ?  & - -c 2 2 2rgc||}t|}|jp t}||||_|S)aW Return new marker scaled by specified scale factors. If *sy* is not given, the same scale is applied in both the *x*- and *y*-directions. Parameters ---------- sx : float *X*-direction scaling factor. sy : float, optional *Y*-direction scaling factor. )rrZr scale)r_sxsyrrks rescaledzMarkerStyle.scaledsJ :B && /=8:: %/%5%5b"%=%= "rgcd|_dS)NFr~rus re _set_nothingzMarkerStyle._set_nothings  rgctjtj|j}t d|z |_||_dS)N?)rmaxabsr{r rrkrj)r_pathrescales re_set_custom_markerzMarkerStyle._set_custom_markersE& ..//"****3=99 rgc:||jdSrx)rrrus rerzMarkerStyle._set_path_markers  -----rgcT|t|jdSrx)rrrrus rerzMarkerStyle._set_verticess& T\ 2 233333rgc|j}t|dkr |dd}}n#t|dkr|d|d}}|d}|dkr2tj||_|jp t j|_n|dkr2tj ||_|jp t j |_nQ|dkr9tj ||_d|_ |jp t j |_ntd|td||_dS) NrrrrFzUnexpected tuple marker: r)rrzrunit_regular_polygonrjr\r miterrpunit_regular_starbevelunit_regular_asteriskrtrr rrrk)r_r`numsidesrotationsymstyles rerzMarkerStyle._set_tuple_markers' v;;!  !'ChHH [[A  !'F1IhH!9 q==28<??DJ!Aq6Aq6Aq6Aq6"BCCDN##%%B SCHHLF O & &v . . ."&/D .A)/rgcd||jdddS)Nrr)rrkrrus re_set_thin_diamondzMarkerStyle._set_thin_diamondms2  c3'''''rgctd|_d|_t jd}|s||_n|j}dtj dzdz }t |gd}t |gd}t |d|d|d d| g|dg}t |d|d |d d| g|dg}||f||f||f||fd | \|_|_ |j|_ |jp tj|_dS) Nrrr@)rrrr)rrrrrrrrrrWrVrTrU)r rrkrnrrrrjr{rsqrtrrlrmr\r rrp)r_polypathvertsyrWrVrTrUs re _set_pentagonzMarkerStyle._set_pentagonqsZ"****3//",Q//  2!DJJ%ERWQZZ2%Au\\\*++C%011Fq58U1XA2waIJJD%(E!HeAhQBqJKKEV} u  **  ""*$ &DJ#'/D .A)/rgc @td|_d|_t jdd}|s ||_n%|j}t tj |dd|dd |dd g}t tj |d d |d dg}t tj |dd |dd g}t tj |dd |dd |dd g}||f||f||f||fd| \|_|_ |j|_ |jp tj|_dS)Nrrrgŋ!r?) innerCirclerr rrr)r rrkrnrrrrjr{r concatenaterrlrmr\r rrp)r_r!r"rWrVrTrUs re _set_starzMarkerStyle._set_stars"****3//")!BBB  2!DJJ%Er~uQqSz52;ac &KLLMMC".%!*eAaCj)ABBCCFac E!A#J'?@@AADqsU1R4[%!*(MNNOOEV} u  **  ""*$ &DJ#'/D .A)/rgctd|_d|_t jd}|s ||_n|j}tj tj dtj zdz }t tj | dfg|gd|dfgg}t tj | dfg|dd|dfgg}t |dd}t |gd }||f||f||f||fd |\|_|_|j|_|jp t$j|_dS) Nrr*rg@r)rrrrr)rrrrr)r rrkrnrrrrjr{rrcospir+rrlrmr\r rrp)r_r!r"r5rWrVrTrUs re _set_hexagon1zMarkerStyle._set_hexagon1ss"****3//#,Q//   2!DJJ%Erva"%i"n--..Ar~!Qy% 2BaVH&MNNOOC".QB7)U1Q3Z1a&)JKKLLFac ##D|||,--EV} u  **  ""*$ &DJ#'/D .A)/rgc  tdd|_d|_t jd}|s||_n|j }tj ddz d}}t |gd}t |dd }t tj ||fg|dd| | f||fgg}t tj ||fg|d d d | | fgg}||f||f||f||fd | \|_|_|j|_|jp t"j|_dS) Nrr*rrg?)rrrrrrrrrr)r rrrkrnrrrrjr{rr r+rrlrmr\r rrp) r_r!r"r5r#rWrVrTrUs re _set_hexagon2zMarkerStyle._set_hexagon2s"****3//::2>>#,Q//   2!DJJ%E71::>6qAu___-..C%!*%%FQ%)rA2hA%7(9::;;DQ%!B-A2r()56677EV} u  **  ""*$ &DJ#'/D .A)/rgc td|_d|_t jd}|s"|jd||_ntj ddz }t ddgdd g| d gd|gd| g| dgddggx|_|_ | }|jdd d d d ||j d|_|jp t j|_dS)Nrrr)g6@rrrrrrrr)rTrVrUrWr)r rrkrnrrrrrjrr rlrrrmr\r rrp)r_r!r5rs re _set_octagonzMarkerStyle._set_octagonsE"****3//",Q//  M O & &t , , ,!DJJ b A*.R1a&A2q'B7qbQB8aW.+/+/ /DJ##%%B O & &b3sCCBG I I I"&/"8"8":":"E"Ee"L"LD .A)/rgrctd|_d|_d|_|j|_dSNrrF)r rrkrnrt_line_marker_pathrjrus re _set_vlinezMarkerStyle._set_vlines8"****3//" + rgcl||jd|_dSNr)r:rkrrus re _set_hlinezMarkerStyle._set_hlines- /44R88rgctdd|_d|_d|_|j|_dS)Nr6rFr rrkrnrt_tickhoriz_pathrjrus re _set_tickleftzMarkerStyle._set_ticklefts:"****455" ) rgctdd|_d|_d|_|j|_dSNrFr?rus re_set_tickrightzMarkerStyle._set_tickrights:"****344" ) rggctdd|_d|_d|_|j|_dSrCr rrkrnrt_tickvert_pathrjrus re _set_tickupzMarkerStyle._set_tickups:"****344" ( rgctdd|_d|_d|_|j|_dS)Nrr6FrFrus re _set_tickdownzMarkerStyle._set_tickdowns:"****355" ( rgg?rgctd|_d|_d|_|j|_dS)NrrF)r rrkrnrt _tri_pathrjrus re _set_tri_downzMarkerStyle._set_tri_downs7"****3//" ^ rgcl||jd|_dSNrrMrkrrus re _set_tri_upzMarkerStyle._set_tri_up/ /44S99rgcl||jd|_dSNrrPrus re _set_tri_leftzMarkerStyle._set_tri_leftrRrgcl||jd|_dSr<rPrus re_set_tri_rightzMarkerStyle._set_tri_right"s/ /44R88rgg?ctd|_d|_d|_|j|_|jp tj |_ dSNrg@F) r rrkrnrt _caret_pathrjr\r rrprus re_set_caretdownzMarkerStyle._set_caretdown(sI"****3//" % .A)/rgcl||jd|_dSrOr[rkrrus re _set_caretupzMarkerStyle._set_caretup// /44S99rgcl||jd|_dSrTr]rus re_set_caretleftzMarkerStyle._set_caretleft3r_rgcl||jd|_dSr<r]rus re_set_caretrightzMarkerStyle._set_caretright7s/ /44R88rggcF||j|_dSrx)r[_caret_path_baserjrus re_set_caretdownbasezMarkerStyle._set_caretdownbase=s" * rgcl||jd|_dSrOrfrkrrus re_set_caretupbasezMarkerStyle._set_caretupbaseA/ !!!/44S99rgcl||jd|_dSrTrhrus re_set_caretleftbasezMarkerStyle._set_caretleftbaseErjrgcl||jd|_dSr<rhrus re_set_caretrightbasezMarkerStyle._set_caretrightbaseIs/ !!!/44R88rgctd|_d|_d|_|j|_dSr8)r rrkrnrt _plus_pathrjrus re _set_pluszMarkerStyle._set_plusRs7"****3//" _ rgctd|_d|_d|_|j|_dSrY)r rrkrnrt_x_pathrjrus re_set_xzMarkerStyle._set_x]s7"****3//" \ rg) )r)rru)rr)rrrrrrrrrrrrrur)rur)rrr*))rrrvrwrxryrzr{)rurct|_d|_|jp tj|_|s|j|_ dS|j x|_ |_ | }|j ddddd||j d|_dSNrrrrr)rWrTrVrU)r rkrnr\r rrpr_plus_filled_pathrj_plus_filled_path_trlrrrrmr_rs re_set_plus_filledzMarkerStyle._set_plus_filledjs"**".A)/   K/DJJJ+/*B BDJ##%%B O & &2sCCBG I I I"&/"8"8":":"E"Ec"J"JD   rg) )r)rr)rr)rrrrrrrrrrrrrrrr)rrr)rrrrrrrct|_d|_|jp tj|_|s|j|_ dS|j x|_ |_ | }|j ddddd||j d|_dSr})r rkrnr\r rrpr_x_filled_pathrj_x_filled_path_trlrrrrmrs re _set_x_filledzMarkerStyle._set_x_filleds"**".A)/   K,DJJJ+/*? ?DJ##%%B O & &2sCCBG I I I"&/"8"8":":"E"Ec"J"JD   rg)NNNNrx)r)k__name__ __module__ __qualname____doc__TICKLEFT TICKRIGHTTICKUPTICKDOWN CARETLEFT CARETRIGHTCARETUP CARETDOWN CARETLEFTBASECARETRIGHTBASE CARETUPBASE CARETDOWNBASErfilled_markersrrrfrvr|rrr]rrrr^rrrrrrrrrrrrrrrrrrrr_create_closedrrrrrrr r rrrrrr$r,r0r3r5r9r:r=r@rArDrGrHrJMOVETOLINETOrLrMrQrUrWrZr[r^rarcrerfrirlrnrprqrsrtrarrayr~rrrrrrgrerrs  * W* W* X* _ * ] * _ * * Z* X* Z* [* Y* X* Z* V* Z!*" Z#**$ V%*& S'*( Y)** ^+*, W-*. W/*0 ]1*2 Z3*4 *5*6 ;7*8 9*: *;*< ;=*> L?*@ A*B ;C*D E**F (]   Y IS**G\NDJ9KO!!!!<   ... $ $ $$$$######JEEEIII$$$111  "t:, ...444EEE*0=== L L L L### $ $ $)T(1a&2r(QG)DEEN*t*QFT4L3++NOO*t* T{QGb"X688*t*QFQGb"X+FGG*t*QFQGaW+EFFBBB<***,,,+++,,,BBB$ B B B(((BBB.BBB,BBB0BBB4BBB*sDkC:677,,, 999dS#Jc 344O*** *** TD#;s 455N))) ))) sCj3+Cj3*Cj4+/k4;k4;k4;011I$$$ ::::::999$s c3Z#s<==KBBB::::::999tdC[3+Qx@AA+++::::::999c{S#JT{S#J0{DK{DK122J %%% dT4L3*3K#t.KK.//G """ ,+HBH6D6D6D-E-EGH-IJJ.$-hbh8/8/8//0/023/455 K K K)T(3B3B3B*C*CEF*GHHN+t*8285%5%5%,&,&(),*++ K K K K Krgr)$rrcollections.abcrrnumpyr matplotlibrrRrrrr transformsr r _enumsr r rangerrrrrrrrrrrremptyrirrrgrers5@@B ++++++++33333333'''''''' ?DeBii<9fh J ]d828F##$$ u Ku Ku Ku Ku Ku Ku Ku Ku Ku Krg