Wh=5 ddlmZddlmZmZmZmZmZddlm Z m Z m Z m Z m Z ddlmZddlmZmZmZmZmZddlmZmZmZmZddlmZmZddlmZm Z m!Z!m"Z"m#Z#erkdd 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@mAZAmBZBmCZCmDZDmEZEmFZFGdde3eedfZGedddZHgdZIGddedeeeedeeeZJGddeJeeeZKGd d!eee eeeefZLGd"d#eLeefeeefZMGd$d%eLeefe eeeefZNGd&d'eLeefe eeeefZOGd(d)eLeefe eeeefZPGd*d+eLeefe eeeefZQGd,d-eLeefe eeeefZRGd.d/eeeHfZSy )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 IntoDTypeMultiIndexSelectorRollingInterpolationMethodSizedMultiIndexSelector_1DArray _SliceIndexc"eZdZUded<ded<y)HistDataz/NotRequired[list[float] | _1DArray | list[Any]] breakpointz2NativeSeriesT | _1DArray | _CountsT_co | list[Any]countN)__name__ __module__ __qualname____annotations__T/var/www/html/jupyter_env/lib/python3.12/site-packages/narwhals/_compliant/series.pyr5r56sCCAAr=r5 _CountsT_co Iterable[Any]T)bound covariant) CompliantSeries EagerSeriesEagerSeriesCatNamespaceEagerSeriesDateTimeNamespaceEagerSeriesHistEagerSeriesListNamespaceEagerSeriesNamespaceEagerSeriesStringNamespaceEagerSeriesStructNamespaceceZdZUded<edEdZdFdZdGdZedHdZ dIdZ dJdZ dKd Z edLd Z edMd ZdNd ZdOd ZdPdZdQdZdRdZedSdZeddd dTdZdUdZdUdZdUdZdUdZdVdZdVdZdRdZdRdZdFdZdRdZdWd Z dXd!Z!dYd"Z"dVd#Z#dZd$Z$d[d%Z%d\d&Z&dRd'Z'd]d(Z(d^d)Z)d^d*Z*d]d+Z+dRd,Z,dRd-Z- d_d.Z. d`d/Z/dad0Z0dYd1Z1d\d2Z2dbd3Z3dcd4Z4d^d5Z5dYd6Z6ddd7Z7 ded8Z8dfd9Z9dgd:Z:dhd;Z;did<Zdjd?Z= dkd@Z>dcdAZ?dldBZ@eA dmdCZBeA dndDZCy)orCr(_implementationcyNr<selfs r>nativezCompliantSeries.nativeUs'*r=c|SrOr<rPs r>__narwhals_series__z#CompliantSeries.__narwhals_series__Ws r=cyrOr<rPs r>__native_namespace__z$CompliantSeries.__native_namespace__Zr=cyrOr<clsdatacontexts r> from_nativezCompliantSeries.from_native[sWZr=c<|jj|dS)Nfull)level)_versionseriesrPs r> to_narwhalszCompliantSeries.to_narwhals]s}}##D#77r=cyrOr<rQrbs r> _with_nativezCompliantSeries._with_native`rWr=cyrOr<)rQversions r> _with_versionzCompliantSeries._with_versionarWr=cyrOr<rPs r>dtypezCompliantSeries.dtypeds!r=cyrOr<rPs r>namezCompliantSeries.namefsr=cyrOr<)rQrkcopys r> __array__zCompliantSeries.__array__hrWr=cyrOr<rQothers r> __contains__zCompliantSeries.__contains__irWr=cyrOr<rQitems r> __getitem__zCompliantSeries.__getitem__jrWr=cyrOr<rPs r>__iter__zCompliantSeries.__iter__krWr=c,t|jSrO)lenrRrPs r>__len__zCompliantSeries.__len__ls4;;r=cyrOr<rYs r> from_numpyzCompliantSeries.from_numpyosTWr=N)rmrkcyrOr<)rZr[r\rmrks r> from_iterablezCompliantSeries.from_iterableqsr=cyrOr<rrs r>__radd__zCompliantSeries.__radd__{rWr=cyrOr<rrs r>__rand__zCompliantSeries.__rand__|rWr=cyrOr<rrs r>__rmul__zCompliantSeries.__rmul__}rWr=cyrOr<rrs r>__ror__zCompliantSeries.__ror__~rWr=cyrOr<rPs r>allzCompliantSeries.allrWr=cyrOr<rPs r>anyzCompliantSeries.anyrWr=cyrOr<rPs r>arg_maxzCompliantSeries.arg_maxrWr=cyrOr<rPs r>arg_minzCompliantSeries.arg_minrWr=cyrOr<rPs r>arg_truezCompliantSeries.arg_truerWr=cyrOr<rPs r>r7zCompliantSeries.countrWr=cyrOr<)rQ predicates r>filterzCompliantSeries.filterrWr=cyrOr<)rQnoffsets r> gather_everyzCompliantSeries.gather_everyrWr=cyrOr<rQrs r>headzCompliantSeries.headrWr=c(|jdk(SNr)r|rPs r>is_emptyzCompliantSeries.is_emptysxxzQr=cyrOr<)rQ descendings r> is_sortedzCompliantSeries.is_sortedrWr=cyrOr<)rQindexs r>rwzCompliantSeries.itemrWr=cyrOr<rPs r>kurtosiszCompliantSeries.kurtosisrWr=cyrOr<rPs r>r|zCompliantSeries.lenrWr=cyrOr<rPs r>maxzCompliantSeries.maxrWr=cyrOr<rPs r>meanzCompliantSeries.meanrWr=cyrOr<rPs r>medianzCompliantSeries.medianrWr=cyrOr<rPs r>minzCompliantSeries.minrWr=cyrOr<rPs r>n_uniquezCompliantSeries.n_uniquerWr=cyrOr<rPs r> null_countzCompliantSeries.null_countrWr=cyrOr<)rQquantile interpolations r>rzCompliantSeries.quantilesr=cyrOr<)rQrfractionwith_replacementseeds r>samplezCompliantSeries.samplesr=cyrOr<)rQindicesvaluess r>scatterzCompliantSeries.scatterrWr=cyrOr<rs r>shiftzCompliantSeries.shiftrWr=cyrOr<rPs r>skewzCompliantSeries.skewrWr=cyrOr<)rQr nulls_lasts r>sortzCompliantSeries.sortrWr=cyrOr<rQddofs r>stdzCompliantSeries.stdrWr=cyrOr<rPs r>sumzCompliantSeries.sumrWr=cyrOr<rs r>tailzCompliantSeries.tailrWr=cyrOr<rPs r>to_arrowzCompliantSeries.to_arrowrWr=cyrOr<)rQ separator drop_firsts r> to_dummieszCompliantSeries.to_dummies25r=cyrOr<rPs r>to_framezCompliantSeries.to_framerWr=cyrOr<rPs r>to_listzCompliantSeries.to_listrWr=cyrOr<rPs r> to_pandaszCompliantSeries.to_pandasrWr=cyrOr<rPs r> to_polarszCompliantSeries.to_polarsrWr=F)maintain_ordercyrOr<)rQrs r>uniquezCompliantSeries.uniquerWr=cyrOr<)rQrparallelrm normalizes r> value_countszCompliantSeries.value_countsrr=cyrOr<rs r>varzCompliantSeries.varrWr=cyrOr<)rQmaskrss r>zip_withzCompliantSeries.zip_withrWr=cy)z(`Series.hist(bins=..., bin_count=None)`.Nr<)rQbinsinclude_breakpoints r>hist_from_binszCompliantSeries.hist_from_bins r=cy)z(`Series.hist(bins=None, bin_count=...)`.Nr<)rQ bin_countrs r>hist_from_bin_countz#CompliantSeries.hist_from_bin_countrr=returnr)rr$)rr")r[rr\r*rr$)rSeries[NativeSeriesT])rbrrr$)rhr)rr$)rr+)rstr)rkrroz bool | Nonerr2)rsrrbool)rwMultiIndexSelector[Self]rr)rz Iterator[Any])rint)r[r-r\r*rr$) r[r@r\r*rmrrkzIntoDType | Nonerr$)rsrrr$rr)rrrr$)rrrrrr$)rrrr$)rrrr)r int | Nonerr)r float | None)rr)rfloat)rrrr0rr) rrrrrrrrrr$)rzint | Sequence[int]rrrr$)rrrrrr$)rrrr)rz pa.Array[Any])rrrrr'CompliantDataFrame[Self, Any, Any, Any])rr)rz list[Any])rzpd.Series[Any])rz pl.Series)rrrr$) rrrrrmz str | Nonerrrr)rrrsrrr$)r list[float]rrrr)rrrrrr)Dr8r9r:r;propertyrRrTrV classmethodr]rcrfrirkrmrprtrxrzr}rrrrrrrrrrrr7rrrrrrwrr|rrrrrrrrrrrrrrrrrrrrrrrrrrrrr<r=r>rCrCJs@$# **6ZZ85:!! J3E, WW"& !     0//.!!#1<':1+ ""$.H        N('F-',66-16 06G'.)/4B66'+63=6JN6 06.:  8< 0    59 0  r=rC)r2r-rceZdZUded<ded<ded<ded<edd Zedd Zdd Zd d  ddZ ddZ ddZ ddZ d dZ ed!dZed"dZed#dZed$dZed%dZy)&rDr_native_seriesr(rMr)rar _broadcastc6|jjSrO)rM_backend_versionrPs r>rzEagerSeries._backend_versions##4466r=cy)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<)rZrbs r>_align_full_broadcastz!EagerSeries._align_full_broadcasts r=c@|j|g|j|S)N)rmr\)rrm)rQvalues r> _from_scalarzEagerSeries._from_scalars !!5' 4!HHr=F)preserve_broadcastcy)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<)rQrbrs r>rfzEagerSeries._with_natives r=cyrOr<rPs r>__narwhals_namespace__z"EagerSeries.__narwhals_namespace__s=@r=cyrOr<rQrowss r>_gatherzEagerSeries._gatherrWr=cyrOr<rs r> _gather_slicezEagerSeries._gather_slicerWr=ct|ttfr|j|St |r|j |j St|r|j |St|yrO) isinstanceslicerangerrrrRrrrvs r>rxzEagerSeries.__getitem__s[ dUEN +%%d+ + t $<< , , *4 0<<% %Tr=cyrOr<rPs r>rzEagerSeries.strsFIr=cyrOr<rPs r>dtzEagerSeries.dtsGJr=cyrOr<rPs r>catzEagerSeries.catsCFr=cyrOr<rPs r>listzEagerSeries.listsEHr=cyrOr<rPs r>structzEagerSeries.struct sILr=Nrztuple[int, ...])rbr$rzSequence[Self])r rrr$)rbrrrrr$)rz2EagerNamespace[Any, Self, Any, Any, NativeSeriesT])rz&SizedMultiIndexSelector[NativeSeriesT]rr$)rz_SliceIndex | rangerr$)rwrrr$)rz/EagerSeriesStringNamespace[Self, NativeSeriesT])rz1EagerSeriesDateTimeNamespace[Self, NativeSeriesT])rz,EagerSeriesCatNamespace[Self, NativeSeriesT])rz-EagerSeriesListNamespace[Self, NativeSeriesT])rz/EagerSeriesStructNamespace[Self, NativeSeriesT])r8r9r:r;rrrr r rfrrrrxrrr r"r$r<r=r>rDrDs## 77  "IDI  #  <@    A ;AQCII JJ FF HH LLr=rDczeZdZUded<ed dZed dZed dZed dZeddZ ddZ y )_SeriesNamespacer_compliant_seriesc|jSrOr(rPs r> compliantz_SeriesNamespace.compliants%%%r=c.|jjSrO)r+rMrPs r>implementationz_SeriesNamespace.implementations~~---r=c6|jjSrO)r-rrPs r>backend_versionz _SeriesNamespace.backend_versions""3355r=c.|jjSrO)r+rarPs r>rhz_SeriesNamespace.version s~~&&&r=c.|jjSrO)r(rRrPs r>rRz_SeriesNamespace.native$s%%,,,r=c8|jj|SrO)r+rfres r> with_nativez_SeriesNamespace.with_native(s~~**622r=N)rr)rr(r%)rr))rr)rbrrr) r8r9r:r;rr+r-r/rhrRr3r<r=r>r'r' sq +* &&..66''--3r=r'c eZdZUded<ddZy)rIrr(c||_yrOr*res r>__init__zEagerSeriesNamespace.__init__2s !'r=N)rbrrNone)r8r9r:r;r6r<r=r>rIrI,s'&(r=rIc eZdZy)rENr8r9r:r<r=r>rErE6r=rEc eZdZy)rFNr9r<r=r>rFrF=r:r=rFc eZdZy)rHNr9r<r=r>rHrHDr:r=rHc eZdZy)rJNr9r<r=r>rJrJKr:r=rJc eZdZy)rKNr9r<r=r>rKrKRr:r=rKceZdZUded<ded<ded<eddZe ddZdd Zd d  dd Z dd Z ddZ ddZ ddZ ddZddZd dZ d!dZy)"rGEagerSeries[NativeSeriesT]_seriesr _breakpoint$HistData[NativeSeriesT, _CountsT_co]_datac.|jjSrO)rArRrPs r>rRzEagerSeriesHist.native^s||"""r=cD|j|}||_||_|SrO)__new__rArB)rZrbrobjs r> from_serieszEagerSeriesHist.from_seriesbs%kk# , r=cyrOr<rPs r>rzEagerSeriesHist.to_framekrWr=both)closedcyrOr<)rQstartend num_samplesrLs r> _linear_spacezEagerSeriesHist._linear_spacelsr=cyrOr<rPs r>is_empty_serieszEagerSeriesHist.is_empty_seriesvrWr=c,|jrggdSdgiS)N)r6r7r7)rBrPs r> data_emptyzEagerSeriesHist.data_emptyys262B2Bb2.URT Ur=cyrOr<)rQargs r> series_emptyzEagerSeriesHist.series_empty~/2r=ct|dkr|j|_|S|jr|j ||_|S|j ||_|S)N)r|rUrDrSrX_calculate_histrQrs r> with_binszEagerSeriesHist.with_binssb t9>*DJ   ! ! #**40DJ --d3DJ r=c|dk(r|j|_|S|jr|j||_|S|j |j ||_|Sr)rUrDrSrXr\_calculate_binsrQrs r>with_bin_countzEagerSeriesHist.with_bin_countsi >*DJ   ! ! #**95DJ --d.B.B9.MNDJ r=c\t|tr|jdd|dzn|}|ddS)Nrr[)rrrQ)rQrWrs r>_calculate_breakpointz%EagerSeriesHist._calculate_breakpoints04>sC4Ht!!!Qa0cABxr=cyrOr<ras r>r`zEagerSeriesHist._calculate_binsrWr=cyrOr<r]s r>r\zEagerSeriesHist._calculate_histrYr=Nr)rbr@rrrr$)rr) rNrrOrrPrrLzLiteral['both', 'none']rr2r)rrC)rWint | list[float]rrC)rrrr$)rrrr$)rWrgrlist[float] | _1DArray)rrrr2)rrhrrC)r8r9r:r;rrRrrIrrQrSrUrXr^rbrdr`r\r<r=r>rGrGYs '' // ##/HL 1+1   (  +V 3$3 -3?3*3 -3r=rG)T __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/r0r1r2r3r5r?__all__rCrDr'rIrErFrHrJrKrGr<r=r>rsM"AA7WV9<< >>@<HH%&B9gm]&BCB m?dK  y ./}&' ] y xDM/-0(=2IDMN3()"# "2 233>(_&667 O- -.(_&667! _. ./_&667o& _. ./_&667/" _. ./_&667O$ _. ./_&667O$ _. ./B3h}k9:B3r=