
    Lpj                    B   % S SK Jr  S SKrS SKrS SKJrJrJrJr  S SK	J
r
Jr  S SKJr  S SKJr  S SKJr  S SKJr  S S	KJr  S S
KJrJrJrJrJrJrJrJrJrJ r J!r!J"r"  S SK#J$r$  S SK%J&r&J'r'J(r(  S SK)J*r*J+r+  S SK,J-r-  S SK.J/r/  \(       a  S SK0J1r1J2r2J3r3J4r4J5r5  S SK6J7r7  S SKJ8r8  S SK9r:S SK;r<S SK=r>S SK?J@r@JArA  S SKBJCrC  S SKDJErE  S SKFJGrG  S SKHJIrI  S SKJJKrK  S SKLJMrM  S SK%JNrNJOrO  S SK,JPrP  S SKQJRrRJSrSJTrTJUrUJVrVJWrWJXrXJYrYJZrZJ[r[J\r\J]r]  Sr^S\_S'   0 S S!_S"S!_S#S$_S%S$_S&S'_S(S'_S)S*_S+S*_S,S-_S.S-_S/S0_S1S0_S2S3_S4S3_S5S6_S7S6_S8S9_S9S:S:S;S<.Er`0 S S9_S"S9_S#S9_S%S9_S&S9_S(S9_S)S9_S+S9_S,S9_S.S9_S/S9_S1S9_S2S9_S4S9_S5S9_S7S9_S8S9_S9S:S:S;S<.Era " S= S>\
\   5      rb " S? S@\SA   5      rcg)B    )annotationsN)TYPE_CHECKINGAnyLiteraloverload)EagerSeriesEagerSeriesHistPandasLikeSeriesCatNamespace!PandasLikeSeriesDateTimeNamespace)PandasLikeSeriesListNamespacePandasLikeSeriesStringNamespace)PandasLikeSeriesStructNamespace)NUMPY_VERSIONalign_and_extract_nativebinary_string_sum_fallbackbroadcast_series_to_indexget_dtype_backendimport_array_modulenarwhals_to_native_dtypenative_to_narwhals_dtypeobject_native_to_narwhals_dtyperenameselect_columns_by_name	set_index)assert_never)
NO_DEFAULTImplementation
is_list_of)is_numpy_array_1dis_pandas_like_series)String)InvalidOperationError)CallableHashableIterableIteratorSequence)
ModuleType)	TypeAlias)SelfTypeIs)ChunkedArrayAny)HistDataPandasLikeDataFramePandasLikeNamespace)NativeSeriesT)	NoDefault)Version_LimitedContext)DType)ClosedIntervalFillNullStrategyInto1DArray	IntoDTypeModeKeepStrategyNonNestedLiteralPythonLiteral
RankMethodRollingInterpolationMethodSizedMultiIndexSelector_1DArray_SliceIndexz%HistData[pd.Series[Any], list[float]]r,   PandasHistDataInt64int64zint64[pyarrow]Int32int32zint32[pyarrow]Int16int16zint16[pyarrow]Int8int8zint8[pyarrow]UInt64uint64zuint64[pyarrow]UInt32uint32zuint32[pyarrow]UInt16uint16zuint16[pyarrow]UInt8uint8zuint8[pyarrow]Float64float64float32float16)zfloat64[pyarrow]Float32zfloat32[pyarrow]zhalffloat[pyarrow]c                     \ rS rSr        SS jr\SS j5       rSS jrSS jrSS jr	SS jr
SS jrS	S
.SS jjr\SSSS.           SS jj5       r\SS j5       r\SS j5       r\SS j5       r\SS j5       r\SS j5       r\SS j5       r\S 5       r                SS jr\        SS j5       r\S	S.       SS jj5       rS	S.       SS jjrSS jrSSS jjrSS jrSS jr        SS  jrSS! jrSS" jr SS# jr!SS$ jr"SS% jr#SS& jr$SS' jr%SS( jr&SS) jr'SS* jr(SS+ jr)SS, jr*SS- jr+SS. jr,SS/ jr-SS0 jr.SS1 jr/SS2 jr0SS3 jr1SS4 jr2SS5 jr3SS6 jr4SS7 jr5SS8 jr6SS9 jr7SS: jr8SS; jr9SS< jr:SS= jr;SS> jr<SS? jr=SS@ jr>SSA jr?SSB jr@SSC jrASSD jrBSSE jrCSSF jrDSSG jrESSH jrFSSI jrGSSJ jrHSSK jrISSL jrJSSM jrKSSN jrLSSO jrMSSP jrNSSQ jrOSSR jrP        SSS jrQSST jrRSSU jrSSSV jrTSSW jrUSSX jrVSSY jrWSZS[.SS\ jjrXSS] jrYSS^ jrZ          SS_ jr[SS` jr\SSa jr]SSb jr^SSSc.SSd jjjr_SSe jr`SSf jraSSg jrbSSh jrcSSi jrdSSj jreSSk jrf          SSl jrg      SSm jrhSSn jriSSo jrjSSp jrkSSq jrlSSr jrmSSs jrnSSt jroSSu jrpSSv jrqSSw jrrSSx jrsSSy jrtSSz jruSS{ jrvSS| jrwSS} jrxSS~ jrySS jrzSS jr{          SS jr|          SS jr}SS jr~SS jrSS jrSS jr      SS jr      SS jrSS jrSS jrSS jrSS jrSS jrSS jr      SS jr      SS jrSS jr\SS j5       r\SS j5       r\SS j5       r\SS j5       r\SS j5       rSrg)PandasLikeSeriesu   c               X    UR                   U l        Xl        X l        X0l        SU l        g )NF)name_name_native_series_implementation_version
_broadcast)selfnative_seriesimplementationversions       X/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/narwhals/_pandas_like/series.py__init__PandasLikeSeries.__init__v   s+     #''
+-      c                    U R                   $ N)rb   rf   s    rj   nativePandasLikeSeries.native   s    """rm   c                    U R                   R                  5       (       a  U R                   R                  5       $ S[        U R                   5       3n[	        U5      e)Nz!Expected pandas/modin/cudf, got: )rc   is_pandas_liketo_native_namespacetypeAssertionErrorrf   msgs     rj   __native_namespace__%PandasLikeSeries.__native_namespace__   sO    ..00'';;==1$t7K7K2L1MNS!!rm   c                H    SSK Jn  U" U R                  U R                  5      $ )Nr   r3   )narwhals._pandas_like.namespacer4   rc   rd   )rf   r4   s     rj   __narwhals_namespace__'PandasLikeSeries.__narwhals_namespace__   s    G"4#7#7GGrm   c                    [        U[        5      (       a  [        U5      OUnU R                  U R                  R
                  U   5      $ ro   )
isinstancetuplelist_with_nativerq   ilocrf   rowss     rj   _gatherPandasLikeSeries._gather   s9    'e44tDz$  !1!1$!788rm   c                    U R                  U R                  R                  [        UR                  UR
                  UR                  5         5      $ ro   )r   rq   r   slicestartstopstepr   s     rj   _gather_slicePandasLikeSeries._gather_slice   s<      KKU4::tyy$))DE
 	
rm   c                L    U R                  U R                  U R                  US9$ N)rh   ri   )	__class__rq   rc   )rf   ri   s     rj   _with_versionPandasLikeSeries._with_version   s)    ~~KK(<(<g  
 	
rm   Fpreserve_broadcastc               ~    U R                  XR                  U R                  S9nU(       a  U R                  Ul        U$ r   )r   rc   rd   re   )rf   seriesr   results       rj   r   PandasLikeSeries._with_native   s:    #7#7   
  $Frm    N)r`   dtypeindexc               2   UR                   nUR                  nUR                  5       n0 n	U(       a  [        US Xg5      U	S'   O3UR	                  5       (       a  SU	S'   O Ub  [        U5      (       a  XYS'   U R                  UR                  " U4SU0U	D6US9$ )Nr   Fcopyr   r`   context)rc   rd   ru   r   	is_pandaslenfrom_nativeSeries)
clsdatar   r`   r   r   rh   ri   nskwdss
             rj   from_iterablePandasLikeSeries.from_iterable   s     !00""//1!4UD.ZDM''))$V SZZ %WryyADADA7SSrm   c                    [        U 5      $ ro   )r#   )objs    rj   
_is_nativePandasLikeSeries._is_native   s    $S))rm   c              8    U " XR                   UR                  S9$ r   )rc   rd   )r   r   r   s      rj   r   PandasLikeSeries.from_native   s    4(?(?IYIYZZrm   c                  UR                   n[        U5      (       a  UOU/nUR                  5       R                  USS9nU R	                  XRS9$ )Nr   r`   r   )rc   r"   ru   r   r   )r   r   r   rh   arrrq   s         rj   
from_numpyPandasLikeSeries.from_numpy   sO     00'--dD6335<<Sr<Jv77rm   c           	     p   US   R                  5       R                  nU Vs/ s H  n[        U5      PM     nn[        S [	        XASS9 5       5      nXR                  U5         R                  R
                  n/ nU H  nUR                  (       a?  [        UR                  XcR                  R                  5       US9nUR                  U5      n	OKUR                  R
                  ULa0  [        UR                  XcR                  S9nUR                  U5      n	OUn	UR                  U	5        M     U$ s  snf )Nr   c              3  P   #    U  H  u  pUR                   (       a  M  Uv   M     g 7fro   )re   ).0lengthss      rj   	<genexpr>9PandasLikeSeries._align_full_broadcast.<locals>.<genexpr>   s      
$FyvallFF$Fs   &	&F)strict)	is_nestedseries_classrh   )rz   r   r   maxzipr   rq   re   r   r   r   r   r   rc   append)
r   r   r   r   lengthstarget_lengthidx	reindexedrq   	compliants
             rj   _align_full_broadcast&PandasLikeSeries._align_full_broadcast   s   //188#)*6a3q66* 
$'$F
 
 ]]=1299??	A||2HHcWW->->-@v NN62	s*"188SARARSNN62		Y'  % +s   D3c                    U R                   $ ro   )ra   rp   s    rj   r`   PandasLikeSeries.name   s    zzrm   c                    U R                   R                  nUS:w  a   [        XR                  U R                  5      $ [        U R                   U R                  U R                  5      $ )Nobject)rq   r   r   rd   rc   r   )rf   native_dtypes     rj   r   PandasLikeSeries.dtype   sZ    {{(( x' %\==$BVBVW	
 1T]]D,@,@	
rm   c                N    [         (       a  SS KnU$ [        U R                  5      $ Nr   )r   numpyr   rc   )rf   nps     rj   _array_funcsPandasLikeSeries._array_funcs   s     =I"4#7#788rm   c          
     |   U R                   nUR                  5       n	U R                  [        R                  L aO  US:X  a  U(       a  U	R                  5       (       d   UR                  XX4US9R                  5       n
O-Sn[        U5      eUR                  XX4XeUS9R                  5       n
S X'   U R                  U
5      $ )Nr   )comspanhalflifealphaadjustzscuDF only supports `ewm_mean` when there are no missing values or when both `min_period=0` and `ignore_nulls=False`)	ignore_na)
rq   isnarc   r    CUDFanyewmmeanNotImplementedErrorr   )rf   r   r   	half_lifer   r   min_samplesignore_nullssermask_nar   ry   s               rj   ewm_meanPandasLikeSeries.ewm_mean   s     kk((*>#6#66q w{{}}PV ! $& 
K  *#..WW9[L  df    ((rm   c                   g ro    rf   indicesvaluesin_places       rj   scatterPandasLikeSeries.scatter       rm   )r   c                   g ro   r   r   s       rj   r   r   #  r   rm   c               x   U R                   nU R                  UR                  pe[        UR                  UR                  U   US9nU(       a  UOUR	                  SS9nUR                  5       (       a!  U(       a  [        S:  a  UR	                  5       nXxR                  U'   U(       a  S $ U R                  U5      $ )Nr   T)deep)   )	rc   rq   r   r   r   r   r   r   r   )	rf   r   r   r   implrg   indices_nativevalues_nativer   s	            rj   r   r   (  s    
 ##(,W^^~!MM=..~>t
 #+0B0B0B0M>>]T-A)..0M&3N#t>T%6%6v%>>rm   c                l   U R                   U:X  a4  U R                  R                   S:w  a  U R                  U R                  SS9$ [        U[	        U R                  R                   U R
                  5      U R
                  U R                  S9nU R                  U R                  R                  U5      SS9$ )Nr   Tr   )dtype_backendrh   ri   )r   rq   r   r   r   rc   rd   astype)rf   r   pd_dtypes      rj   castPandasLikeSeries.cast;  s    ::4;;#4#4#@ $$T[[T$JJ++DKK,=,=t?S?ST//MM	
   !3!3H!=RV WWrm   c                    UcB  [        U 5      S:w  a  S[        U 5       S3n[        U5      eU R                  R                  S   $ U R                  R                  U   $ )N   zlcan only call '.item()' if the Series is of length 1, or an explicit index is provided (Series is of length )r   )r   
ValueErrorrq   r   )rf   r   ry   s      rj   itemPandasLikeSeries.itemI  sf    =4yA~NNQRVi[XY[  !o%;;##A&&{{&&rm   c                x    SSK Jn  U" U R                  R                  5       U R                  U R
                  SS9$ )Nr   r1   F)rh   ri   validate_column_names)narwhals._pandas_like.dataframer2   rq   to_framerc   rd   )rf   r2   s     rj   r  PandasLikeSeries.to_frameU  s5    G"KK  "//MM"'	
 	
rm   c                    U R                   R                  5       nU(       a(  U R                  R                  5       R	                  5       $ U R                  R                  5       $ ro   )rc   is_cudfrq   to_arrow	to_pylistto_list)rf   r  s     rj   r  PandasLikeSeries.to_list_  sF    &&..05<t{{##%//1W$++BUBUBWWrm   c                   U R                   n[        X5      u  pQ[        X5      u  pRUS:X  a$  UR                  U5      UR                  U5      -  nOUS:X  a$  UR	                  U5      UR                  U5      -  nO_US:X  a$  UR	                  U5      UR                  U5      -  nO5US:X  a$  UR                  U5      UR                  U5      -  nO[        U5        U R                  W5      R                  UR                  5      $ )Nleftrightnoneboth)
rq   r   geltgtler   r   aliasr`   )rf   lower_boundupper_boundclosedr   _ress          rj   
is_betweenPandasLikeSeries.is_betweenc  s     kk1$D1$DV&&%{(;;Cw&&%{(;;Cv&&%{(;;Cv&&%{(;;C   %++CHH55rm   c                   U R                   nUR                  U5      n[        UR                  U R                  5      nUb|  UR                  US9nU R                  R                  5       (       a/  U R                  S:  a  UR                  UR                  5       SS9  OUR                  UR                  5       5      nU R                  U5      $ )Nr      r   Tinplace)rq   isinr   r   rc   convert_dtypesr   _backend_versionmaskr   r   )rf   otherr   r"  r   s        rj   is_inPandasLikeSeries.is_inu  s    kkhhuo)#))T5I5IJ$$$=$AC##--//D4I4IF4RT2hhsxxz*  %%rm   c                    U R                   n[        U5      nU R                  R                  U5      nUR	                  X1R
                  UR                  S9R                  U   nU R                  U5      $ )N)r`   r   )	rq   r   r   aranger   r`   r   locr   )rf   r   sizer   r   s        rj   arg_truePandasLikeSeries.arg_true  s`    kk3x  ''-t((#))DHHM  ((rm   c                6    U R                   R                  5       $ ro   )rq   argminrp   s    rj   arg_minPandasLikeSeries.arg_min      {{!!##rm   c                6    U R                   R                  5       $ ro   )rq   argmaxrp   s    rj   arg_maxPandasLikeSeries.arg_max  r<  rm   c                    [        U[        5      (       d  [        X5      u  p#OUnU R                  U R                  R
                  U   5      R                  U R                  5      $ ro   )r!   boolr   r   rq   r4  r  r`   )rf   	predicater!  other_natives       rj   filterPandasLikeSeries.filter  sO    )T**6tGOA|$L  !>?EEdiiPPrm   c                l    [        U R                  5      (       a  U R                  R                  S   $ S $ r   r   rq   r   rp   s    rj   firstPandasLikeSeries.first  s*    &)$++&6&6t{{"@D@rm   c                l    [        U R                  5      (       a  U R                  R                  S   $ S $ )NrH  rp   s    rj   lastPandasLikeSeries.last  s*    '*4;;'7'7t{{#ATArm   c                   [        X5      u  p4U R                  =(       a    [        USS5      n U" X45      nU R                  XeS9R                  U R                  5      $ ! [         a    UR                  S:X  au  U R
                  [        :X  aa  [        U[        5      (       d.  [        X R                  5      (       a2  UR
                  [        :X  a  U R                  5       n[        X4U5      n Ne f = f)Nre   Taddr   )r   re   getattr	TypeError__name__r   r$   r   strr   rz   r   r   r  r`   )rf   opr/  r   rD  r   r"  pdxs           rj   _with_binaryPandasLikeSeries._with_binary  s    4TA!__Sd1S	S'C    LRRII
 	
  	 u$JJ&(uc**"5..99ekkV>S //10CH	s   A BC0.C0c                b   ^ U R                  U4S jU5      R                  U R                  5      $ )Nc                   > T" X5      $ ro   r   )xyrU  s     rj   <lambda>5PandasLikeSeries._with_binary_right.<locals>.<lambda>  s	    bhrm   )rW  r  r`   )rf   rU  r/  s    ` rj   _with_binary_right#PandasLikeSeries._with_binary_right  s&      !6>DDTYYOOrm   c                B    U R                  [        R                  U5      $ ro   )rW  operatoreqrf   r/  s     rj   __eq__PandasLikeSeries.__eq__        e44rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  nerd  s     rj   __ne__PandasLikeSeries.__ne__  rg  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  r  rd  s     rj   __ge__PandasLikeSeries.__ge__  rg  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  r  rd  s     rj   __gt__PandasLikeSeries.__gt__  rg  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  r  rd  s     rj   __le__PandasLikeSeries.__le__  rg  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  r  rd  s     rj   __lt__PandasLikeSeries.__lt__  rg  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  and_rd  s     rj   __and__PandasLikeSeries.__and__  s      66rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  ry  rd  s     rj   __rand__PandasLikeSeries.__rand__  s    &&x}}e<<rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  or_rd  s     rj   __or__PandasLikeSeries.__or__        u55rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __ror__PandasLikeSeries.__ror__      &&x||U;;rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  rP  rd  s     rj   __add__PandasLikeSeries.__add__  r  rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  rP  rd  s     rj   __radd__PandasLikeSeries.__radd__  r  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  subrd  s     rj   __sub__PandasLikeSeries.__sub__  r  rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __rsub__PandasLikeSeries.__rsub__  r  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  mulrd  s     rj   __mul__PandasLikeSeries.__mul__  r  rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __rmul__PandasLikeSeries.__rmul__  r  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  truedivrd  s     rj   __truediv__PandasLikeSeries.__truediv__  s      !1!1599rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __rtruediv__PandasLikeSeries.__rtruediv__  s    &&x'7'7??rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  floordivrd  s     rj   __floordiv__PandasLikeSeries.__floordiv__  s      !2!2E::rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __rfloordiv__PandasLikeSeries.__rfloordiv__  s    &&x'8'8%@@rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  powrd  s     rj   __pow__PandasLikeSeries.__pow__  r  rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __rpow__PandasLikeSeries.__rpow__  r  rm   c                B    U R                  [        R                  U5      $ ro   )rW  rb  modrd  s     rj   __mod__PandasLikeSeries.__mod__  r  rm   c                B    U R                  [        R                  U5      $ ro   )r_  rb  r  rd  s     rj   __rmod__PandasLikeSeries.__rmod__  r  rm   c                :    U R                  U R                  ) 5      $ ro   r   rq   rp   s    rj   
__invert__PandasLikeSeries.__invert__        $++..rm   c                :    U R                  U R                  * 5      $ ro   r  rp   s    rj   __neg__PandasLikeSeries.__neg__  r  rm   c                6    U R                   R                  5       $ ro   )rq   r   rp   s    rj   r   PandasLikeSeries.any	      {{  rm   c                6    U R                   R                  5       $ ro   )rq   allrp   s    rj   r  PandasLikeSeries.all  r  rm   c                6    U R                   R                  5       $ ro   )rq   minrp   s    rj   r  PandasLikeSeries.min  r  rm   c                6    U R                   R                  5       $ ro   )rq   r   rp   s    rj   r   PandasLikeSeries.max  r  rm   c                6    U R                   R                  5       $ ro   )rq   sumrp   s    rj   r  PandasLikeSeries.sum  r  rm   c                6    U R                   R                  5       $ ro   )rq   countrp   s    rj   r  PandasLikeSeries.count  s    {{  ""rm   c                6    U R                   R                  5       $ ro   )rq   r   rp   s    rj   r   PandasLikeSeries.mean  s    {{!!rm   c                    U R                   R                  5       (       d  Sn[        U5      eU R                  R	                  5       $ )Nz<`median` operation not supported for non-numeric input type.)r   
is_numericr%   rq   medianrx   s     rj   r  PandasLikeSeries.median  s8    zz$$&&PC',,{{!!##rm   c               4    U R                   R                  US9$ Nddof)rq   stdrf   r  s     rj   r  PandasLikeSeries.std$      {{D))rm   c               4    U R                   R                  US9$ r  )rq   varr  s     rj   r  PandasLikeSeries.var'  r  rm   c                J   U R                   R                  5       n[        U5      S:X  a  g [        U5      S:X  a  [        S5      $ [        U5      S:X  a  gXR	                  5       -
  nUS-  R	                  5       nUS-  R	                  5       nUS:w  a  XCS-  -  $ [        S5      $ )Nr   r  nanr   g        r(  g      ?rq   dropnar   floatr   )rf   ser_not_nullmm2m3s        rj   skewPandasLikeSeries.skew*  s    {{))+|!|!<|!,,..d[[]d[[]!#qrW~:eEl:rm   c                0   U R                   R                  5       n[        U5      S:X  a  g [        U5      S:X  a  [        S5      $ XR	                  5       -
  nUS-  R	                  5       nUS-  R	                  5       nUS:w  a
  XCS-  -  S-
  $ [        S5      $ )Nr   r  r  r      g      @r  )rf   r  r  r  m4s        rj   kurtosisPandasLikeSeries.kurtosis7  s    {{))+|!|!<,,..d[[]d[[]%'1WrU|c!>%,>rm   c                ,    [        U R                  5      $ ro   )r   rq   rp   s    rj   r   PandasLikeSeries.lenB  s    4;;rm   c                R    U R                  U R                  R                  5       SS9$ )NTr   )r   rq   r   rp   s    rj   is_nullPandasLikeSeries.is_nullG  s%      !1!1!3 MMrm   c                    U R                   nU R                  R                  5       (       d  SU R                   S3n[        U5      eU R	                  X:g  SS9$ )Nz3`.is_nan` only supported for numeric dtype and not z, did you mean `.is_null`?Tr   )rq   r   r  r%   r   )rf   r   ry   s      rj   is_nanPandasLikeSeries.is_nanJ  sT    kkzz$$&&G

|SmnC',,   EErm   c                   U R                   nU R                  [        R                  L a  U R                  S:  a  SS0O0 n[
        R                  " 5          [
        R                  " SS[        S9  Ub0  [        X5      u  pgU R                  UR                  " SSU0UD6SS	9nO<U R                  US
:X  a  UR                  " SSU0UD6OUR                  " SSU0UD6SS	9nS S S 5        U$ ! , (       d  f       W$ = f)Nr(  downcastFignorez&The 'downcast' keyword .*is deprecated)categoryvalueTr   forwardlimitr   )rq   rc   r    PANDASr-  warningscatch_warningsfilterwarningsFutureWarningr   r   fillnaffillbfill)	rf   r  strategyr  r   kwargsr!  native_valueres_sers	            rj   	fill_nullPandasLikeSeries.fill_nullR  s    kk ##~'<'<<%%,  	 	 $$&##B]  ":4"G++JJ<\<V<QU ,  ++9, II4E4V499&9'+	 ,  '  ! '&  s   B
C))
C8c                   U R                   nUR                  5       (       a  Uc  Sn[        U5      eU R                  R	                  5       (       d  SU R                   S3n[        U5      eU R                  nUc   UR                  R                  R                  OUnXD:g  nUR                  5       nUR                  5       (       a  US:  a  UR                  SSS9  OUR                  S5      nU R                  UR                  Xe5      SS9$ )	Nz6`fill_nan(value=None)` is not support for CuDF backendz5`.fill_nan` only supported for numeric dtype and not z, did you mean `.fill_null`?r'  FTr)  r   )rc   r  r   r   r  r%   rq   arrayna_valuer-  r   r  r   r.  )rf   r  r   ry   r   fillr.  backend_versions           rj   fill_nanPandasLikeSeries.fill_nanq  s    ##<<>>u}JC%c**zz$$&&I$**UqrC',,KK).qww}}%%Ev//1>>& 8KKtK,;;u%D  !3 MMrm   c                T    U R                  U R                  R                  5       5      $ ro   )r   rq   r  rp   s    rj   
drop_nullsPandasLikeSeries.drop_nulls  s       !3!3!566rm   c                4    U R                   R                  SS9$ )NF)r  )rq   nuniquerp   s    rj   n_uniquePandasLikeSeries.n_unique  s    {{""%"00rm   c               T    U R                  U R                  R                  XUS95      $ )N)nreplacerandom_state)r   rq   sample)rf   r  with_replacementseeds       rj   r"  PandasLikeSeries.sample  s,      KK4P
 	
rm   c                T    U R                  U R                  R                  5       5      $ ro   )r   rq   absrp   s    rj   r'  PandasLikeSeries.abs  s      !233rm   c                   U(       d  U R                   R                  SS9O$U R                   S S S2   R                  SS9S S S2   nU R                  U5      $ NT)skipnarL  )rq   cumsumr   rf   reverser   s      rj   cum_sumPandasLikeSeries.cum_sum  ]      KKd+TrT")))6tt< 	
   ((rm   Tmaintain_orderc                   U R                  [        U R                  5      " U R                  R                  5       U R                  S95      $ )zePandas always maintains order, as per its docstring.

> Uniques are returned in order of appearance.
r   )r   rv   rq   uniquer`   )rf   r3  s     rj   r5  PandasLikeSeries.unique  s6    
   dkk!24;;3E3E3Gdii!XYYrm   c                T    U R                  U R                  R                  5       5      $ ro   )r   rq   diffrp   s    rj   r8  PandasLikeSeries.diff  s       !1!1!344rm   c                V    U R                  U R                  R                  U5      5      $ ro   )r   rq   shiftrf   r  s     rj   r;  PandasLikeSeries.shift  s"      !2!21!566rm   c               D   U R                  5       nU R                  nU R                  nU R                  n[	        UR
                  U5      n	U(       a  [        XIXR                  5      OS n
UR                  U5      R                  U5      nUS:  nUR                  X:U R                  S9nUc  U	b  UR                  U	S9nUR                  UR                  XS5         nUR                  Ul        U[         L az  UR#                  5       U) -  nUR%                  5       (       a>  U R'                  X   5      R)                  SS9R+                  5       nSU 3n[-        U5      eUR                  US 5      nO [/        X5      u  nnUR                  UU5      nU R'                  U5      $ )Nr   )r   r`   r&  Fr2  zYreplace_strict did not replace all non-null values.

The following did not get replaced: )rz   r   rq   rc   r   r   r   rd   Indexget_indexerr   r`   r,  r   wherer   r   notnar   r   r5  r  r%   r   )rf   defaultoldnewreturn_dtype	namespacearray_funcsrq   r   r   r   idxswas_matched
new_seriesnative_resultunmatched_maskunmatched_valuesry   r!  default_natives                       rj   replace_strictPandasLikeSeries.replace_strict  s    --/	''##)&,,=  %\$V 	 s#//7ai%%cTYY%G
M$=#222OJ #(9(9+Q(OP$llj #\\^|<N!!##%%f&<=V5V1WY !;;K:LN  ,C00)//TBM !9 GA~)//^LM  //rm   c                   U(       a  SOSnU R                  U R                  R                  U(       + US95      R                  U R                  5      $ )NrM  rI  )	ascendingna_position)r   rq   sort_valuesr  r`   )rf   
descending
nulls_lastrT  s       rj   sortPandasLikeSeries.sort  sE     *f  KK##*n+#V

%		
	rm   c                |    XR                   :w  a,  U R                  [        U R                  XR                  S9SS9$ U $ )Nr   Tr   )r`   r   r   rq   rc   )rf   r`   s     rj   r  PandasLikeSeries.alias  sB    99$$t{{D9M9MN#' %   rm   c                    U R                  XS9$ )N)r   r   )to_numpy)rf   r   r   s      rj   	__array__PandasLikeSeries.__array__  s     }}5}44rm   )r   c                  U R                   R                  nU R                  n[        XCR                  5      (       aL  UR
                  b?  U R                  R                  S5      R                  R                  S 5      R                  nOU R                  nSU=(       d    U R                  R                  5       0n[        UR                  5      nU[        ;   d
  U[        ;   a  UR                  5       R!                  5       nU(       a8  U[        ;   a.  UR#                  S[%        S5      05        U=(       d	    [        U   nU(       d  U[        ;   a  U=(       d	    [        U   nUR&                  " SSU0UD6$ )NUTCr   r  r  r   r   )rd   dtypesr   r   Datetime	time_zonedtconvert_time_zonereplace_time_zonerq   rc   r  rT  PANDAS_TO_NUMPY_DTYPE_MISSING PANDAS_TO_NUMPY_DTYPE_NO_MISSINGr   r   updater  r]  )	rf   r   r   rb  
self_dtyper   r  	dtype_strhas_missings	            rj   r]  PandasLikeSeries.to_numpy  s    %%ZZ
j//22z7K7K7W))%033EEdKRRAA"($*P$2F2F2N2N2P!QL	66<<&&(,,.Ky,IIz5<89I!>y!I90P#PL!A)!Lzz0000rm   c                d   U R                   [        R                  L a  U R                  $ U R                   [        R                  L a  U R                  R                  5       $ U R                   [        R                  L a  U R                  R                  5       $ SU R                    3n[        U5      e)NzUnknown implementation: )	rc   r    r  rq   r   	to_pandasMODIN
_to_pandasrw   rx   s     rj   rp  PandasLikeSeries.to_pandas  s    >#8#88;;>#6#66;;((**>#7#77;;))++()=)=(>?S!!rm   c                J    SS K nUR                  " U R                  5       5      $ r   )polarsfrom_pandasrp  )rf   pls     rj   	to_polarsPandasLikeSeries.to_polars  s    ~~dnn.//rm   c                    U R                  U R                  R                  SS9) 5      R                  U R                  5      $ )NFkeepr   rq   
duplicatedr  r`   rp   s    rj   	is_uniquePandasLikeSeries.is_unique  s7      $++"8"8e"8"D!DEKKDIIVVrm   c                R    U R                   R                  5       R                  5       $ ro   )rq   r   r  rp   s    rj   
null_countPandasLikeSeries.null_count   s    {{!%%''rm   c                    U R                  U R                  R                  SS9) 5      R                  U R                  5      $ )NrI  r{  r}  rp   s    rj   is_first_distinct"PandasLikeSeries.is_first_distinct#  s7      $++"8"8g"8"F!FGMMdiiXXrm   c                    U R                  U R                  R                  SS9) 5      R                  U R                  5      $ )NrM  r{  r}  rp   s    rj   is_last_distinct!PandasLikeSeries.is_last_distinct&  s7      $++"8"8f"8"E!EFLLTYYWWrm   c                   [        U[        5      (       d  S[        U5       3n[        U5      eU(       a  U R                  R
                  $ U R                  R                  $ )Nz/argument 'descending' should be boolean, found )r   rB  rv   rR  rq   is_monotonic_decreasingis_monotonic_increasing)rf   rV  ry   s      rj   	is_sortedPandasLikeSeries.is_sorted)  sN    *d++CDDTCUVCC. ;;666{{222rm   c                  SSK Jn  U R                  c  SOU R                  nU=(       d    U(       a  SOSnU R                  R	                  SSUS9R                  5       nXg/Ul        U(       a  UR                  USS9nUR                  " XS	9$ )
z-Parallel is unused, exists for compatibility.r   r1   r   
proportionr  F)r  rX  	normalize)rS  r   )	r  r2   ra   rq   value_countsreset_indexcolumnsrU  r   )	rf   rX  parallelr`   r  r2   index_name_value_name_	val_counts	            rj   r  PandasLikeSeries.value_counts2  s     	H!%!3gFy|gKK,,u	 - 

+- 	 )6	!--kU-KI"..yGGrm   c                4    U R                   R                  XS9$ )N)qinterpolation)rq   quantile)rf   r  r  s      rj   r  PandasLikeSeries.quantileE  s     {{##h#LLrm   c                    U R                   n[        X5      u  pA[        X5      u  pBUR                  X5      nU R                  U5      $ ro   )rq   r   rA  r   )rf   r.  r/  r   r!  r"  s         rj   zip_withPandasLikeSeries.zip_withJ  sB    kk*46+D8ii$  %%rm   c                V    U R                  U R                  R                  U5      5      $ ro   )r   rq   headr<  s     rj   r  PandasLikeSeries.headQ  "      !1!1!!455rm   c                V    U R                  U R                  R                  U5      5      $ ro   )r   rq   tailr<  s     rj   r  PandasLikeSeries.tailT  r  rm   c                R    U R                  U R                  R                  US95      $ )N)decimals)r   rq   round)rf   r  s     rj   r  PandasLikeSeries.roundW  s%      !2!2H!2!EFFrm   c                   U R                   nU R                  UR                  5      (       a"  SS KJn  U R                  XR                  5      nO'U R                  R                  nU R                  X5      nU R                  U5      $ r   )
rq   is_native_dtype_pyarrowr   pyarrow.computecompute_apply_pyarrow_compute_funcfloorr   _apply_array_funcr   rf   rq   pcresult_native
array_funcs        rj   r  PandasLikeSeries.floorZ  si    ''55( <<VXXNM**00J 226FM  //rm   c                   U R                   nU R                  UR                  5      (       a"  SS KJn  U R                  XR                  5      nO'U R                  R                  nU R                  X5      nU R                  U5      $ r   )
rq   r  r   r  r  r  ceilr   r  r   r  s        rj   r  PandasLikeSeries.ceile  si    ''55( <<VWWMM**//J 226FM  //rm   c          	        SSK Jn  U R                  5       nU R                  nU R                  (       a  [        U R                  5      OSnU U S3nUR                  5       R                  5       nUR                  UUUUUSS9n	U(       aF  [        U	R                  5      Gt pU/U
Qn[        [        XU R                  5      X0U R                  S9n	UR                  " XS9$ )	Nr   r1   r   nullrN   )prefix
prefix_sep
drop_firstdummy_nar   )r  rh   r   )r  r2   rz   rq   ra   rT  r   r   get_dummiesr   r  r   r   rc   r   )rf   	separatorr  r2   plxr   r`   null_col_pl	has_nullsr   colsnull_col_pdoutput_orders                rj   
to_dummiesPandasLikeSeries.to_dummiesp  s    G'')"&**s4::"yk.KKM%%'	 ! ! 
 !%fnn!5T'/$/L&vT=Q=QR$2#33F
 #..vDDrm   c                X    U R                  U R                  R                  US U2   5      $ ro   )r   rq   r   )rf   r  offsets      rj   gather_everyPandasLikeSeries.gather_every  s(      !1!1&)!)!<==rm   c                   [        X5      u  p4[        X5      u  p5U R                  nUR                  5       (       a  SS0O0 nU R                  nUR	                  5       (       dX  U R                  U5      (       a  UR                  X:  U5      nS nU R                  U5      (       a  UR                  X:*  U5      nS nU R                  UR                  " XE40 UD65      $ Naxisr   	r   rc   is_modinrq   r   r   rA  r   clip)	rf   r  r  r!  lowerupperr   r  r   s	            rj   r  PandasLikeSeries.clip  s    +D>+D>##04&!R~~ u%%fou=u%%fou=  U!DV!DEErm   c                H   [        X5      u  p#U R                  nUR                  5       (       a  SS0O0 nU R                  nUR	                  5       (       d,  U R                  U5      (       a  UR                  Xc:  U5      nS nU R                  UR                  " U40 UD65      $ r  r  )rf   r  r!  r  r   r  r   s          rj   
clip_lowerPandasLikeSeries.clip_lower  s    +D>##04&!R~~DOOE$:$: \\&/59FE  U!=f!=>>rm   c                J   [        X5      u  p#U R                  nUR                  5       (       a  SS0O0 nU R                  nUR	                  5       (       d,  U R                  U5      (       a  UR                  Xc:*  U5      nS nU R                  UR                  " SSU0UD65      $ )Nr  r   r  r   r  )rf   r  r!  r  r   r  r   s          rj   
clip_upperPandasLikeSeries.clip_upper  s    +D>##04&!R~~DOOE$:$: \\&/59FE  !C5!CF!CDDrm   c                    U R                   [        R                  L a  U R                  R	                  5       $ SS KnUR                  R                  U R                  5      $ r   )rc   r    r   rq   r  pyarrowArrayrv  )rf   pas     rj   r  PandasLikeSeries.to_arrow  sE    >#6#66;;''))xx##DKK00rm   c                   U R                   R                  5       nU R                  Ul        U R                  US:X  a  UR	                  S5      5      $ U5      $ )Nr   r  )rq   moder`   r   r  )rf   r|  r   s      rj   r  PandasLikeSeries.mode  sF    !!#ii  45=QMMfMMrm   c                   U R                   R                  5       ) nU(       d  UR                  5       O![        U 5      UR                  5       -
  U-   S-
  nU R	                  U5      $ Nr  )rq   r   r,  r   r   )rf   r.  not_na_seriesr   s       rj   	cum_countPandasLikeSeries.cum_count  sa    ))++    "T]1133mCaG 	
   ((rm   c                   U(       d  U R                   R                  SS9O$U R                   S S S2   R                  SS9S S S2   nU R                  U5      $ r*  )rq   cumminr   r-  s      rj   cum_minPandasLikeSeries.cum_min  r1  rm   c                   U(       d  U R                   R                  SS9O$U R                   S S S2   R                  SS9S S S2   nU R                  U5      $ r*  )rq   cummaxr   r-  s      rj   cum_maxPandasLikeSeries.cum_max  r1  rm   c                   U(       d  U R                   R                  SS9O$U R                   S S S2   R                  SS9S S S2   nU R                  U5      $ r*  )rq   cumprodr   r-  s      rj   cum_prodPandasLikeSeries.cum_prod  s]      KKt,TrT"**$*7"= 	
   ((rm   c               t    U R                   R                  XUS9R                  5       nU R                  U5      $ Nwindowmin_periodscenter)rq   rollingr  r   rf   window_sizer   r  r   s        rj   rolling_sumPandasLikeSeries.rolling_sum  s=    $$ % 

#% 	   ((rm   c               t    U R                   R                  XUS9R                  5       nU R                  U5      $ r  )rq   r  r   r   r  s        rj   rolling_meanPandasLikeSeries.rolling_mean  s=    $$ % 

$& 	   ((rm   c               r    U R                   R                  XUS9R                  US9nU R                  U5      $ Nr  r  )rq   r  r  r   rf   r   r   r  r  r   s         rj   rolling_varPandasLikeSeries.rolling_var  C     $$ % 

#4#. 	   ((rm   c               r    U R                   R                  XUS9R                  US9nU R                  U5      $ r  )rq   r  r  r   r  s         rj   rolling_stdPandasLikeSeries.rolling_std  r  rm   c              #     #    U R                   R                  5       (       a  Sn[        U5      eU R                  R	                  5        S h  vN   g  N7f)NzIterating over a cuDF Series, DataFrame or Index is not supported. For more information see: https://docs.rapids.ai/api/cudf/stable/user_guide/pandas-comparison/#iteration)rc   r  r   rq   __iter__rx   s     rj   r  PandasLikeSeries.__iter__  sH     '')){  &c**;;'')))s   A
AAAc                    Uc(  U R                   R                  5       R                  5       $ U R                   U:H  R                  5       $ ro   )rq   r   r   rd  s     rj   __contains__PandasLikeSeries.__contains__  s9    +0=t{{!%%'Zt{{e?S>X>X>ZZrm   c                r    U R                   nU R                  U[        S5      :  U[        S5      :  -  5      $ )Nz-infinf)rq   r   r  )rf   r   s     rj   	is_finitePandasLikeSeries.is_finite  s3    KK  !eFm"3E%L8H!IJJrm   c          	     \   US:X  a  SOUnU R                   nU R                  [        R                  L GaI  U R                  S:  Ga8  [        U R                  R                  U R                  5      S:X  Ga	  U R                  R                  5       (       a  U R                  5       =nR                  5       (       a  U S3nU R                  5       nU R                  5       R                  UR                  R                  U5      R!                  U5      5      R                  nU R#                  UR%                  U5      R'                  USU(       + SS9R(                  S S 2S	4   5      R!                  U R                   5      $ U R#                  U R                  R'                  USU(       + SS95      $ )
NordinalrI  r  numpy_nullable_is_nullr|  F)method	na_optionrS  pctr   )r`   rc   r    r  r-  r   rq   r   
is_integerr  r   r~   r  with_columns_expr_from_seriesr  r   groupbyrankr   )	rf   r  rV  	pd_methodr`   	null_mask	mask_namer  dfs	            rj   r%  PandasLikeSeries.rank  su   %2G	yy  N$9$99%%,!$++"3"3T5I5IJ 

%%''"lln,1133
  &)I--/Ccii44Y?EEiPQ 
 $$

9%$$",n	   ad	 eDII	   KK F*nRW  
 	
rm   c               b    [         R                  XS9R                  U5      R                  5       $ N)include_breakpoint)_PandasHistfrom_series	with_binsr  )rf   binsr-  s      rj   hist_from_binsPandasLikeSeries.hist_from_binsB  s*     ##D#PYt_XZ	
rm   c               b    [         R                  XS9R                  U5      R                  5       $ r,  )r.  r/  with_bin_countr  )rf   	bin_countr-  s      rj   hist_from_bin_count$PandasLikeSeries.hist_from_bin_countK  s+     ##D#P^I&XZ	
rm   c                $  ^^^ U R                   nU R                  UR                  5      (       a!  SS KJm  SUU4S jjnU R                  X#5      nO0U R                  R                  mSUU4S jjnU R                  X%5      nU R                  U5      $ )Nr   c                (   > TR                  U T5      $ ro   )logb)cabaser  s    rj   pc_log$PandasLikeSeries.log.<locals>.pc_logY  s    wwr4((rm   c                &   > T" U 5      T" T5      -  $ ro   r   )r   r=  log_funcs    rj   	array_log'PandasLikeSeries.log.<locals>.array_log`  s    }x~55rm   )r<  r/   returnr/   )r   r5   rD  r5   )
rq   r  r   r  r  r  r   logr  r   )rf   r=  rq   r>  r  rB  rA  r  s    `    @@rj   rE  PandasLikeSeries.logT  s~    ''55() ) !<<VLM((,,H6 6 !226EM  //rm   c                   U R                   nU R                  UR                  5      (       a"  SS KJn  U R                  XR                  5      nO'U R                  R                  nU R                  X5      nU R                  U5      $ r   )
rq   r  r   r  r  r  expr   r  r   r  s        rj   rH  PandasLikeSeries.expf  si    ''55( <<VVVLM**..J 226FM  //rm   c                V    U R                  U R                  R                  S5      5      $ )N      ?)r   rq   r  rp   s    rj   sqrtPandasLikeSeries.sqrtr  s       !566rm   c                   U R                   nU R                  UR                  5      (       a#  SS KJn  U R                  UUR                  5      nO'U R                  R                  nU R                  X5      nU R                  U5      $ r   )
rq   r  r   r  r  r  sinr   r  r   r  s        rj   rO  PandasLikeSeries.sinu  q    ''55( <<M
 **..J 226FM  //rm   c                   U R                   nU R                  UR                  5      (       a#  SS KJn  U R                  UUR                  5      nO'U R                  R                  nU R                  X5      nU R                  U5      $ r   )
rq   r  r   r  r  r  cosr   r  r   r  s        rj   rS  PandasLikeSeries.cos  rQ  rm   c                2    U R                   n[        XS9S:H  $ )Nr   r  )rc   r   )rf   r   r   s      rj   r  (PandasLikeSeries.is_native_dtype_pyarrow  s    ## CyPPrm   c                   SSK Jn  [        U5      nU" UR                  R                  5      nU" UR                  U R
                  5      n[        USU R                  U R
                  5      nU" XWUR                  UR                  S9$ )Nr   )r   r  )r   r   r`   )
narwhals._arrow.utilsr   rv   r  	_pa_arrayrd   r   rc   r   r`   )rf   rq   pc_funcr   
native_cls
result_arrnw_dtype	out_dtypes           rj   r  ,PandasLikeSeries._apply_pyarrow_compute_func  st     	C&\
V\\334
+JOOT]]K,i!5!5t}}
	 v||&++
 	
rm   c                    [        U5      nU" U5      nU R                  R                  5       (       a  U" XAR                  UR                  S9$ U$ )N)r   r`   )rv   rc   r  r   r`   )rf   rq   r  r[  r\  s        rj   r  "PandasLikeSeries._apply_array_func  sQ     &\
'
 ##++-- zFKKH	
 	
rm   c               l    U(       a  U R                  5       R                  5       $ U R                  5       $ ro   )r  rI  )rf   r   s     rj   	any_valuePandasLikeSeries.any_value  s%    ,8t &&(JdjjlJrm   c                    [        U 5      $ ro   r   rp   s    rj   rT  PandasLikeSeries.str  s    .t44rm   c                    [        U 5      $ ro   r   rp   s    rj   re  PandasLikeSeries.dt  s    066rm   c                    [        U 5      $ ro   r
   rp   s    rj   catPandasLikeSeries.cat  s    +D11rm   c                h    [        U R                  S5      (       d  Sn[        U5      e[        U 5      $ )Nr   z>Series must be of PyArrow List type to support list namespace.)hasattrrq   rR  r   rx   s     rj   r   PandasLikeSeries.list  s-    t{{F++RCC. ,T22rm   c                h    [        U R                  S5      (       d  Sn[        U5      e[        U 5      $ )NstructzBSeries must be of PyArrow Struct type to support struct namespace.)rm  rq   rR  r   rx   s     rj   rp  PandasLikeSeries.struct  s-    t{{H--VCC. .t44rm   )re   rc   ra   rb   rd   )rg   r   rh   r    ri   r7   rD  None)rD  r   )rD  r+   )rD  r4   )r   z'SizedMultiIndexSelector[pd.Series[Any]]rD  r-   )r   z_SliceIndex | rangerD  r-   )ri   r7   rD  r-   )r   r   r   rB  rD  r-   )r   zIterable[Any]r   r8   r`   rT  r   IntoDType | Noner   r   rD  r-   )r   r   rD  zTypeIs[Any])r   r   r   r8   rD  r-   )r   r<   r   r8   rD  r-   )r   r-   rD  zSequence[Self])rD  rT  )rD  r9   )r   float | Noner   rt  r   rt  r   rt  r   rB  r   intr   rB  rD  r-   )r   r-   r   r-   r   zLiteral[True]rD  rr  )r   r-   r   r-   r   zLiteral[False]rD  r-   )r   r-   r   r-   r   rB  rD  zSelf | None)r   r=   rD  r-   ro   )r   
int | NonerD  r   rD  r2   )rD  z	list[Any])r  r   r  r   r   r:   rD  r-   )r/  r   rD  r-   )rD  r-   )rD  ru  )rC  r   rD  r-   )rD  r@   )rU  zCallable[..., pd.Series]r/  r   rD  r-   )r/  r   rD  r-   rD  rB  )rD  r  )r  ru  rD  r  )rD  rt  )r  zSelf | NonNestedLiteralr
  zFillNullStrategy | Noner  rv  rD  r-   )r  rt  rD  r-   )r  ru  r#  rB  r$  rv  rD  r-   )r.  rB  rD  r-   )r3  rB  rD  r-   )r  ru  rD  r-   )
rC  zPandasLikeSeries | NoDefaultrD  Sequence[Any]rE  ry  rF  rs  rD  r]   )rV  rB  rW  rB  rD  r]   )r`   zstr | HashablerD  r-   )r   r   r   zbool | NonerD  rD   )rD  pd.Series[Any])rD  z	pl.Series)rV  rB  rD  rB  )
rX  rB  r  rB  r`   z
str | Noner  rB  rD  r2   )r  r  r  rB   rD  r  )r.  r   r/  r   rD  r-   )r  ru  rD  r-   )r  rT  r  rB  rD  r2   )r  ru  r  ru  rD  r-   )r  r-   r  r-   rD  r-   )r  r-   rD  r-   )r  r-   rD  r-   )rD  zpa.Array[Any])r|  r>   rD  r-   )r   ru  r   ru  r  rB  rD  r-   )
r   ru  r   ru  r  rB  r  ru  rD  r-   )rD  zIterator[Any])r/  r   rD  rB  )r  rA   rV  rB  rD  r-   )r1  list[float]r-  rB  rD  r2   )r6  ru  r-  rB  rD  r2   )r=  r  rD  r-   )r   r   rD  rB  )rq   r5   rZ  z,Callable[[ChunkedArrayAny], ChunkedArrayAny]rD  r5   )rq   r5   r  z(Callable[[NativeSeriesT], NativeSeriesT]rD  r5   )r   rB  rD  r@   )rD  r   )rD  r   )rD  r   )rD  r   )rD  r   )rS  
__module____qualname____firstlineno__rk   propertyrq   rz   r~   r   r   r   r   classmethodr   staticmethodr   r   r   r   r`   r   r   r   r   r   r  r  r  r  r#  r0  r6  r:  r?  rE  rI  rM  rW  r_  re  rj  rm  rp  rs  rv  rz  r}  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r   r  r  r   r  r  r   r  r  r  r  r  r   r  r  r  r  r  r  r"  r'  r/  r5  r8  r;  rP  rX  r  r^  r]  rp  rx  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r	  r  r  r  r  r%  r2  r7  rE  rH  rL  rO  rS  r  r  r  rc  rT  re  rj  r   rp  __static_attributes__r   rm   rj   r]   r]   u   sz      5C NU 	  # #"H
9



 GL   "&TT !	T
 T  T T 
T T0 * * [ [ 8 8  ,   
 
 9 9) ) 	)
  ) ) ) ) ) 
)> %)8E	  IN%)8F	 
 @E??%)?8<?	?&X
'
X66-06:H6	6$
&)$$
QAB
.P5555557=6<6<6<6<:@;A6<6<
//
!!!!!#"$**;	? 
NF& * 	
 
>N,71

4) 04 Z5750-50 50 	50 '50 
50n51 1 10"0W(YX3HH'+H3=HJNH	H&MM.HM	M
&66G	0	0E:>F(?E1N
))))))))03)=A)IL)	)))03)=A)IL)	)*[K#
J

8<
	


59
	
0$
0700Q
#
.Z
	
	
#	
1Y	
		
K 5 5 7 7 2 2 3 3 5 5rm   r]   c                      \ rS rSr% S\S'   SS jrSS jrSS jrSS jrSS	S
.       SS jjr	SS.         SS jjr
SS jrSS jrSrg)r.  i  r]   _seriesc                    U R                   R                  5       R                  R                  nU R                   R	                  5       R
                  nU" U" U R                  5      U R                   S9$ )Nr   )r  r~   
_dataframer   rz   	DataFrame_data)rf   r   r  s      rj   r  _PandasHist.to_frame  sR    ll99;FFRRLL557AA	9TZZ0$,,GGrm   c                <    U R                   R                  5       S:  $ r  )r  r  rp   s    rj   is_empty_series_PandasHist.is_empty_series  s    ||!!#a''rm   c               v    U R                  U5      nU R                  (       a  U R                  U5      US.$ SU0$ )N
breakpointr  r  )_zeros_breakpoint_calculate_breakpoint)rf   argr  s      rj   series_empty_PandasHist.series_empty  s:    C "&"<"<S"AERRrm   c                   U R                   R                  R                  n[        U[        5      (       a  U" U5      $ U" [        U5      S-
  5      $ r  )r  r   zerosr   ru  r   )rf   r  r  s      rj   r  _PandasHist._zeros  s?    ))//'S11uSzJuSX\7JJrm   Nr  )labelsr   c               x    U R                   R                  5       R                  nU" U R                  UUS:H  USS9$ )Nr  T)r1  r  r  include_lowest)r  rz   cutrq   )rf   breaksr  r   r  s        rj   _cut_PandasHist._cut  sA     ll//155KKG#
 	
rm   r  )r   c               P    U R                   R                  R                  XX4S:H  S9$ )Nr  )r   r   numendpoint)r  r   linspace)rf   r   endnum_samplesr   s        rj   _linear_space_PandasHist._linear_space  s0     ||((11{v=M 2 
 	
rm   c                    U R                   R                  5       U R                   R                  5       p2X#:X  a
  US-  nUS-  nU R                  X#US-   5      $ )z6Prepare bins for histogram calculation from bin_count.rK  r  )rq   r  r   r  )rf   r6  r  r  s       rj   _calculate_bins_PandasHist._calculate_bins  sM    {{($++//*;u>SLESLE!!%	A>>rm   c                    U R                  U5      nUR                  SSS9R                  UR                  R                  SS9nUR                  SSS9  U R                  (       a  USS  US.$ S	U0$ )
NTF)r  rX  r   )
fill_value)dropr*  r  r  r  )r  r  reindexrj  
categoriesr  r  )rf   r1  r  r  s       rj   _calculate_hist_PandasHist._calculate_hist  s     YYt_
 ''t%'@HHNN%%! I 
 	tT2"&qr(U;;rm   r   rw  rx  )r  int | list[float]rD  rF   )r  r  rD  rD   )r  list[float] | _1DArrayr  zSequence[str] | Noner   zLiteral['left', 'right']rD  rz  )
r   r  r  r  r  ru  r   zLiteral['both', 'none']rD  rD   )r6  ru  rD  rD   )r1  r  rD  rF   )rS  r|  r}  r~  __annotations__r  r  r  r  r  r  r  r  r  r   rm   rj   r.  r.    s    H(
 K (,+2
&
 %	

 )
 

. +1



 

 	

 (

 


? rm   r.  )rz  r{  )d
__future__r   rb  r  typingr   r   r   r   narwhals._compliantr   r	    narwhals._pandas_like.series_catr   narwhals._pandas_like.series_dtr   !narwhals._pandas_like.series_listr    narwhals._pandas_like.series_strr   #narwhals._pandas_like.series_structr   narwhals._pandas_like.utilsr   r   r   r   r   r   r   r   r   r   r   r   narwhals._typing_compatr   narwhals._utilsr   r    r!   narwhals.dependenciesr"   r#   narwhals.dtypesr$   narwhals.exceptionsr%   collections.abcr&   r'   r(   r)   r*   typesr+   r,   pandaspdru  rw  r  r  typing_extensionsr-   r.   narwhals._arrow.typingr/   narwhals._compliant.seriesr0   r  r2   r}   r4   narwhals._pandas_like.typingr5   narwhals._typingr6   r7   r8   r9   narwhals.typingr:   r;   r<   r=   r>   r?   r@   rA   rB   rC   rD   rE   rF   r  ri  rh  r]   r.  r   rm   rj   <module>r     s   "   8 8 < I M K L O    1 B B J " 5PP  .63CC:*8%    !HNIG$W$g$ W$ g	$
 W$ g$ F$ V$ h$ x$ h$ x$ h$ x$ W$  g!$" y#$$ "!#+$  .!Y!i! Y! i	!
 Y! i! I! Y! i! y! i! y! i! y! Y!  i!!" y#!$ "!#+! 2W5{3' W5t"J /"AB J rm   