U MZf5.@sdZddlmZddlmZmZddlmZmZm Z m Z m Z m Z ddl ZddlmZddlmZmZmZddlmZdd lmZmZmZmZdd lmZdd lmZdd l m!Z!dd l"m#Z#ddl$m%Z%erddl&m'Z'm(Z(ddddddddZ)GdddeZ*Gddde*Z+Gddde*Z,ddddd Z-d!d"d!d#d$d%Z.d!d"d!d&d'd(Z/d!d"d!d&d)d*Z0d!d"d!d+d,d-Z1d!d.d/d0d1Z2dd2d3d4d5Z3dS)6z Module responsible for execution of NDFrame.describe() method. Method NDFrame.describe() delegates actual execution to function describe_ndframe(). ) annotations)ABCabstractmethod) TYPE_CHECKINGAnyCallableHashableSequencecastN) Timestamp)DtypeObjNDFrameTnpt)validate_percentile) is_bool_dtypeis_complex_dtypeis_extension_array_dtypeis_numeric_dtype)DatetimeTZDtype) ArrowDtype) Float64Dtype)concat)format_percentiles) DataFrameSeriesr str | Sequence[str] | Nonez#Sequence[float] | np.ndarray | None)objincludeexclude percentilesreturncCsNt|}|jdkr$ttd|d}nttd|||d}|j|d}tt|S)a Describe 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``. 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. rrr)rrr)r)refine_percentilesndimSeriesDescriberr DataFrameDescriberdescriber )rrrrZ describerresultr)@/tmp/pip-unpacked-wheel-nbcvw55c/pandas/core/methods/describe.pydescribe_ndframe4s  r+c@s4eZdZdZdddddZedddd d Zd S) NDFrameDescriberAbstractzAbstract class for describing dataframe or series. Parameters ---------- obj : Series or DataFrame Object to be described. zDataFrame | SeriesNone)rr cCs ||_dSNr")selfrr)r)r*__init__ksz!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'nsz!NDFrameDescriberAbstract.describeN)__name__ __module__ __qualname____doc__r0rr'r)r)r)r*r,bsr,c@s*eZdZUdZded<dddddZdS) r%z2Class responsible for creating series description.rrr1r2cCst|j}||j|Sr.)select_describe_funcr)r/r describe_funcr)r)r*r'~szSeriesDescriber.describeN)r3r4r5r6__annotations__r'r)r)r)r*r%ys r%csDeZdZdZdddddfdd Zddd d d Zd d ZZS)r&abClass 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. rrr-)rrrr cs:||_||_|jdkr*|jjdkr*tdt|dS)Nrz+Cannot describe a DataFrame without columns)rrr$columnssize ValueErrorsuperr0)r/rrr __class__r)r*r0s zDataFrameDescriber.__init__r1r2csj|}g}|D] \}}t|}||||qt|tfdd|Dddd}|j|_|S)Ncsg|]}|jddqS)F)copy)Zreindex.0xZ col_namesr)r* sz/DataFrameDescriber.describe..r!F)Zaxissort) _select_dataitemsr7appendreorder_columnsrr;rA)r/rdataldesc_seriesr8dr)rEr*r's zDataFrameDescriber.describecCs|jdkrB|jdkrBtjdg}|jj|d}t|jdkr~|j}n<|jdkrj|jdk rbd}t||j}n|jj|j|jd}|S)zSelect columns to be described.Ndatetime)rrallz*exclude must be None when include is 'all')rr) rrnpnumberrZ select_dtypeslenr;r=)r/Zdefault_includerLmsgr)r)r*rHs   zDataFrameDescriber._select_data)r3r4r5r6r0r'rH __classcell__r)r)r?r*r&s r&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 |rt |j t r|j jdkrd }qdd l}t |}qt}n t|rt|st d }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. rrcountmeanstdminmaxmNfloatrXr]dtype)pandasrrr_r`rarbquantiletolistrcr isinstancergrkindZpyarrowZfloat64rrrrSr])rOrrformatted_percentiles stat_indexrPrgpar)r)r*describe_numeric_1ds(     rp)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^rf) value_countsrUrXilocrSnanr_rhrr]) rLrqr\ objcounts count_uniquersrtrgr(rr)r)r*describe_categorical_1ds  r{c 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_rrrNi8rsrtfirstlast)tzrur^rf)rvrUr_rXrwdtrZdropnavaluesviewr tzinfoZ tz_convertZ tz_localizerbrcrSrxrhrr]) rLrqr\ryrzr(rgrsrtrZasintrr)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]) rhrrr_r`rbrirjrcr])rLrrrmrnrPr)r)r*describe_timestamp_1dJs  rr)rLr cCsNt|jrtSt|rtS|jjdks2t|jtr6tS|jjdkrFtStSdS)zSelect proper function for describing series based on data type. Parameters ---------- data : Series Series to be described. MrdN) rrgr{rrprlrkrr)rLr)r)r*r7bs  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) rSarraylistrrJZasarrayrrAssertionErrorrUr=)rZ unique_pctsr)r)r*r#xs     r#)4r6 __future__rabcrrtypingrrrrr r ZnumpyrSZpandas._libs.tslibsr Zpandas._typingr r rZpandas.util._validatorsrZpandas.core.dtypes.commonrrrrZpandas.core.dtypes.dtypesrZpandas.core.arrays.arrow.dtyperZpandas.core.arrays.floatingrZpandas.core.reshape.concatrZpandas.io.formats.formatrrhrrr+r,r%r&rKrpr{rrr7r#r)r)r)r*s4         . B ( 0