o it @sdZddlZddlmZddlZddlZddlm Z m Z ddl m Z ddl mZmZddlmZmZed \ ZZZZZZZZZZZZe e d Z!Gd d 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``. ============================== ====== ========================================= As a deprecated feature, ``None`` also means 'nothing' when directly constructing a `.MarkerStyle`, but note that there are other contexts where ``marker=None`` instead means "the default marker" (e.g. :rc:`scatter.marker` for `.Axes.scatter`). 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)Sized)_apicbook)Path)IdentityTransformAffine2D) JoinStyleCapStyle )rc@s2eZdZdZidddddddd 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 GddHdIZdJdKZdLdMZdNdOZdPdQZdRdSZdTdUZdVdWZdXdYZdZd[Zd\d]Zd^d_Zd`daZ dbdcZ!dddeZ"dfdgZ#dhe$fdidjZ%dGdGdkdldmZ&ddndoZ'dpdqZ(drdsZ)dtduZ*dvdwZ+dxdyZ,dzd{Z-d|d}Z.dddZ/ddZ0ddZ1e23ddgddgddggZ4e23ddgddgddggZ5e23ddgddgddgddggZ6e23ddgddgddggZ7e23ddgddgddggZ8ddZ9ddZ:ddZ;ddZddZ?ddZ@ddZAddZBddZCddZDddZEe2ddgdd~ggZFddZGddZHe2ddgd~dggZIddZJddZKe2ddgdd~ggZLddZMddZNe2ddgddgddgddgddgddgge2jOe2jPe2jOe2jPe2jOe2jPgZQddZRddZSddZTddZUe2ddgddgd~dggZVddZWddÄZXddńZYddDŽZZe2ddgddgd~dggZ[ddʄZ\dd̄Z]dd΄Z^ddЄZ_e2ddgd~dgddgdd~gge2jOe2jPe2jOe2jPgZ`dd҄Zae2ddgd~d~gdd~gd~dgge2jOe2jPe2jOe2jPgZbddԄZce23edegdբdZfe23edegdעdZgddلZhe23edegdڢdZie23edegdܢdZjddބZkdGS) 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,ZpixelocirclevZ triangle_down^Z triangle_upZtriangle_right1Ztri_down2Ztri_up3Ztri_left4Z tri_right8ZoctagonsZsquarepZpentagon*starhZhexagon1HZhexagon2+plusxDZdiamonddZ thin_diamond|Zvline_ZhlinePZ plus_filledXZx_filledZtickleftZ tickrightZtickupZtickdownZ caretleftZ caretrightZcaretupZ caretdownZ caretleftbaseZcaretrightbaseZ caretupbaseZ caretdownbaseNoneZnothingnone )rrrrrrrrrrr r!r%r&r)r*)fullleftrightbottomtopr,)r0r1r2r3NcCsPd|_||_|durt|nd|_|durt|nd|_||||dS)a Parameters ---------- marker : str, array-like, Path, MarkerStyle, or None - Another instance of *MarkerStyle* copies the details of that ``marker``. - *None* means no marker. This is the deprecated default. - 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 : transforms.Transform, default: None Transform that will be combined with the native transform of the marker. capstyle : `.CapStyle` or %(CapStyle)s, default: None Cap style that will override the default cap style of the marker. joinstyle : `.JoinStyle` or %(JoinStyle)s, default: None 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 transformZcapstyleZ joinstyler>a/var/www/html/eduruby.in/lip-sync/lip-sync-env/lib/python3.10/site-packages/matplotlib/markers.py__init__s  zMarkerStyle.__init__cCs\|jdurdSt|_t|_d|_d|_d|_tj |_ |j p t j |_|jdk|_|dS)Nr,)r4 _empty_path_pathr _transform _alt_path_alt_transform_snap_thresholdr round _joinstyler6r Zbutt _capstyle _fillstyle_filledr:r>r>r?_recaches   zMarkerStyle._recachecCstt|jjSN)boollenrBverticesrLr>r>r?__bool__zMarkerStyle.__bool__cC|jSrNrKrLr>r>r? is_filledzMarkerStyle.is_filledcCrTrN)rJrLr>r>r? get_fillstylerWzMarkerStyle.get_fillstylecCs,|dur tjd}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)r<)mplrcParamsrZ check_in_list fillstylesrJ)r:r<r>r>r?r8s  zMarkerStyle._set_fillstylecC|jjSrN)rHnamerLr>r>r? get_joinstyle)zMarkerStyle.get_joinstylecCr\rN)rIr]rLr>r>r? get_capstyle,r_zMarkerStyle.get_capstylecCrTrN)_markerrLr>r>r? get_marker/rWzMarkerStyle.get_markerc Cs4t|trt|r|j|_n{t|ttfr'||jvr't|d|j||_nct|t j r>|j dkr>|j ddkr>|j |_nLt|trH|j|_nBt|tr^t|dvr^|ddvr^|j|_n,t|trkt|j|_nz t||j |_Wnty}ztd||d}~wwt|ts||_|dSdS)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`. Z_set_r r)r )rrr zUnrecognized marker style N) isinstancestrrZ is_math_text_set_mathtext_pathr4intmarkersgetattrnpZndarrayndimshape _set_verticesr_set_path_markerrrP_set_tuple_markerr copydeepcopy__dict__ ValueErrorrarM)r:r;errr>r>r?r92s:          zMarkerStyle._set_markercCrT)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*. )rBrLr>r>r?get_pathYzMarkerStyle.get_pathcC$|jdur |jS|j|jS)zj Return the transform to be applied to the `.Path` from `MarkerStyle.get_path()`. N)r5rCfrozenrLr>r>r? get_transformb  zMarkerStyle.get_transformcCrT)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*. )rDrLr>r>r? get_alt_pathlrvzMarkerStyle.get_alt_pathcCrw)zn Return the transform to be applied to the `.Path` from `MarkerStyle.get_alt_path()`. N)r5rErxrLr>r>r?get_alt_transformurzzMarkerStyle.get_alt_transformcCrTrN)rFrLr>r>r?get_snap_thresholdrWzMarkerStyle.get_snap_thresholdcCs|jdur |jSdS)z.Return user supplied part of marker transform.N)r5rxrLr>r>r?get_user_transforms  zMarkerStyle.get_user_transformr=cCs.t|}|jdur|j|7_|S||_|S)a  Return a new version of this marker with the transform applied. Parameters ---------- transform : `~matplotlib.transforms.Affine2D`, default: None Transform will be combined with current user supplied transform. N)r r5)r:r= new_markerr>r>r? transformeds  zMarkerStyle.transformed)degradcCsv|dur |dur td|dur|durtdt|}|jdur%t|_|dur/|j||dur9|j||S)aL Return a new version of this marker rotated by specified angle. Parameters ---------- deg : float, default: None Rotation angle in degrees. rad : float, default: None 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)rsr r5r rotate_degrotate)r:rrrr>r>r?rotateds   zMarkerStyle.rotatedcCs2|dur|}t|}|jpt}||||_|S)aW Return new marker scaled by specified scale factors. If *sy* is None, the same scale is applied in both the *x*- and *y*-directions. Parameters ---------- sx : float *X*-direction scaling factor. sy : float, default: None *Y*-direction scaling factor. N)r r5rscale)r:sxZsyrrCr>r>r?scaleds  zMarkerStyle.scaledcCs d|_dS)NFrUrLr>r>r? _set_nothings zMarkerStyle._set_nothingcCs.tt|j}td||_||_dS)N?)rjmaxabsrQrrrCrB)r:pathZrescaler>r>r?_set_custom_markers zMarkerStyle._set_custom_markercCs||jdSrN)rrarLr>r>r?rnrSzMarkerStyle._set_path_markercCs|t|jdSrN)rrrarLr>r>r?rmszMarkerStyle._set_verticescCs|j}t|dkr|dd}}nt|dkr |d|d}}|d}|dkr6t||_|jp3tj|_n.|dkrHt ||_|jpEtj |_n|dkr]t ||_d|_ |jpZtj |_nt d|td||_dS) Nr rrcrFzUnexpected tuple marker: r)rarPrunit_regular_polygonrBr7r miterrHunit_regular_starbevelZunit_regular_asteriskrKrsrrrrC)r:r;ZnumsidesZrotationZsymstyler>r>r?ros$     zMarkerStyle._set_tuple_markercCsddlm}|d|tjdd}t|jdkrdS|}t|j |j }t |j d|j |j d|j d||_||_d |_dS) zc Draw mathtext markers '$...$' using `.TextPath` object. Submitted by tcb r)TextPath)rrz text.usetex)ZxyrZusetexNr?F)Zmatplotlib.textrrbrYrZrPrQZ get_extentsrwidthheightr translateZxminZyminrrCrBZ_snap)r:rtextZbboxZmax_dimr>r>r?rfs  (  zMarkerStyle._set_mathtext_pathcCs||jvSrN)rX_half_fillstylesrLr>r>r? _half_fillszMarkerStyle._half_fillrcCsxtd||_tj|_|st|_ dSt |_ |_ | }|j ddddd||j d|_dS)NrrZr1r3r0r2f@)rrrCrjinfrFrrZ unit_circlerBZunit_circle_righthalfrDrXrrxrE)r:sizefsr>r>r? _set_circleszMarkerStyle._set_circlecCs|jdddS)Nr)r)rrLr>r>r? _set_pointrSzMarkerStyle._set_pointcCs$t|_tdd|_d|_dS)Ng9߿)runit_rectanglerBrrrCrFrLr>r>r? _set_pixels  zMarkerStyle._set_pixelrrg333333gɿ333333?cCstd||_d|_|s|j|_ni|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|_|jptj|_dS) Nr@r3rr r2r0rrc)rrrrCrFr_triangle_pathrB_triangle_path_u_triangle_path_l_triangle_path_d_triangle_path_rrXrDrEr7r rrH)r:ZrotskipZmpathsrr>r>r? _set_triangle-s. zMarkerStyle._set_trianglecC |ddS)NrrrrLr>r>r?_set_triangle_upK zMarkerStyle._set_triangle_upcCr)Nrr rrLr>r>r?_set_triangle_downNrzMarkerStyle._set_triangle_downcCr)NgV@rcrrLr>r>r?_set_triangle_leftQrzMarkerStyle._set_triangle_leftcCr)Ngp@rrrLr>r>r?_set_triangle_rightTrzMarkerStyle._set_triangle_rightcCstdd|_d|_|st|_n?tddgddgddgddgddgg|_tddgddgddgddgddgg|_| }dddd d |}|j ||j|_ |j pYt j|_dS) N@rrrrrrr)r2r1r3r0)rrrCrFrrrrBrDrXrrEr7r rrHr:rrr>r>r? _set_squareWs    zMarkerStyle._set_squarecCstddd|_d|_|st|_n9tddgddgddgddgg|_tddgddgddgddgg|_ | }ddddd |}|j||j|_ |j pVt j|_dS) Nr-rrrrrrr)rrrrCrFrrrrBrDrXrEr7r rrHrr>r>r? _set_diamondis "" zMarkerStyle._set_diamondcCs||jdddS)Nrr)rrCrrLr>r>r?_set_thin_diamondwzMarkerStyle._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|_ |jp{tj|_dS) Nrrr@)rrrr)rr rcrrrr rrcr3r2r0r1)rrrCrFrrrrBrQrjsqrtrXrDrEr7r rrH)r:polypathvertsyr3r2r0r1r>r>r? _set_pentagon{s$ ((   zMarkerStyle._set_pentagoncCstd|_d|_tjddd}|s||_nl|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|_ |jptj|_dS)Nrrrgŋ!r?)Z innerCirclerr rrcr)rrrCrFrrrrBrQrj concatenaterXrDrEr7r rrH)r:rrr3r2r0r1r>r>r? _set_stars","",   zMarkerStyle._set_starcCs td|_d|_td}|s||_ne|j}t t dt j d}tt | dfg|gd|dfgg}tt | dfg|dd|dfgg}t|dd}t|gd }||f||f||f||fd |\|_|_|j|_|jptj|_dS) Nrrrg@r)rrrr r)rrrrcr)rrrCrFrrrrBrQrjrcospirrXrDrEr7r rrH)r:rrr$r3r2r0r1r>r>r? _set_hexagon1s$ **   zMarkerStyle._set_hexagon1c Cstdd|_d|_td}|s||_nh|j }t ddd}}t|gd}t|dd }tt ||fg|dd| | f||fgg}tt ||fg|d d d | | fgg}||f||f||f||fd | \|_|_|j|_|jptj|_dS) Nrrrcrg?)rrrrrrrr rr)rrrrCrFrrrrBrQrjrrrXrDrEr7r rrH) r:rrr$rr3r2r0r1r>r>r? _set_hexagon2s, $    zMarkerStyle._set_hexagon2c Cstd|_d|_td}|s|jd||_nAt dd}tddgdd g| d gd|gd| g| dgddgg|_|_ | }|jdd d d d ||j d|_|jpctj|_dS)Nrrrg6@rrrrrrrr)r0r2r1r3r)rrrCrFrrrrrBrjrrDrXrxrEr7r rrH)r:rr$rr>r>r? _set_octagons$   zMarkerStyle._set_octagonrcC&td|_d|_d|_|j|_dSNrrF)rrrCrFrK_line_marker_pathrBrLr>r>r? _set_vline zMarkerStyle._set_vlinecC||jd|_dSNr)rrCrrLr>r>r? _set_hlinerzMarkerStyle._set_hlinecCs(tdd|_d|_d|_|j|_dS)NrrFrrrCrFrK_tickhoriz_pathrBrLr>r>r? _set_tickleft zMarkerStyle._set_tickleftcC(tdd|_d|_d|_|j|_dSNrFrrLr>r>r?_set_tickrightrzMarkerStyle._set_tickrightgcCrrrrrCrFrK_tickvert_pathrBrLr>r>r? _set_tickup rzMarkerStyle._set_tickupcCs(tdd|_d|_d|_|j|_dS)NrrFrrLr>r>r? _set_tickdownrzMarkerStyle._set_tickdowng?rgcCr)NrrF)rrrCrFrK _tri_pathrBrLr>r>r? _set_tri_downrzMarkerStyle._set_tri_downcCrNrrrCrrLr>r>r? _set_tri_up$rzMarkerStyle._set_tri_upcCrNrrrLr>r>r? _set_tri_left(rzMarkerStyle._set_tri_leftcCrrrrLr>r>r?_set_tri_right,rzMarkerStyle._set_tri_rightg?cCs4td|_d|_d|_|j|_|jptj |_ dSNrg@F) rrrCrFrK _caret_pathrBr7r rrHrLr>r>r?_set_caretdown2s zMarkerStyle._set_caretdowncCrrrrCrrLr>r>r? _set_caretup9rzMarkerStyle._set_caretupcCrrrrLr>r>r?_set_caretleft=rzMarkerStyle._set_caretleftcCrrrrLr>r>r?_set_caretrightArzMarkerStyle._set_caretrightgcCs||j|_dSrN)r_caret_path_baserBrLr>r>r?_set_caretdownbaseGs zMarkerStyle._set_caretdownbasecCrrrrCrrLr>r>r?_set_caretupbaseKrzMarkerStyle._set_caretupbasecCrrrrLr>r>r?_set_caretleftbaseOrzMarkerStyle._set_caretleftbasecCrrrrLr>r>r?_set_caretrightbaseSrzMarkerStyle._set_caretrightbasecCrr)rrrCrFrK _plus_pathrBrLr>r>r? _set_plus\rzMarkerStyle._set_pluscCrr)rrrCrFrK_x_pathrBrLr>r>r?_set_xgrzMarkerStyle._set_x) )r)rr)rr)rcrrcrrrrrcrrcrrrr)rr)rrr))rcrrrrrrr )rrcCvt|_d|_|jp tj|_|s|j|_ dS|j |_ |_ | }|j ddddd||j d|_dSNrrrrr)r3r0r2r1)rrCrFr7r rrHr_plus_filled_pathrB_plus_filled_path_trDrXrrxrEr:rr>r>r?_set_plus_filledt zMarkerStyle._set_plus_filled) )r)rr)rr)r rrrr rrr rrrr rrrr)rrr)rrrrrrrcCr r )rrCrFr7r rrHr_x_filled_pathrB_x_filled_path_trDrXrrxrErr>r>r? _set_x_filledrzMarkerStyle._set_x_filled)NNNNrN)r)l__name__ __module__ __qualname____doc__TICKLEFT TICKRIGHTTICKUPTICKDOWN CARETLEFT CARETRIGHTCARETUP CARETDOWN CARETLEFTBASECARETRIGHTBASE CARETUPBASE CARETDOWNBASErhZfilled_markersr[rr@rMrRrVrXr8r^r`rbr9ruryr{r|r}r~rrrrrrrnrmrorfrrrrrZ_create_closedrrrrrrrrrrrrrrrrrrrrrrrrrrrZMOVETOZLINETOrrrrrrrrrrrrrrrrrrrrjarrayr r rrrrr>r>r>r?r s      !"#.  '            r )#rrpcollections.abcrnumpyrjZ matplotlibrYr.rrrrZ transformsrrZ_enumsr r ranger r!r"r#r$r%r&r'r(r)r*r+emptyrAr r>r>r>r?s