
    7^jo                    8   U d dl mZ d dlZd dlZd dlmZmZmZmZ d dl	m
Z
mZ d dlmZ d dlmZ d dlmZ d dlmZ d d	lmZ d d
lmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z" d dl#m$Z$ d dl%m&Z&m'Z'm(Z( d dl)m*Z*m+Z+ d dl,m-Z- d dl.m/Z/ erd dl0m1Z1m2Z2m3Z3m4Z4m5Z5 d dl6m7Z7 d dlm8Z8 d dl9Z:d dl;Z<d dl=Z>d dl?m@Z@mAZA d dlBmCZC d dlDmEZE d dlFmGZG d dlHmIZI d dlJmKZK d dlLmMZM d dl%mNZNmOZO d dl,mPZP d dlQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z] dZ^de_d<   i d d!d"d!d#d$d%d$d&d'd(d'd)d*d+d*d,d-d.d-d/d0d1d0d2d3d4d3d5d6d7d6d8d9d9d:d:d;d<Z`i d d9d"d9d#d9d%d9d&d9d(d9d)d9d+d9d,d9d.d9d/d9d1d9d2d9d4d9d5d9d7d9d8d9d9d:d:d;d<Za G d= d>e
e         Zb G d? d@edA         Zcy)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                  T   e Zd Z	 	 	 	 	 	 	 	 ddZedd       ZddZddZddZddZ	ddZ
dd	dd
Zedddd	 	 	 	 	 	 	 	 	 	 	 dd       Zedd       Zedd       Zedd       Zedd       Zedd       Zedd       Zed        Z	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ddZe	 	 	 	 	 	 	 	 dd       Zedd	 	 	 	 	 	 	 dd       Zdd	 	 	 	 	 	 	 ddZddZdddZddZddZ	 	 	 	 	 	 	 	 ddZdd Zdd!Zdd"Z dd#Z!dd$Z"dd%Z#dd&Z$dd'Z%dd(Z&dd)Z'dd*Z(dd+Z)dd,Z*dd-Z+dd.Z,dd/Z-dd0Z.dd1Z/dd2Z0dd3Z1dd4Z2dd5Z3dd6Z4dd7Z5dd8Z6dd9Z7dd:Z8dd;Z9dd<Z:dd=Z;dd>Z<dd?Z=dd@Z>ddAZ?ddBZ@ddCZAddDZBddEZCddFZDddGZEddHZFddIZGddJZHddKZIddLZJddMZKddNZLddOZMddPZNddQZO	 	 	 	 	 	 	 	 ddRZPddSZQddTZRddUZSddVZTddWZUddXZVdYdZdd[ZWdd\ZXdd]ZY	 	 	 	 	 	 	 	 	 	 dd^ZZdd_Z[dd`Z\ddaZ]dddbddcZ^dddZ_ddeZ`ddfZaddgZbddhZcddiZdddjZe	 	 	 	 	 	 	 	 	 	 ddkZf	 	 	 	 	 	 ddlZgddmZhddnZiddoZjddpZkddqZlddrZmddsZnddtZodduZpddvZqddwZrddxZsddyZtddzZudd{Zvdd|Zwdd}Zxdd~ZyddZz	 	 	 	 	 	 	 	 	 	 ddZ{	 	 	 	 	 	 	 	 	 	 ddZ|ddZ}ddZ~ddZddZ	 	 	 	 	 	 ddZ	 	 	 	 	 	 ddZddZddZddZddZddZddZ	 	 	 	 	 	 ddZ	 	 	 	 	 	 ddZddZedd       Zedd       Zedd       Zedd       Zedd       Zy)PandasLikeSeriesc               ^    |j                   | _        || _        || _        || _        d| _        y )NF)name_name_native_series_implementation_version
_broadcast)selfnative_seriesimplementationversions       g/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/narwhals/_pandas_like/series.py__init__zPandasLikeSeries.__init__v   s1     #''
+-      c                    | j                   S N)ra   re   s    ri   nativezPandasLikeSeries.native   s    """rk   c                    | j                   j                         r| j                   j                         S dt        | j                          }t	        |      )Nz!Expected pandas/modin/cudf, got: )rb   is_pandas_liketo_native_namespacetypeAssertionErrorre   msgs     ri   __native_namespace__z%PandasLikeSeries.__native_namespace__   sL    ..0'';;==1$t7K7K2L1MNS!!rk   c                H    ddl m}  || j                  | j                        S )Nr   r3   )narwhals._pandas_like.namespacer4   rb   rc   )re   r4   s     ri   __narwhals_namespace__z'PandasLikeSeries.__narwhals_namespace__   s    G"4#7#7GGrk   c                    t        |t              rt        |      n|}| j                  | j                  j
                  |         S rm   )
isinstancetuplelist_with_nativero   ilocre   rowss     ri   _gatherzPandasLikeSeries._gather   s6    'e4tDz$  !1!1$!788rk   c                    | j                  | j                  j                  t        |j                  |j
                  |j                                 S rm   )r   ro   r   slicestartstopstepr   s     ri   _gather_slicezPandasLikeSeries._gather_slice   s<      KKU4::tyy$))DE
 	
rk   c                R    | j                  | j                  | j                  |      S N)rg   rh   )	__class__ro   rb   )re   rh   s     ri   _with_versionzPandasLikeSeries._with_version   s)    ~~KK(<(<g  
 	
rk   Fpreserve_broadcastc               |    | j                  || j                  | j                        }|r| j                  |_        |S r   )r   rb   rc   rd   )re   seriesr   results       ri   r   zPandasLikeSeries._with_native   s<    4#7#7   
  $Frk    N)r_   dtypeindexc                  |j                   }|j                  }|j                         }i }	|rt        |d ||      |	d<   n)|j	                         rd|	d<   n	 |t        |      r||	d<   | j                   |j                  |fd|i|	|      S )Nr   Fcopyr   r_   context)rb   rc   rr   r   	is_pandaslenfrom_nativeSeries)
clsdatar   r_   r   r   rg   rh   nskwdss
             ri   from_iterablezPandasLikeSeries.from_iterable   s     !00""//1!4UD.RYZDM'')$V SZ %WyryyADADA7SSrk   c                    t        |       S rm   )r#   )objs    ri   
_is_nativezPandasLikeSeries._is_native   s    $S))rk   c              @     | ||j                   |j                        S r   )rb   rc   )r   r   r   s      ri   r   zPandasLikeSeries.from_native   s    4(?(?IYIYZZrk   c                  |j                   }t        |      r|n|g}|j                         j                  |d      }| j	                  ||      S )Nr   r_   r   )rb   r"   rr   r   r   )r   r   r   rg   arrro   s         ri   
from_numpyzPandasLikeSeries.from_numpy   sN     00'-dD6335<<Sr<Jvw77rk   c                t   |d   j                         j                  }|D cg c]  }t        |       }}t        d t	        ||d      D              }||j                  |         j                  j
                  }g }|D ]  }|j                  rCt        |j                  ||j                  j                         |      }|j                  |      }	nN|j                  j
                  |ur4t        |j                  ||j                        }|j                  |      }	n|}	|j                  |	        |S c c}w )Nr   c              3  @   K   | ]  \  }}|j                   r|  y wrm   )rd   ).0lengthss      ri   	<genexpr>z9PandasLikeSeries._align_full_broadcast.<locals>.<genexpr>   s      
 vqallF
s   F)strict)	is_nestedseries_classrg   )rw   r   r   maxzipr   ro   rd   r   r   r   r   r   rb   append)
r   r   r   r   lengthstarget_lengthidx	reindexedro   	compliants
             ri   _align_full_broadcastz&PandasLikeSeries._align_full_broadcast   s   //188#)*a3q6** 
$'$F
 
 W]]=1299??	 	(A||2HHcQWW->->-@v NN62	s*"188SARARSNN62		Y'	( % +s   D5c                    | j                   S rm   )r`   rn   s    ri   r_   zPandasLikeSeries.name   s    zzrk   c                    | j                   j                  }|dk7  r!t        || j                  | j                        S t        | j                   | j                  | j                        S )Nobject)ro   r   r   rc   rb   r   )re   native_dtypes     ri   r   zPandasLikeSeries.dtype   s\    {{(( x' %\4==$BVBVW	
 1T]]D,@,@	
rk   c                D    t         rdd l}|S t        | j                        S Nr   )r   numpyr   rb   )re   nps     ri   _array_funcszPandasLikeSeries._array_funcs   s    I"4#7#788rk   c          	     |   | j                   }|j                         }	| j                  t        j                  u rI|dk(  r|r|	j                         s%|j                  |||||      j                         }
n3d}t        |      |j                  |||||||      j                         }
d |
|	<   | j                  |
      S )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)
ro   isnarb   r    CUDFanyewmmeanNotImplementedErrorr   )re   r   r   	half_lifer   r   min_samplesignore_nullssermask_nar   rv   s               ri   ewm_meanzPandasLikeSeries.ewm_mean   s     kk((*>#6#66q w{{}$%PV ! $& 
K  *#..WWT9e[&L  df  w  ((rk   c                    y rm    re   indicesvaluesin_places       ri   scatterzPandasLikeSeries.scatter       rk   )r   c                    y rm   r   r   s       ri   r   zPandasLikeSeries.scatter#  r   rk   c               ^   | j                   }| j                  |j                  }}t        |j                  |j                  |   |      }|r|n|j	                  d      }|j                         r|rt        dk  r|j	                         }||j                  |<   |rd S | j                  |      S )Nr   T)deep)   )	rb   ro   r   r   r   r   r   r   r   )	re   r   r   r   implrf   indices_nativevalues_nativer   s	            ri   r   zPandasLikeSeries.scatter(  s    
 ##(,W^^~!MM=..~>t
 #+0B0B0B0M>>]T-A)..0M&3N#t>T%6%6v%>>rk   c                z   | j                   |k(  r6| j                  j                   dk7  r| j                  | j                  d      S t        |t	        | j                  j                   | j
                        | j
                  | j                        }| j                  | j                  j                  |      d      S )Nr   Tr   )dtype_backendrg   rh   )r   ro   r   r   r   rb   rc   astype)re   r   pd_dtypes      ri   castzPandasLikeSeries.cast;  s    ::4;;#4#4#@ $$T[[T$JJ++DKK,=,=t?S?ST//MM	
   !3!3H!=RV WWrk   c                    |At        |       dk7  rdt        |        d}t        |      | j                  j                  d   S | j                  j                  |   S )N   zlcan only call '.item()' if the Series is of length 1, or an explicit index is provided (Series is of length )r   )r   
ValueErrorro   r   )re   r   rv   s      ri   itemzPandasLikeSeries.itemI  sf    =4yA~NNQRVi[XY[  !o%;;##A&&{{&&rk   c                ~    ddl m}  || j                  j                         | j                  | j
                  d      S )Nr   r1   F)rg   rh   validate_column_names)narwhals._pandas_like.dataframer2   ro   to_framerb   rc   )re   r2   s     ri   r   zPandasLikeSeries.to_frameU  s5    G"KK  "//MM"'	
 	
rk   c                    | j                   j                         }|r(| j                  j                         j	                         S | j                  j                         S rm   )rb   is_cudfro   to_arrow	to_pylistto_list)re   r   s     ri   r   zPandasLikeSeries.to_list_  sF    &&..05<t{{##%//1W$++BUBUBWWrk   c                   | j                   }t        | |      \  }}t        | |      \  }}|dk(  r$|j                  |      |j                  |      z  }n|dk(  r$|j	                  |      |j                  |      z  }n]|dk(  r$|j	                  |      |j                  |      z  }n4|dk(  r$|j                  |      |j                  |      z  }nt        |       | j                        j                  |j                        S )Nleftrightnoneboth)
ro   r   geltgtler   r   aliasr_   )re   lower_boundupper_boundclosedr   _ress          ri   
is_betweenzPandasLikeSeries.is_betweenc  s     kk1$D;1$D;V&&%{(;;Cw&&%{(;;Cv&&%{(;;Cv&&%{(;;C   %++CHH55rk   c                V    | j                  | j                  j                  |            S rm   )r   ro   isinre   others     ri   is_inzPandasLikeSeries.is_inu  s"      !1!1%!899rk   c                    | j                   }t        |      }| j                  j                  |      }|j	                  ||j
                  |j                        j                  |   }| j                  |      S )N)r_   r   )	ro   r   r   aranger   r_   r   locr   )re   r   sizer   r   s        ri   arg_truezPandasLikeSeries.arg_truex  sb    kk3x  ''-t#((#))DHHM  ((rk   c                6    | j                   j                         S rm   )ro   argminrn   s    ri   arg_minzPandasLikeSeries.arg_min      {{!!##rk   c                6    | j                   j                         S rm   )ro   argmaxrn   s    ri   arg_maxzPandasLikeSeries.arg_max  r  rk   c                    t        |t              st        | |      \  }}n|}| j                  | j                  j
                  |         j                  | j                        S rm   )r!   boolr   r   ro   r  r  r_   )re   	predicater	  other_natives       ri   filterzPandasLikeSeries.filter  sN    )T*6tYGOA|$L  !>?EEdiiPPrk   c                b    t        | j                        r| j                  j                  d   S d S r   r   ro   r   rn   s    ri   firstzPandasLikeSeries.first  s'    &)$++&6t{{"@D@rk   c                b    t        | j                        r| j                  j                  d   S d S )Nr#  rn   s    ri   lastzPandasLikeSeries.last  s'    '*4;;'7t{{#ATArk   c                   t        | |      \  }}| j                  xr t        |dd      }	  |||      }| j                  ||      j                  | j                        S # t        $ r} |j                  dk(  rj| j
                  t        k(  rWt        |t              s)t        || j                        r1|j
                  t        k(  r| j                         }t        |||      }n Y w xY w)Nrd   Taddr   )r   rd   getattr	TypeError__name__r   r$   r|   strr   rw   r   r   r  r_   )re   opr  r   r   r   r
  pdxs           ri   _with_binaryzPandasLikeSeries._with_binary  s    4T5A\!__Sd1S	S,'C   9K LRRII
 	
  	 u$JJ&(uc*"5$..9ekkV>S //10lCH 	s   	A! !BC'&C'c                `    | j                  fd|      j                  | j                        S )Nc                     ||       S rm   r   )xyr.  s     ri   <lambda>z5PandasLikeSeries._with_binary_right.<locals>.<lambda>  s    bAh rk   )r0  r  r_   )re   r.  r  s    ` ri   _with_binary_rightz#PandasLikeSeries._with_binary_right  s&      !6>DDTYYOOrk   c                B    | j                  t        j                  |      S rm   )r0  operatoreqr  s     ri   __eq__zPandasLikeSeries.__eq__        e44rk   c                B    | j                  t        j                  |      S rm   )r0  r8  ner  s     ri   __ne__zPandasLikeSeries.__ne__  r;  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  r  r  s     ri   __ge__zPandasLikeSeries.__ge__  r;  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  r  r  s     ri   __gt__zPandasLikeSeries.__gt__  r;  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  r  r  s     ri   __le__zPandasLikeSeries.__le__  r;  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  r  r  s     ri   __lt__zPandasLikeSeries.__lt__  r;  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  and_r  s     ri   __and__zPandasLikeSeries.__and__  s      66rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rH  r  s     ri   __rand__zPandasLikeSeries.__rand__  s    &&x}}e<<rk   c                B    | j                  t        j                  |      S rm   )r0  r8  or_r  s     ri   __or__zPandasLikeSeries.__or__        u55rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rM  r  s     ri   __ror__zPandasLikeSeries.__ror__      &&x||U;;rk   c                B    | j                  t        j                  |      S rm   )r0  r8  r)  r  s     ri   __add__zPandasLikeSeries.__add__  rO  rk   c                B    | j                  t        j                  |      S rm   )r6  r8  r)  r  s     ri   __radd__zPandasLikeSeries.__radd__  rR  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  subr  s     ri   __sub__zPandasLikeSeries.__sub__  rO  rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rX  r  s     ri   __rsub__zPandasLikeSeries.__rsub__  rR  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  mulr  s     ri   __mul__zPandasLikeSeries.__mul__  rO  rk   c                B    | j                  t        j                  |      S rm   )r6  r8  r]  r  s     ri   __rmul__zPandasLikeSeries.__rmul__  rR  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  truedivr  s     ri   __truediv__zPandasLikeSeries.__truediv__  s      !1!1599rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rb  r  s     ri   __rtruediv__zPandasLikeSeries.__rtruediv__  s    &&x'7'7??rk   c                B    | j                  t        j                  |      S rm   )r0  r8  floordivr  s     ri   __floordiv__zPandasLikeSeries.__floordiv__  s      !2!2E::rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rg  r  s     ri   __rfloordiv__zPandasLikeSeries.__rfloordiv__  s    &&x'8'8%@@rk   c                B    | j                  t        j                  |      S rm   )r0  r8  powr  s     ri   __pow__zPandasLikeSeries.__pow__  rO  rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rl  r  s     ri   __rpow__zPandasLikeSeries.__rpow__  rR  rk   c                B    | j                  t        j                  |      S rm   )r0  r8  modr  s     ri   __mod__zPandasLikeSeries.__mod__  rO  rk   c                B    | j                  t        j                  |      S rm   )r6  r8  rq  r  s     ri   __rmod__zPandasLikeSeries.__rmod__  rR  rk   c                :    | j                  | j                         S rm   r   ro   rn   s    ri   
__invert__zPandasLikeSeries.__invert__        $++..rk   c                :    | j                  | j                         S rm   rv  rn   s    ri   __neg__zPandasLikeSeries.__neg__  rx  rk   c                6    | j                   j                         S rm   )ro   r   rn   s    ri   r   zPandasLikeSeries.any       {{  rk   c                6    | j                   j                         S rm   )ro   allrn   s    ri   r~  zPandasLikeSeries.all  r|  rk   c                6    | j                   j                         S rm   )ro   minrn   s    ri   r  zPandasLikeSeries.min  r|  rk   c                6    | j                   j                         S rm   )ro   r   rn   s    ri   r   zPandasLikeSeries.max	  r|  rk   c                6    | j                   j                         S rm   )ro   sumrn   s    ri   r  zPandasLikeSeries.sum  r|  rk   c                6    | j                   j                         S rm   )ro   countrn   s    ri   r  zPandasLikeSeries.count  s    {{  ""rk   c                6    | j                   j                         S rm   )ro   r   rn   s    ri   r   zPandasLikeSeries.mean  s    {{!!rk   c                    | j                   j                         sd}t        |      | j                  j	                         S )Nz<`median` operation not supported for non-numeric input type.)r   
is_numericr%   ro   medianru   s     ri   r  zPandasLikeSeries.median  s5    zz$$&PC',,{{!!##rk   c               :    | j                   j                  |      S Nddof)ro   stdre   r  s     ri   r  zPandasLikeSeries.std      {{D))rk   c               :    | j                   j                  |      S r  )ro   varr  s     ri   r  zPandasLikeSeries.var  r  rk   c                F   | j                   j                         }t        |      dk(  ry t        |      dk(  rt        d      S t        |      dk(  ry||j	                         z
  }|dz  j	                         }|dz  j	                         }|dk7  r||dz  z  S t        d      S )Nr   r   nanr   g           g      ?ro   dropnar   floatr   )re   ser_not_nullmm2m3s        ri   skewzPandasLikeSeries.skew!  s    {{))+|!|!<|!<,,..d[[]d[[]!#qrRW~:eEl:rk   c                .   | j                   j                         }t        |      dk(  ry t        |      dk(  rt        d      S ||j	                         z
  }|dz  j	                         }|dz  j	                         }|dk7  r||dz  z  dz
  S t        d      S )Nr   r   r  r      g      @r  )re   r  r  r  m4s        ri   kurtosiszPandasLikeSeries.kurtosis.  s    {{))+|!|!<<,,..d[[]d[[]%'1WrRU|c!>%,>rk   c                ,    t        | j                        S rm   )r   ro   rn   s    ri   r   zPandasLikeSeries.len9  s    4;;rk   c                X    | j                  | j                  j                         d      S )NTr   )r   ro   r   rn   s    ri   is_nullzPandasLikeSeries.is_null>  s%      !1!1!3 MMrk   c                    | j                   }| j                  j                         sd| j                   d}t        |      | j	                  ||k7  d      S )Nz3`.is_nan` only supported for numeric dtype and not z, did you mean `.is_null`?Tr   )ro   r   r  r%   r   )re   r   rv   s      ri   is_nanzPandasLikeSeries.is_nanA  sS    kkzz$$&G

|SmnC',,   EErk   c                   | j                   }| j                  t        j                  u r| j                  dk  rddini }t        j                         5  t        j                  ddt               |5t        | |      \  }}| j                   |j                  dd|i|d	      }n>| j                  |d
k(  r |j                  dd|i|n |j                  dd|i|d	      }d d d        |S # 1 sw Y   S xY w)Nr  downcastFignorez&The 'downcast' keyword .*is deprecated)categoryvalueTr   forwardlimitr   )ro   rb   r    PANDAS_backend_versionwarningscatch_warningsfilterwarningsFutureWarningr   r   fillnaffillbfill)	re   r  strategyr  r   kwargsr	  native_valueres_sers	            ri   	fill_nullzPandasLikeSeries.fill_nullI  s    kk ##~'<'<<%%,  	 	 $$& 	##B]  ":4"G<++CJJ<\<V<QU ,  ++9, CII4E4V4"99&9'+	 , 	  !	  s   BC..C8c                   | j                   }|j                         r|d}t        |      | j                  j	                         sd| j                   d}t        |      | j                  }| |j                  j                  j                  n|}||k7  }|j                         }|j                         r|dk  r|j                  dd       n|j                  d      }| j                  |j                  ||      d      S )	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  r   FT)inplacer   )rb   r   r   r   r  r%   ro   arrayna_valuer  r   r  r   mask)re   r  r   rv   r   fillr  backend_versions           ri   fill_nanzPandasLikeSeries.fill_nanh  s    ##<<>u}JC%c**zz$$&I$**UqrC',,KK).qww}}%%EAv//1>>& 8KKtK,;;u%D  d!3 MMrk   c                T    | j                  | j                  j                               S rm   )r   ro   r  rn   s    ri   
drop_nullszPandasLikeSeries.drop_nulls~  s       !3!3!566rk   c                :    | j                   j                  d      S )NF)r  )ro   nuniquern   s    ri   n_uniquezPandasLikeSeries.n_unique  s    {{""%"00rk   c               \    | j                  | j                  j                  |||            S )N)nreplacerandom_state)r   ro   sample)re   r  with_replacementseeds       ri   r  zPandasLikeSeries.sample  s/      KK,<4P
 	
rk   c                T    | j                  | j                  j                               S rm   )r   ro   absrn   s    ri   r  zPandasLikeSeries.abs  s      !233rk   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S NT)skipnar&  )ro   cumsumr   re   reverser   s      ri   cum_sumzPandasLikeSeries.cum_sum  ]      KKd+TrT")))6tt< 	
   ((rk   Tmaintain_orderc                   | j                   t        | j                        | j                  j                         | j                              S )zuPandas always maintains order, as per its docstring.

        > Uniques are returned in order of appearance.
        r   )r   rs   ro   uniquer_   )re   r  s     ri   r  zPandasLikeSeries.unique  s9    
   !2dkk!24;;3E3E3Gdii!XYYrk   c                T    | j                  | j                  j                               S rm   )r   ro   diffrn   s    ri   r  zPandasLikeSeries.diff  s       !1!1!344rk   c                V    | j                  | j                  j                  |            S rm   )r   ro   shiftre   r  s     ri   r  zPandasLikeSeries.shift  s"      !2!21!566rk   c               H   | j                         }| j                  }| j                  }| j                  }t	        |j
                  |      }	|rt        ||	|| j                        nd }
|j                  |      j                  |      }|dk\  }|j                  ||
| j                        }||	|j                  |	      }|j                  |j                  ||d         }|j                  |_        |t         u ry|j#                         | z  }|j%                         rB| j'                  ||         j)                  d      j+                         }d| }t-        |      |j                  |d       }n!t/        | |      \  }}|j                  ||      }| j'                  |      S )Nr   )r   r_   )r   Fr  zYreplace_strict did not replace all non-null values.

The following did not get replaced: )rw   r   ro   rb   r   r   r   rc   Indexget_indexerr   r_   convert_dtypesr   wherer   r   notnar   r   r  r   r%   r   )re   defaultoldnewreturn_dtype	namespacearray_funcsro   r   r   r   idxswas_matched
new_seriesnative_resultunmatched_maskunmatched_valuesrv   r	  default_natives                       ri   replace_strictzPandasLikeSeries.replace_strict  s    --/	''##)&,,=  %\=$V 	 s#//7ai%%cTYY%G
M$=#222OJ #(9(9+tQ(OP$llj #\\^|<N!!#%%f^&<=V5V1WY !;;K:LN  ,C00)//TBM !9w GA~)//^LM  //rk   c                   |rdnd}| j                  | j                  j                  | |            j                  | j                        S )Nr'  r$  )	ascendingna_position)r   ro   sort_valuesr  r_   )re   
descending
nulls_lastr  s       ri   sortzPandasLikeSeries.sort  sE     *f  KK##*n+#V

%		
	rk   c                    || j                   k7  r3| j                  t        | j                  || j                        d      S | S )Nr   Tr   )r_   r   r   ro   rb   )re   r_   s     ri   r  zPandasLikeSeries.alias  sF    499$$t{{D9M9MN#' %   rk   c               (    | j                  ||      S )N)r   r   )to_numpy)re   r   r   s      ri   	__array__zPandasLikeSeries.__array__  s     }}5t}44rk   )r   c                   | j                   j                  }t        | j                  |j                        rU| j                  j
                  ?| j                  j                  d      j                  j                  d       j                  }n| j                  }|j                         j                         }d|xs | j                  j                         i}|rWt        |j                        t        v r<|j!                  dt#        d      i       |xs t        t        |j                           }|s;t        |j                        t$        v r |xs t$        t        |j                           } |j&                  dd|i|S )NUTCr   r  r  r   r   )rc   dtypesr|   r   Datetime	time_zonedtconvert_time_zonereplace_time_zonero   r   r   rb   r   r-  PANDAS_TO_NUMPY_DTYPE_MISSINGupdater   PANDAS_TO_NUMPY_DTYPE_NO_MISSINGr  )re   r   r   r  r   has_missingr  s          ri   r  zPandasLikeSeries.to_numpy  s    %%djj&//2tzz7K7K7W))%033EEdKRRAAffhlln"($*P$2F2F2N2N2P!Q3qww<+HHMM:uU|45H:3qww<HEs177|/OOK=c!''lKEqzz0000rk   c                ^   | j                   t        j                  u r| j                  S | j                   t        j                  u r| j                  j                         S | j                   t        j                  u r| j                  j                         S d| j                    }t        |      )NzUnknown implementation: )	rb   r    r  ro   r   	to_pandasMODIN
_to_pandasrt   ru   s     ri   r  zPandasLikeSeries.to_pandas  s    >#8#88;;>#6#66;;((**>#7#77;;))++()=)=(>?S!!rk   c                J    dd l } |j                  | j                               S r   )polarsfrom_pandasr  )re   pls     ri   	to_polarszPandasLikeSeries.to_polars  s    r~~dnn.//rk   c                    | j                  | j                  j                  d             j                  | j                        S )NFkeepr   ro   
duplicatedr  r_   rn   s    ri   	is_uniquezPandasLikeSeries.is_unique  s7      $++"8"8e"8"D!DEKKDIIVVrk   c                R    | j                   j                         j                         S rm   )ro   r   r  rn   s    ri   
null_countzPandasLikeSeries.null_count  s    {{!%%''rk   c                    | j                  | j                  j                  d             j                  | j                        S )Nr$  r  r  rn   s    ri   is_first_distinctz"PandasLikeSeries.is_first_distinct  s7      $++"8"8g"8"F!FGMMdiiXXrk   c                    | j                  | j                  j                  d             j                  | j                        S )Nr'  r  r  rn   s    ri   is_last_distinctz!PandasLikeSeries.is_last_distinct  s7      $++"8"8f"8"E!EFLLTYYWWrk   c                   t        |t              sdt        |       }t        |      |r| j                  j
                  S | j                  j                  S )Nz/argument 'descending' should be boolean, found )r|   r  rs   r+  ro   is_monotonic_decreasingis_monotonic_increasing)re   r  rv   s      ri   	is_sortedzPandasLikeSeries.is_sorted  sK    *d+CDDTCUVCC. ;;666{{222rk   c                  ddl m} | j                  dn| j                  }|xs |rdnd}| j                  j	                  dd|      j                         }||g|_        |r|j                  |d      } |j                  || 	      S )
z-Parallel is unused, exists for compatibility.r   r1   r   
proportionr  F)r  r  	normalize)r  r   )	r   r2   r`   ro   value_countsreset_indexcolumnsr  r   )	re   r  parallelr_   r*  r2   index_name_value_name_	val_counts	            ri   r+  zPandasLikeSeries.value_counts#  s     	H!%!3gFy|gKK,,u	 - 

+- 	 )+6	!--kU-KI."..y$GGrk   c                <    | j                   j                  ||      S )N)qinterpolation)ro   quantile)re   r5  r4  s      ri   r5  zPandasLikeSeries.quantile6  s     {{##hm#LLrk   c                    | j                   }t        | |      \  }}t        | |      \  }}|j                  ||      }| j                  |      S rm   )ro   r   r  r   )re   r  r  r   r	  r
  s         ri   zip_withzPandasLikeSeries.zip_with;  sL    kk*464+D%85iie$  %%rk   c                V    | j                  | j                  j                  |            S rm   )r   ro   headr  s     ri   r9  zPandasLikeSeries.headB  "      !1!1!!455rk   c                V    | j                  | j                  j                  |            S rm   )r   ro   tailr  s     ri   r<  zPandasLikeSeries.tailE  r:  rk   c                X    | j                  | j                  j                  |            S )N)decimals)r   ro   round)re   r>  s     ri   r?  zPandasLikeSeries.roundH  s%      !2!2H!2!EFFrk   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
ro   is_native_dtype_pyarrowr   pyarrow.computecompute_apply_pyarrow_compute_funcfloorr   _apply_array_funcr   re   ro   pcresult_native
array_funcs        ri   rE  zPandasLikeSeries.floorK  sj    ''5( <<VRXXNM**00J 226:FM  //rk   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
ro   rA  r   rB  rC  rD  ceilr   rF  r   rG  s        ri   rL  zPandasLikeSeries.ceilV  sj    ''5( <<VRWWMM**//J 226:FM  //rk   c                  ddl m} | j                         }| j                  }| j                  rt        | j                        nd}| | d}|j                         j                         }|j                  |||||d      }	|rLt        |	j                        ^ }
}|g|
}t        t        |	|| j                        ||i| j                        }	 |j                  |	|       S )	Nr   r1   r   nullrN   )prefix
prefix_sep
drop_firstdummy_nar   )r-  rg   r   )r   r2   rw   ro   r`   r-  r   r   get_dummiesr~   r-  r   r   rb   r   )re   	separatorrQ  r2   plxr   r_   null_col_pl	has_nullsr   colsnull_col_pdoutput_orders                ri   
to_dummieszPandasLikeSeries.to_dummiesa  s    G'')"&**s4::"yk.KKM%%'	 ! ! 
 !%fnn!5T;'/$/L&v|T=Q=QR$k2#33F
 /"..vtDDrk   c                X    | j                  | j                  j                  |d |         S rm   )r   ro   r   )re   r  offsets      ri   gather_everyzPandasLikeSeries.gather_every~  s(      !1!1&)!)!<==rk   c                   t        | |      \  }}t        | |      \  }}| j                  }|j                         rddini }| j                  }|j	                         sP| j                  |      r|j                  ||k\  |      }d }| j                  |      r|j                  ||k  |      }d }| j                   |j                  ||fi |      S Naxisr   	r   rb   is_modinro   r   r   r  r   clip)	re   r  r  r	  lowerupperr   r  r   s	            ri   rd  zPandasLikeSeries.clip  s    +D+>5+D+>5##04&!R~~ u%fou=u%fou=  UE!DV!DEErk   c                0   t        | |      \  }}| j                  }|j                         rddini }| j                  }|j	                         s(| j                  |      r|j                  ||k\  |      }d }| j                   |j                  |fi |      S r`  rb  )re   r  r	  re  r   r  r   s          ri   
clip_lowerzPandasLikeSeries.clip_lower  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  U!=f!=>>rk   c                2   t        | |      \  }}| j                  }|j                         rddini }| j                  }|j	                         s(| j                  |      r|j                  ||k  |      }d }| j                   |j                  dd|i|      S )Nra  r   rf  r   rb  )re   r  r	  rf  r   r  r   s          ri   
clip_upperzPandasLikeSeries.clip_upper  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  !C5!CF!CDDrk   c                    | j                   t        j                  u r| j                  j	                         S dd l}|j                  j                  | j                        S r   )rb   r    r   ro   r   pyarrowArrayr  )re   pas     ri   r   zPandasLikeSeries.to_arrow  sE    >#6#66;;''))xx##DKK00rk   c                   | j                   j                         }| j                  |_        | j                  |dk(  r|j	                  d            S |      S )Nr   r   )ro   moder_   r   r9  )re   r  r   s      ri   rp  zPandasLikeSeries.mode  sF    !!#ii  45=QMMfMMrk   c                   | j                   j                          }|s|j                         n!t        |       |j                         z
  |z   dz
  }| j	                  |      S Nr   )ro   r   r  r   r   )re   r  not_na_seriesr   s       ri   	cum_countzPandasLikeSeries.cum_count  sa    ))++    "T]1133mCaG 	
   ((rk   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )ro   cumminr   r  s      ri   cum_minzPandasLikeSeries.cum_min  r  rk   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )ro   cummaxr   r  s      ri   cum_maxzPandasLikeSeries.cum_max  r  rk   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )ro   cumprodr   r  s      ri   cum_prodzPandasLikeSeries.cum_prod  s]      KKt,TrT"**$*7"= 	
   ((rk   c               |    | j                   j                  |||      j                         }| j                  |      S Nwindowmin_periodscenter)ro   rollingr  r   re   window_sizer   r  r   s        ri   rolling_sumzPandasLikeSeries.rolling_sum  s?    $$K % 

#% 	   ((rk   c               |    | j                   j                  |||      j                         }| j                  |      S r  )ro   r  r   r   r  s        ri   rolling_meanzPandasLikeSeries.rolling_mean  s?    $$K % 

$& 	   ((rk   c                   | j                   j                  |||      j                  |      }| j                  |      S Nr  r  )ro   r  r  r   re   r  r   r  r  r   s         ri   rolling_varzPandasLikeSeries.rolling_var  E     $$K % 

#4#. 	   ((rk   c                   | j                   j                  |||      j                  |      }| j                  |      S r  )ro   r  r  r   r  s         ri   rolling_stdzPandasLikeSeries.rolling_std  r  rk   c              #     K   | j                   j                         rd}t        |      | j                  j	                         E d {    y 7 w)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)rb   r   r   ro   __iter__ru   s     ri   r  zPandasLikeSeries.__iter__  sF     ''){  &c**;;'')))s   AAAAc                    |(| j                   j                         j                         S | j                   |k(  j                         S rm   )ro   r   r   r  s     ri   __contains__zPandasLikeSeries.__contains__  s9    +0=t{{!%%'Zt{{e?S>X>X>ZZrk   c                r    | j                   }| j                  |t        d      kD  |t        d      k  z        S )Nz-infinf)ro   r   r  )re   r   s     ri   	is_finitezPandasLikeSeries.is_finite
  s3    KK  !eFm"3E%L8H!IJJrk   c               :   |dk(  rdn|}| j                   }| j                  t        j                  u r;| j                  dk  r+t        | j                  j                  | j                        dk(  r| j                  j                         r| j                         x}j                         r| d}| j                         }| j                         j                  |j                  j                  |      j!                  |            j                  }| j#                  |j%                  |      j'                  |d| d      j(                  d d d	f         j!                  | j                         S | j#                  | j                  j'                  |d| d            S )
Nordinalr$  r  numpy_nullable_is_nullr  F)method	na_optionr  pctr   )r_   rb   r    r  r  r   ro   r   
is_integerr  r   rz   r   with_columns_expr_from_seriesr  r   groupbyrankr   )	re   r  r  	pd_methodr_   	null_mask	mask_namerU  dfs	            ri   r  zPandasLikeSeries.rank  so   %2G	yy  N$9$99%%,!$++"3"3T5I5IJ 

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

9%$$",n	   ad	 eDII	   KK F*nRW  
 	
rk   c               j    t         j                  | |      j                  |      j                         S N)include_breakpoint)_PandasHistfrom_series	with_binsr   )re   binsr  s      ri   hist_from_binszPandasLikeSeries.hist_from_bins3  s-     ##D=O#PYt_XZ	
rk   c               j    t         j                  | |      j                  |      j                         S r  )r  r  with_bin_countr   )re   	bin_countr  s      ri   hist_from_bin_countz$PandasLikeSeries.hist_from_bin_count<  s.     ##D=O#P^I&XZ	
rk   c                   | j                   }| j                  |j                        r dd lm dfd}| j                  ||      }n/| j                  j                  dfd}| j                  ||      }| j                  |      S )Nr   c                (    j                  |       S rm   )logb)cabaserH  s    ri   pc_logz$PandasLikeSeries.log.<locals>.pc_logJ  s    wwr4((rk   c                &     |              z  S rm   r   )r   r  log_funcs    ri   	array_logz'PandasLikeSeries.log.<locals>.array_logQ  s    }x~55rk   )r  r/   returnr/   )r   r5   r  r5   )
ro   rA  r   rB  rC  rD  r   logrF  r   )re   r  ro   r  rI  r  r  rH  s    `    @@ri   r  zPandasLikeSeries.logE  su    ''5() !<<VVLM((,,H6 !2269EM  //rk   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
ro   rA  r   rB  rC  rD  expr   rF  r   rG  s        ri   r  zPandasLikeSeries.expW  sj    ''5( <<VRVVLM**..J 226:FM  //rk   c                V    | j                  | j                  j                  d            S )N      ?)r   ro   rl  rn   s    ri   sqrtzPandasLikeSeries.sqrtc  s       !566rk   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
ro   rA  r   rB  rC  rD  sinr   rF  r   rG  s        ri   r  zPandasLikeSeries.sinf  p    ''5( <<M
 **..J 226:FM  //rk   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
ro   rA  r   rB  rC  rD  cosr   rF  r   rG  s        ri   r  zPandasLikeSeries.cosu  r  rk   c                :    | j                   }t        ||      dk(  S )Nr   rl  )rb   r   )re   r   r   s      ri   rA  z(PandasLikeSeries.is_native_dtype_pyarrow  s    ## dCyPPrk   c                   ddl m} t        |      } ||j                  j                        } ||j                  | j
                        }t        |d| j                  | j
                        } ||||j                  |j                        S )Nr   )r   rl  )r   r   r_   )
narwhals._arrow.utilsr   rs   r  	_pa_arrayrc   r   rb   r   r_   )re   ro   pc_funcr   
native_cls
result_arrnw_dtype	out_dtypes           ri   rD  z,PandasLikeSeries._apply_pyarrow_compute_func  sv     	C&\
V\\334
+JOOT]]K,i!5!5t}}
	 iv||&++
 	
rk   c                    t        |      } ||      }| j                  j                         r |||j                  |j                        S |S )N)r   r_   )rs   rb   r   r   r_   )re   ro   rJ  r  r  s        ri   rF  z"PandasLikeSeries._apply_array_func  sP     &\
'
 ##++- zFKKH	
 	
rk   c               b    |r| j                         j                         S | j                         S rm   )r  r$  )re   r   s     ri   	any_valuezPandasLikeSeries.any_value  s%    ,8t &&(JdjjlJrk   c                    t        |       S rm   r   rn   s    ri   r-  zPandasLikeSeries.str  s    .t44rk   c                    t        |       S rm   r   rn   s    ri   r  zPandasLikeSeries.dt  s    066rk   c                    t        |       S rm   r
   rn   s    ri   catzPandasLikeSeries.cat  s    +D11rk   c                ^    t        | j                  d      sd}t        |      t        |       S )Nr~   z>Series must be of PyArrow List type to support list namespace.)hasattrro   r+  r   ru   s     ri   r~   zPandasLikeSeries.list  s*    t{{F+RCC. ,T22rk   c                ^    t        | j                  d      sd}t        |      t        |       S )NstructzBSeries must be of PyArrow Struct type to support struct namespace.)r  ro   r+  r   ru   s     ri   r  zPandasLikeSeries.struct  s*    t{{H-VCC. .t44rk   )rf   r   rg   r    rh   r7   r  None)r  r   )r  r+   )r  r4   )r   z'SizedMultiIndexSelector[pd.Series[Any]]r  r-   )r   z_SliceIndex | ranger  r-   )rh   r7   r  r-   )r   r   r   r  r  r-   )r   zIterable[Any]r   r8   r_   r-  r   IntoDType | Noner   r   r  r-   )r   r   r  zTypeIs[Any])r   r   r   r8   r  r-   )r   r<   r   r8   r  r-   )r   r-   r  zSequence[Self])r  r-  )r  r9   )r   float | Noner   r  r   r  r   r  r   r  r   intr   r  r  r-   )r   r-   r   r-   r   zLiteral[True]r  r  )r   r-   r   r-   r   zLiteral[False]r  r-   )r   r-   r   r-   r   r  r  zSelf | None)r   r=   r  r-   rm   )r   
int | Noner  r   r  r2   )r  z	list[Any])r  r   r  r   r  r:   r  r-   )r  r   r  r-   )r  r-   )r  r  )r  r   r  r-   )r  r@   )r.  zCallable[..., pd.Series]r  r   r  r-   )r  r   r  r-   r  r  )r  r  )r  r  r  r  )r  r  )r  zSelf | NonNestedLiteralr  zFillNullStrategy | Noner  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  zPandasLikeSeries | NoDefaultr  Sequence[Any]r  r  r  r  r  r]   )r  r  r  r  r  r]   )r_   zstr | Hashabler  r-   )r   r   r   zbool | Noner  rD   )r  pd.Series[Any])r  z	pl.Series)r  r  r  r  )
r  r  r.  r  r_   z
str | Noner*  r  r  r2   )r5  r  r4  rB   r  r  )r  r   r  r   r  r-   )r>  r  r  r-   )rT  r-  rQ  r  r  r2   )r  r  r]  r  r  r-   )r  r-   r  r-   r  r-   )r  r-   r  r-   )r  r-   r  r-   )r  zpa.Array[Any])r  r>   r  r-   )r  r  r   r  r  r  r  r-   )
r  r  r   r  r  r  r  r  r  r-   )r  zIterator[Any])r  r   r  r  )r  rA   r  r  r  r-   )r  list[float]r  r  r  r2   )r  r  r  r  r  r2   )r  r  r  r-   )r   r   r  r  )ro   r5   r  z,Callable[[ChunkedArrayAny], ChunkedArrayAny]r  r5   )ro   r5   rJ  z(Callable[[NativeSeriesT], NativeSeriesT]r  r5   )r   r  r  r@   )r  r   )r  r   )r  r   )r  r   )r  r   )r,  
__module____qualname__rj   propertyro   rw   rz   r   r   r   r   classmethodr   staticmethodr   r   r   r   r_   r   r   r   r   r   r   r   r   r   r  r  r  r  r  r!  r$  r'  r0  r6  r:  r>  r@  rB  rD  rF  rI  rK  rN  rQ  rT  rV  rY  r[  r^  r`  rc  re  rh  rj  rm  ro  rr  rt  rw  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+  r5  r7  r9  r<  r?  rE  rL  r[  r^  rd  rh  rj  r   rp  rt  rw  rz  r}  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  rA  rD  rF  r  r-  r  r  r~   r  r   rk   ri   r]   r]   u   su      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$"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 5rk   r]   c                      e Zd ZU ded<   ddZddZddZddZddd		 	 	 	 	 	 	 dd
Zdd	 	 	 	 	 	 	 	 	 ddZ	ddZ
ddZy)r  r]   _seriesc                    | j                   j                         j                  j                  }| j                   j	                         j
                  } | || j                        | j                         S )Nr   )r  rz   
_dataframer   rw   	DataFrame_data)re   r   r  s      ri   r   z_PandasHist.to_frame  sR    ll99;FFRRLL557AA	9TZZ0$,,GGrk   c                <    | j                   j                         dk  S rr  )r  r  rn   s    ri   is_empty_seriesz_PandasHist.is_empty_series  s    ||!!#a''rk   c               l    | j                  |      }| j                  r| j                  |      |dS d|iS )N
breakpointr  r  )_zeros_breakpoint_calculate_breakpoint)re   argr  s      ri   series_emptyz_PandasHist.series_empty  s:    C "&"<"<S"AERRrk   c                   | j                   j                  j                  }t        |t              r ||      S  |t        |      dz
        S rr  )r  r   zerosr|   r  r   )re   r  r  s      ri   r  z_PandasHist._zeros  s<    ))//'S1uSzJuSX\7JJrk   Nr   )labelsr  c               ~    | j                   j                         j                  } || j                  ||dk(  |d      S )Nr   T)r  r   r  include_lowest)r  rw   cutro   )re   breaksr  r  r  s        ri   _cutz_PandasHist._cut  sA     ll//155KKG#
 	
rk   r   )r  c               Z    | j                   j                  j                  ||||dk(        S )Nr   )r   r   numendpoint)r  r   linspace)re   r   endnum_samplesr  s        ri   _linear_spacez_PandasHist._linear_space  s4     ||((11c{Vv=M 2 
 	
rk   c                    | j                   j                         | j                   j                         }}||k(  r
|dz  }|dz  }| j                  |||dz         S )z6Prepare bins for histogram calculation from bin_count.r  r   )ro   r  r   r  )re   r  re  rf  s       ri   _calculate_binsz_PandasHist._calculate_bins  sS    {{($++//*;uE>SLESLE!!%	A>>rk   c                    | j                  |      }|j                  dd      j                  |j                  j                  d      }|j                  dd       | j                  r|dd  |dS d	|iS )
NTF)r  r  r   )
fill_value)dropr  r   r  r  )r  r+  reindexr  
categoriesr,  r  )re   r  r  r  s       ri   _calculate_histz_PandasHist._calculate_hist  s     YYt_
 ''t%'@HHNN%%! I 
 	tT2"&qr(U;;rk   r  r  )r  int | list[float]r  rF   )r  r  r  rD   )r  list[float] | _1DArrayr  zSequence[str] | Noner  zLiteral['left', 'right']r  r  )
r   r  r	  r  r
  r  r  zLiteral['both', 'none']r  rD   )r  r  r  rD   )r  r  r  rF   )r,  r  r  __annotations__r   r  r  r  r  r  r  r  r   rk   ri   r  r    s    H(
 K (,+2
&
 %	

 )
 

. +1



 

 	

 (

 


? rk   r  )r  r  )d
__future__r   r8  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pdr  r  rl  rn  typing_extensionsr-   r.   narwhals._arrow.typingr/   narwhals._compliant.seriesr0   r   r2   ry   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  r  r  r]   r  r   rk   ri   <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#!$ "!#+! 2H5{3' H5V"J /"AB J rk   