Owg.dZddlmZddlmZmZddlmZmZm Z ddl Z ddl m Z ddlmZmZmZddlmZdd lmZmZdd lmZmZmZdd lmZdd lmZdd lm Z erddl!m"Z"m#Z#ddl$m%Z%m&Z& ddZ'GddeZ(Gdde(Z)Gdde(Z*ddZ+d dZ, d!dZ- d!dZ.d"dZ/ d#dZ0 d$dZ1y)%z Module responsible for execution of NDFrame.describe() method. Method NDFrame.describe() delegates actual execution to function describe_ndframe(). ) annotations)ABCabstractmethod) TYPE_CHECKINGCallablecastN) Timestamp)DtypeObjNDFrameTnpt)validate_percentile) is_bool_dtypeis_numeric_dtype) ArrowDtypeDatetimeTZDtypeExtensionDtype) Float64Dtype)concat)format_percentiles)HashableSequence) DataFrameSeriesct|}|jdk(rttd|}nt td|||}|j |}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. robjr)rincludeexclude) percentiles)_refine_percentilesndimSeriesDescriberrDataFrameDescriberdescriber )rrrr describerresults S/var/www/horilla/myenv/lib/python3.12/site-packages/pandas/core/methods/describe.pydescribe_ndframer)7sm8&k2K xx1}#Xs# '[#&   K  8F & !!c*eZdZdZddZeddZy)NDFrameDescriberAbstractzAbstract class for describing dataframe or series. Parameters ---------- obj : Series or DataFrame Object to be described. c||_yNr)selfrs r(__init__z!NDFrameDescriberAbstract.__init__ns r*cy)zDo describe either series or dataframe. Parameters ---------- percentiles : list-like of numbers The percentiles to include in the output. N)r/r s r(r%z!NDFrameDescriberAbstract.describeqsr*N)rDataFrame | SeriesreturnNone)r Sequence[float] | np.ndarrayr4r3)__name__ __module__ __qualname____doc__r0rr%r2r*r(r,r,es   r*r,c$eZdZUdZded<ddZy)r#z2Class responsible for creating series description.rrcRt|j}||j|Sr.)select_describe_funcr)r/r describe_funcs r(r%zSeriesDescriber.describes&, HH TXX{33r*N)r r6r4r)r7r8r9r:__annotations__r%r2r*r(r#r#|s< K4r*r#cPeZdZUdZded< dfd ZddZd dZxZS) 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. rrc||_||_|jdk(r$|jjdk(r t dt ||y)Nrz+Cannot describe a DataFrame without columns)rrr"columnssize ValueErrorsuperr0)r/rrr __class__s r(r0zDataFrameDescriber.__init__sH  88q=S[[--2JK K r*c X|j}g}|jD](\}}t|}|j|||*t |}t |Dcgc]}|j |dc}dd} |jj| _| Scc}w)NF)copyr)axissort) _select_dataitemsr=appendreorder_columnsrreindexrCrI) r/r dataldesc_seriesr> col_namesxds r(r%zDataFrameDescriber.describes  "  =IAv08M LLv{; < =$E* 7< =!QYYyuY - =  LL%%'  >s"B'c|j`|jTtjdg}|jj |}t |jdk(r |j}|S|jdk(r'|j d}t||j}|S|jj |j|j}|S)zSelect columns to be described.datetime)rrallz*exclude must be None when include is 'all')rr) rrnpnumberr select_dtypeslenrCrE)r/default_includerQmsgs r(rLzDataFrameDescriber._select_datas LL t||';46IIz3JO88))/)BD4<< A%xx \\U "||'B o%88D  88))  *D r*)rrrstr | Sequence[str] | Nonerrar4r5)r r6r4r)r4r) r7r8r9r:r?r0r%rL __classcell__)rGs@r(r$r$sD  N   ,  ,   "r*r$cg}t}td|Dt}|D]0}|D])}||vs|j||j |+2|S)z,Set a convenient order for rows for display.c34K|]}|jywr.)index).0rVs r( z"reorder_columns..s3AGG3s)key)setsortedr^addrN)rRnames seen_names ldesc_indexesidxnamesnames r(rOrOseE #J3U3=M!# #D:%t$ T" ## Lr*cddlm}t|}gd|zdgz}|j|j |j |j g|j|jz|jgz}t|jtr_t|jtr:|jjdk(rd}nYddl}t|j!}n;t#}n0|jjdvrt%jd}nd}||||j&| 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. rr)countmeanstdminmaxmNiufbfloatrerpdtype)pandasrrrsrtrurvquantiletolistrw isinstancer|rrkindpyarrowfloat64rr[rp)rTr rformatted_percentiles stat_indexrWr|pas r(describe_numeric_1drs.{;03HHE7RJ  fjjlC //+ & - - / 0 ::<. &,,/ fllJ /||  C'$"2::<0 NE   f $! !:FKKu EEr*c<gd}|j}t||dk7}|dkDr!|jd|jd}}d}n"tj tj }}d}|j |||g}ddlm} | |||j|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. )rsuniquetopfreqrNobjectrrr{) value_countsr^reilocr[nanrsr}rrp) rQpercentiles_ignoredrl objcounts count_uniquerrr|r'rs r(describe_categorical_1drs /E!!#Iya01LaOOA& q(9TFFBFFTjjlL#t 4F &DIIU CCr*cddg}|j}t||dk7}|j|g}d}|dkDr|jd|jd}}|j j } |jjjd} t|}|j| |j| }n|j| }|gdz }|||t| j| t| j| gz }n,|dd gz }|t j"t j"gz }d }dd lm} | |||j(| 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. rsrrNi8)rrfirstlast)tzrrrrrr{)rr^rsrerdtrdropnavaluesviewr tzinfo tz_convert tz_localizervrwr[rr}rrp) rQrrlrrr'r|rrrasintrs r($describe_timestamp_as_categorical_1dr"sGh E!!#Iya01L'+zz|\&BF EaOOA& q(9T WWZZ $$))$/n :: !bn..$C//"%C 11   eiikb ) eiikb )    % 266266"" &DIIU CCr*c&ddlm}t|}gd|zdgz}|j|j |j g|j |jz|jgz}||||jS)zDescribe series containing datetime64 dtype. Parameters ---------- data : Series Series to be described. percentiles : list-like of numbers The percentiles to include in the output. rrr)rsrtrvrw)rerp) r}rrrsrtrvr~rrwrp)rQr rrrrWs r(describe_timestamp_1drRs.{;),AAUGKJ tyy{DHHJ/ -- $ + + - . 88:,  !:DII 66r*ct|jrtSt|rtS|jj dk(st |jtrtS|jj dk(rtStS)zSelect proper function for describing series based on data type. Parameters ---------- data : Series Series to be described. Mrx) rr|rrrrrrr)rQs r(r=r=jscTZZ && $ "" C :djj/#J$$ C ""&&r*c.|tjgdSt|}t|d|vr|j dtj |}tj |}|Jt|t|kr td|S)z Ensure that percentiles are unique and sorted. Parameters ---------- percentiles : list-like of numbers, optional The percentiles to include in the output. )g??g?rz%percentiles cannot contain duplicates) r[arraylistr rNasarrayrr^rE)r unique_pctss r(r!r!sxx)**{#K $ +3**[)K))K(K  "" " ;#k**@AA r*) rr rrarrar #Sequence[float] | np.ndarray | Noner4r )rRzSequence[Series]r4zlist[Hashable])rTrr Sequence[float]r4r)rQrrrr4r)rQrr rr4r)rQrr4r)r rr4znpt.NDArray[np.float64])2r: __future__rabcrrtypingrrrnumpyr[pandas._libs.tslibsr pandas._typingr r r pandas.util._validatorsr pandas.core.dtypes.commonrrpandas.core.dtypes.dtypesrrrpandas.core.arrays.floatingrpandas.core.reshape.concatrpandas.io.formats.formatrcollections.abcrrr}rrr)r,r#r$rOrrrrr=r!r2r*r(rs> # ) 8 5-7  +" +"(+"( +" 5 +"  +"\ s . 4. 4A1AH &FRD D(D D@-D -D(-D -D`70' ' ', 4  r*