U `{j}1@sdZddlmZddlmZmZddlZddlmZm Z m Z m Z m Z m Z ddlZddlZddlmZddlmZmZddlmZdd lmZdd lmZmZmZmZmZdd l m!Z!dd l"m#Z#erdd l$m%Z%m&Z&dddddddddZ'GdddeZ(Gddde(Z)Gddde(Z*dddddZ+d d!d d"d#d$Z,d d!d d%d&d'Z-d d!d d%d(d)Z.d d!d d*d+d,Z/d dd-d.d/d0Z0dd1d2d3d4Z1dS)5z Module responsible for execution of NDFrame.describe() method. Method NDFrame.describe() delegates actual execution to function describe_ndframe(). ) annotations)ABCabstractmethodN) TYPE_CHECKINGAnyCallableHashableSequencecast) Timestamp)NDFrameTnpt)find_stack_level)validate_percentile) is_bool_dtypeis_complex_dtypeis_datetime64_any_dtypeis_numeric_dtypeis_timedelta64_dtype)concat)format_percentiles) DataFrameSeriesr str | Sequence[str] | Noneboolz#Sequence[float] | np.ndarray | None)objincludeexcludedatetime_is_numeric percentilesreturncCsRt|}|jdkr&ttd||d}nttd||||d}|j|d}tt|S)aDescribe series or dataframe. Called from pandas.core.generic.NDFrame.describe() Parameters ---------- obj: DataFrame or Series Either dataframe or series to be described. include : 'all', list-like of dtypes or None (default), optional A white list of data types to include in the result. Ignored for ``Series``. exclude : list-like of dtypes or None (default), optional, A black list of data types to omit from the result. Ignored for ``Series``. datetime_is_numeric : bool, default False Whether to treat datetime dtypes as numeric. percentiles : list-like of numbers, optional The percentiles to include in the output. All should fall between 0 and 1. The default is ``[.25, .5, .75]``, which returns the 25th, 50th, and 75th percentiles. Returns ------- Dataframe or series description. rrrr)rrrr)r)refine_percentilesndimSeriesDescriberr DataFrameDescriberdescriber )rrrrrZ describerresultr)S/var/www/html/bwave/python/venv/lib/python3.8/site-packages/pandas/core/describe.pydescribe_ndframe4s  r+c@s6eZdZdZddddddZeddd d d Zd S) NDFrameDescriberAbstractzAbstract class for describing dataframe or series. Parameters ---------- obj : Series or DataFrame Object to be described. datetime_is_numeric : bool Whether to treat datetime dtypes as numeric. zDataFrame | SeriesrNone)rrr cCs||_||_dSNr")selfrrr)r)r*__init__rsz!NDFrameDescriberAbstract.__init__Sequence[float] | np.ndarrayrr cCsdS)zDo describe either series or dataframe. Parameters ---------- percentiles : list-like of numbers The percentiles to include in the output. Nr))r/rr)r)r*r'vsz!NDFrameDescriberAbstract.describeN)__name__ __module__ __qualname____doc__r0rr'r)r)r)r*r,gs r,c@s*eZdZUdZded<dddddZdS) r%z2Class responsible for creating series description.rrr1r2cCst|j|j}||j|Sr.)select_describe_funcrr)r/r describe_funcr)r)r*r's zSeriesDescriber.describeN)r3r4r5r6__annotations__r'r)r)r)r*r%s r%csFeZdZdZddddddfdd Zd dd d d Zd dZZS)r&aClass responsible for creating dataobj description. Parameters ---------- obj : DataFrame DataFrame to be described. include : 'all', list-like of dtypes or None A white list of data types to include in the result. exclude : list-like of dtypes or None A black list of data types to omit from the result. datetime_is_numeric : bool Whether to treat datetime dtypes as numeric. rrrr-)rrrrr cs>||_||_|jdkr*|jjdkr*tdtj||ddS)Nrz+Cannot describe a DataFrame without columns)r)rrr$columnssize ValueErrorsuperr0)r/rrrr __class__r)r*r0s zDataFrameDescriber.__init__r1r2csn|}g}|D]$\}}t||j}||||qt|tfdd|Dddd}|j|_|S)Ncsg|]}|jddqS)F)copy)Zreindex.0xZ col_namesr)r* sz/DataFrameDescriber.describe..r!F)Zaxissort) _select_dataitemsr7rappendreorder_columnsrr;rA)r/rdataldesc_seriesr8dr)rEr*r's  zDataFrameDescriber.describecCs|jdkrP|jdkrPtjg}|jr,|d|jj|d}t|j dkr|j}n<|jdkrx|jdk rpd}t ||j}n|jj|j|jd}|S)zSelect columns to be described.Ndatetime)rrallz*exclude must be None when include is 'all')rr) rrnpnumberrrJrZ select_dtypeslenr;r=)r/Zdefault_includerLmsgr)r)r*rHs"   zDataFrameDescriber._select_data)r3r4r5r6r0r'rH __classcell__r)r)r?r*r&sr&zSequence[Series]zlist[Hashable])rMr cCsDg}tdd|Dtd}|D] }|D]}||kr&||q&q|S)z,Set a convenient order for rows for display.css|] }|jVqdSr.)indexrBr)r)r* sz"reorder_columns..)key)sortedrUrJ)rMnamesZ ldesc_indexesZidxnamesnamer)r)r*rKsrKrzSequence[float])rOrr cCsddlm}t|}ddddg|dg}||||g||| g}t |rrt |srt nd}||||j |d S) zDescribe series containing numerical data. Parameters ---------- series : Series Series to be described. percentiles : list-like of numbers The percentiles to include in the output. rrcountmeanstdminmaxNrXr]dtype)pandasrrr_r`rarbquantiletolistrcrrfloatr])rOrrformatted_percentiles stat_indexrPrer)r)r*describe_numeric_1ds  rl)rLpercentiles_ignoredr c Csddddg}|}t||dk}|dkrH|jd|jd}}d}ntjtj}}d}||||g}ddlm} | |||j |d S) zDescribe series containing categorical data. Parameters ---------- data : Series Series to be described. percentiles_ignored : list-like of numbers Ignored, but in place to unify interface. r_uniquetopfreqrNobjectr^rd) value_countsrUrXilocrSnanr_rfrr]) rLrmr\ objcounts count_uniquerorprer(rr)r)r*describe_categorical_1ds  rwc Csddg}|}t||dk}||g}d}|dkr|jd|jd}}|jj} |j d} t |}|j dk r| dk r| | }n | | }|dddd g7}|||t | | d t | | d g7}n |ddg7}|tjtjg7}d }dd lm} | |||j|d S)zDescribe series containing timestamp data treated as categorical. Parameters ---------- data : Series Series to be described. percentiles_ignored : list-like of numbers Ignored, but in place to unify interface. r_rnrNi8rorpfirstlast)tzrqr^rd)rrrUr_rXrsdtr{Zdropnavaluesviewr tzinfoZ tz_convertZ tz_localizerbrcrSrtrfrr]) rLrmr\rurvr(rerorpr{Zasintrr)r)r*$describe_timestamp_as_categorical_1ds2      r)rLrr cCsfddlm}t|}dddg|dg}|||g|||g}||||j dS)zDescribe series containing datetime64 dtype. Parameters ---------- data : Series Series to be described. percentiles : list-like of numbers The percentiles to include in the output. rr^r_r`rbrc)rXr]) rfrrr_r`rbrgrhrcr])rLrrrjrkrPr)r)r*describe_timestamp_1dIs  rr)rLrr cCs`t|jrtSt|rtSt|jrJ|r,tStjdt t t dt Snt|jrXtStSdS)zSelect proper function for describing series based on data type. Parameters ---------- data : Series Series to be described. datetime_is_numeric : bool Whether to treat datetime dtypes as numeric. zTreating datetime data as categorical rather than numeric in `.describe` is deprecated and will be removed in a future version of pandas. Specify `datetime_is_numeric=True` to silence this warning and adopt the future behavior now.) stacklevelN)rrerwrrlrrwarningswarn FutureWarningrinspect currentframerr)rLrr)r)r*r7as    r7z%np.ndarray[Any, np.dtype[np.float64]]r2cCsv|dkrtdddgSt|}t|d|kr:|dt|}t|}|dk sZtt|t|krrt d|S)z Ensure that percentiles are unique and sorted. Parameters ---------- percentiles : list-like of numbers, optional The percentiles to include in the output. Ng?g?g?z%percentiles cannot contain duplicates) rSarraylistrrJZasarrayrnAssertionErrorrUr=)rZ unique_pctsr)r)r*r#s     r#)2r6 __future__rabcrrrtypingrrrrr r rnumpyrSZpandas._libs.tslibsr Zpandas._typingr r Zpandas.util._exceptionsrZpandas.util._validatorsrZpandas.core.dtypes.commonrrrrrZpandas.core.reshape.concatrZpandas.io.formats.formatrrfrrr+r,r%r&rKrlrwrrr7r#r)r)r)r*s4       3 G  0$