hh5 ~ddlmZddlmZmZmZmZmZddlm Z m Z m Z m Z m Z ddlmZddlmZmZmZmZmZddlmZmZmZmZddlmZmZddlmZm Z m!Z!m"Z"m#Z#ersdd l$m%Z%m&Z&m'Z'dd l(m)Z)dd l*Z+dd l,Z-dd l.Z/dd l0m1Z1m2Z2m3Z3dd l4m5Z5ddl6m7Z7ddlm8Z8m9Z9m:Z:ddl;mZ>ddl?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGGdde3eedfZHedddZIgdZJGddedeeeedeeeZKGddeKeeeZLGd d!eee eeeefZMGd"d#eMeefeeefZNGd$d%eMeefe eeeefZOGd&d'eMeefe eeeefZPGd(d)eMeefe eeeefZQGd*d+eMeefe eeeefZRGd,d-eMeefe eeeefZSGd.d/eeeIfZTd S)0) annotations) TYPE_CHECKINGAnyGenericLiteralProtocol) CatNamespaceDateTimeNamespace ListNamespaceStringNamespaceStructNamespace)CompliantColumn)CompliantSeriesT_coEagerDataFrameAnyEagerSeriesT_co NativeSeriesTNativeSeriesT_co) FromIterable FromNativeNumpyConvertible ToNarwhals)TypeVar assert_never)_StoresCompliant _StoresNativeis_compliant_seriesis_sized_multi_index_selectorunstable)IterableIteratorSequence) ModuleTypeN) NotRequiredSelf TypedDict)CompliantDataFrame)EagerNamespace)ImplementationVersion_LimitedContext)DType)Series) Into1DArray IntoDTypeMultiIndexSelector PythonLiteralRollingInterpolationMethodSizedMultiIndexSelector_1DArray _SliceIndexc$eZdZUded<ded<dS)HistDataz/NotRequired[list[float] | _1DArray | list[Any]] breakpointz2NativeSeriesT | _1DArray | _CountsT_co | list[Any]countN)__name__ __module__ __qualname____annotations__Q/var/www/histauto/venv/lib/python3.11/site-packages/narwhals/_compliant/series.pyr6r67s*CCCCAAAAAAr>r6 _CountsT_co Iterable[Any]T)bound covariant) CompliantSeries EagerSeriesEagerSeriesCatNamespaceEagerSeriesDateTimeNamespaceEagerSeriesHistEagerSeriesListNamespaceEagerSeriesNamespaceEagerSeriesStringNamespaceEagerSeriesStructNamespaceceZdZUded<eddZddZdd Zedd Z ddZ ddZ ddZ eddZ eddZddZdd!Zdd$Zdd&Zdd(Zedd*Zed+d,d-dd1Zdd2Zdd3Zdd4Zdd5Zdd6Zdd7Zdd8Zdd9Zdd:Zdd;Zdd=Z dd?Z!dd@Z"ddCZ#ddDZ$ddEZ%ddGZ&ddJZ'ddLZ(ddMZ)ddNZ*ddPZ+ddQZ,ddRZ-ddSZ.ddTZ/ddXZ0dd\Z1dd`Z2ddaZ3ddbZ4dddZ5ddfZ6ddgZ7ddhZ8ddjZ9ddnZ:ddoZ;ddqZdvdwddyZ?dd~Z@ddZAddZBeCddZDeCddZEd,S)rDr(_implementationreturnrcdSNr=selfs r?nativezCompliantSeries.nativeVs'*sr>r$c|SrQr=rRs r?__narwhals_series__z#CompliantSeries.__narwhals_series__Xs r>r"cdSrQr=rRs r?__native_namespace__z$CompliantSeries.__native_namespace__[r>datacontextr*cdSrQr=clsrZr[s r? from_nativezCompliantSeries.from_native\sWZWZr>Series[NativeSeriesT]c:|j|dS)Nfull)level)_versionseriesrRs r? to_narwhalszCompliantSeries.to_narwhals^s}##D#777r>rercdSrQr=rSres r? _with_nativezCompliantSeries._with_nativearYr>versionr)cdSrQr=)rSrjs r? _with_versionzCompliantSeries._with_versionbrYr>r+cdSrQr=rRs r?dtypezCompliantSeries.dtypees!cr>strcdSrQr=rRs r?namezCompliantSeries.namegs3r>rncopy bool | Noner3cdSrQr=)rSrnrrs r? __array__zCompliantSeries.__array__irYr>otherboolcdSrQr=rSrvs r? __contains__zCompliantSeries.__contains__jrYr>itemMultiIndexSelector[Self]cdSrQr=rSr{s r? __getitem__zCompliantSeries.__getitem__krYr> Iterator[Any]cdSrQr=rRs r?__iter__zCompliantSeries.__iter__lrYr>intc*t|jSrQ)lenrTrRs r?__len__zCompliantSeries.__len__ms4;r>r-cdSrQr=r]s r? from_numpyzCompliantSeries.from_numpypsTWTWr>N)rqrnrArqIntoDType | NonecdSrQr=)r^rZr[rqrns r? from_iterablezCompliantSeries.from_iterablers sr>cdSrQr=rys r?__radd__zCompliantSeries.__radd__|rYr>cdSrQr=rys r?__rand__zCompliantSeries.__rand__}rYr>cdSrQr=rys r?__rmul__zCompliantSeries.__rmul__~rYr>cdSrQr=rys r?__ror__zCompliantSeries.__ror__rYr>cdSrQr=rRs r?allzCompliantSeries.allrYr>cdSrQr=rRs r?anyzCompliantSeries.anyrYr>cdSrQr=rRs r?arg_maxzCompliantSeries.arg_maxrYr>cdSrQr=rRs r?arg_minzCompliantSeries.arg_minrYr>cdSrQr=rRs r?arg_truezCompliantSeries.arg_truerYr>cdSrQr=rRs r?r8zCompliantSeries.countrYr> predicatecdSrQr=)rSrs r?filterzCompliantSeries.filterrYr>r0cdSrQr=rRs r?firstzCompliantSeries.firstrYr>cdSrQr=rRs r?lastzCompliantSeries.lastrYr>noffsetcdSrQr=)rSrrs r? gather_everyzCompliantSeries.gather_everyrYr>cdSrQr=rSrs r?headzCompliantSeries.headrYr>c2|dkSNr)rrRs r?is_emptyzCompliantSeries.is_emptysxxzzQr> descendingcdSrQr=)rSrs r? is_sortedzCompliantSeries.is_sortedrYr>index int | NonecdSrQr=)rSrs r?r{zCompliantSeries.itemrYr> float | NonecdSrQr=rRs r?kurtosiszCompliantSeries.kurtosisrYr>cdSrQr=rRs r?rzCompliantSeries.lenrYr>cdSrQr=rRs r?maxzCompliantSeries.maxrYr>floatcdSrQr=rRs r?meanzCompliantSeries.meanrYr>cdSrQr=rRs r?medianzCompliantSeries.medianrYr>cdSrQr=rRs r?minzCompliantSeries.minrYr>cdSrQr=rRs r?n_uniquezCompliantSeries.n_uniquerYr>cdSrQr=rRs r? null_countzCompliantSeries.null_countrYr>quantile interpolationr1cdSrQr=)rSrrs r?rzCompliantSeries.quantilesr>fractionwith_replacementseedcdSrQr=)rSrrrrs r?samplezCompliantSeries.samples sr>indicesint | Sequence[int]valuescdSrQr=)rSrrs r?scatterzCompliantSeries.scatterrYr>cdSrQr=rs r?shiftzCompliantSeries.shiftrYr>cdSrQr=rRs r?skewzCompliantSeries.skewrYr> nulls_lastcdSrQr=)rSrrs r?sortzCompliantSeries.sortrYr>ddofcdSrQr=rSrs r?stdzCompliantSeries.stdrYr>cdSrQr=rRs r?sumzCompliantSeries.sumrYr>cdSrQr=rs r?tailzCompliantSeries.tailrYr> pa.Array[Any]cdSrQr=rRs r?to_arrowzCompliantSeries.to_arrowrYr> separator drop_first'CompliantDataFrame[Self, Any, Any, Any]cdSrQr=)rSrrs r? to_dummieszCompliantSeries.to_dummies25#r>cdSrQr=rRs r?to_framezCompliantSeries.to_framerYr> list[Any]cdSrQr=rRs r?to_listzCompliantSeries.to_listrYr>pd.Series[Any]cdSrQr=rRs r? to_pandaszCompliantSeries.to_pandasrYr> pl.SeriescdSrQr=rRs r? to_polarszCompliantSeries.to_polarsrYr>F)maintain_orderrcdSrQr=)rSrs r?uniquezCompliantSeries.uniquerYr>rparallel str | None normalizecdSrQr=)rSrrrqrs r? value_countszCompliantSeries.value_countsrr>cdSrQr=rs r?varzCompliantSeries.varrYr>maskcdSrQr=)rSrrvs r?zip_withzCompliantSeries.zip_withrYr>bins list[float]include_breakpointcdS)z(`Series.hist(bins=..., bin_count=None)`.Nr=)rSrrs r?hist_from_binszCompliantSeries.hist_from_bins r> bin_countcdS)z(`Series.hist(bins=None, bin_count=...)`.Nr=)rSr rs r?hist_from_bin_countz#CompliantSeries.hist_from_bin_countr r>rOr)rOr$)rOr")rZrr[r*rOr$)rOr`)rerrOr$)rjr)rOr$)rOr+)rOro)rnrrrrsrOr3)rvrrOrw)r{r|rOr)rOr)rOr)rZr-r[r*rOr$) rZrAr[r*rqrornrrOr$)rvrrOr$rOrw)rrrOr$)rOr0)rrrrrOr$)rrrOr$)rrwrOrw)rrrOr)rOr)rOr)rOr)rrrr1rOr) rrrrrrwrrrOr$)rrrrrOr$)rrwrrwrOr$)rrrOr)rOr)rrorrwrOr)rOr)rOr)rOr)rOr)rrwrOr$) rrwrrwrqrrrwrOr)rrrvrrOr$)rrrrwrOr)r rrrwrOr)Fr9r:r;r<propertyrTrVrX classmethodr_rfrirlrnrqrurzrrrrrrrrrrrrrrr8rrrrrrrr{rrrrrrrrrrrrrrrrrrrrrrrrrrrrr r r=r>r?rDrDKs$### ***X*6555ZZZ[Z88885444::::!!!X! XJJJJ3333EEEE,,,,    WWW[W"&[0///////////....!!!!!!!!####1111))))((((<<<<'''':9991111++++    """"""""$$$$NMMM((((''''FFFF----'''',,,,6666GFFF''''....))))/4BBBBBB6666.---::::   X    X   r>rD)r3r-r`ceZdZUded<ded<ded<ded<ed,d Zed-dZd.dZddd/dZ d0dZ d1dZ d2dZ d3d Z ed4d"Zed5d$Zed6d&Zed7d(Zed8d*Zd+S)9rEr_native_seriesr(rNr)rdrw _broadcastrOtuple[int, ...]c4|jSrQ)rN_backend_versionrRs r?rzEagerSeries._backend_versions#44666r>rer$Sequence[Self]cdS)aEnsure all of `series` have the same length (and index if `pandas`). Scalars get broadcasted to the full length of the longest Series. This is useful when you need to construct a full Series anyway, such as: DataFrame.select(...) It should not be used in binary operations, such as: nw.col("a") - nw.col("a").mean() because then it's more efficient to extract the right-hand-side's single element as a scalar. Nr=)r^res r?_align_full_broadcastz!EagerSeries._align_full_broadcasts r>valuec>||g|j|S)N)rqr[)rrq)rSrs r? _from_scalarzEagerSeries._from_scalars!!!5' 4!HHHr>F)preserve_broadcastrrcdS)aReturn a new `CompliantSeries`, wrapping the native `series`. In cases when operations are known to not affect whether a result should be broadcast, we can pass `preserve_broadcast=True`. Set this with care - it should only be set for unary expressions which don't change length or order, such as `.alias` or `.fill_null`. If in doubt, don't set it, you probably don't need it. Nr=)rSrers r?rizEagerSeries._with_natives  r>2EagerNamespace[Any, Self, Any, Any, NativeSeriesT]cdSrQr=rRs r?__narwhals_namespace__z"EagerSeries.__narwhals_namespace__s=@Sr>rows&SizedMultiIndexSelector[NativeSeriesT]cdSrQr=rSr#s r?_gatherzEagerSeries._gatherrYr>_SliceIndex | rangecdSrQr=r&s r? _gather_slicezEagerSeries._gather_slicerYr>r{r|c t|ttfr||St |r||jSt|r||St|dSrQ) isinstancesliceranger*rr'rTrrr~s r?rzEagerSeries.__getitem__s dUEN + + ,%%d++ + t $ $ &<< ,, , *4 0 0 &<<%% %Tr>/EagerSeriesStringNamespace[Self, NativeSeriesT]cdSrQr=rRs r?rozEagerSeries.strsFIcr>1EagerSeriesDateTimeNamespace[Self, NativeSeriesT]cdSrQr=rRs r?dtzEagerSeries.dtsGJsr>,EagerSeriesCatNamespace[Self, NativeSeriesT]cdSrQr=rRs r?catzEagerSeries.catsCF3r>-EagerSeriesListNamespace[Self, NativeSeriesT]cdSrQr=rRs r?listzEagerSeries.list sEHSr>/EagerSeriesStructNamespace[Self, NativeSeriesT]cdSrQr=rRs r?structzEagerSeries.struct sILr>NrOr)rer$rOr)rrrOr$)rerrrwrOr$)rOr )r#r$rOr$)r#r(rOr$)r{r|rOr$)rOr/)rOr1)rOr4)rOr7)rOr:)r9r:r;r<rrrrrrir"r'r*rror3r6r9r<r=r>r?rErEst#### 777X7   [ "IIIIDI       AAAAQPPPCCCCIIIXI JJJXJ FFFXF HHHXH LLLXLLLr>rEceZdZUded<eddZeddZeddZedd Zedd Z ddZ dS)_SeriesNamespacer_compliant_seriesrOc|jSrQr@rRs r? compliantz_SeriesNamespace.compliants %%r>r(c|jjSrQ)rCrNrRs r?implementationz_SeriesNamespace.implementations ~--r>rc4|jSrQ)rErrRs r?backend_versionz _SeriesNamespace.backend_versions"33555r>r)c|jjSrQ)rCrdrRs r?rjz_SeriesNamespace.version#s ~&&r>rc|jjSrQ)r@rTrRs r?rTz_SeriesNamespace.native's%,,r>rerc6|j|SrQ)rCrirhs r? with_nativez_SeriesNamespace.with_native+s~**6222r>N)rOr)rOr(r=)rOr))rOr)rerrOr) r9r:r;r<rrCrErGrjrTrKr=r>r?r?r?s +*** &&&X&...X.666X6'''X'---X-333333r>r?c"eZdZUded<ddZdS) rJrr@rerONonec||_dSrQrBrhs r?__init__zEagerSeriesNamespace.__init__5s!'r>N)rerrOrM)r9r:r;r<rOr=r>r?rJrJ/s8'&&&((((((r>rJceZdZdS)rFNr9r:r;r=r>r?rFrF93r>rFceZdZdS)rGNrQr=r>r?rGrG@rRr>rGceZdZdS)rINrQr=r>r?rIrIGrRr>rIceZdZdS)rKNrQr=r>r?rKrKNrRr>rKceZdZdS)rLNrQr=r>r?rLrLUrRr>rLceZdZUded<ded<ded<ed*d Zed+d Zd,dZddd-dZ d.dZ d/dZ d0dZ d1d"Z d2d$Zd3d&Zd4d'Zd5d(Zd)S)6rHEagerSeries[NativeSeriesT]_seriesrw _breakpoint$HistData[NativeSeriesT, _CountsT_co]_datarOrc|jjSrQ)rYrTrRs r?rTzEagerSeriesHist.nativeas |""r>rerr$cL||}||_||_|SrQ)__new__rYrZ)r^rerobjs r? from_serieszEagerSeriesHist.from_serieses(kk# , r>rcdSrQr=rRs r?rzEagerSeriesHist.to_framenrYr>both)closedstartrend num_samplesrrdLiteral['both', 'none']r3cdSrQr=)rSrerfrgrds r? _linear_spacezEagerSeriesHist._linear_spaceos 3r>cdSrQr=rRs r?is_empty_serieszEagerSeriesHist.is_empty_seriesyrYr>c"|jrggdndgiS)N)r7r8r8)rZrRs r? data_emptyzEagerSeriesHist.data_empty|s"262BUb2...RT Ur>argint | list[float]cdSrQr=)rSros r? series_emptyzEagerSeriesHist.series_empty/2sr>rrct|dkr||_nI|r|||_n|||_|S)N)rrnr\rlrr_calculate_histrSrs r? with_binszEagerSeriesHist.with_binssi t99>>**DJJ  ! ! # # 4**400DJJ--d33DJ r>r c|dkr||_n\|r|||_n-||||_|Sr)rnr\rlrrrv_calculate_binsrSr s r?with_bin_countzEagerSeriesHist.with_bin_countsr >>**DJJ  ! ! # # O**955DJJ--d.B.B9.M.MNNDJ r>list[float] | _1DArraycxt|tr|dd|dzn|}|ddS)Nrru)r,rrj)rSrors r?_calculate_breakpointz%EagerSeriesHist._calculate_breakpoints>4>sC4H4HQt!!!Qa000cABBxr>cdSrQr=r{s r?rzzEagerSeriesHist._calculate_binsrYr>cdSrQr=rws r?rvzEagerSeriesHist._calculate_histrsr>Nr)rerXrrwrOr$)rOr) rerrfrrgrrdrhrOr3r)rOr[)rorprOr[)rrrOr$)r rrOr$)rorprOr})r rrOr3)rr}rOr[)r9r:r;r<rrTrrarrjrlrnrrrxr|rrzrvr=r>r?rHrH\sA''''//// ###X#[1000+1 +***VVVV 3333?>>>333333r>rH)U __future__rtypingrrrrr!narwhals._compliant.any_namespacer r r r r narwhals._compliant.columnrnarwhals._compliant.typingrrrrrnarwhals._translaterrrrnarwhals._typing_compatrrnarwhals._utilsrrrrrcollections.abcrr r!typesr"pandaspdpolarsplpyarrowpatyping_extensionsr#r$r%narwhals._compliant.dataframer&narwhals._compliant.namespacer'r(r)r*narwhals.dtypesr+narwhals.seriesr,narwhals.typingr-r.r/r0r1r2r3r4r6r@__all__rDrEr?rJrFrGrIrKrLrHr=r>r?rs""""""AAAAAAAAAAAAAA766666WVVVVVVVVVVV99999999B<<<<<<<<<<      >>>>>>>>>>@@@@@@<<<<<<HHHHHHHHHH%%%%%%&&&&&&                    BBBBB9gm]&BCBBB gm?dKKK    { { { { { ./}&' ] { { { |DMDMDMDMDM/-0(=2IDMDMDMN33333()"# "2 23333>(((((_&667 O- -.(((_&667! _. ./_&667o& _. ./_&667/" _. ./_&667O$ _. ./_&667O$ _. ./B3B3B3B3B3h}k9:B3B3B3B3B3r>