a Sic>n@sdZddlZddlZddlZddlZddlZddlmZddlm Z m Z ddl Z ddl ZddlZddlmZddlmZddlmZddlmZdd lmZgd Zd d Zd dZddZddZ ddZ!ddZ"dFddZ#ddZ$ddZ%ddZ&dGd!d"Z'd#d$Z(d%d&Z)dHd(d)Z*d*d+Z+dId,d-Z,dJd.d/Z-d0d1Z.d2d3Z/d4d5Z0d6d7Z1d8d9Z2d:d;Z3dd?Z5d@dAZ6dBdCZ7edDdEZ8dS)Kz+Utility functions, mostly for internal use.N)contextmanager)urlopen urlretrieve)to_rgb)normalize_kwargs)Version)user_cache_dir) desaturatesaturateset_hls_values move_legenddespineget_dataset_names get_data_home load_datasetc Csrt|dd}t|}g}tt|D]2\}\}}||}||}||}|||gq.t|j}|S)aConvert intervals to error arguments relative to plot heights. Parameters ---------- cis : 2 x n sequence sequence of confidence interval limits heights : n sequence sequence of plot heights Returns ------- errsize : 2 x n array sequence of error size relative to height values in correct format as argument for plt.bar ) np atleast_2dreshape atleast_1d enumerate transposeappendasarrayT) ZcisheightsZerrsizeilowhighhZelowZehighr"I/var/www/html/django/DPS/env/lib/python3.9/site-packages/seaborn/utils.py ci_to_errsizes  r$c Cspzddlm}t|j}WnHtyfzddlm}|j}Wnty`d}t |Yn0Yn0||S)z Compute the quantile function of the standard normal distribution. This wrapper exists because we are dropping scipy as a mandatory dependency but statistics.NormalDist was added to the standard library in 3.8. r) NormalDist)normzFStandard normal quantile functions require either Python>=3.8 or scipy) statisticsr%r vectorizeZinv_cdf ImportError scipy.statsr&Zppf RuntimeError)qr%Zqfr&msgr"r"r#_normal_quantile_func6s     r.cCs<|j|jr8z||jWnty6Yn0dS)z>Force draw of a matplotlib figure, accounting for back-compat.N)canvasdrawstale get_rendererAttributeError)figr"r"r# _draw_figureMs   r5c s|dur dS|dur|S|jdkr^ttjjd}|ggdd|d\}|}|nf|jdkrtfddd D}t |t j }}|||fi}| }t |sd} nt j|d d jd d k} d vr| rt|d }|n|jdkr0|t j gt j gfi\}t|}|n|jdkr|j} tt| jjtjjt| jjtjjg} ttjtdkr| rdSttjj|ggfi}|} t| d }||S)zFIf needed, get a default color by using the matplotlib property cycle.NplotcolorF)scalexscaleyr7scatterc3s&|]}t|gjdVqdS)rN)rrgetshape).0keykwsr"r# psz!_default_color..)scfc facecolor facecolorsr)axisrrCbar fill_betweenz3.3C0)__name___normalize_kwargsmpllinesLine2Dr; get_colorremovemaxrfullnanget_facecolorslenuniquer<r get_facecolor__self__any isinstancexaxis converterdates DateConverteryaxisr __version__ collectionsPolyCollection) methodhuer7r@ZscoutZ scout_sizeZscout_xZscout_yrFZ single_coloraxZ datetime_axisrEr"r?r#_default_colorXsP            rgcCsPd|krdksntdt|}tj|\}}}||9}t|||}|S)alDecrease the saturation channel of a color by some percent. Parameters ---------- color : matplotlib color hex, rgb-tuple, or html color name prop : float saturation channel of color will be multiplied by this value Returns ------- new_color : rgb tuple desaturated color code in RGB tuple representation rrzprop must be between 0 and 1) ValueErrorrcolorsys rgb_to_hls hls_to_rgb)r7proprgbr!lrB new_colorr"r"r#r sr cCs t|ddS)a Return a fully saturated color with the same hue. Parameters ---------- color : matplotlib color hex, rgb-tuple, or html color name Returns ------- new_color : rgb tuple saturated color code in RGB tuple representation r)rB)r )r7r"r"r#r sr cCsLt|}ttj|}t|||gD]\}}|dur$|||<q$tj|}|S)anIndependently manipulate the h, l, or s channels of a color. Parameters ---------- color : matplotlib color hex, rgb-tuple, or html color name h, l, s : floats between 0 and 1, or None new values for each channel in hls space Returns ------- new_color : rgb tuple new color code in RGB tuple representation N)rlistrirjrrk)r7r!rnrBrmvalsrvalr"r"r#r s  r cKs@d}t|tt}|j|fi||j|fi|dS)z[Grab current axis and label it. DEPRECATED: will be removed in a future version. zCThis function is deprecated and will be removed in a future versionN)warningswarn FutureWarningpltgca set_xlabel set_ylabel)xlabelylabelkwargsr-rfr"r"r#axlabels  r}cCs|t|S)aGHelper method for removing null values from data vectors. Parameters ---------- vector : vector object Must implement boolean masking with [] subscript syntax. Returns ------- clean_clean : same type as ``vector`` Vector of data with null values removed. May be a copy or a view. )pdnotnull)vectorr"r"r# remove_nasrcCs&tjd}d|jvr |dSdgS)a Return the list of colors in the current matplotlib color cycle Parameters ---------- None Returns ------- colors : list List of matplotlib colors in the current cycle, or dark gray if the current color cycle is empty. zaxes.prop_cycler7z.15)rMrcParamskeysby_key)cyclerr"r"r#get_color_cycles rTFc Cs|dur|durtj}n|dur,|j}n|dur:|g}|D]} dD]h} t|  } | j| | |durH| rHz|| d} Wnty|} Yn0| j| d| fqH|r,|s,t dd| j j D} t dd| j j D}| j d| j j D]}|j| q| j j D]}|j|q|r|st d d| jj D} t d d| jj D}| j d | jj D]}|j| qx| jj D]}|j|q|r>t| }|jrDt|t| k|d}t|t| k|d }| jd ||| jd |||||k}|||k}| |t| }|jr>t|t| k|d}t|t| k|d }| jd||| jd|||||k}|||k}| |q>dS)a Remove the top and right spines from plot(s). fig : matplotlib figure, optional Figure to despine all axes of, defaults to the current figure. ax : matplotlib axes, optional Specific axes object to despine. Ignored if fig is provided. top, right, left, bottom : boolean, optional If True, remove that spine. offset : int or dict, optional Absolute distance, in points, spines should be moved away from the axes (negative values move spines inward). A single value applies to all spines; a dict can be used to set offset values per side. trim : bool, optional If True, limit spines to the smallest and largest major tick on each non-despined axis. Returns ------- None N)toprightleftbottomroutwardcss|]}|jVqdSN tick1line get_visibler=tr"r"r#rATszdespine..css|]}|jVqdSrrrr"r"r#rAXsrcss|]}|jVqdSrrrr"r"r#rAcscss|]}|jVqdSrrrr"r"r#rAgsrrrr)rvgcfaxeslocalsspines set_visibler;r3 set_positionrZr` majorTicks minorTicksset_ticks_position tick2liner\rr get_xtickssizecompressminget_xlimrR set_bounds set_xticks get_yticksget_ylim set_yticks)r4rfrrrroffsettrimrZax_isideZ is_visiblerrZmaj_onZmin_onrxticksZ firsttickZlasttickZnewticksyticksr"r"r#r&s               rc sddlm}t||r&|j}|jj}nTt|tjjrB|j}|j}n8t|tjj rn|j rb|j d}nd}|j}n d}t ||dur|d}t ||j }dd|D}ttjjjfd d |D} | d | d } d |vr| |d d d |D} | D]0\} } | jfi| dd| i|| q|d|j| |||||fd|i| }|| | t||r||_ dS)a< Recreate a plot's legend at a new location. The name is a slight misnomer. Matplotlib legends do not expose public control over their position parameters. So this function creates a new legend, copying over the data from the original object, which is then removed. Parameters ---------- obj : the object with the plot This argument can be either a seaborn or matplotlib object: - :class:`seaborn.FacetGrid` or :class:`seaborn.PairGrid` - :class:`matplotlib.axes.Axes` or :class:`matplotlib.figure.Figure` loc : str or int Location argument, as in :meth:`matplotlib.axes.Axes.legend`. kwargs Other keyword arguments are passed to :meth:`matplotlib.axes.Axes.legend`. Examples -------- .. include:: ../docstrings/move_legend.rst r)GridrNzC`obj` must be a seaborn Grid or matplotlib Axes or Figure instance.z has no legend attached.cSsg|] }|qSr")get_textrr"r"r# zmove_legend..csi|]\}}|vr||qSr"r"r=kvZ legend_kwsr"r# rzmove_legend..bbox_to_anchortitlecSs i|]\}}|dr||qS)Ztitle_) startswithrr"r"r#rrframeonloc)!Zseaborn.axisgridrr[legendfigurerMrAxeslegend_Figurelegends TypeErrorrh legendHandles get_textsinspect signatureLegend parameters propertiesitemspopset_textset setdefault legendPatchrupdaterQ set_titlerget_fontproperties_legend)objrr|rZ old_legendZ legend_funcerrhandleslabelspropsrZ title_kwargsr>rrZ new_legendr"rr#r sH          r cCsFt||||d}t||||d}t|||}|S)z0Establish support for a kernel density estimate.rr)rRrrlinspace)databwgridsizecutclipZ support_minZ support_maxsupportr"r"r# _kde_supportsr_cCs&d|dd|df}t|||S)z2Return a percentile range from an array of values.2r)r nanpercentile)awhichrGpr"r"r#cisrcCsLd}t|}|}Wdn1s*0Yd}t||}|S)zkReport available example datasets, useful for reporting issues. Requires an internet connection. z'https://github.com/mwaskom/seaborn-dataNz+/mwaskom/seaborn-data/blob/master/(\w*).csv)rreadrefindalldecode)urlresphtmlpatdatasetsr"r"r#rs  &rcCs@|durtjdtd}tj|}tj|shttps://raw.githubusercontent.com/mwaskom/seaborn-data/master/z.csv'z%' is not one of the example datasets.rNZtipsday)ZThurFriSatSunZsexZMaleZFemaletimeZLunchZDinnerZsmokerYesNoflightsmonthexercise)z1 minz15 minz30 minkind)restZwalkingrunningZdietzno fatzlow fatZtitanicclass)ZFirstSecondZThirdZdeckZABCDEFGZpenguinsZdiamondsr7)DEFGHIJZclarity)IFZVVS1ZVVS2ZVS1ZVS2ZSI1ZSI2ZI1r)ZIdealZPremiumz Very GoodZGoodZFairZtaxispickupZdropoffZseaiceDateZdowjones)r[r~ DataFramerrrjoinrbasenamerrrhrread_csvilocisnullall CategoricalstrrWrpr to_datetime) namecacherr@rr cache_path full_pathdfmonthsr"r"r#rsf#                 rcsP|sdSz.dd|DfddD}t|dkWStyJYdS0dS)zReturn a boolean for whether the list of ticklabels have overlaps. Parameters ---------- labels : list of matplotlib ticklabels Returns ------- overlap : boolean True if any of the labels overlap. FcSsg|] }|qSr")get_window_extentr=rnr"r"r#rrz+axis_ticklabels_overlap..csg|]}|qSr")count_overlaps)r=bbboxesr"r#rrrN)rRr+)roverlapsr"r&r#axis_ticklabels_overlaps  r)cCst|t|fS)zReturn booleans for whether the x and y ticklabels on an Axes overlap. Parameters ---------- ax : matplotlib Axes Returns ------- x_overlap, y_overlap : booleans True when the labels on that axis overlap. )r)get_xticklabelsget_yticklabels)rfr"r"r#axes_ticklabels_overlaps  r,cs|j|}fdd|D}Gfddd}t|tjjrNtjn tj|_ |fdd|D}||fS)z=Return levels and formatted levels for brief numeric legends.cs(g|] }|dkr|dkr|qS)rrr"r#limitsr"r#rrz-locator_to_legend_entries..cseZdZfddZdS)z-locator_to_legend_entries..dummy_axiscsSrr")selfr-r"r#get_view_intervalsz?locator_to_legend_entries..dummy_axis.get_view_intervalN)rK __module__ __qualname__r0r"r-r"r# dummy_axissr3csg|] }|qSr"r")r=x) formatterr"r#rr) tick_valuesastyper[rMticker LogLocator LogFormatterScalarFormatterrGset_locs)locatorr.dtypeZ raw_levelsr3Zformatted_levelsr")r5r.r#locator_to_legend_entriess   r?cCsttjj|ddddf}t|dk|d|ddd}|gd}z |WStyn|YS0dS) aCalculate the relative luminance of a color according to W3C standards Parameters ---------- color : matplotlib color or sequence of matplotlib colors Hex code, rgb-tuple, or html color name. Returns ------- luminance : float(s) between 0 and 1 Nrg#?gףp= )@g)\(?gzG?g333333@)gz6?g,C?g]m{?) rMcolorscolorConverter to_rgba_arrayrwheredotitemrh)r7rmZlumr"r"r#relative_luminances "  rFcCs<t|tr|Sz|jddWSty6t|YS0dS)aReturn a string representing a Python object. Strings (i.e. type ``str``) are returned unchanged. Byte strings (i.e. type ``bytes``) are returned as UTF-8-decoded strings. For other objects, the method ``__str__()`` is called, and the result is returned as a string. Parameters ---------- obj : object Any Python object Returns ------- s : str UTF-8-decoded string representation of ``obj`` zutf-8)encodingN)r[rrr3)rr"r"r#to_utf8s   rHc CsZdgdgdgdgdgdgdgdgd gd }zt||}WntyTt||}Yn0|S) z>Wrapper for mpl.cbook.normalize_kwargs that supports <= 3.2.1.rClwlsrDecmfcmecmewms) r7 linewidth linestylerE edgecolormarkerfacecolormarkeredgecolormarkeredgewidth markersize)rr3)r@artist _alias_mapr"r"r#rLs  rLcCs,||vr(td|d|dt|ddS)z+Raise if value for param is not in options.`z` must be one of z, but z was passed.N)rhrepr)paramoptionsvaluer"r"r#_check_argument sr^cCsDt|j}t|j}|D]"}||vr||vr||j||<q|S)zBAssign default kwargs for call_func using values from source_func.)rrrdefault)r@Z call_funcZ source_funcneededdefaultsr[r"r"r#_assign_default_kwargss  rbcCstjdd}|tjjd}|D]T}|\}}|}tdd|Ds(| d|D]}|durd| |qdq(dS)z Make invisible-handle "subtitles" entries look more like titles. Note: This function is not part of the public API and may be changed or removed. zlegend.title_fontsizeNrcss|]}|VqdSr)r)r=rWr"r"r#rA4rz*adjust_legend_subtitles..) rvrr;findobjrM offsetboxVPacker get_childrenr set_widthset_size)r font_sizeZhpackershpackZ draw_area text_areartextr"r"r#adjust_legend_subtitles's   rmcCsP|dkrL|durd}n|dkr$d}nd|f}dt|d}tj|tdd|S) a Warn on usage of ci= and convert to appropriate errorbar= arg. ci was deprecated when errorbar was added in 0.12. It should not be removed completely for some time, but it can be moved out of function definitions (and extracted from kwargs) after one cycle. deprecatedNsdrz2 The `ci` parameter is deprecated. Use `errorbar=z` for the same effect. r) stacklevel)rZrsrtru)errorbarrr-r"r"r# _deprecate_ci;s rrc cs:tjd}zdtjd<dVW|tjd<n |tjd<0dS)zBContext manager for preventing rc-controlled auto-layout behavior.zfigure.autolayoutFN)rMr)orig_valr"r"r#_disable_autolayoutTs  rt)NNN)NNTTFFNF)rN)N)TN)9__doc__rrrrsri contextlibrurllib.requestrrnumpyrpandasr~ matplotlibrMmatplotlib.colorsrmatplotlib.pyplotpyplotrvZmatplotlib.cbookrZexternal.versionrZexternal.appdirsr __all__r$r.r5rgr r r r}rrrr rrrrrr)r,r?rFrHrLr^rbrmrrrtr"r"r"r#s^       P#   fZ   l