o i| @sdZddlmZddlZddlmZmZddlm Z ddl m Z m Z e d\ ZZZZZZZZZZZZe ed ZGd d d ZdS) aa Functions to handle markers; used by the marker functionality of `~matplotlib.axes.Axes.plot` and `~matplotlib.axes.Axes.scatter`. 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 ``""`` 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``. ============================== ====== ========================================= ``None`` is the default which means 'nothing', however this table is referred to from other docs for the valid inputs from marker inputs and in those cases ``None`` still means 'default'. Note that special symbols can be defined via the :doc:`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) Examples showing the use of markers: * :doc:`/gallery/lines_bars_and_markers/marker_reference` * :doc:`/gallery/shapes_and_collections/marker_path` * :doc:`/gallery/lines_bars_and_markers/scatter_star_poly` .. |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 )SizedN)cbookrcParams)Path)IdentityTransformAffine2D )rc@s eZdZdZidddddddd 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@iZdDZdEZdFZdGZddHdIZdJdKZdLdMZdNdOZdPdQZdRdSZdTdUZdVdWZdXdYZdZd[Zd\d]Zd^d_Z d`daZ!dbdcZ"dddeZ#dfdgZ$dhdiZ%djdkZ&dldmZ'dndoZ(dpdqZ)drdsZ*ddudvZ+dwdxZ,dydzZ-e.d{d|gd}d}gd|d}gd{d|ggd~dZ/e.d{d|gddgddgd{d|ggd~dZ0e.ddgddgd|d}gd}d}gddggd~dZ1e.d{d|gd{d}gd}d}gd{d|ggd~dZ2e.d{d|gd{d}gd|d}gd{d|ggd~dZ3ddZ4ddZ5ddZ6ddZ7ddZ8ddZ9ddZ:ddZ;ddZddZ?ddZ@e.ddgddtggZAddZBddZCe.ddgdtdggZDddZEddZFe.ddgddtggZGddZHddZIe.ddgddgddgddGgddgddGgge.jJe.jKe.jJe.jKe.jJe.jKgZLddZMddZNddZOddZPe.ddgddgdtdggZQddZRddZSddZTddZUe.ddgddgdtd{ggZVddZWddÄZXddńZYddDŽZZe.ddgdtdgddgddtgge.jJe.jKe.jJe.jKgZ[ddɄZ\e.ddgdtdtgddtgdtdgge.jJe.jKe.jJe.jKgZ]dd˄Z^e.gd̢d~dZ_e.gd͢d~dZ`ddτZae.gdТd~dZbe.gdѢd~dZcddӄZddAS) MarkerStylea  A class representing marker types. Attributes ---------- markers : list All known markers. filled_markers : list All known filled markers. This is a subset of *markers*. fillstyles : list 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 caretdownbaseNonenothingN )rrrrrr"r$r&r(r*r,r1r3r9r;)fullleftrightbottomtopnone)rNrOrPrQ?cCsd|_||||dS)aX Parameters ---------- marker : str or array-like or None, default: None *None* means no marker. For other possible marker values see the module docstring `matplotlib.markers`. fillstyle : str, default: 'full' One of 'full', 'left', 'right', 'bottom', 'top', 'none'. N)_marker_function set_fillstyle set_marker)selfmarker fillstylerZM/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/matplotlib/markers.py__init__s zMarkerStyle.__init__cCsL|jdurdSt|_t|_d|_d|_d|_d|_d|_ d|_ |dS)NroundbuttT) rT _empty_path_pathr _transform _alt_path_alt_transform_snap_threshold _joinstyle _capstyle_filledrWrZrZr[_recaches  zMarkerStyle._recachecCstt|jjSN)boollenr`verticesrhrZrZr[__bool__zMarkerStyle.__bool__cC|jSrjrgrhrZrZr[ is_filledzMarkerStyle.is_filledcCrprj) _fillstylerhrZrZr[ get_fillstylerszMarkerStyle.get_fillstylecCs2|durtd}tj|j|d||_|dS)z Set the fillstyle. Parameters ---------- fillstyle : {'full', 'left', 'right', 'bottom', 'top', 'none'} The part of the marker surface that is colored with markerfacecolor. Nzmarkers.fillstyle)rY)rr_check_in_list fillstylesrtri)rWrYrZrZr[rUs   zMarkerStyle.set_fillstylecCrprj)rerhrZrZr[ get_joinstyle rszMarkerStyle.get_joinstylecCrprj)rfrhrZrZr[ get_capstylerszMarkerStyle.get_capstylecCrprj)_markerrhrZrZr[ get_markerrszMarkerStyle.get_markerc Cs6t|tjr|jdkr|jddkr|j|_ntt|tr&t |r&|j |_net|t r0|j |_n[t|t rFt|dvrF|ddvrF|j|_nEt|tjtfs_||jvr_t|d|j||_n,t|trl|j|jnz t ||j|_Wnty}ztd||d}~wwt|ts||_|dSdS)a Set the marker. Parameters ---------- marker : str or array-like or None, default: None *None* means no marker. For other possible marker values see the module docstring `matplotlib.markers`. r r)r rrr _set_zUnrecognized marker style {!r}N) isinstancenpndarrayndimshape _set_verticesrTstrr is_math_text_set_mathtext_pathr_set_path_markerrrl_set_tuple_markerlistmarkersgetattrr __dict__update ValueErrorformatrzri)rWrXerrrZrZr[rVs@            zMarkerStyle.set_markercCrp)z Return a `.Path` for the primary part of the marker. For unfilled markers this is the whole marker, for filled markers, this is the area to be drawn with *markerfacecolor*. )r`rhrZrZr[get_path;zMarkerStyle.get_pathcC |jS)zj Return the transform to be applied to the `.Path` from `MarkerStyle.get_path()`. )rafrozenrhrZrZr[ get_transformD zMarkerStyle.get_transformcCrp)z Return a `.Path` for the alternate part of the marker. For unfilled markers, this is *None*; for filled markers, this is the area to be drawn with *markerfacecoloralt*. )rbrhrZrZr[ get_alt_pathKrzMarkerStyle.get_alt_pathcCr)zn Return the transform to be applied to the `.Path` from `MarkerStyle.get_alt_path()`. )rcrrhrZrZr[get_alt_transformTrzMarkerStyle.get_alt_transformcCrprj)rdrhrZrZr[get_snap_threshold[rszMarkerStyle.get_snap_thresholdcCs d|_dS)NFrqrhrZrZr[ _set_nothing^s zMarkerStyle._set_nothingcCs.tt|j}td||_||_dS)NrS)rmaxabsrmrscalerar`)rWpathrescalerZrZr[_set_custom_markeras zMarkerStyle._set_custom_markercCs||jdSrj)rrzrhrZrZr[rfrozMarkerStyle._set_path_markercCs|t|jdSrj)rrrzrhrZrZr[riszMarkerStyle._set_verticescCs|j}t|dkr|dd}}nt|dkr |d|d}}|d}|dkr2t||_d|_n&|dkr@t||_d|_n|dkrQt||_d|_d|_nt d |t d  ||_ dS) Nr rr|rmiterbevelFzUnexpected tuple marker: rS)rzrlrunit_regular_polygonr`reunit_regular_starunit_regular_asteriskrgrrr rotate_degra)rWrXnumsidesrotationsymstylerZrZr[rls$     zMarkerStyle._set_tuple_markerc Csddlm}|d|tdd}t|jdkrdS|jjdd\}}|jjdd\}}||}||}t||} t | d| | d|  d | |_ ||_ d |_ dS) za Draws mathtext markers '$...$' using TextPath object. Submitted by tcb r)TextPath)rrz text.usetex)xyr$usetexN)axisrS?F)matplotlib.textrr{rrlrmminrr translaterrar`_snap) rWrtextxminyminxmaxymaxwidthheightmax_dimrZrZr[rs"      zMarkerStyle._set_mathtext_pathcCs||jvSrj)ru_half_fillstylesrhrZrZr[ _half_fillszMarkerStyle._half_fillrcCstd||_tj|_|}|st |_ dS|dkr#d}n|dkr*d}n |dkr1d}nd}t |_ |_ |j ||j d|_dS) NrSrPp@rQV@rNf@r)rrrarinfrdrurr unit_circler`unit_circle_righthalfrbrrrc)rW reductionfsrotaterZrZr[ _set_circles zMarkerStyle._set_circlecCs$t|_tdd|_d|_dS)Ng9߿)runit_rectangler`rrrardrhrZrZr[ _set_pixels  zMarkerStyle._set_pixelcCs|j|jddS)N)r)r_point_size_reductionrhrZrZr[ _set_pointszMarkerStyle._set_pointrrT)closedg333333gɿ333333?cCstd||_d|_|}|s|j|_ne|j |j |j |j g}|dkr;|d|d|_|d|d|_ n@|dkrR|d|d|_|d|d|_ n)|dkri|d |d|_|d |d|_ n|d |d|_|d |d|_ |j|_d |_dS) NrS@rQrr rPrNrr|r)rrrrardrur_triangle_pathr`_triangle_path_u_triangle_path_l_triangle_path_d_triangle_path_rrbrcre)rWrotskiprmpathsrZrZr[ _set_triangles.  zMarkerStyle._set_trianglecC |ddS)NrrrrhrZrZr[_set_triangle_up zMarkerStyle._set_triangle_upcCr)Nrr rrhrZrZr[_set_triangle_downrzMarkerStyle._set_triangle_downcCr)Nrr|rrhrZrZr[_set_triangle_leftrzMarkerStyle._set_triangle_leftcCr)NrrrrhrZrZr[_set_triangle_rightrzMarkerStyle._set_triangle_rightcCstdd|_d|_|}|st|_nI|dkr d}n|dkr'd}n |dkr.d}nd }tddgd dgd d gdd gddgg|_tdd gd d gd d gdd gdd gg|_ |j ||j|_ d |_ dS) N@rPrrQrrNrrrrSr) rrrardrurrrr`rbrrcrerWrrrZrZr[ _set_squares*     zMarkerStyle._set_squarecCstddd|_d|_|}|st|_ nCtddgddgddgddgg|_ tddgddgddgddgg|_ |dkrEd}n|dkrLd }n |d krSd }nd }|j||j|_ d |_ dS)Nr-rrrrPrrQrrNrrr) rrrrardrurrrr`rbrcrerrZrZr[ _set_diamonds" ""  zMarkerStyle._set_diamondcCs||jdddS)Nrr)rrarrhrZrZr[_set_thin_diamond)zMarkerStyle._set_thin_diamondc CsHtd|_d|_td}|}|s||_n|j }dt dd}t|d|d|d|dg}t|d|d|d |d|dg}t|d|d|dd| g|dg}t|d|d|d d| g|dg}|d kr|||} } n|d kr||} } n|d kr||} } n||} } | |_| |_ |j|_ d |_dS)NrSrr@rrr r|rQrPrNr)rrrardrrrurr`rmrsqrtrbrcre) rWpolypathrvertsyrQrPrNrOmpath mpath_altrZrZr[ _set_pentagon-s.  &((     zMarkerStyle._set_pentagonc CsTtd|_d|_|}tjddd}|s||_n|j }tt |ddddf|dd ddf|df}tt |d d ddf|d f}tt |dd ddf|df}tt |d|dd ddf|df}|d kr||}} n|dkr||}} n|dkr||}} n||}} ||_| |_ |j|_ d|_dS)NrSrrgŋ!r?) innerCirclerr r|rQrPrNr)rrrardrurrrr`rmrvstackrbrcre) rWrrrrQrPrNrOrrrZrZr[ _set_starMs,8&&,     zMarkerStyle._set_starc Cs:td|_d|_|}td}|s||_n}|j }t t dt j d}tt | dg|dddf|dgf}tt | dg|ddddf|dgf}t|dddf}t|d ddf}|d kru||} } n|d kr||} } n|d kr||} } n||} } | |_| |_|j|_d |_dS)NrSrrg@r)rrrr )rrr r|)rrrr|rQrPrNr)rrrardrurrrr`rmrrcospirrbrcre) rWrrrr0rQrPrNrOrrrZrZr[ _set_hexagon1ls. *.     zMarkerStyle._set_hexagon1c Cs@tdd|_d|_|}td}|s||_ n}|j }t ddd}}t|dddf}t|dddf}tt ||g|d ddf| | g||gf}tt ||g|d ddf| | gf} |d krx||} } n|d kr||} } n|d kr|| } } n| |} } | |_ | |_|j|_d|_dS)NrSrr|r?)rrrrr)rr r|rr})rrr|rQrPrNr)rrrrardrurrrr`rmrrrrbrcre) rWrrrr0rrQrPrNrOrrrZrZr[ _set_hexagon2s2 ,     zMarkerStyle._set_hexagon2c Cstd|_d|_|}td}|s!|jd||_ nOt dd}tddgdd g| d gd|gd| g| dgddgg}|d krKd }n|d krRd }n |dkrYd}nd}|j|||_ |_ |j d|_d|_dS)NrSrrg6@rrrrrrPrrQrrOrrr)rrrardrurrrrr`rrrbrrcre)rWrrr0halfrrZrZr[ _set_octagons,     zMarkerStyle._set_octagonrcC&td|_d|_d|_|j|_dSNrSrF)rrrardrg_line_marker_pathr`rhrZrZr[ _set_vline zMarkerStyle._set_vlinecC||jd|_dSNZ)rrarrhrZrZr[ _set_hlinerzMarkerStyle._set_hlinecCs(tdd|_d|_d|_|j|_dS)NrrFrrrardrg_tickhoriz_pathr`rhrZrZr[ _set_tickleft zMarkerStyle._set_tickleftcC(tdd|_d|_d|_|j|_dSNrFr rhrZrZr[_set_tickrightrzMarkerStyle._set_tickrightgcCrrrrrardrg_tickvert_pathr`rhrZrZr[ _set_tickuprzMarkerStyle._set_tickupcCs(tdd|_d|_d|_|j|_dS)NrrFrrhrZrZr[ _set_tickdownrzMarkerStyle._set_tickdowng?gcCr)NrSrF)rrrardrg _tri_pathr`rhrZrZr[ _set_tri_downrzMarkerStyle._set_tri_downcCrNrrarrhrZrZr[ _set_tri_uprzMarkerStyle._set_tri_upcCrNrrhrZrZr[ _set_tri_leftrzMarkerStyle._set_tri_leftcCrr rrhrZrZr[_set_tri_right rzMarkerStyle._set_tri_rightg?cCs,td|_d|_d|_|j|_d|_dS)NrS@Fr)rrrardrg _caret_pathr`rerhrZrZr[_set_caretdowns  zMarkerStyle._set_caretdowncCrrr#rarrhrZrZr[ _set_caretuprzMarkerStyle._set_caretupcCrrr$rhrZrZr[_set_caretleftrzMarkerStyle._set_caretleftcCrr r$rhrZrZr[_set_caretright!rzMarkerStyle._set_caretrightgcCs||j|_dSrj)r#_caret_path_baser`rhrZrZr[_set_caretdownbase's zMarkerStyle._set_caretdownbasecCrrr)rarrhrZrZr[_set_caretupbase+rzMarkerStyle._set_caretupbasecCrrr*rhrZrZr[_set_caretleftbase/rzMarkerStyle._set_caretleftbasecCrr r*rhrZrZr[_set_caretrightbase3rzMarkerStyle._set_caretrightbasecCrr)rrrardrg _plus_pathr`rhrZrZr[ _set_plus<rzMarkerStyle._set_pluscCr)NrSr!F)rrrardrg_x_pathr`rhrZrZr[_set_xGrzMarkerStyle._set_x) UUUUUU?r)UUUUUU?r)r4r3)rr3rr4r4r4r4rr3rr3r4rr4)rr3)r3r3r2) rrSr5r6r7r8r9r:)rrSr;cCtdd|_d|_d|_|}|s|j|_dS|dkr%d\}}n|dkr.d\}}n |dkr7d \}}nd \}}|j |_|j |_ tdd|_ |j ||j |dS NrrrrQ)rrrP)rrrN)r r)rr ) rrrardrerur_plus_filled_pathr`_plus_filled_path_trbrcrrWrr rotate_altrZrZr[_set_plus_filledU$     zMarkerStyle._set_plus_filled) ?r)rSrE)rr)rrErrSrrrrrSrrErrrrErS)rrErD)rFrGrHrIrJrKrLrFcCr<r=) rrrardrerur_x_filled_pathr`_x_filled_path_trbrcrr@rZrZr[ _set_x_filledurCzMarkerStyle._set_x_filled)NN)r)e__name__ __module__ __qualname____doc__TICKLEFT TICKRIGHTTICKUPTICKDOWN CARETLEFT CARETRIGHTCARETUP CARETDOWN CARETLEFTBASECARETRIGHTBASE CARETUPBASE CARETDOWNBASErfilled_markersrwrrr\rirnrrrurUrxryr{rVrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r rrrrrMOVETOLINETOrrrrr r"r#r%r&r'r(r)r+r,r-r.r/r0r1r>r?rBrMrNrOrZrZrZr[r s       !"#.  &   $ $$ "#     r )rScollections.abcrnumpyrrLrrrr transformsrrrangerTrUrVrWrXrYrZr[r\r]r^r_emptyr_r rZrZrZr[s