
    Lpj"                       % S SK Jr  S SKJrJrJrJrJr  S SK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  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#J$r$  S S
K%J&r&J'r'  S SK(J)r)  S SK*J+r+J,r,J-r-J.r.J/r/  S SK0J1r1  S SK2J3r3J4r4  \(       a  S SK5J6r6J7r7J8r8J9r9  S SK:J;r;  S SKJ<r<  S SK=r>S SK?r@S SKAJBrBJCrC  S SKDJErE  S SKFJGrG  S SKHJIrIJJrJJKrKJLrLJMrMJNrNJOrOJPrPJQrQJRrRJSrS  S SKTJUrU  S SKVJWrW  S SK*JXrXJYrY  S SKZJ[r[  S SK\J]r]J^r^J_r_J`r`JaraJbrbJcrcJdrdJereJfrfJgrgJhrhJiri  SrjS\kS'   \      S)S j5       rl\      S*S j5       rl\      S+S  j5       rl\      S,S! j5       rlS-S" jrl " S# S$\&S%   5      rm " S& S'\'S(   5      rng).    )annotations)TYPE_CHECKINGAnyLiteralcastoverloadNArrowSeriesCatNamespaceArrowSeriesDateTimeNamespaceArrowSeriesListNamespaceArrowSeriesStringNamespaceArrowSeriesStructNamespace)arangecast_for_truedivchunked_arrayextract_nativefloordiv_compatis_array_or_scalarlitnarwhals_to_native_dtypenative_to_narwhals_dtype
nulls_like
pad_seriessortablezeros)EagerSeriesEagerSeriesHist)assert_never)
NO_DEFAULTImplementationgenerate_temporary_column_name
is_list_ofnot_implemented)is_numpy_array_1d)InvalidOperationError
ShapeError)CallableIterableIteratorSequence)
ModuleType)	TypeAlias)SelfTypeIsArrowDataFrameArrowNamespace)ArrayAnyArrayOrChunkedArrayArrayOrScalarChunkedArrayAny
IncompleteNullPlacementOrder	ScalarAny
TieBreaker	_AsPyType_BasicDataType)HistData)	NoDefault)Version_LimitedContext)DType)ClosedIntervalFillNullStrategyInto1DArray	IntoDTypeModeKeepStrategyNonNestedLiteralPythonLiteral
RankMethodRollingInterpolationMethodSizedMultiIndexSelector_1DArray_2DArray_SliceIndexzHHistData[ChunkedArrayAny, list[ScalarAny] | pa.Int64Array | list[float]]r0   ArrowHistDatac                    g N valuereturn_py_scalars     R/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/narwhals/_arrow/series.pymaybe_extract_py_scalarr\   [   s         c                    g rV   rW   rX   s     r[   r\   r\   b   s     r]   c                    g rV   rW   rX   s     r[   r\   r\   i   s     r]   c                    g rV   rW   rX   s     r[   r\   r\   p   s     r]   c                x   ^  [         (       a  T R                  5       $ U(       a  [        T SU 4S j5      " 5       $ T $ )Nas_pyc                    > T $ rV   rW   )rY   s   r[   <lambda>)maybe_extract_py_scalar.<locals>.<lambda>{   s    ur]   )r   rb   getattrrX   s   ` r[   r\   r\   w   s.    }{{}ug}577Lr]   c                    ^  \ rS rSr\R
                  r        SS jr\SS j5       r	SS jr
SS.     SS jjrSS jrSS	 jr\S
SS.         SS jj5       rSU 4S jjr\SS j5       r\S
S.       SS jj5       r\SS j5       r\SS j5       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'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r0\SS/ j5       r1S0S1.SS2 jjr2SS3 jr3S0S1.SS4 jjr4S0S1.SS5 jjr5S0S1.SS6 jjr6S0S1.SS7 jjr7S0S1.SS8 jjr8S0S1.SS9 jjr9S0S1.SS: jjr:S0S1.SS; jjr;S0S1.SS< jjr<SS= jr=SS> jr>S0S1.SS? jjr?S0S1.SS@ jjr@S0S1.SSA jjrAS0S1.SSB jjrBS0S1.SSC jjrCS0S1.SSD jjrDSSE jrE\SSF j5       rFSSG jrGSSH jrHSSI jrISSJ jrJSSSK.SSL jjjrKSSSK.SSM jjjrLSSN jrM\SSO j5       rNSSP jrOSSQ jrPSSR jrQSSS jrRSST jrSSSU jrTS0S1.SSV jjrUS0S1.SSW jjrV        SSX jrWSSY jrXSSZ jrYSS[ jrZS0S1.SS\ jjr[SS] jr\SS^ jr]SS_ jr^SS` jr_SSSa jjr`          SSb jraSSc jrbSSd jrcSSe jrd        SSf jreSSg jrfSSh jrgSSi jrhSSj jriSSk jrjSSl jrkSSm jrlS0Sn.SSo jjrm          SSp jrnSSq jroSSr jrpS0S1.       SSs jjrqSSSt jjrrSSu jrsSSv jrtSSw jruSSx jrvSSy jrwSSz 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rSS jrS0S1.     SS jjr\SS j5       r\SS j5       r\SS j5       r\SS j5       r\SS j5       r\" 5       rSrU =r$ )ArrowSeries   c               6    X l         Xl        X0l        SU l        g )NF)_name_native_series_version
_broadcast)selfnative_seriesnameversions       r[   __init__ArrowSeries.__init__   s     
/<r]   c                    U R                   $ rV   )rl   ro   s    r[   nativeArrowSeries.native   s    """r]   c                L    U R                  U R                  U R                  US9$ N)rq   rr   )	__class__rw   rk   )ro   rr   s     r[   _with_versionArrowSeries._with_version   s    ~~dkk

G~LLr]   Fpreserve_broadcastc               ~    U R                  [        U5      U R                  U S9nU(       a  U R                  Ul        U$ )Nrq   context)from_nativer   rq   rn   )ro   seriesr   results       r[   _with_nativeArrowSeries._with_native   s9     !!-"7diiQU!V $Fr]   c                    [        X5      u  p4U R                  =(       a    [        USS5      nU R                  U" X45      US9R	                  U R
                  5      $ Nrn   Tr~   )r   rn   rf   r   aliasrq   )ro   opotherserother_nativer   s         r[   _with_binaryArrowSeries._with_binary   sX    *47!__Sd1S  s!6H ! 

%		
	r]   c                b   ^ U R                  U4S jU5      R                  U R                  5      $ )Nc                   > T" X5      $ rV   rW   )xyr   s     r[   rd   0ArrowSeries._with_binary_right.<locals>.<lambda>   s	    bhr]   )r   r   rq   )ro   r   r   s    ` r[   _with_binary_rightArrowSeries._with_binary_right   s&      !6>DDTYYOOr]    N)rq   dtypec                   UR                   nUbT  [        XE5      n[        U5      (       a  UR                  U5      nS nU R	                  U5      (       a  UO[        U/U5      nO[        U/5      nU R                  XrUS9$ )N)r   rq   )rm   r   r   r   
_is_nativer   r   )clsdatar   rq   r   rr   dtype_parw   s           r[   from_iterableArrowSeries.from_iterable   sz     ""+CE+SH!$''yy* ^^D11T}dVX7VF"D6*FvTBBr]   c                d   > [        US5      (       a  UR                  5       n[        TU ]  U5      $ )Nrb   )hasattrrb   super_from_scalar)ro   rY   r{   s     r[   r   ArrowSeries._from_scalar   s+    5'""KKMEw#E**r]   c                6    [        U [        R                  5      $ rV   )
isinstancepaChunkedArray)objs    r[   r   ArrowSeries._is_native   s    #r//r]   rq   c              $    U " XR                   US9$ )N)rr   rq   )rm   )r   r   r   rq   s       r[   r   ArrowSeries.from_native   s     4!1!1==r]   c              L    U R                  [        U5      (       a  XS9$ U/US9$ N)r   )r   r(   )r   r   r   s      r[   
from_numpyArrowSeries.from_numpy   s=      %d++D ! 
 	
26 ! 
 	
r]   c           	       ^	 U Vs/ s H  n[        U5      PM     nn[        S [        X1SS9 5       5      m	[        U	4S jU 5       5      nU(       a  U$ / nU H  nUR                  (       a4  UR                  [        R                  " UR                  S   T	5      5      nO'[        U5      =nT	:w  a  ST	 SU S3n[        U5      eUnUR                  U5        M     U$ s  snf )	Nc              3  P   #    U  H  u  pUR                   (       a  M  Uv   M     g 7frV   )rn   ).0lengthss      r[   	<genexpr>4ArrowSeries._align_full_broadcast.<locals>.<genexpr>   s      
$FyvallFF$Fs   &	&F)strictc              3  ,   >#    U  H	  oT:H  v   M     g 7frV   rW   )r   _lentarget_lengths     r[   r   r      s     B'$-'s   r   zExpected object of length z, got .)lenmaxzipallrn   r   r   repeatrw   r*   append)
r   r   r   lengths	fast_pathreshaped	compliant
actual_lenmsgr   s
            @r[   _align_full_broadcast!ArrowSeries._align_full_broadcast   s    #)*6a3q66* 
$'$F
 
 B'BB	MA||NN299QXXa[-+PQ	 #A&*=82=/
|STU o%	OOI&  # +s   Cc                .    SSK Jn  U" U R                  S9$ )Nr   r5   )rr   )narwhals._arrow.namespacer6   rm   )ro   r6   s     r[   __narwhals_namespace__"ArrowSeries.__narwhals_namespace__   s    <dmm44r]   c                B    U R                  [        R                  U5      $ rV   )r   pcequalro   r   s     r[   __eq__ArrowSeries.__eq__         511r]   c                B    U R                  [        R                  U5      $ rV   )r   r   	not_equalr   s     r[   __ne__ArrowSeries.__ne__   s      u55r]   c                B    U R                  [        R                  U5      $ rV   )r   r   greater_equalr   s     r[   __ge__ArrowSeries.__ge__   s      !1!1599r]   c                B    U R                  [        R                  U5      $ rV   )r   r   greaterr   s     r[   __gt__ArrowSeries.__gt__   s      U33r]   c                B    U R                  [        R                  U5      $ rV   )r   r   
less_equalr   s     r[   __le__ArrowSeries.__le__         66r]   c                B    U R                  [        R                  U5      $ rV   )r   r   lessr   s     r[   __lt__ArrowSeries.__lt__   s      %00r]   c                B    U R                  [        R                  U5      $ rV   )r   r   
and_kleener   s     r[   __and__ArrowSeries.__and__   r   r]   c                B    U R                  [        R                  U5      $ rV   )r   r   r   r   s     r[   __rand__ArrowSeries.__rand__   s    &&r}}e<<r]   c                B    U R                  [        R                  U5      $ rV   r   r   	or_kleener   s     r[   __or__ArrowSeries.__or__       &&r||U;;r]   c                B    U R                  [        R                  U5      $ rV   r   r   s     r[   __ror__ArrowSeries.__ror__  r   r]   c                B    U R                  [        R                  U5      $ rV   )r   r   addr   s     r[   __add__ArrowSeries.__add__  s      //r]   c                B    U R                  [        R                  U5      $ rV   )r   r   r   r   s     r[   __radd__ArrowSeries.__radd__  s    &&rvvu55r]   c                B    U R                  [        R                  U5      $ rV   )r   r   subtractr   s     r[   __sub__ArrowSeries.__sub__
        e44r]   c                B    U R                  [        R                  U5      $ rV   )r   r   r  r   s     r[   __rsub__ArrowSeries.__rsub__      &&r{{E::r]   c                B    U R                  [        R                  U5      $ rV   )r   r   multiplyr   s     r[   __mul__ArrowSeries.__mul__  r  r]   c                B    U R                  [        R                  U5      $ rV   )r   r   r  r   s     r[   __rmul__ArrowSeries.__rmul__  r  r]   c                B    U R                  [        R                  U5      $ rV   )r   r   powerr   s     r[   __pow__ArrowSeries.__pow__  r   r]   c                B    U R                  [        R                  U5      $ rV   )r   r   r  r   s     r[   __rpow__ArrowSeries.__rpow__  s    &&rxx77r]   c                .    U R                  [        U5      $ rV   )r   r   r   s     r[   __floordiv__ArrowSeries.__floordiv__  s      %88r]   c                .    U R                  [        U5      $ rV   )r   r   r   s     r[   __rfloordiv__ArrowSeries.__rfloordiv__  s    &&>>r]   c                (    U R                  S U5      $ )Nc                :    [         R                  " [        X5      6 $ rV   r   divider   r   r   s     r[   rd   )ArrowSeries.__truediv__.<locals>.<lambda>#  s    bii9I!9O.Pr]   )r   r   s     r[   __truediv__ArrowSeries.__truediv__"  s      !PRWXXr]   c                (    U R                  S U5      $ )Nc                :    [         R                  " [        X5      6 $ rV   r#  r%  s     r[   rd   *ArrowSeries.__rtruediv__.<locals>.<lambda>'  s    $4Q$:;r]   )r   r   s     r[   __rtruediv__ArrowSeries.__rtruediv__%  s    &&;U
 	
r]   c                    U R                   =(       a    [        USS5      nX-  R                  n[        X5      u  pA[        R
                  " U[        R                  " X15      5      nU R                  XRS9$ r   rn   rf   rw   r   r   r  r  r   ro   r   r   	floor_divr   ress         r[   __mod__ArrowSeries.__mod__*  s`    !__Sd1S]**	#D0
kk#r{{9<=   LLr]   c                    U R                   =(       a    [        USS5      nX-  R                  n[        X5      u  pA[        R
                  " U[        R                  " X45      5      nU R                  XRS9$ r   r/  r0  s         r[   __rmod__ArrowSeries.__rmod__1  s`    !__Sd1S]**	#D0
kk%Y!<=   LLr]   c                ^    U R                  [        R                  " U R                  5      SS9$ NTr~   )r   r   invertrw   rv   s    r[   
__invert__ArrowSeries.__invert__8  %      4;;!7D QQr]   c                ^    U R                  [        R                  " U R                  5      SS9$ r9  )r   r   negaterw   rv   s    r[   __neg__ArrowSeries.__neg__;  r=  r]   c                .    U R                   R                  $ rV   )rw   typerv   s    r[   _typeArrowSeries._type>  s    {{r]   T)_return_py_scalarc               @    [        [        U R                  5      U5      $ rV   )r\   r   rw   ro   rF  s     r[   r   ArrowSeries.lenB  s    &s4;;'79JKKr]   c                    [        U[        5      (       d  [        X5      u  p#OUnU R                  U R                  R                  U5      5      $ rV   )r&   boolr   r   rw   filter)ro   	predicate_r   s       r[   rL  ArrowSeries.filterE  sB    )T**,T=OA|$L  !3!3L!ABBr]   c               n    [        U R                  5      (       a  U R                  S   OS n[        X!5      $ Nr   )r   rw   r\   )ro   rF  r   s      r[   firstArrowSeries.firstM  s*    #&t{{#3#3Q&vAAr]   c               f    U R                   n[        U5      =n(       a  X#S-
     OS n[        XA5      $ N   )rw   r   r\   )ro   rF  caheightr   s        r[   lastArrowSeries.lastQ  s1    [[.1"g$5F$5QJD&vAAr]   c               V    [        [        R                  " U R                  5      U5      $ rV   )r\   r   meanrw   rH  s     r[   r\  ArrowSeries.meanV  s    &rwwt{{';=NOOr]   c                   U R                   R                  5       (       d  Sn[        U5      e[        [        R
                  " U R                  SSS9S   U5      $ )Nz<`median` operation not supported for non-numeric input type.      ?linearqinterpolationr   )r   
is_numericr)   r\   r   quantilerw   )ro   rF  r   s      r[   medianArrowSeries.medianY  sN    zz$$&&PC',,&KKs(CAFHY
 	
r]   c               V    [        [        R                  " U R                  5      U5      $ rV   )r\   r   minrw   rH  s     r[   ri  ArrowSeries.minb      &rvvdkk':<MNNr]   c               V    [        [        R                  " U R                  5      U5      $ rV   )r\   r   r   rw   rH  s     r[   r   ArrowSeries.maxe  rk  r]   c                   [         R                  " U R                  [         R                  " U R                  5      5      n[	        X!5      $ rV   )r   indexrw   ri  r\   )ro   rF  	index_mins      r[   arg_minArrowSeries.arg_minh  .    HHT[["&&*=>	&yDDr]   c                   [         R                  " U R                  [         R                  " U R                  5      5      n[	        X!5      $ rV   )r   ro  rw   r   r\   )ro   rF  	index_maxs      r[   arg_maxArrowSeries.arg_maxl  rs  r]   c               T    [        [        R                  " U R                  SS9U5      $ Nr   	min_count)r\   r   sumrw   rH  s     r[   r|  ArrowSeries.sump  $    &FF4;;!,.?
 	
r]   c                T    U R                  U R                  R                  5       5      $ rV   )r   rw   	drop_nullrv   s    r[   
drop_nullsArrowSeries.drop_nullsu  s       !6!6!899r]   c                <   US:  a'  [        X5      /U R                  S U*  R                  QnOKUS:  a*  / U R                  U* S  R                  Q[        U* U 5      PnOU R                  U R                  5      $ U R                  [        R
                  " U5      5      $ rQ  )r   rw   chunksr   r   concat_arrays)ro   narrayss      r[   shiftArrowSeries.shiftx  s    q5 )DDKK!,<,C,CDFUEt{{A23'..E
A2t0DEF$$T[[11  !1!1&!9::r]   c               T    [        [        R                  " U R                  US9U5      $ N)ddof)r\   r   stddevrw   ro   r  rF  s      r[   stdArrowSeries.std  s$    &IIdkk-/@
 	
r]   c               T    [        [        R                  " U R                  US9U5      $ r  )r\   r   variancerw   r  s      r[   varArrowSeries.var  s$    &KK$/1B
 	
r]   c          	     P   U R                   R                  5       n[        U5      S:X  a  g [        U5      S:X  a  [        S5      $ [        U5      S:X  a  g[        R
                  " U[        R                  " U5      5      n[        R                  " [        R                  " U[        S5      5      5      n[        R                  " [        R                  " U[        S5      5      5      n[        R                  " U[        R                  " U[        S5      5      5      n[        Xa5      $ )Nr   rV  nan   g           g      ?rw   r  r   floatr   r  r\  r  r   r$  r\   )ro   rF  ser_not_nullmm2m3biased_population_skewnesss          r[   skewArrowSeries.skew  s    {{,,.|!|!<|!KKbggl&;<WWRXXaQ()WWRXXaQ()%'YYr288BC3I%J"&'AUUr]   c               l   U R                   R                  5       n[        U5      S:X  a  g [        U5      S:X  a  [        S5      $ [        R
                  " U[        R                  " U5      5      n[        R                  " [        R                  " U[        S5      5      5      n[        R                  " [        R                  " U[        S5      5      5      n[        R
                  " [        R                  " U[        R                  " U[        S5      5      5      [        S5      5      n[        Xa5      $ )Nr   rV  r  r     r  r  )ro   rF  r  r  r  m4ks          r[   kurtosisArrowSeries.kurtosis  s    {{,,.|!|!<KKbggl&;<WWRXXaQ()WWRXXaQ()KK		"bhhr3q6&:;SVD&q<<r]   c               V    [        [        R                  " U R                  5      U5      $ rV   )r\   r   countrw   rH  s     r[   r  ArrowSeries.count  s    &rxx'<>OPPr]   c               p    [        [        R                  " U R                  R	                  5       SS9U5      $ )Nr   )mode)r\   r   r  rw   uniquerH  s     r[   n_uniqueArrowSeries.n_unique  s-    &HHT[['')68I
 	
r]   c                    U R                   [        R                  L a  U R                   R                  5       $ S[	        U R                   5       3n[        U5      e)NzExpected pyarrow, got: )_implementationr$   PYARROWto_native_namespacerC  AssertionError)ro   r   s     r[   __native_namespace__ ArrowSeries.__native_namespace__  sN    >#9#99'';;=='T-A-A(B'CDS!!r]   c                    U R                   $ rV   )rk   rv   s    r[   rq   ArrowSeries.name  s    zzr]   c                *   [        U5      S:X  a+  U R                  U R                  R                  SS5      5      $ U R                  S:  a   [        U[        5      (       a  [        U5      nU R                  U R                  R                  U5      5      $ )Nr   )   )	r   r   rw   slice_backend_versionr   tuplelisttake)ro   rowss     r[   _gatherArrowSeries._gather  sr    t9>$$T[[%6%6q!%<==  5(Ze-D-D:D  !1!1$!788r]   c                   UR                   =(       d    SnUR                  b  UR                  O[        U R                  5      nUS:  a  [        U R                  5      U-   nUS:  a  [        U R                  5      U-   nUR                  b  UR                  S:w  a  Sn[        U5      eU R                  U R                  R                  X#U-
  5      5      $ )Nr   rV  z4Slicing with step is not supported on PyArrow tables)startstopr   rw   stepNotImplementedErrorr   r  )ro   r  r  r  r   s        r[   _gather_sliceArrowSeries._gather_slice  s    

a II1tyys4;;7G19$u,E!8t{{#d*D99 TYY!^HC%c**  !2!25,!GHHr]   c                Z   [         R                  " [        S[        U 5      SS9UR                  5      n[         R
                  " UR                  5      nUR                  R                  U5      R                  5       nU R                  [         R                  " U R                  X55      5      $ )Nr   rV  )r  endr  )
r   is_inr   r   rw   sort_indicesr  combine_chunksr   replace_with_mask)ro   indicesvaluesmasksorted_indicesreplacementss         r[   scatterArrowSeries.scatter  st    xxQCIA>O8}})).9HHJ  !5!5dkk4!VWWr]   c                6    U R                   R                  5       $ rV   )rw   	to_pylistrv   s    r[   to_listArrowSeries.to_list  s    {{$$&&r]   )copyc               4    U R                   R                  XS9$ )N)r   r  )rw   	__array__ro   r   r  s      r[   r  ArrowSeries.__array__  s    {{$$5$<<r]   c               6    U R                   R                  5       $ rV   )rw   to_numpyr  s      r[   r  ArrowSeries.to_numpy  s    {{##%%r]   c                p    U R                  U R                  XR                  S9nU R                  Ul        U$ rz   )r{   rw   rm   rn   )ro   rq   rets      r[   r   ArrowSeries.alias  s,    nnT[[t]]nK
r]   c                V    [        U R                  R                  U R                  5      $ rV   )r   rw   rC  rm   rv   s    r[   r   ArrowSeries.dtype  s    '(8(8$--HHr]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   absrw   rv   s    r[   r  ArrowSeries.abs         !455r]   c                   [         R                  nU(       d  U" U R                  SS9OU" U R                  S S S2   SS9S S S2   nU R                  U5      $ NT)
skip_nulls)r   cumulative_sumrw   r   )ro   reversecum_sumr   s       r[   r  ArrowSeries.cum_sum  sZ    ##  DKKD1TrT*t<TrTB 	
   ((r]   c                `    U R                  [        R                  " U R                  USS95      $ )Nhalf_towards_infinity)
round_mode)r   r   roundrw   )ro   decimalss     r[   r  ArrowSeries.round  s*      HHT[[(7NO
 	
r]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   floorrw   rv   s    r[   r  ArrowSeries.floor  s       $++!677r]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   ceilrw   rv   s    r[   r  ArrowSeries.ceil         !566r]   c                |    U R                  [        R                  " U R                  R	                  5       5      5      $ rV   )r   r   pairwise_diffrw   r  rv   s    r[   diffArrowSeries.diff  s+      !1!1$++2L2L2N!OPPr]   c               T    [        [        R                  " U R                  SS9U5      $ ry  )r\   r   anyrw   rH  s     r[   r  ArrowSeries.any  r~  r]   c               T    [        [        R                  " U R                  SS9U5      $ ry  )r\   r   r   rw   rH  s     r[   r   ArrowSeries.all  r~  r]   c                h   [        X5      u  pA[        X5      u  pBUS:X  aZ  [        R                  " U R                  U5      n[        R                  " U R                  U5      n[        R
                  " XV5      nGO(US:X  aY  [        R                  " U R                  U5      n[        R                  " U R                  U5      n	[        R
                  " X5      nOUS:X  aY  [        R                  " U R                  U5      n[        R                  " U R                  U5      n[        R
                  " X5      nOjUS:X  aY  [        R                  " U R                  U5      n[        R                  " U R                  U5      n	[        R
                  " XY5      nO[        U5        U R                  W5      $ )Nleftrightnoneboth)
r   r   r   rw   r   r   r   r   r"   r   )
ro   lower_boundupper_boundclosedrN  geltr2  gtles
             r[   
is_betweenArrowSeries.is_between  s1    (:':V!!$++{;Bk2B--'CwDKK5Bt{{K8B--'CvDKK5Bk2B--'Cv!!$++{;Bt{{K8B--'C   %%r]   c                R    U R                  U R                  R                  5       SS9$ r9  )r   rw   is_nullrv   s    r[   r  ArrowSeries.is_null   s%      !4!4!64 PPr]   c                ^    U R                  [        R                  " U R                  5      SS9$ r9  )r   r   is_nanrw   rv   s    r[   r  ArrowSeries.is_nan#  r=  r]   c                    [        XR                  5      nU R                  [        R                  " U R
                  U5      SS9$ r9  )r   rm   r   r   r   rw   )ro   r   	data_types      r[   r   ArrowSeries.cast&  s6    ,UMMB	  i!@UY ZZr]   c               B    [        U R                  R                  U5      $ rV   )r\   rw   
null_countrH  s     r[   r"  ArrowSeries.null_count*  s    &t{{'='=?PQQr]   c           
         US:  a+  U R                  U R                  R                  SU5      5      $ [        U 5      nU R                  U R                  R                  S[	        SX!-   5      5      5      $ rQ  )r   rw   r  r   r   ro   r  num_rowss      r[   headArrowSeries.head-  s_    6$$T[[%6%6q!%<==t9  !2!21c!X\6J!KLLr]   c           	         US:  aA  [        U 5      nU R                  U R                  R                  [	        SX!-
  5      5      5      $ U R                  U R                  R                  [        U5      5      5      $ rQ  )r   r   rw   r  r   r  r%  s      r[   tailArrowSeries.tail3  s_    64yH$$T[[%6%6s1hl7K%LMM  !2!23q6!:;;r]   c                
   U R                  U5      (       a  UnO[        R                  " U5      nU R                  n[        R
                  " X2S9nU R                  [        R                  " UR                  5       S U5      5      $ )N)	value_set)	r   r   arrayrw   r   r  r   if_elser  )ro   r   r-  rw   r  s        r[   r  ArrowSeries.is_in9  s_    ??5!!-2II5  FNN,<dE!JKKr]   c                t    SS K nUR                  U R                  5      nU R                  X R                  U S9$ )Nr   r   )numpyflatnonzerorw   r   rq   )ro   npr2  s      r[   arg_trueArrowSeries.arg_trueB  s1    nnT[[)!!#IIt!DDr]   c                    Uc@  [        U 5      S:w  a  S[        U 5       S3n[        U5      e[        U R                  S   SS9$ [        U R                  U   SS9$ )NrV  zlcan only call '.item()' if the Series is of length 1, or an explicit index is provided (Series is of length )r   TrZ   )r   
ValueErrorr\   rw   )ro   ro  r   s      r[   itemArrowSeries.itemH  sg    =4yA~NNQRVi[XY[  !o%*4;;q>DQQ&t{{5'9DQQr]   c                  SSK Jn  U R                  c  SOU R                  nU=(       d    U(       a  SOSn[        R                  " U R
                  5      nUR                  S5      n	UR                  S5      n
U(       a1  [        R                  " [        U
[        R                  " U
5      5      6 n
X4n[        R                  R                  XU/S9nU(       a  UR                  US	4/5      nU" XR                  S
S9$ )z-Parallel is unused, exists for compatibility.r   r3   ro  
proportionr  r  countsnames
descendingTrr   validate_column_names)narwhals._arrow.dataframer4   rk   r   value_countsrw   fieldr$  r   r|  r   Tablefrom_arrayssort_byrm   )ro   sortparallelrq   	normalizer4   index_name_value_name_
val_countsr  r?  r  	val_counts                r[   rF  ArrowSeries.value_countsS  s     	=!%!3gFy|g__T[[1
!!(+!!(+YY 0 HIFHH(([7Q(R	!))K+F*GHI}}D
 	
r]   c                    UR                   R                  5       nU R                  [        R                  " X0R                   UR                   5      5      $ rV   )rw   r  r   r   r/  )ro   r  r   conds       r[   zip_withArrowSeries.zip_withk  s8    {{))+  D++u||!LMMr]   c          	        SS K nUR                  R                  US9nUR                  UR	                  U5      XS9nU R                  U R                  R                  [        R                  " U[        R                  " 5       S95      5      $ )Nr   )seed)sizereplacerC  )r2  randomdefault_rngchoicer   r   rw   r  r   r.  uint64)ro   r  with_replacementrX  r4  rngr  s          r[   sampleArrowSeries.sampleo  sg    ii###.**RYYq\*L  !1!1"((72U!VWWr]   c                    [         R                  " [         R                  " U R                  5      XR                  5      nU R	                  USS9$ r9  )r   r/  r  rw   r   )ro   rY   r   s      r[   fill_nanArrowSeries.fill_nanv  s9    BIIdkk2E;;G  D AAr]   c                D   SS jnU R                   nUb$  [        X5      u  pg[        R                  " XW5      nOYUc3  US:X  a  [        R                  " U5      O[        R
                  " U5      nO#US:X  a  U" XS5      OU" US S S2   U5      S S S2   nU R                  USS9$ )Nc                   [        S5      n[        R                  " U 5      n[        S[	        U 5      S5      n[        R
                  " [        R                  " X4U5      5      n[        R                  " XR5      n[        R                  " XeS 5      n[        R                  " [        R                  " XE5      [        U5      5      n[        R                  " [        R                  " X75      X R                  U5      5      $ )Nr  r   rV  )r   r   is_validr   r   cumulative_maxr/  r   r   r  or_r  )arrlimitsentinelis_not_nullro  index_not_nullnot_oobbeyond_limits           r[   fill_null_forward_limit6ArrowSeries.fill_null.<locals>.fill_null_forward_limit  s     2wH++c*K1c#h*E..rzz+h/WXN ll><GZZFN::bkk%&H#e*UL::{138P r]   forwardr  Tr~   )rl  r:   rm  intreturnr7   )rw   r   r   	fill_nullfill_null_forwardfill_null_backwardr   )	ro   rY   strategyrm  rs  rw   rN  native_valuer   s	            r[   rx  ArrowSeries.fill_nullz  s    	" ,T9OA$&LL$FF] y( $$V,**62  y( (6,VDbD\5A$B$G 
   D AAr]   c                    SSK Jn  [        R                  R	                  U R
                  /U R                  /S9nU" X R                  SS9$ )Nr   r3   r@  FrC  )rE  r4   r   rH  rI  rw   rq   rm   )ro   r4   dfs      r[   to_frameArrowSeries.to_frame  s;    <XX!!4;;-		{!Cb--uUUr]   c                T    SS K nUR                  " U R                  U R                  S9$ )Nr   r   )pandasSeriesrw   rq   )ro   pds     r[   	to_pandasArrowSeries.to_pandas  s    yy49955r]   c                V    SS K n[        SUR                  " U R                  5      5      $ )Nr   	pl.Series)polarsr   
from_arrowrw   )ro   pls     r[   	to_polarsArrowSeries.to_polars  s    Kt{{!;<<r]   c                p    U R                  5       R                  5       R                  U R                  5      $ rV   )r  	is_uniquer   rq   rv   s    r[   r  ArrowSeries.is_unique  s&    }}((*00;;r]   c                   SS K n[        R                  " UR                  [	        U 5      5      5      n[        SU R                  /S9n[        R                  R                  U R                  /U R                  /S9R                  X25      R                  U R                  5      R                  US4/5      R                  U S35      nU R                  [        R                   " X$5      5      $ )Nr      n_bytescolumnsr@  ri  _minr2  r   r.  r   r   r%   rq   rH  rI  rw   append_columngroup_by	aggregatecolumnr   r   r  )ro   r4  
row_number	col_tokenfirst_distinct_indexs        r[   is_first_distinctArrowSeries.is_first_distinct  s    XXbiiD	23
21tyykR	HH  $++tyyk B]91Xdii YE*+,Vyk&' 	   *!KLLr]   c                   SS K n[        R                  " UR                  [	        U 5      5      5      n[        SU R                  /S9n[        R                  R                  U R                  /U R                  /S9R                  X25      R                  U R                  5      R                  US4/5      R                  U S35      nU R                  [        R                   " X$5      5      $ )Nr   r  r  r@  r   _maxr  )ro   r4  r  r  last_distinct_indexs        r[   is_last_distinctArrowSeries.is_last_distinct  s    XXbiiD	23
21tyykR	HH  $++tyyk B]91Xdii YE*+,Vyk&' 	   *!JKKr]   c                  [        U[        5      (       d  S[        U5       3n[        U5      eU(       aF  [        R
                  " [        R                  " U R                  S S U R                  SS  5      5      nOE[        R
                  " [        R                  " U R                  S S U R                  SS  5      5      n[        USS9$ )Nz/argument 'descending' should be boolean, found r  rV  Tr9  )
r   rK  rC  	TypeErrorr   r   r   rw   r   r\   )ro   rB  r   r   s       r[   	is_sortedArrowSeries.is_sorted  s    *d++CDDTCUVCC. VVB,,T[["-=t{{12OPFVVBMM$++cr*:DKKOLMF&vEEr]   maintain_orderc               T    U R                  U R                  R                  5       5      $ rV   )r   rw   r  )ro   r  s     r[   r  ArrowSeries.unique  s       !3!3!566r]   c               `   [         R                  " U R                  [        R                  " U5      5      n[         R
                  " U5      n[         R                  " [        R                  " U5      U5      nUb$  UR                  [        X@R                  5      5      nU R                  U5      nU[        L a  [         R                  " [         R
                  " U R                  5      [         R                  " U5      5      n	[        [         R                  " U	SS9SS9(       aK  U R!                  U R                  U	5      5      R#                  SS9R%                  5       n
SU
 3n['        U5      e U$ [)        X5      u  pqU R                  [         R*                  " XhR                  U5      5      nU$ )Nr   rz  Tr9  Fr  zYreplace_strict did not replace all non-null values.

The following did not get replaced: )r   index_inrw   r   r.  ri  r  r   r   rm   r   r#   and_r:  r\   r  rL  r  r  r)   r   r/  )ro   defaultoldnewreturn_dtypeidxswas_matchedresult_nativer   unmatched_maskunmatched_valuesr   s               r[   replace_strictArrowSeries.replace_strict  sW    {{4;;6kk$'t4#)..(}}EM ""=1j   WWR[[%=ryy?UVN&~3d KK 1 1. ABV5V1WY !;;K:LN  ,C00$ 	 &4F%D"M &&rzz+}}g'VWFr]   c                   U(       a  SOSnU(       a  SOSn[         R                  " [        U R                  5      X4S9nU R	                  U R                  R                  U5      5      $ )NrB  	ascendingat_endat_start)ordernull_placement)r   array_sort_indicesr   rw   r   r  )ro   rB  
nulls_lastr  r  r  s         r[   rK  ArrowSeries.sort  sT    '1|{4>J..T[[!
   !1!1.!ABBr]   c          	        SS K nSSKJn  U R                  nU R                  R                  5       R                  S5      nUR                  [        UR                  5      [        U5      4UR                  5      nSXvR                  UR                  [        U5      5      4'   U U S3U U S3pUR                   V
s/ s H"  n
X0R                  U U U
 3U U U
 35      PM$     nn
X;   a2  U	/[        U Vs/ s H  oU	:w  d  M
  UPM     sn5      [        U5      S  QO[        U5      [        U5      S  nU" [         R"                  R%                  X{S9U R&                  SS	9R(                  " U6 $ s  sn
f s  snf )
Nr   r3   encoderV  Nonenullr@  TrC  )r2  rE  r4   rk   rw   r  dictionary_encoder   r   
dictionaryint8r  r   getsortedrv  r   rH  rI  rm   simple_select)ro   	separator
drop_firstr4  r4   rq   dar  null_col_panull_col_plvcolscoutput_orders                 r[   
to_dummiesArrowSeries.to_dummies  s   <zz335GGQHHc"--&8#b'%BBGGL23

BIIc"g../&*VI;d#;vi[PT=U[
 ]]	
 # &**&A3'D6)QC)@ #	 	 
 " D=Dq,<D=>s:?PQ
 c*o/0 	 HH   5MM"&
 -	 &	' 	'
 >s   =)E08	E5
E5
c               Z    [        [        R                  " U R                  XS9S   U5      $ )Nra  r   )r\   r   re  rw   )ro   re  rc  rF  s       r[   re  ArrowSeries.quantile5  s+     'KKxMaP
 	
r]   c                D    U R                  U R                  US U2   5      $ rV   )r   rw   )ro   r  offsets      r[   gather_everyArrowSeries.gather_everyA  s"      VYQY!788r]   c                    [        X5      u  p4[        X5      u  p5U R                  [        R                  " [        R                  " U R
                  U5      U5      5      $ rV   )r   r   r   max_element_wisemin_element_wiserw   )ro   r  r  rN  loweruppers         r[   clipArrowSeries.clipD  sN    !$4!$4   3 3DKK GO
 	
r]   c                |    [        X5      u  p#U R                  [        R                  " U R                  U5      5      $ rV   )r   r   r   r  rw   )ro   r  rN  r  s       r[   
clip_lowerArrowSeries.clip_lowerK  0    !$4  !4!4T[[%!HIIr]   c                |    [        X5      u  p#U R                  [        R                  " U R                  U5      5      $ rV   )r   r   r   r  rw   )ro   r  rN  r  s       r[   
clip_upperArrowSeries.clip_upperO  r  r]   c                6    U R                   R                  5       $ rV   )rw   r  rv   s    r[   to_arrowArrowSeries.to_arrowS  s    {{))++r]   c               p   U R                  5       n[        SU R                  /S9nU R                  USSSS9nUR	                  UR                  U5      UR                  U5      R                  5       R                  5       :H  5      R                  U R                  5      nUS:X  a  UR                  S5      $ U$ )Nr  r  F)rq   rM  rK  rL  r  rV  )
r   r%   rq   rF  rL  colr   	broadcast
get_columnr'  )ro   keepplxr  r?  r   s         r[   r  ArrowSeries.modeV  s    ))+21tyykR	""e%% # 
 GGI#'')"4"8"8":"D"D"FF

*TYY
 	 "&v{{1~:F:r]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   	is_finiterw   rv   s    r[   r  ArrowSeries.is_finitea  s       dkk!:;;r]   c                   U R                   R                  nU R                  5       ) R                  UR	                  5       5      R                  US9$ )Nr  )rm   dtypesr  r   UInt32r  )ro   r  r  s      r[   	cum_countArrowSeries.cum_countd  s>    %%%%fmmo6>>w>OOr]   c                   U(       d  [         R                  " U R                  SS9O*[         R                  " U R                  S S S2   SS9S S S2   nU R                  U5      $ r  )r   cumulative_minrw   r   ro   r  r   s      r[   cum_minArrowSeries.cum_minh  [      dkkd;""4;;tt#4FttL 	
   ((r]   c                   U(       d  [         R                  " U R                  SS9O*[         R                  " U R                  S S S2   SS9S S S2   nU R                  U5      $ r  )r   rj  rw   r   r  s      r[   cum_maxArrowSeries.cum_maxp  r  r]   c                   U(       d  [         R                  " U R                  SS9O*[         R                  " U R                  S S S2   SS9S S S2   nU R                  U5      $ r  )r   cumulative_prodrw   r   r  s      r[   cum_prodArrowSeries.cum_prodx  s[      t{{t<##DKK"$5$G"M 	
   ((r]   c                  Ub  UOUn[        XUS9u  pEUR                  SS9R                  S SS S9nUS:w  a#  UUR                  U5      R                  SS S S9-
  OUnUR	                  SS9nXR                  U5      R                  SS S S9-
  n	U R                  [        R                  " X:  R                  UR                  S 5      5      n
U
R                  [        US 5      5      $ Nwindow_sizecenterFr  ru  rY   r{  rm  r   r   r  rx  r  r   r   r   r/  rw   r  r  ro   r  min_samplesr  padded_seriesr  r  rolling_sumvalid_countcount_in_windowr   s              r[   r  ArrowSeries.rolling_sum  s   %0%<k+ *4QW X'''6@@$ A 
 a mmK(22TQU2VW 	 	 $--e-<%(9(9+(F(P(Pd$ )Q )
 
 ""JJ6>>@R@RTXY
 ##E&$$788r]   c                  Ub  UOUn[        XUS9u  pEUR                  SS9R                  S SS S9nUS:w  a#  UUR                  U5      R                  SS S S9-
  OUnUR	                  SS9nXR                  U5      R                  SS S S9-
  n	U R                  [        R                  " X:  R                  UR                  S 5      5      U	-  n
U
R                  [        US 5      5      $ r  r  r  s              r[   rolling_meanArrowSeries.rolling_mean  s%   %0%<k+ *4QW X'''6@@$ A 
 a mmK(22TQU2VW 	 	 $--e-<%(9(9+(F(P(Pd$ )Q )
 

 

$3;;[=O=OQU
  	 ##E&$$788r]   c                  Ub  UOUn[        XUS9u  pVUR                  SS9R                  S SS S9nUS:w  a#  UUR                  U5      R                  SS S S9-
  OUn[	        US5      R                  SS9R                  S SS S9n	US:w  a#  U	U	R                  U5      R                  SS S S9-
  OU	n
UR                  SS9nXR                  U5      R                  SS S S9-
  nU R                  [        R                  " X:  R                  XS-  U-  -
  R                  S 5      5      U R                  [        R                  " X-
  R                  S5      5      -  nUR                  [        US S 5      5      $ )Nr  Fr  ru  r  r   r  )r   r  rx  r  powr   r   r   r/  rw   r  r  r  )ro   r  r  r  r  r  r  r  r  
cum_sum_sqrolling_sum_sqr  r  r   s                 r[   rolling_varArrowSeries.rolling_var  s    &1%<k+ *4QW X'''6@@$ A 
 a mmK(22TQU2VW 	 	 q!WUW#YTITYB 	 a {+55ATX5YZ 	 	 $--e-<%(9(9+(F(P(Pd$ )Q )
 
 ""JJ /77>O#CDLL
 b11?3I2Q2QSTUVW ##E&$$=>>r]   c               (    U R                  XX4S9S-  $ )N)r  r  r  r  r_  )r$  )ro   r  r  r  r  s        r[   rolling_stdArrowSeries.rolling_std  s+     '   	
r]   c                  US:X  a  Sn[        U5      eU(       a  SOSnUS:X  a  SOUn[        U R                  5      nU R                  S:  a  UR	                  5       nOUn[
        R                  " U5      n[
        R                  " XtUS9n	[
        R                  " U[        S U	R                  5      U	5      n
U R                  U
5      $ )	Naveragez`rank` with `method='average' is not supported for pyarrow backend. The available methods are {'min', 'max', 'dense', 'ordinal'}.rB  r  ordinalrR  )   r   r   )	sort_keys
tiebreaker)r:  r   rw   r  r  r   r  rankr/  r   rC  r   )ro   methodrB  r   r-  r.  sortable_seriesrp   	null_maskr/  r   s              r[   r/  ArrowSeries.rank  s    YP  S/!+5<;	,2i,?V
 #4;;/  :-+::<M+MJJ}-	ww}jQIs4';TB  ((r]   c               b    [         R                  XS9R                  U5      R                  5       $ N)include_breakpoint)
_ArrowHistfrom_series	with_binsr  )ro   binsr6  s      r[   hist_from_binsArrowSeries.hist_from_bins  s*     ""4"OYt_XZ	
r]   c               b    [         R                  XS9R                  U5      R                  5       $ r5  )r7  r8  with_bin_countr  )ro   	bin_countr6  s      r[   hist_from_bin_countArrowSeries.hist_from_bin_count  s+     ""4"O^I&XZ	
r]   c              #  J   #    U R                    H  n[        USS9v   M     g 7f)NTr9  )rw   r\   )ro   r   s     r[   __iter__ArrowSeries.__iter__  s      A)!dCC s   !#c                   SSK JnJnJn   Ub  [	        U5      O[	        S U R
                  S9n[        [        R                  " XPR                  5      SS9$ ! X#U4 a-  nS[        U5       SU R                   S3n[        U5      UeS nAff = f)	Nr   )ArrowInvalidArrowNotImplementedErrorArrowTypeErrorr[  Tr9  z Unable to compare other of type z with series of type r   )pyarrowrF  rG  rH  r   rD  r\   r   r  rw   rC  r   r)   )ro   r   rF  rG  rH  other_excr   s           r[   __contains__ArrowSeries.__contains__  s    	
 	
	6#(#4SZ#d:TF*-  G 	64T%[MAVW[WaWaVbbcdC',#5	6s   A	A B(BBc                t    U R                  [        R                  " U R                  [	        U5      5      5      $ rV   )r   r   logbrw   r   )ro   bases     r[   logArrowSeries.log)  s&      c$i!@AAr]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   exprw   rv   s    r[   rT  ArrowSeries.exp,  r  r]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   sqrtrw   rv   s    r[   rW  ArrowSeries.sqrt/  r   r]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   sinrw   rv   s    r[   rZ  ArrowSeries.sin2  r  r]   c                `    U R                  [        R                  " U R                  5      5      $ rV   )r   r   cosrw   rv   s    r[   r]  ArrowSeries.cos5  r  r]   c               l    U(       a  U R                  5       R                  5       $ U R                  5       $ rV   )r  rR  )ro   ignore_nullsrF  s      r[   	any_valueArrowSeries.any_value8  s'     -9t &&(JdjjlJr]   c                    [        U 5      $ rV   r   rv   s    r[   dtArrowSeries.dt=  s    +D11r]   c                    [        U 5      $ rV   r	   rv   s    r[   catArrowSeries.catA  s    &t,,r]   c                    [        U 5      $ rV   r   rv   s    r[   strArrowSeries.strE      )$//r]   c                    [        U 5      $ rV   r   rv   s    r[   r  ArrowSeries.listI  s    '--r]   c                    [        U 5      $ rV   r   rv   s    r[   structArrowSeries.structM  rl  r]   )rn   rk   rl   rm   )rp   r:   rq   rj  rr   rD   rw  r  )rw  r:   )rr   rD   rw  r1   )r   r9   r   rK  rw  r1   )r   zCallable[..., ArrayOrScalar]r   r   rw  r1   )
r   zIterable[Any]r   rE   rq   rj  r   IntoDType | Nonerw  r1   )rY   r   rw  r1   )r   zChunkedArrayAny | Anyrw  zTypeIs[ChunkedArrayAny])r   r:   r   rE   rq   rj  rw  r1   )r   rI   r   rE   rw  r1   )r   r1   rw  zSequence[Self])rw  r6   )r   objectrw  r1   )r   r   rw  r1   )rw  r1   )rw  zpa.DataType)rF  rK  rw  rv  )rM  zArrowSeries | list[bool | None]rw  r1   )rF  rK  rw  rM   )rF  rK  rw  r  )rF  rK  rw  r   )r  rv  rw  r1   )r  rv  rF  rK  rw  r  )rF  rK  rw  float | None)rw  r/   )rw  rj  )r  z(SizedMultiIndexSelector[ChunkedArrayAny]rw  r1   )r  z_SliceIndex | rangerw  r1   )r  r1   r  r1   rw  r1   )rw  z	list[Any]rV   )r   r   r  zbool | Nonerw  rQ   )rq   rj  rw  r1   )rw  rF   )r  rK  rw  r1   )r  rv  rw  r1   )rF  rK  rw  rK  )r  r   r  r   r  rG   rw  r1   )r   rJ   rw  r1   )ro  
int | Nonerw  r   )
rK  rK  rL  rK  rq   z
str | NonerM  rK  rw  r4   )r  r1   r   r1   rw  r1   )r  rv  r`  rK  rX  ru  rw  r1   )rY   rt  rw  r1   )rY   zSelf | NonNestedLiteralr{  zFillNullStrategy | Nonerm  ru  rw  r1   rw  r4   )rw  zpd.Series[Any])rw  r  )rw  rh   )rB  rK  rw  rK  )r  rK  rw  r1   )
r  zAny | NoDefaultr  Sequence[Any]r  rw  r  rr  rw  r1   )rB  rK  r  rK  rw  r1   )r  rj  r  rK  rw  r4   )re  r  rc  rO   rF  rK  rw  r  )r   )r  rv  r  rv  rw  r1   )r  r1   r  r1   rw  r1   )r  r1   rw  r1   )r  r1   rw  r1   )rw  r7   )r  rK   rw  rh   )r  rv  r  rv  r  rK  rw  r1   )
r  rv  r  rv  r  rK  r  rv  rw  r1   )r0  rN   rB  rK  rw  r1   )r:  list[float]r6  rK  rw  r4   )r?  rv  r6  rK  rw  r4   )rw  zIterator[Any])r   r   rw  rK  )rP  r  rw  r1   )r`  rK  rF  rK  rw  rM   )rw  r   )rw  r
   )rw  r   )rw  r   )rw  r   )__name__
__module____qualname____firstlineno__r$   r  r  rs   propertyrw   r|   r   r   r   classmethodr   r   staticmethodr   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,  r3  r6  r;  r@  rD  r   rL  rR  rY  r\  rf  ri  r   rq  rv  r|  r  r  r  r  r  r  r  r  r  rq   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  r;  rF  rU  rb  re  rx  r  r  r  r  r  r  r  r  r  rK  r  re  r  r  r  r  r  r  r  r   r  r	  r  r  r  r$  r'  r/  r;  r@  rC  rL  rQ  rT  rW  rZ  r]  ra  rd  rg  rj  r  rp  r'   ewm_mean__static_attributes____classcell__)r{   s   @r[   rh   rh      sK   $,,O , 7: EL 	  # #M DI#<@	P  "&CC !	C
 C  C 
C C&+
 0 0 PR>">3B>JM>	> >
 
 

  (5
26:4717=<<065;5;289?Y

MMRR     04 LC 26 B 15 B
 15 P 37 
 04 O 04 O 48 E 48 E 04 

:; ;? 

 ;? 

 15 V 59 
= 26 Q 59 

"  9
IX'=$ = =& & &
 I I6)

87Q 04 

 04 

&&-0&:H&	&2QR[ 7; RM<LE	R

'+
3=
JN
	
0NXB'B&'B *'B 	'B
 
'BRV6
=
<MLF 04 7( ( ( 	( '( 
(TC'L #'



 2


  

 


9
JJ,	;<P)))909:)?)?03)?=A)?IL)?	)?V

03
=A
IL
	
)2

8<
	


59
	
D6 B6766 @DK#K8<K	K
 2 2 - - 0 0 . . 0 0  Hr]   rh   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
 jjr	SS jr
SS jrSrg)r7  iT  rh   _seriesc                    [         R                  R                  nU R                  R	                  5       R
                  R                  nU" U" U R                  5      U R                  S9$ r   )r   rH  from_pydictr  r   
_dataframer   _data)ro   tabler   s      r[   r  _ArrowHist.to_frameY  sI    HH00ll99;FFRR5,dllCCr]   c                    U R                   R                  SS9n[        SUR                  5       5      nUR                  S:H  $ )NT)nan_is_nullzpa.BooleanArrayr   )rw   r  r   r  false_count)ro   r  rl  s      r[   is_empty_series_ArrowHist.is_empty_series`  s@     ++%%$%7$g&<&<&>?!##r]   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)ro   argr  s      r[   series_empty_ArrowHist.series_emptyj  s:    C "&"<"<S"AERRr]   c               p    [        U[        5      (       a  [        U5      $ [        [        U5      S-
  5      $ rU  )r   rv  r   r   )ro   r  s     r[   r  _ArrowHist._zerosp  s*    'S11uSzJuSX\7JJr]   r  )r  c               "    SSK Jn  U" XX4S:H  S9$ )Nr   )linspacer  )r  r  numendpoint)r2  r  )ro   r  r  num_samplesr  r  s         r[   _linear_space_ArrowHist._linear_spaces  s     	#e;SYIYZZr]   c                    [         R                  " U R                  5      nUS   R                  5       US   R                  5       pCX4:X  a
  US-  nUS-  nU R	                  X4US-   5      $ )z6Prepare bins for histogram calculation from bin_count.ri  r   r_  rV  )r   min_maxrw   rb   r  )ro   r?  dr  r  s        r[   _calculate_bins_ArrowHist._calculate_bins  s_    JJt{{#x~~'5)9u>SLESLE!!%	A>>r]   c           
     J   U R                   n[        SU5      n[        U5      S:X  a  [        R                  " [        R
                  " U[        US   5      5      [        R                  " U[        US   5      5      5      n[        R                  " UR                  [        R                  " 5       5      5      nU R                  (       a
  US   /U/S.$ SU/0$ SS KnUR                  XSS	9n[        R                  " [        R                  " U[        US   5      5      SU5      nUR!                  US
S9u  pxUR#                  S[        U5      5      n	UR%                  U	5      n
XR'                  Xy5         XR'                  X5      '   U R                  (       a  USS  U
S.$ SU
0$ )Nrx  r  r   rV  r  r  r  r  )sideT)return_counts)rw   r   r   r   r  r   r   r   r|  r   uint8r  r2  searchsortedr/  r   r  r   
zeros_likeisin)ro   r:  r   is_between_binsr  r4  bin_indicesobs_cats
obs_countsobj_catsr?  s              r[   _calculate_hist_ArrowHist._calculate_hist  sa   kk
 M4(t9> gg  c$q'l3R]]3DQRG5UO FF?//
;<E'+BxjE7CCeW%% 	oodfo=jj#s47|!<aM  "yyDyI99QD	*x(.89T.Uwwx*+"&qr(V<<  r]   rW   Nrv  )rw  rK  )r  int | list[float]rw  rT   )r  r  rw  zpa.Int64Array)
r  r  r  r  r  rv  r  zLiteral['both', 'none']rw  rQ   )r?  rv  rw  rQ   )r:  zlist[float] | _1DArrayrw  rT   )ry  rz  r{  r|  __annotations__r  r  r  r  r  r  r  r  rW   r]   r[   r7  r7  T  sj     D$ K +1
[
[ 
[ 	
[ (
[ 

[? !r]   r7  )r:   z-list[ScalarAny] | pa.Int64Array | list[float])rY   z$pa.Scalar[_BasicDataType[_AsPyType]]rZ   rK  rw  r@   )rY   zpa.Scalar[pa.StructType]rZ   rK  rw  zlist[dict[str, Any]])rY   z1pa.Scalar[pa.ListType[_BasicDataType[_AsPyType]]]rZ   rK  rw  zlist[_AsPyType])rY   zpa.Scalar[Any] | AnyrZ   rK  rw  r   )rY   r   rZ   rK  rw  r   )o
__future__r   typingr   r   r   r   r   rI  r   pyarrow.computecomputer   narwhals._arrow.series_catr
   narwhals._arrow.series_dtr   narwhals._arrow.series_listr   narwhals._arrow.series_strr   narwhals._arrow.series_structr   narwhals._arrow.utilsr   r   r   r   r   r   r   r   r   r   r   r   r   narwhals._compliantr    r!   narwhals._typing_compatr"   narwhals._utilsr#   r$   r%   r&   r'   narwhals.dependenciesr(   narwhals.exceptionsr)   r*   collections.abcr+   r,   r-   r.   typesr/   r0   r  r  r  r  typing_extensionsr1   r2   rE  r4   r   r6   narwhals._arrow.typingr7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   narwhals._compliant.seriesrB   narwhals._typingrC   rD   rE   narwhals.dtypesrF   narwhals.typingrG   rH   rI   rJ   rK   rL   rM   rN   rO   rP   rQ   rR   rS   rT   r  r\   rh   r7  rW   r]   r[   <module>r     s   " > >   > B @ A D    = 0  4 AFF  .88    4*8%   " 	S 9  
/  
 
#  
 
<  
 
 	 
R!+/0 R!jT!VWT!r]   