a Sic@sXddlmZddlZddlmZmZddlZddlmZmZddl Z ddl m Z ddl Z ddl Z ddlZddlZddlmZmZddlmZdd lmZdd lmZdd lmZmZmZmZm Z m!Z!e "e#Z$d d Z%ddZ&ddZ'eddZ(GdddZ)e)Z*GdddZ+ddZ,GdddZ-d#ddZ.e.Z/dddd Z0d!d"Z1e+2dS)$) namedtupleN) lru_cachewraps) Signature Parameter)Number)_apicbook) BoundaryNorm)ScalarMappable)Path)BboxIdentityTransform TransformTransformedBboxTransformedPatchPathTransformedPathcstfdd}d|_|S)a- Decorator for Artist.draw method. Provides routines that run before and after the draw call. The before and after functions are useful for changing artist-dependent renderer attributes or making other setup function calls, such as starting and flushing a mixed-mode renderer. c srz |r:|jdkr*|js*|d|_|jd7_n|jdkrX|jrX|d|_|durl|||W|dur|||r|jd8_|jr|jr|jj r||S|r|jd8_|jrn|jrn|jj rn||n`|dur*|||rB|jd8_|jrl|jrl|jj rl||0dS)NrTrF) get_rasterizedZ _raster_depth _rasterizingZstart_rasterizingstop_rasterizingget_agg_filterZ start_filterZ stop_filterfigureZsuppressComposite)artistrendererdrawM/var/www/html/django/DPS/env/lib/python3.9/site-packages/matplotlib/artist.py draw_wrapper!sP      z)allow_rasterization..draw_wrapperT)r_supports_rasterizationrrrrrallow_rasterizations r"cstfdd}|S)z Decorator for Artist.draw method. Needed on the outermost artist, i.e. Figure, to finish up if the render is still in rasterized mode. cs0||g|Ri|}|jr,|d|_|S)NF)rr)rrargskwargsresultrrrrHs z-_finalize_rasterization..draw_wrapper)rr!rrr_finalize_rasterizationCsr&cCs|jr||j_dSN)axesstaleselfvalrrr_stale_axes_callbackRsr-_XYPairzx yc@seZdZddZdS)_UnsetcCsdS)Nzrr+rrr__repr__[sz_Unset.__repr__N)__name__ __module__ __qualname__r1rrrrr/Zsr/c@seZdZdZdZddZgdZeddZdd Z d d Z d d Z ddZ ddZ ddZeddZejddZeddZejddZdddZdddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zdd-d.Zd/d0Zd1d2Zd3d4Zd5d6Z d7d8Z!d9d:Z"d;d<Z#d=d>Z$d?d@Z%dAdBZ&dCdDZ'dEdFZ(ddGdHZ)dIdJZ*dKdLZ+dMdNZ,dOdPZ-dQdRZ.ddSdTZ/dUdVZ0dWdXZ1dYdZZ2d[d\Z3d]d^Z4d_d`Z5dadbZ6dcddZ7dedfZ8dgdhZ9didjZ:dkdlZ;dmdnZdsdtZ?dudvZ@dwdxZAdydzZBd{d|ZCd}d~ZDddZEddZFddZGddZHeddZIddZJddZKddZLddZMddZNddZOePjQddZRdddZSddZTddZUddZVddZWeeVeWZXdS)Artistz Abstract base class for objects that render into a FigureCanvas. Typically, all visible elements in a figure are subclasses of Artist. rcCs>t|jdsdSdd|_d|j_|jd|j_|dS)N_autogenerated_signaturec[stj|fi|Sr')r5setr+r$rrruz*Artist.__init_subclass__..r7z.set)hasattrr7r2r4#_update_set_signature_and_docstringclsrrr__init_subclass__is   zArtist.__init_subclass__)Z navigate_moderZ 3d_propertiescCsHttdtjgddt|D|j_d|j_dt||j_ dS)z Update the signature of the set function to list all properties as keyword arguments. Property aliases are not listed in the signature for brevity, but are still accepted as keyword arguments. r+cSs&g|]}|tjvrt|tjtdqS))default)r5_PROPERTIES_EXCLUDED_FROM_SETr KEYWORD_ONLY_UNSET).0proprrr s z>Artist._update_set_signature_and_docstring..Tzr:z$Artist.have_units..)r(anyZ _axis_mapvalues)r+axrrrrxszArtist.have_unitscCs.t|dd}|dus|jdur"|S|j|S)z Convert *x* using the unit type of the xaxis. If the artist is not contained in an Axes or if the xaxis does not have units, *x* itself is returned. r(N)getattrxaxis convert_units)r+xr}rrrconvert_xunitss zArtist.convert_xunitscCs.t|dd}|dus|jdur"|S|j|S)z Convert *y* using the unit type of the yaxis. If the artist is not contained in an Axes or if the yaxis does not have units, *y* itself is returned. r(N)r~yaxisr)r+yr}rrrconvert_yunitss zArtist.convert_yunitscCs|jS)z Any where *artist* is the calling `.Artist`. Return values may exist but are ignored. Returns ------- int The observer id associated with the callback. This id can be used for removing the callback with `.remove_callback` later. See Also -------- remove_callback rNcsSr'rrfuncr+rrr9wr:z%Artist.add_callback..)rcconnect)r+rrrr add_callback\szArtist.add_callbackcCs|j|dS)zu Remove a callback based on its observer id. See Also -------- add_callback N)rc disconnect)r+oidrrrremove_callbackyszArtist.remove_callbackcCs|jddS)z Call all of the registered callbacks. This function is triggered internally when a property is changed. See Also -------- add_callback remove_callback rNN)rcprocessr0rrrrNs zArtist.pchangedcCs|jS)z Return whether the Artist has an explicitly set transform. This is *True* after `.set_transform` has been called. )rTr0rrris_transform_setszArtist.is_transform_setcCs||_d|_|d|_dS)zk Set the artist transform. Parameters ---------- t : `.Transform` TN)rSrTrNr))r+trrr set_transformszArtist.set_transformcCsB|jdurt|_n(t|jtsszArtist.get_urlcCs ||_dS)zf Set the url for the artist. Parameters ---------- url : str Nr)r+urlrrrset_urlBszArtist.set_urlcCs|jS)zReturn the group id.rgr0rrrget_gidLszArtist.get_gidcCs ||_dS)zm Set the (group) id for the artist. Parameters ---------- gid : str Nr)r+gidrrrset_gidPszArtist.set_gidcCstjdr|jSdSdS)zP Return the snap setting. See `.set_snap` for details. z path.snapFN)rirjrhr0rrrget_snapZs zArtist.get_snapcCs||_d|_dS)a Set the snapping behavior. Snapping aligns positions with the pixel grid, which results in clearer images. For example, if a black line of 1px width was defined at a position in between two pixels, the resulting image would contain the interpolated value of that line in the pixel grid, which would be a grey value on both adjacent pixel positions. In contrast, snapping will move the line to the nearest integer pixel value, so that the resulting image will really contain a 1px wide black line. Snapping is currently only supported by the Agg and MacOSX backends. Parameters ---------- snap : bool or None Possible values: - *True*: Snap vertices to the nearest pixel center. - *False*: Do not modify vertex positions. - *None*: (auto) If the path contains only rectilinear line segments, round to the nearest pixel center. TN)rhr))r+snaprrrset_snapeszArtist.set_snapcCs|jS)a Return the sketch parameters for the artist. Returns ------- tuple or None A 3-tuple with the following elements: - *scale*: The amplitude of the wiggle perpendicular to the source line. - *length*: The length of the wiggle along the line. - *randomness*: The scale factor by which the length is shrunken or expanded. Returns *None* if no sketch parameters were set. )rkr0rrrget_sketch_paramsszArtist.get_sketch_paramscCs.|durd|_n||pd|pdf|_d|_dS)a Set the sketch parameters. Parameters ---------- scale : float, optional The amplitude of the wiggle perpendicular to the source line, in pixels. If scale is `None`, or not provided, no sketch filter will be provided. length : float, optional The length of the wiggle along the line, in pixels (default 128.0) randomness : float, optional The scale factor by which the length is shrunken or expanded (default 16.0) The PGF backend uses this argument as an RNG seed and not as described above. Using the same seed yields the same random shape. .. ACCEPTS: (scale: float, length: float, randomness: float) Ng`@g0@T)rkr))r+scalelength randomnessrrrset_sketch_paramsszArtist.set_sketch_paramscCs||_d|_dS)z{ Set the path effects. Parameters ---------- path_effects : `.AbstractPathEffect` TN)rlr))r+Z path_effectsrrrset_path_effectsszArtist.set_path_effectscCs|jSr')rlr0rrrget_path_effectsszArtist.get_path_effectscCs|jS)z4Return the `.Figure` instance the artist belongs to.)rr0rrr get_figureszArtist.get_figurecCsH|j|urdS|jdur td||_|jr>|j|ur>|d|_dS)z Set the `.Figure` instance the artist belongs to. Parameters ---------- fig : `.Figure` Nz1Can not put single artist in more than one figureT)r RuntimeErrorrNr))r+figrrr set_figures  zArtist.set_figurecCs||_|d|_dS)zq Set the artist's clip `.Bbox`. Parameters ---------- clipbox : `.Bbox` TN)rXrNr))r+rXrrr set_clip_boxszArtist.set_clip_boxcCsddlm}m}d}|durrt||rFtt||_d|_ d}n,t||r`t ||_ d}nt|t rr|\}}|durd|_ d}nFt|t rt |||_ d}n*t|t r||_ d}nt|t r||_ d}|stdt|jt|j|d|_dS)a Set the artist's clip path. Parameters ---------- path : `.Patch` or `.Path` or `.TransformedPath` or None The clip path. If given a `.Path`, *transform* must be provided as well. If *None*, a previously set clip path is removed. transform : `~matplotlib.transforms.Transform`, optional Only used if *path* is a `.Path`, in which case the given `.Path` is converted to a `.TransformedPath` using *transform*. Notes ----- For efficiency, if *path* is a `.Rectangle` this method will set the clipping box to the corresponding rectangle and set the clipping path to ``None``. For technical reasons (support of `~.Artist.set`), a tuple (*path*, *transform*) is also accepted as a single positional parameter. .. ACCEPTS: Patch or (Path, Transform) or None r)Patch RectangleFNTz5Invalid arguments to set_clip_path, of type {} and {})matplotlib.patchesrrrrrunitrrXrYrtupler r TypeErrorformatr_r2rNr))r+path transformrrsuccessrrr set_clip_pathsD        zArtist.set_clip_pathcCs|jS)zc Return the alpha value used for blending - not supported on all backends. )rWr0rrr get_alpha%szArtist.get_alphacCs|jS)zReturn the visibility.)rUr0rrr get_visible,szArtist.get_visiblecCs|jS)z&Return whether the artist is animated.)rVr0rrrr0szArtist.get_animatedcCs|jS)a Return boolean flag, ``True`` if artist is included in layout calculations. E.g. :doc:`/tutorials/intermediate/constrainedlayout_guide`, `.Figure.tight_layout()`, and ``fig.savefig(fname, bbox_inches='tight')``. rnr0rrr get_in_layout4s zArtist.get_in_layoutcCsp|}|}|jduon|on|dus2|duon|dusPt|j|jjjkon|dupnt|t on|j |jj uS)at Return a boolean flag, ``True`` if the artist is clipped to the Axes and can thus be skipped in layout calculations. Requires `get_clip_on` is True, one of `clip_box` or `clip_path` is set, ``clip_box.extents`` is equivalent to ``ax.bbox.extents`` (if set), and ``clip_path._patch`` is equivalent to ``ax.patch`` (if set). N) rrr(rnpallextentsrrr_patchpatch)r+rrrrr_fully_clipped_to_axes?s    zArtist._fully_clipped_to_axescCs|jS)z(Return whether the artist uses clipping.)rZr0rrrrWszArtist.get_clip_oncCs|jS)zReturn the clipbox.)rXr0rrrr[szArtist.get_clip_boxcCs|jS)zReturn the clip path.)rYr0rrrr_szArtist.get_clip_pathcCs|jdur|jSdS)z Return the clip path with the non-affine part of its transformation applied, and the remaining affine part of its transformation. N)NN)rYget_transformed_path_and_affiner0rrr$get_transformed_clip_path_and_affinecs  z+Artist.get_transformed_clip_path_and_affinecCs||_|d|_dS)z Set whether the artist uses clipping. When False artists will be visible outside of the Axes which can lead to unexpected results. Parameters ---------- b : bool TN)rZrNr)r+brrr set_clip_onms zArtist.set_clip_oncCsB|jr*|jdur||j||jn|d|ddS)z!Set the clip properly for the gc.N)rZrXZset_clip_rectanglerrY)r+gcrrr _set_gc_clip~s    zArtist._set_gc_clipcCs|jS)z.Return whether the artist is to be rasterized.)r]r0rrrrszArtist.get_rasterizedcCs,|r"t|jds"td|d||_dS)a Force rasterized (bitmap) drawing for vector graphics output. Rasterized drawing is not supported by all artists. If you try to enable this on an artist that does not support it, the command has no effect and a warning will be issued. This setting is ignored for pixel-based output. See also :doc:`/gallery/misc/rasterization_demo`. Parameters ---------- rasterized : bool r zRasterization of 'z' will be ignoredN)r;rr warn_externalr])r+Z rasterizedrrrset_rasterizedszArtist.set_rasterizedcCs|jS)z1Return filter function to be used for agg filter.)r^r0rrrrszArtist.get_agg_filtercCs||_d|_dS)a Set the agg filter. Parameters ---------- filter_func : callable A filter function, which takes a (m, n, depth) float array and a dpi value, and returns a (m, n, depth) array and two offsets from the bottom left corner of the image .. ACCEPTS: a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array and two offsets from the bottom left corner of the image TN)r^r))r+ filter_funcrrrset_agg_filterszArtist.set_agg_filtercCs|s dSd|_dS)ac Draw the Artist (and its children) using the given renderer. This has no effect if the artist is not visible (`.Artist.get_visible` returns False). Parameters ---------- renderer : `.RendererBase` subclass. Notes ----- This method is overridden in the Artist subclasses. NF)rr)rrrrrsz Artist.drawcCsj|dur$t|ts$tdt||durRd|kr@dksRntd|d||_|d|_dS)z Set the alpha value used for blending - not supported on all backends. Parameters ---------- alpha : scalar or None *alpha* must be within the 0-1 range, inclusive. Nz#alpha must be numeric or None, not rrzalpha (z) is outside 0-1 rangeT)rrrr_rrWrNr)r+alpharrr set_alphas  zArtist.set_alphacCst|trtdt|s,t||dSt|}d|krN| dksjt d|d| ||_ | d|_ dS)a" Set the alpha value used for blending - not supported on all backends. Parameters ---------- alpha : array-like or scalar or None All values must be within the 0-1 range, inclusive. Masked values and nans are not supported. z+alpha must be numeric or None, not a stringNrrz5alpha must be between 0 and 1, inclusive, but min is z , max is T)rstrrriterabler5rasarrayminmaxrrWrNr)rrrr_set_alpha_for_arrays    zArtist._set_alpha_for_arraycCs||_|d|_dS)zf Set the artist's visibility. Parameters ---------- b : bool TN)rUrNr)rrrr set_visibleszArtist.set_visiblecCs|j|kr||_|dS)a Set whether the artist is intended to be used in an animation. If True, the artist is excluded from regular drawing of the figure. You have to call `.Figure.draw_artist` / `.Axes.draw_artist` explicitly on the artist. This approach is used to speed up animations using blitting. See also `matplotlib.animation` and :doc:`/tutorials/advanced/blitting`. Parameters ---------- b : bool N)rVrNrrrr set_animateds zArtist.set_animatedcCs ||_dS)a) Set if artist is to be included in layout calculations, E.g. :doc:`/tutorials/intermediate/constrainedlayout_guide`, `.Figure.tight_layout()`, and ``fig.savefig(fname, bbox_inches='tight')``. Parameters ---------- in_layout : bool Nr)r+Z in_layoutrrr set_in_layouts zArtist.set_in_layoutcCs|jS)z4Return the label used for this artist in the legend.)r[r0rrr get_label szArtist.get_labelcCs,|durt||_nd|_|d|_dS)z Set a label that will be displayed in the legend. Parameters ---------- s : object *s* will be converted to a string by calling `str`. NT)rr[rNr))r+srrr set_label$s  zArtist.set_labelcCs|jS)zReturn the artist's zorder.)zorderr0rrr get_zorder4szArtist.get_zordercCs(|dur|jj}||_|d|_dS)z Set the zorder for the artist. Artists with lower zorder values are drawn first. Parameters ---------- level : float NT)rrrNr))r+levelrrr set_zorder8s zArtist.set_zordercCs|jS)a ``x`` and ``y`` sticky edge lists for autoscaling. When performing autoscaling, if a data limit coincides with a value in the corresponding sticky_edges list, then no margin will be added--the view limit "sticks" to the edge. A typical use case is histograms, where one usually expects no margin on the bottom edge (0) of the histogram. Moreover, margin expansion "bumps" against sticky edges and cannot cross them. For example, if the upper data limit is 1.0, the upper view limit computed by simple margin application is 1.2, but there is a sticky edge at 1.1, then the actual upper view limit will be 1.1. This attribute cannot be assigned to; however, the ``x`` and ``y`` lists can be modified in place as needed. Examples -------- >>> artist.sticky_edges.x[:] = (xmin, xmax) >>> artist.sticky_edges.y[:] = (ymin, ymax) )rmr0rrr sticky_edgesGszArtist.sticky_edgescCs|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j|_|j |_ |j j |j j dd<|j j |j j dd<|d|_dS)z'Copy properties from *other* to *self*.NT)rSrTrUrWrXrZrYr[rkrlrrrqrrNr))r+otherrrr update_frombszArtist.update_fromcCs t|S)z8Return a dictionary of all the properties of the artist.)rH propertiesr0rrrrsszArtist.propertiescCsg}tj|dd||D]b\}}|dkr@|t|||qt|d|d}t|spt|jt ||d|||qWdn1s0Y|r| d|_ |S)z Helper for `.Artist.set` and `.Artist.update`. *errfmt* is used to generate error messages for invalid property names; it get formatted with ``type(self)`` and the property name. F)Zeventsonr(set_N)r>Z prop_nameT) r _setattr_cmitemsappendsetattrr~rrdrr_rNr))r+propsZerrfmtretkvrrrr _update_propsws.zArtist._update_propscCs ||dS)z Update this artist's properties from the dict *props*. Parameters ---------- props : dict z5{cls.__name__!r} object has no property {prop_name!r}r)r+r rrrupdatesz Artist.updatecCs ||dS)z Update artist properties without prenormalizing them, but generating errors as if calling `set`. The lack of prenormalization is to maintain backcompatibility. zE{cls.__name__}.set() got an unexpected keyword argument {prop_name!r}rr8rrr_internal_updateszArtist._internal_updatecKs|t||Sr')rr normalize_kwargsr8rrrr7sz Artist.setc +sTfdd|D}z*jfi|dVWjfi|njfi|0dS)zV `.Artist.set` context-manager that restores original values at exit. cs i|]}|td|qSget_)r~)rDr r0rr r:z"Artist._cm_set..Nr7)r+r$Z orig_valsrr0r_cm_sets zArtist._cm_setTcsdurddn8ttr4ttr4fddntrBntdtfdd|Dg}|r||r||||S)a Find artist objects. Recursively find all `.Artist` instances contained in the artist. Parameters ---------- match A filter criterion for the matches. This can be - *None*: Return all objects contained in artist. - A function with signature ``def match(artist: Artist) -> bool``. The result will only contain artists for which the function returns *True*. - A class instance: e.g., `.Line2D`. The result will only contain artists of this class or its subclasses (``isinstance`` check). include_self : bool Include *self* in the list to be checked for a match. Returns ------- list of `.Artist` NcSsdS)NTrrrrr matchfuncsz!Artist.findobj..matchfunccs t|Sr')rr)matchrrrszFmatch must be None, a matplotlib.artist.Artist subclass, or a callablecsg|]}|qSr)findobj)rDc)rrrrFr:z"Artist.findobj..) rr_ issubclassr5rrsumrr )r+r include_selfartistsr)rrrrs   zArtist.findobjcCsdS)a Return the cursor data for a given event. .. note:: This method is intended to be overridden by artist subclasses. As an end-user of Matplotlib you will most likely not call this method yourself. Cursor data can be used by Artists to provide additional context information for a given event. The default implementation just returns *None*. Subclasses can override the method and return arbitrary data. However, when doing so, they must ensure that `.format_cursor_data` can convert the data to a string representation. The only current use case is displaying the z-value of an `.AxesImage` in the status bar of a plot window, while moving the mouse. Parameters ---------- event : `matplotlib.backend_bases.MouseEvent` See Also -------- format_cursor_data Nr)r+eventrrrr`szArtist.get_cursor_datac Cs:t|dkrt|tr|jj}tj|r0dS||}t |rt|jt rt t |jj |}td|d}t|jj ||d}n6|jt||tddg|}t ||}t||}nd}d||Sz |dWnttfy|g}Yn0ddd |D} d | d Sd S) ac Return a string representation of *data*. .. note:: This method is intended to be overridden by artist subclasses. As an end-user of Matplotlib you will most likely not call this method yourself. The default implementation converts ints and floats and arrays of ints and floats into a comma-separated string enclosed in square brackets, unless the artist has an associated colorbar, in which case scalar values are formatted using the colorbar's formatter. See Also -------- get_cursor_data rz[]rz [{:-#.{}g}]z, css"|]}t|trd|VqdS)z{:0.3g}N)rrr)rDitemrrrrz6s z,Artist.format_cursor_data..[]N)rndimrr cmapNmagetmasknormisfiniter argminabs boundariesrdiffinverseintarrayr _g_sig_digitsrr IndexErrorjoin) r+datannormedcur_idxZ neigh_idxdeltaZ neighborsZ g_sig_digitsdata_strrrrformat_cursor_datas2        zArtist.format_cursor_datacCs|jS)z Return whether this artist is queried for custom context information when the mouse cursor moves over it. )rar0rrr get_mouseover:szArtist.get_mouseovercCs8t||_|j}|r4|jr(|j|n |j|dS)a3 Set whether this artist is queried for custom context information when the mouse cursor moves over it. Parameters ---------- mouseover : bool See Also -------- get_cursor_data .ToolCursorPosition .NavigationToolbar2 N)boolrar(rtaddru)r+ mouseoverr}rrr set_mouseoverAs  zArtist.set_mouseover)N)N)N)NNN)N)NT)Yr2r3r4rLrr?rA classmethodr<rorsrwrxrrpropertyr(setterr)rrrrrNrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr7 contextlibcontextmanagerrrr`r?r@rDrCrrrrr5`s $+             %#       >         +8r5cOsFz|j|ii|ddiWSty@|j|i|YS0dS)z Matplotlib's `.Axes.get_tightbbox` and `.Axis.get_tightbbox` support a *for_layout_only* kwarg; this helper tries to uses the kwarg but skips it when encountering third-party subclasses that do not support it. Zfor_layout_onlyTN)rr)objr#r$rrr_get_tightbbox_for_layout_only[s rKc@seZdZdZddZddZedZddZ d d Z d d Z e e d dddZe e d dddZddZhdZddZd"ddZd#ddZddZd d!Zd S)$rHz A helper class to inspect an `~matplotlib.artist.Artist` and return information about its settable properties and their current values. cCsXt|ts,t|r,t|}t|r,|d}||_t|tsDt|}||_| |_ dS)a Initialize the artist inspector with an `Artist` or an iterable of `Artist`\s. If an iterable is used, we assume it is a homogeneous sequence (all `Artist`\s are of the same type) and it is your responsibility to make sure this is so. rN) rr5rrlistlenoorigr_o get_aliasesaliasd)r+rOrrrroms   zArtistInspector.__init__csfddtjD}i}|D]f}tj|}|s.z`({}.*)`Nr) dirrOr~is_aliasresearchrinspectgetdocgroup setdefaultr7rB)r+namesaliasesrTrZpropnamerr0rrPs   &zArtistInspector.get_aliasesz6\n\s*(?:\.\.\s+)?ACCEPTS:\s*((?:.|\n)*?)(?:$|(?:\n\n))cCsd|}t|j|s&td|j|ft|j|}t|}|durHdS|drVdS|j|}|dur~t dd| dS|j j d}t d ||}|r| dSdS) a/ Get the legal arguments for the setter associated with *attr*. This is done by querying the docstring of the setter for a line that begins with "ACCEPTS:" or ".. ACCEPTS:", and then by looking for a numpydoc-style documentation for the setter's first argument. zset_%sz%s has no function %sNunknown Alias for z * rz(?m)^ *\*?{} : (.+))r;rOrdr~rZr[rR_get_valid_values_regexrYrXsubr\__code__ co_varnamesr)r+attrrTr docstringr param_namerrrget_valid_valuess"        z ArtistInspector.get_valid_valuescCs,ddd}|D]\}}|||}q|S)z Changes the full path to the public API path that is used in sphinx. This is needed for links to work. Axes)_base._AxesBase _axes.Axes)rreplace)r+Z source_class replace_dictkeyvaluerrr _replace_paths zArtistInspector._replace_pathcCsdg}t|jD]P}|dsqt|j|}t|r||dks||rLq||ddq|S)z Get the attribute strings with setters for object. For example, for a line, return ``['markerfacecolor', 'linewidth', ....]``. rr#rUN)rVrOrRr~rnumber_of_parametersrWr )r+ZsettersrTrrrrrIs   zArtistInspector.get_settersN)maxsizecCstt|jS)z3Return number of parameters of the callable *func*.)rMrZ signature parameters)rrrrrssz$ArtistInspector.number_of_parameterscCs t|}|durdS|dS)zT Return whether the object *method* is an alias for another method. NFra)rZr[rR)methoddsrrrrWs zArtistInspector.is_aliascCs*dddt|j|gD}||S)a Return 'PROPNAME or alias' if *s* has an alias, else return 'PROPNAME'. e.g., for the line markerfacecolor property, which has an alias, return 'markerfacecolor or mfc' and for the transform property, which does not, return 'transform'. rMcss|]}d|VqdSz or %sNrrDrrrrrzr:z/ArtistInspector.aliased_name..)r8sortedrQget)r+rr_rrr aliased_names"zArtistInspector.aliased_name> z3matplotlib.text._AnnotationBase.set_annotation_clipz)matplotlib.image._ImageBase.set_filterradz%matplotlib.image._ImageBase.set_alphaz$matplotlib.image._ImageBase.set_dataz(matplotlib.image._ImageBase.set_resamplez3matplotlib.image._ImageBase.set_interpolation_stagez*matplotlib.image._ImageBase.set_filternormz%matplotlib.image._ImageBase.set_arrayz-matplotlib.image._ImageBase.set_interpolationcCsF||jvrd|dSdddt|j|gD}d|||fS)a3 Return 'PROPNAME or alias' if *s* has an alias, else return 'PROPNAME', formatted for reST. e.g., for the line markerfacecolor property, which has an alias, return 'markerfacecolor or mfc' and for the transform property, which does not, return 'transform'. z``rMcss|]}d|VqdSryrrzrrrrzr:z4ArtistInspector.aliased_name_rest..z:meth:`%s <%s>`%s) _NOT_LINKABLEr8r{rQr|)r+rtargetr_rrraliased_name_rest s  "z!ArtistInspector.aliased_name_restr#cCst|rd|}nd}|dur2||}d|||fSg}t|D],}||}||}|d|||fqB|S)a If *prop* is *None*, return a list of strings of all settable properties and their valid values. If *prop* is not *None*, it is a valid property name and that property will be returned as a string of property : valid values. rbrMN%s%s: %s)rjr{rIr}r )r+rE leadingspacepadacceptslinesrTrrrpprint_setterss     zArtistInspector.pprint_settersrUc sf|rd|nd|dur2|}d||fSg}tD]d}jjD](}t|d|d}|rN|jdurNqqNtjd|}|||jd|j fqBfdd|D}fd d|D}t d d |Dt d d |Dd dd d}dddd|d d d d |gfddt ||D|dS)a$ If *prop* is *None*, return a list of reST-formatted strings of all settable properties and their valid values. If *prop* is not *None*, it is a valid property name and that property will be returned as a string of "property : valid" values. rbrMNrr.cs,g|]$\}}||ddddqS)rlrkrm)rrn)rDrErr0rrrFRs  z7ArtistInspector.pprint_setters_rest..csg|]\}}|qSr)rj)rDrE_r0rrrFVscss|]}t|VqdSr'rM)rDr:rrrrzYr:z6ArtistInspector.pprint_setters_rest..css|]}t|VqdSr'r)rDrrrrrzZr: =z .. table::z :class: property-tableProperty Descriptioncs0g|](\}}d|d|qS)r)ljust)rDr:r)col0_lencol1_lenrrrrFfs) rjr{rIrO__mro__r~rLr r3r4rrzip) r+rErrZprop_and_qualnamesr>rwr^Ztable_formatstrr)rrrr+rpprint_setters_rest5sZ         z#ArtistInspector.pprint_setters_restc s|jfddtD}|i}|D]~}t|}||rFq,z value.cs(g|] }|drtt|r|qSr)rRrr~rSrOrrrFosz.ArtistInspector.properties..ignoreNrU) rNrVsortr~rWwarningscatch_warnings simplefilter Exception)r+ZgettersrrrTrr,rrrrls     (  zArtistInspector.propertiescCsg}t|D]\}}t|dddkrNt|dkrNt|ddd}nt|}|dd}t|dkr~|ddd}||}|d ||fq|S) z8Return the getters and actual values as list of strings.shaperNz... rb2z %s = %s) r{rrr~rMrrnr}r )r+rrTr,rrrrpprint_getterss   zArtistInspector.pprint_getters)Nr#)NrU)r2r3r4rLrorPrXcompilercrjrrrI staticmethodrrsrWr}r~rrrrrrrrrrHgs,$      7rHcCs:|dur*t|}|}td|dSt|d|S)a Return the value of an `.Artist`'s *property*, or print all of them. Parameters ---------- obj : `.Artist` The queried artist; e.g., a `.Line2D`, a `.Text`, or an `~.axes.Axes`. property : str or None, default: None If *property* is 'somename', this function returns ``obj.get_somename()``. If it's None (or unset), it *prints* all gettable properties from *obj*. Many properties have aliases for shorter typing, e.g. 'lw' is an alias for 'linewidth'. In the output, aliases and full property names will be listed as: property or alias = value e.g.: linewidth or lw = 2 See Also -------- setp Nrr)rHrprintr8r~)rJrFinspr rrrgetps rfilecst|tr|g}ntt|}|s(dSt|d}s|t|dkr||rbt|j|dd|dntd ||ddSt|drt dt t |ddd|dddfd d |Dfd d |D}tt|S) a Set one or more properties on an `.Artist`, or list allowed values. Parameters ---------- obj : `.Artist` or list of `.Artist` The artist(s) whose properties are being set or queried. When setting properties, all artists are affected; when querying the allowed values, only the first instance in the sequence is queried. For example, two lines can be made thicker and red with a single call: >>> x = arange(0, 1, 0.01) >>> lines = plot(x, sin(2*pi*x), x, sin(4*pi*x)) >>> setp(lines, linewidth=2, color='r') file : file-like, default: `sys.stdout` Where `setp` writes its output when asked to list allowed values. >>> with open('output.log') as file: ... setp(line, file=file) The default, ``None``, means `sys.stdout`. *args, **kwargs The properties to set. The following combinations are supported: - Set the linestyle of a line to be dashed: >>> line, = plot([1, 2, 3]) >>> setp(line, linestyle='--') - Set multiple properties at once: >>> setp(line, linewidth=2, color='r') - List allowed values for a line's linestyle: >>> setp(line, 'linestyle') linestyle: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...} - List all properties that can be set, and their allowed values: >>> setp(line) agg_filter: a filter function, ... [long output listing omitted] `setp` also supports MATLAB style string/value pairs. For example, the following are equivalent: >>> setp(lines, 'linewidth', 2, 'color', 'r') # MATLAB style >>> setp(lines, linewidth=2, color='r') # Python style See Also -------- getp Nrr#)rErrz(The set args must be string, value pairsrcsg|]}|qSr)rrDrO)funcvalsrrrFr:zsetp..csg|]}|jfiqSrrr)r$rrrFr:) rr5rLr flattenrHrMrrr8rdictr)rJrr#r$objsrr r)rr$rsetps ;   "$rcCs:t|}tjdr$d|jddSdd|jddS)a Inspect an `~matplotlib.artist.Artist` class (using `.ArtistInspector`) and return information about its settable properties and their current values. Parameters ---------- artist : `~matplotlib.artist.Artist` or an iterable of `Artist`\s Returns ------- str The settable properties of *artist*, as plain text if :rc:`docstring.hardcopy` is False and as a rst table (intended for use in Sphinx) if it is True. zdocstring.hardcopyrrU)rz Properties: )rHrirjr8rr)rairrrrK s rK)N)3 collectionsrrH functoolsrrrZrrloggingnumbersrrXrnumpyr matplotlibrirMr r colorsr cmr rr transformsrrrrrr getLoggerr2rr"r&r-r.r/rCr5rKrHrr|rrKr<rrrrsT       +  , $T