a ضarx @sdZddlmZddlZddlmZmZmZddl m Z ddl m Z m Z ddlmZmZed \ ZZZZZZZZZZZZe ed ZGd d d Z dS) aO 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 ``""`` 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/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)_apicbookrcParams)Path)IdentityTransformAffine2D) JoinStyleCapStyle )rcR@seZdZdZdddddddd d d d d ddddddddddddddddddd d!d"d#d$d%d&d&d'd(d)d*d+d,d-d.d/d0d1d2ed3ed4ed5ed6ed7e d8e d9e d:e d;e dd?d@dAd@dBd@dCd@i)ZdDZdEZdFZdGZddHdIZdJdKZdLdMZdNdOZdPdQZejdRdSdTdUdVZdWdXZdYdZZd[d\Zd]d^Z ejdRdSdTd_d`Z!dadbZ"dcddZ#dedfZ$dgdhZ%didjZ&dkdlZ'dmdnZ(dodpZ)dqdrZ*dsdtZ+dudvZ,dwdxZ-dydzZ.dd|d}Z/d~dZ0ddZ1e2ddgddgddgddggddZ3e2ddgddgddgddggddZ4e2ddgddgddgddgddggddZ5e2ddgddgddgddggddZ6e2ddgddgddgddggddZ7ddZ8ddZ9ddZ:ddZ;ddZddZ?ddZ@ddZAddZBddZCddZDe2ddgdd{ggZEddZFddZGe2ddgd{dggZHddZIddZJe2ddgdd{ggZKddZLddZMe2ddgddgddgddGgddgddGgge2jNe2jOe2jNe2jOe2jNe2jOgZPddZQddZRddZSddZTe2ddgddgd{dggZUddZVddZWddÄZXddńZYe2ddgddgd{dggZZddȄZ[ddʄZ\dd̄Z]dd΄Z^e2ddgd{dgddgdd{gge2jNe2jOe2jNe2jOgZ_ddЄZ`e2ddgd{d{gdd{gd{dgge2jNe2jOe2jNe2jOgZadd҄Zbe2ecdgdӢdddZee2ecdgdբdddZfddׄZge2ecdgdآdddZhe2ecdgdڢdddZidd܄ZjdAS) MarkerStyleae A class representing marker types. Instances are immutable. If you need to change anything, create a new instance. Attributes ---------- markers : list All known markers. filled_markers : list All known filled markers. This is a subset of *markers*. fillstyles : list The supported fillstyles. .Zpoint,ZpixeloZcirclevZ triangle_down^Z triangle_upZtriangle_right1Ztri_down2Ztri_up3Ztri_left4Z tri_right8ZoctagonsZsquarepZpentagon*ZstarhZhexagon1HZhexagon2+plusxDZdiamonddZ thin_diamond|Zvline_ZhlinePZ plus_filledXZx_filledZtickleftZ tickrightZtickupZtickdownZ caretleftZ caretrightZcaretupZ caretdownZ caretleftbaseZcaretrightbaseZ caretupbaseZ caretdownbaseNoneZnothingN )rrrrrrrrrrrr#r$r'r()fullleftrightbottomtopnone)r-r.r/r0?cCsd|_||||dS)a Parameters ---------- marker : str, array-like, Path, MarkerStyle, or None, default: None - Another instance of *MarkerStyle* copies the details of that ``marker``. - *None* means no 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'. N)_marker_function_set_fillstyle _set_marker)selfmarker fillstyler9b/Users/vegardjervell/Documents/master/model/venv/lib/python3.9/site-packages/matplotlib/markers.py__init__s zMarkerStyle.__init__cCsV|jdurdSt|_t|_d|_d|_d|_tj |_ t j |_ |jdk|_|dS)Nr1)r3 _empty_path_pathr _transform _alt_path_alt_transform_snap_thresholdr round _joinstyler Zbutt _capstyle _fillstyle_filledr6r9r9r:_recaches  zMarkerStyle._recachecCstt|jjSN)boollenr=verticesrGr9r9r:__bool__szMarkerStyle.__bool__cCs|jSrIrFrGr9r9r: is_filledszMarkerStyle.is_filledcCs|jSrI)rErGr9r9r: get_fillstyleszMarkerStyle.get_fillstylez3.4z a new marker) alternativecCs ||SrI)r4r6r8r9r9r: set_fillstyleszMarkerStyle.set_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)r8)rrZ check_in_list fillstylesrErHrRr9r9r:r4 s zMarkerStyle._set_fillstylecCs|jSrI)rCrGr9r9r: get_joinstyleszMarkerStyle.get_joinstylecCs|jSrI)rDrGr9r9r: get_capstyleszMarkerStyle.get_capstylecCs|jSrI)_markerrGr9r9r: get_marker szMarkerStyle.get_markercCs ||SrI)r5)r6r7r9r9r: set_marker#szMarkerStyle.set_markerc CsBt|tjr.|jdkr.|jddkr.|j|_nt|trLt |rL|j |_nt|t r`|j |_nt|t rt|dvr|ddvr|j|_nt|tjtfs||jvrt|d|j||_nft|tr|j|jnLzt ||j|_Wn6ty"}ztd||WYd}~n d}~00t|ts>||_|dS)a Set the marker. Parameters ---------- marker : str, array-like, Path, MarkerStyle, or None, default: None - Another instance of *MarkerStyle* copies the details of that ``marker``. - *None* means no marker. - For other possible marker values see the module docstring `matplotlib.markers`. r r)r )rrr Z_set_zUnrecognized marker style {!r}N) isinstancenpZndarrayndimshape _set_verticesr3strrZ is_math_text_set_mathtext_pathr_set_path_markerrrK_set_tuple_markerlistmarkersgetattrr__dict__update ValueErrorformatrWrH)r6r7errr9r9r:r5's@           zMarkerStyle._set_markercCs|jS)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=rGr9r9r:get_pathPszMarkerStyle.get_pathcCs |jS)zj Return the transform to be applied to the `.Path` from `MarkerStyle.get_path()`. )r>frozenrGr9r9r: get_transformYszMarkerStyle.get_transformcCs|jS)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*. )r?rGr9r9r: get_alt_path`szMarkerStyle.get_alt_pathcCs |jS)zn Return the transform to be applied to the `.Path` from `MarkerStyle.get_alt_path()`. )r@rmrGr9r9r:get_alt_transformiszMarkerStyle.get_alt_transformcCs|jSrI)rArGr9r9r:get_snap_thresholdpszMarkerStyle.get_snap_thresholdcCs d|_dS)NFrNrGr9r9r: _set_nothingsszMarkerStyle._set_nothingcCs.tt|j}td||_||_dS)Nr2)r\maxabsrLr scaler>r=)r6pathZrescaler9r9r:_set_custom_markervszMarkerStyle._set_custom_markercCs||jdSrI)rwrWrGr9r9r:rb{szMarkerStyle._set_path_markercCs|t|jdSrI)rwrrWrGr9r9r:r_~szMarkerStyle._set_verticescCs|j}t|dkr"|dd}}nt|dkr@|d|d}}|d}|dkrft||_tj|_nP|dkrt||_tj |_n2|dkrt ||_d|_ tj |_nt d|t d||_dS) Nr rrZrFzUnexpected tuple marker: r2)rWrKrunit_regular_polygonr=r miterrCunit_regular_starbevelZunit_regular_asteriskrFrir ru rotate_degr>)r6r7ZnumsidesZrotationZsymstyler9r9r:rcs$        zMarkerStyle._set_tuple_markerc Csddlm}|d|tdd}t|jdkr4dS|jjdd\}}|jjdd\}}||}||}t||} t | d| | d|  d | |_ ||_ d |_ dS) z` Draw mathtext markers '$...$' using TextPath object. Submitted by tcb r)TextPath)rrz text.usetex)ZxyrZusetexN)Zaxisr2?F)Zmatplotlib.textr~rXrrKrLminrsr translaterur>r=Z_snap) r6r~textZxminZyminZxmaxZymaxwidthheightZmax_dimr9r9r:ras$   zMarkerStyle._set_mathtext_pathcCs||jvSrI)rP_half_fillstylesrGr9r9r: _half_fillszMarkerStyle._half_fillrcCsvtd||_tj|_|s.t|_ nDt |_ |_ | }|j ddddd||j d|_dS)Nr2rZr.r0r-r/f@)r rur>r\infrArrZ unit_circler=Zunit_circle_righthalfr?rPr}rmr@)r6 reductionfsr9r9r: _set_circles zMarkerStyle._set_circlecCs$t|_tdd|_d|_dS)Ng9߿)runit_rectangler=r rr>rArGr9r9r: _set_pixels zMarkerStyle._set_pixelcCs|j|jddS)N)r)r_point_size_reductionrGr9r9r: _set_pointszMarkerStyle._set_pointrrT)closedg333333gɿ333333?cCs td||_d|_|s,|j|_n|j|j |j |j g}| }|dkrv|d|d|_|d|d|_ n|dkr|d|d|_|d|d|_ nR|dkr|d |d|_|d |d|_ n$|d |d|_|d |d|_ |j|_tj|_dS) Nr2@r0rr r/r-rrZ)r rur}r>rAr_triangle_pathr=_triangle_path_u_triangle_path_l_triangle_path_d_triangle_path_rrPr?r@r rzrC)r6ZrotskipZmpathsrr9r9r: _set_triangles. zMarkerStyle._set_trianglecCs |ddS)NrxrrrGr9r9r:_set_triangle_upszMarkerStyle._set_triangle_upcCs |ddS)Nrr rrGr9r9r:_set_triangle_downszMarkerStyle._set_triangle_downcCs |ddS)NgV@rZrrGr9r9r:_set_triangle_leftszMarkerStyle._set_triangle_leftcCs |ddS)Ngp@rrrGr9r9r:_set_triangle_rightszMarkerStyle._set_triangle_rightcCstdd|_d|_|s*t|_n~tddgddgddgddgddgg|_tddgddgddgddgddgg|_| }dddd d |}|j ||j|_ t j |_dS) N@rxrr2rrrr)r/r.r0r-)r rr>rArrrr=r?rPr}r@r rzrCr6rrotater9r9r: _set_squares    zMarkerStyle._set_squarecCstddd|_d|_|s0t|_nrtddgddgddgddgg|_tddgddgddgddgg|_ | }ddddd |}|j||j|_ t j |_dS) Nr-rrrrrrr)r rr}r>rArrrr=r?rPr@r rzrCrr9r9r: _set_diamonds "" zMarkerStyle._set_diamondcCs||jdddS)Nrr)rr>rurGr9r9r:_set_thin_diamond$szMarkerStyle._set_thin_diamondcCstd|_d|_td}|s.||_n|j}dt dd}t|gd}t|gd}t|d|d|d d| g|dg}t|d|d |d d| g|dg}||f||f||f||fd | \|_|_ |j|_ tj|_dS) Nr2rr@)rrrr)rr rZrrrr rrZr0r/r-r.)r rur>rArryrr=rLr\sqrtrPr?r@r rzrC)r6polypathvertsyr0r/r-r.r9r9r: _set_pentagon(s$ ((   zMarkerStyle._set_pentagoncCstd|_d|_tjddd}|s2||_n|j}tt |dd|dd |dd g}tt |d d |d dg}tt |dd |dd g}tt |dd |dd |dd g}||f||f||f||fd| \|_|_ |j|_ tj|_dS)Nr2rrgŋ!r?)Z innerCirclerr rrZr)r rur>rArr{rr=rLr\ concatenaterPr?r@r r|rC)r6rrr0r/r-r.r9r9r: _set_star?s","",   zMarkerStyle._set_starcCstd|_d|_td}|s.||_n|j}t t dt j d}tt | dfg|gd|dfgg}tt | dfg|dd|dfgg}t|dd}t|gd }||f||f||f||fd |\|_|_|j|_tj|_dS) Nr2rrg@r)rrrr r)rrrrZr)r rur>rArryrr=rLr\rtcospirrPr?r@r rzrC)r6rrr"r0r/r-r.r9r9r: _set_hexagon1Us$ **   zMarkerStyle._set_hexagon1c Cstdd|_d|_td}|s4||_n|j }t ddd}}t|gd}t|dd }tt ||fg|dd| | f||fgg}tt ||fg|d d d | | fgg}||f||f||f||fd | \|_|_|j|_tj|_dS) Nr2rrZrg?)rrrrrrrr rr)r rur}r>rArryrr=rLr\rrrPr?r@r rzrC) r6rrr"rr0r/r-r.r9r9r: _set_hexagon2ms, $    zMarkerStyle._set_hexagon2c Cstd|_d|_td}|s:|jd||_nt dd}tddgdd g| d gd|gd| g| dgddgg|_|_ | }|jdd d d d ||j d|_tj|_dS)Nr2rrg6@rrrrrrrr)r-r/r.r0r)r rur>rArryrr}r=r\rr?rPrmr@r rzrC)r6rr"rr9r9r: _set_octagons$   zMarkerStyle._set_octagonrxcCs&td|_d|_d|_|j|_dSNr2rF)r rur>rArF_line_marker_pathr=rGr9r9r: _set_vlineszMarkerStyle._set_vlinecCs||jd|_dSNr)rr>r}rGr9r9r: _set_hlineszMarkerStyle._set_hlinecCs(tdd|_d|_d|_|j|_dS)NrrFr rur>rArF_tickhoriz_pathr=rGr9r9r: _set_tickleftszMarkerStyle._set_tickleftcCs(tdd|_d|_d|_|j|_dSNrFrrGr9r9r:_set_tickrightszMarkerStyle._set_tickrightgcCs(tdd|_d|_d|_|j|_dSrr rur>rArF_tickvert_pathr=rGr9r9r: _set_tickupszMarkerStyle._set_tickupcCs(tdd|_d|_d|_|j|_dS)NrrFrrGr9r9r: _set_tickdownszMarkerStyle._set_tickdowng?gcCs&td|_d|_d|_|j|_dS)Nr2rF)r rur>rArF _tri_pathr=rGr9r9r: _set_tri_downszMarkerStyle._set_tri_downcCs||jd|_dSNrrr>r}rGr9r9r: _set_tri_upszMarkerStyle._set_tri_upcCs||jd|_dSNrrrGr9r9r: _set_tri_leftszMarkerStyle._set_tri_leftcCs||jd|_dSrrrGr9r9r:_set_tri_rightszMarkerStyle._set_tri_rightg?cCs.td|_d|_d|_|j|_tj|_ dSNr2g@F) r rur>rArF _caret_pathr=r rzrCrGr9r9r:_set_caretdowns zMarkerStyle._set_caretdowncCs||jd|_dSrrr>r}rGr9r9r: _set_caretupszMarkerStyle._set_caretupcCs||jd|_dSrrrGr9r9r:_set_caretleftszMarkerStyle._set_caretleftcCs||jd|_dSrrrGr9r9r:_set_caretrightszMarkerStyle._set_caretrightgcCs||j|_dSrI)r_caret_path_baser=rGr9r9r:_set_caretdownbaseszMarkerStyle._set_caretdownbasecCs||jd|_dSrrr>r}rGr9r9r:_set_caretupbaseszMarkerStyle._set_caretupbasecCs||jd|_dSrrrGr9r9r:_set_caretleftbaseszMarkerStyle._set_caretleftbasecCs||jd|_dSrrrGr9r9r:_set_caretrightbaseszMarkerStyle._set_caretrightbasecCs&td|_d|_d|_|j|_dSr)r rur>rArF _plus_pathr=rGr9r9r: _set_plus szMarkerStyle._set_pluscCs&td|_d|_d|_|j|_dSr)r rur>rArF_x_pathr=rGr9r9r:_set_xszMarkerStyle._set_x) r)rr)rr)rZrrZrrrrrZrrZrrrr)rr)rrrr) rZrrrrrrr)rrrcCsnt|_d|_tj|_|s(|j|_nB|j |_|_ | }|j ddddd||j d|_dSNrrrrr)r0r-r/r.)r r>rAr rzrCr_plus_filled_pathr=_plus_filled_path_tr?rPr}rmr@r6rr9r9r:_set_plus_filled#s zMarkerStyle._set_plus_filled) r)rr)rr)r rrrr rrr rrrr rrrr)rrrr)rrrrrrrrcCsnt|_d|_tj|_|s(|j|_nB|j |_|_ | }|j ddddd||j d|_dSr)r r>rAr rzrCr_x_filled_pathr=_x_filled_path_tr?rPr}rmr@rr9r9r: _set_x_filled;s zMarkerStyle._set_x_filled)NN)r)k__name__ __module__ __qualname____doc__TICKLEFT TICKRIGHTTICKUPTICKDOWN CARETLEFT CARETRIGHTCARETUP CARETDOWN CARETLEFTBASECARETRIGHTBASE CARETUPBASE CARETDOWNBASEreZfilled_markersrTrrr;rHrMrOrPr deprecatedrSr4rUrVrXrYr5rlrnrorprqrrrwrbr_rcrarrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrZMOVETOZLINETOrrrrrrrrrrrrrrrrrrrr\arrayrrrrrrr9r9r9r:rsZ.     )   $ $$        r)!rcollections.abcrZnumpyr\r+rrrrvrZ transformsrr Z_enumsr r rangerrr r r r r rrrrremptyr<rr9r9r9r:s