
    [i7                        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	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" d dl#m$Z$ d dl%m&Z&m'Z'm(Z(m)Z) d dl*m+Z+m,Z, d dl-m.Z. er}d dl/m0Z0m1Z1m2Z2m3Z3 d dl4m5Z5 d dl6Z7d dl8Z9d dl:Z;d dl<m=Z=m>Z>m?Z? d dl@mAZA d dlBmCZC d dlDmEZE d dlFmGZG d dlHmIZI d dlJmKZK d dl%mLZLmMZM d dlNmOZO d dlPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[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-d.d/d.d0d1d2d1d3d4d5d4d6d7d7d8d8d9Z_i dd7d d7d!d7d#d7d$d7d&d7d'd7d)d7d*d7d,d7d-d7d/d7d0d7d2d7d3d7d5d7d6d7d7d8d8d9Z` G d: d;ee         Za G d< d=ed>         Zby)?    )annotationsN)TYPE_CHECKINGAnyCallableLiteral)EagerSeriesEagerSeriesHistPandasLikeSeriesCatNamespace!PandasLikeSeriesDateTimeNamespace)PandasLikeSeriesListNamespacePandasLikeSeriesStringNamespace)PandasLikeSeriesStructNamespace)
align_and_extract_native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)Implementation
is_list_of
no_defaultparse_version)is_numpy_array_1dis_pandas_like_series)InvalidOperationError)HashableIterableIteratorSequence)
ModuleType)Self	TypeAlias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)zfloat64[pyarrow]Float32zfloat32[pyarrow]c                     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ddZ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-dd.Z.dd/Z/dd0Z0dd1Z1dd2Z2dd3Z3dd4Z4dd5Z5dd6Z6dd7Z7dd8Z8dd9Z9dd:Z:dd;Z;dd<Z<dd=Z=dd>Z>dd?Z?dd@Z@ddAZAddBZBddCZCddDZDddEZEddFZFddGZGddHZHddIZIddJZJddKZKddLZLddMZMddNZN	 	 	 	 	 	 	 	 ddOZOddPZPddQZQddRZR	 	 	 	 	 	 	 	 	 	 ddSZSddTZTddUZUdVdWddXZVddYZWddZZX	 	 	 	 	 	 	 	 	 	 dd[ZYdd\ZZdd]Z[dd^Z\ddd_dd`Z]ddaZ^ddbZ_ddcZ`dddZaddeZbddfZcddgZd	 	 	 	 	 	 	 	 	 	 ddhZe	 	 	 	 	 	 ddiZfddjZgddkZhddlZiddmZjddnZkddoZlddpZmddqZnddrZoddsZpddtZqdduZrddvZsddwZtddxZuddyZvddzZwdd{Zxdd|Zy	 	 	 	 	 	 	 	 	 	 dd}Zz	 	 	 	 	 	 	 	 	 	 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       m/var/www/html/userprofiledev.eatanceapp.com/venv/lib/python3.12/site-packages/narwhals/_pandas_like/series.py__init__zPandasLikeSeries.__init__r   s1     #''
+-      c                    | j                   S N)r]   ra   s    re   nativezPandasLikeSeries.native   s    """rg   c                    | j                   j                         r| j                   j                         S dt        | j                          }t	        |      )Nz!Expected pandas/modin/cudf, got: )r^   is_pandas_liketo_native_namespacetypeAssertionErrorra   msgs     re   __native_namespace__z%PandasLikeSeries.__native_namespace__   sL    ..0'';;==1$t7K7K2L1MNS!!rg   c                H    ddl m}  || j                  | j                        S )Nr   r0   )narwhals._pandas_like.namespacer1   r^   r_   )ra   r1   s     re   __narwhals_namespace__z'PandasLikeSeries.__narwhals_namespace__   s    G"4#7#7GGrg   c                    t        |t              rt        |      n|}| j                  | j                  j
                  |         S ri   )
isinstancetuplelist_with_nativerk   ilocra   rowss     re   _gatherzPandasLikeSeries._gather   s6    'e4tDz$  !1!1$!788rg   c                    | j                  | j                  j                  t        |j                  |j
                  |j                                 S ri   )r{   rk   r|   slicestartstopstepr}   s     re   _gather_slicezPandasLikeSeries._gather_slice   s<      KKU4::tyy$))DE
 	
rg   c                R    | j                  | j                  | j                  |      S N)rc   rd   )	__class__rk   r^   )ra   rd   s     re   _with_versionzPandasLikeSeries._with_version   s)    ~~KK(<(<g  
 	
rg   Fpreserve_broadcastc               |    | j                  || j                  | j                        }|r| j                  |_        |S r   )r   r^   r_   r`   )ra   seriesr   results       re   r{   zPandasLikeSeries._with_native   s<    4#7#7   
  $Frg    N)r[   dtypeindexc                  |j                   }|j                  }|j                         }i }	|rt        |d ||      |	d<   n'|j	                         rd|	d<   |t        |      r||	d<   | j                   |j                  |fd|i|	|      S )Nr   Fcopyr   r[   context)r^   r_   rn   r   	is_pandaslenfrom_nativeSeries)
clsdatar   r[   r   r   rc   rd   nskwdss
             re   from_iterablezPandasLikeSeries.from_iterable   s     !00""//1!4UD.RYZDM'')$V SZ %WyryyADADA7SSrg   c                    t        |       S ri   )r"   )objs    re   
_is_nativezPandasLikeSeries._is_native   s    $S))rg   c              @     | ||j                   |j                        S r   )r^   r_   )r   r   r   s      re   r   zPandasLikeSeries.from_native   s    4(?(?IYIYZZrg   c                  |j                   }t        |      r|n|g}|j                         j                  |d      }| j	                  ||      S )Nr   r[   r   )r^   r!   rn   r   r   )r   r   r   rc   arrrk   s         re   
from_numpyzPandasLikeSeries.from_numpy   sN     00'-dD6335<<Sr<Jvw77rg   c                p   |d   j                         j                  }|D cg c]  }t        |       }}t        d t	        ||      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ri   )r`   ).0lengthss      re   	<genexpr>z9PandasLikeSeries._align_full_broadcast.<locals>.<genexpr>   s      
$8yvqF$8s   )	is_nestedseries_classrc   )rs   r   r   maxzipr   rk   r`   r   r   r   r{   r   r^   append)
r   r   r   r   lengthstarget_lengthidx	reindexedrk   	compliants
             re   _align_full_broadcastz&PandasLikeSeries._align_full_broadcast   s   //188#)*6a3q66* 
$'$8
 
 W]]=1299??	A||2HHcQWW->->-@v NN62	s*"188SARARSNN62		Y'  % +s   D3c                    | j                   S ri   )r\   rj   s    re   r[   zPandasLikeSeries.name   s    zzrg   c                    | j                   j                  }|dk7  r!t        || j                  | j                        S t        | j                   | j                  | j                        S )Nobject)rk   r   r   r_   r^   r   )ra   native_dtypes     re   r   zPandasLikeSeries.dtype   s\    {{(( x' %\4==$BVBVW	
 1T]]D,@,@	
rg   c                D    t         rdd l}|S t        | j                        S Nr   )r   numpyr   r^   )ra   nps     re   _array_funcszPandasLikeSeries._array_funcs   s    I"4#7#788rg   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)
rk   isnar^   r   CUDFanyewmmeanNotImplementedErrorr{   )ra   r   r   	half_lifer   r   min_samplesignore_nullssermask_nar   rr   s               re   ewm_meanzPandasLikeSeries.ewm_mean   s     kk((*>#6#66q w{{}$%PV ! $& 
K  *#..WWT9e[&L  df  w  ((rg   c                :   t        || j                        r9t        |j                  | j                  j                  |   | j
                        }| j                  j                  d      }||j                  |<   | j                  |_        | j                  |      S )Nr   T)deep)
rx   r   r   rk   r   r^   r   r|   r[   r{   )ra   indicesvaluesr   s       re   scatterzPandasLikeSeries.scatter  s~    fdnn-!!'*#33F
 KK$' w  ##rg   c                   | j                   }| j                  }t        |j                  | j                  j                  |j                     |      }|t
        j                  u r"t        t              dk  r|j                         }d}|t
        j                  u r3||k  r.|| j                  j                  |j                  j                  <   y || j                  j                  |j                  <   y )Nr   )   )   r   )r^   _backend_versionr   rk   r   r   PANDASr    r   r   r|   r   )ra   r   r   rc   backend_versionvalues_nativemin_pd_versions          re   _scatter_in_placez"PandasLikeSeries._scatter_in_place%  s    --//!MMKKgnn-)

 ^222}R7H47O)..0M^2227W6CDKKW^^223/<DKKW^^,rg   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_backendrc   rd   )r   rk   r{   r   r   r^   r_   astype)ra   r   pd_dtypes      re   castzPandasLikeSeries.cast6  s    ::4;;#4#4#@ $$T[[T$JJ++DKK,=,=t?S?ST//MM	
   !3!3H!=RV WWrg   c                    |At        |       dk7  rdt        |        d}t        |      | j                  j                  d   S | j                  j                  |   S )Nr   zlcan only call '.item()' if the Series is of length 1, or an explicit index is provided (Series is of length )r   )r   
ValueErrorrk   r|   )ra   r   rr   s      re   itemzPandasLikeSeries.itemD  sf    =4yA~NNQRVi[XY[  !o%;;##A&&{{&&rg   c                ~    ddl m}  || j                  j                         | j                  | j
                  d      S )Nr   r.   F)rc   rd   validate_column_names)narwhals._pandas_like.dataframer/   rk   to_framer^   r_   )ra   r/   s     re   r   zPandasLikeSeries.to_frameP  s5    G"KK  "//MM"'	
 	
rg   c                    | j                   j                         }|r(| j                  j                         j	                         S | j                  j                         S ri   )r^   is_cudfrk   to_arrow	to_pylistto_list)ra   r   s     re   r   zPandasLikeSeries.to_listZ  sF    &&..05<t{{##%//1W$++BUBUBWWrg   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)
rk   r   geltgtler   r{   aliasr[   )ra   lower_boundupper_boundclosedr   _ress          re   
is_betweenzPandasLikeSeries.is_between^  s     kk1$D;1$D;V&&%{(;;Cw&&%{(;;Cv&&%{(;;Cv&&%{(;;C   %++CHH55rg   c                V    | j                  | j                  j                  |            S ri   )r{   rk   isinra   others     re   is_inzPandasLikeSeries.is_inp  s"      !1!1%!899rg   c                    | j                   }t        |      }| j                  j                  |      }|j	                  ||j
                  |j                        j                  |   }| j                  |      S )N)r[   r   )	rk   r   r   aranger   r[   r   locr{   )ra   r   sizer   r   s        re   arg_truezPandasLikeSeries.arg_trues  sb    kk3x  ''-t#((#))DHHM  ((rg   c                6    | j                   j                         S ri   )rk   argminrj   s    re   arg_minzPandasLikeSeries.arg_minz      {{!!##rg   c                6    | j                   j                         S ri   )rk   argmaxrj   s    re   arg_maxzPandasLikeSeries.arg_max}  r  rg   c                    t        |t              st        | |      \  }}n|}| j                  | j                  j
                  |         j                  | j                        S ri   )r   boolr   r{   rk   r  r   r[   )ra   	predicater  other_natives       re   filterzPandasLikeSeries.filter  sN    )T*6tYGOA|$L  !>?EEdiiPPrg   c                b    t        | j                        r| j                  j                  d   S d S r   r   rk   r|   rj   s    re   firstzPandasLikeSeries.first  s'    &)$++&6t{{"@D@rg   c                b    t        | j                        r| j                  j                  d   S d S )Nr  rj   s    re   lastzPandasLikeSeries.last  s'    '*4;;'7t{{#ATArg   c                    t        | |      \  }}| j                  xr t        |dd      }| j                   |||      |      j	                  | j
                        S )Nr`   Tr   )r   r`   getattrr{   r   r[   )ra   opr  r   r  r   s         re   _with_binaryzPandasLikeSeries._with_binary  s^    4T5A\!__Sd1S  sL!6H ! 

%		
	rg   c                `    | j                  fd|      j                  | j                        S )Nc                     ||       S ri    )xyr#  s     re   <lambda>z5PandasLikeSeries._with_binary_right.<locals>.<lambda>  s    bAhrg   )r$  r   r[   )ra   r#  r  s    ` re   _with_binary_rightz#PandasLikeSeries._with_binary_right  s&      !6>DDTYYOOrg   c                B    | j                  t        j                  |      S ri   )r$  operatoreqr  s     re   __eq__zPandasLikeSeries.__eq__        e44rg   c                B    | j                  t        j                  |      S ri   )r$  r-  ner  s     re   __ne__zPandasLikeSeries.__ne__  r0  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  r   r  s     re   __ge__zPandasLikeSeries.__ge__  r0  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  r   r  s     re   __gt__zPandasLikeSeries.__gt__  r0  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  r   r  s     re   __le__zPandasLikeSeries.__le__  r0  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  r   r  s     re   __lt__zPandasLikeSeries.__lt__  r0  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  and_r  s     re   __and__zPandasLikeSeries.__and__  s      66rg   c                B    | j                  t        j                  |      S ri   )r+  r-  r=  r  s     re   __rand__zPandasLikeSeries.__rand__  s    &&x}}e<<rg   c                B    | j                  t        j                  |      S ri   )r$  r-  or_r  s     re   __or__zPandasLikeSeries.__or__        u55rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rB  r  s     re   __ror__zPandasLikeSeries.__ror__      &&x||U;;rg   c                B    | j                  t        j                  |      S ri   )r$  r-  addr  s     re   __add__zPandasLikeSeries.__add__  rD  rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rI  r  s     re   __radd__zPandasLikeSeries.__radd__  rG  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  subr  s     re   __sub__zPandasLikeSeries.__sub__  rD  rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rN  r  s     re   __rsub__zPandasLikeSeries.__rsub__  rG  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  mulr  s     re   __mul__zPandasLikeSeries.__mul__  rD  rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rS  r  s     re   __rmul__zPandasLikeSeries.__rmul__  rG  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  truedivr  s     re   __truediv__zPandasLikeSeries.__truediv__  s      !1!1599rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rX  r  s     re   __rtruediv__zPandasLikeSeries.__rtruediv__  s    &&x'7'7??rg   c                B    | j                  t        j                  |      S ri   )r$  r-  floordivr  s     re   __floordiv__zPandasLikeSeries.__floordiv__  s      !2!2E::rg   c                B    | j                  t        j                  |      S ri   )r+  r-  r]  r  s     re   __rfloordiv__zPandasLikeSeries.__rfloordiv__  s    &&x'8'8%@@rg   c                B    | j                  t        j                  |      S ri   )r$  r-  powr  s     re   __pow__zPandasLikeSeries.__pow__  rD  rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rb  r  s     re   __rpow__zPandasLikeSeries.__rpow__  rG  rg   c                B    | j                  t        j                  |      S ri   )r$  r-  modr  s     re   __mod__zPandasLikeSeries.__mod__  rD  rg   c                B    | j                  t        j                  |      S ri   )r+  r-  rg  r  s     re   __rmod__zPandasLikeSeries.__rmod__  rG  rg   c                :    | j                  | j                         S ri   )r{   rk   rj   s    re   
__invert__zPandasLikeSeries.__invert__  s      $++..rg   c                6    | j                   j                         S ri   )rk   r   rj   s    re   r   zPandasLikeSeries.any      {{  rg   c                6    | j                   j                         S ri   )rk   allrj   s    re   rp  zPandasLikeSeries.all  rn  rg   c                6    | j                   j                         S ri   )rk   minrj   s    re   rr  zPandasLikeSeries.min  rn  rg   c                6    | j                   j                         S ri   )rk   r   rj   s    re   r   zPandasLikeSeries.max  rn  rg   c                6    | j                   j                         S ri   )rk   sumrj   s    re   ru  zPandasLikeSeries.sum  rn  rg   c                6    | j                   j                         S ri   )rk   countrj   s    re   rw  zPandasLikeSeries.count  s    {{  ""rg   c                6    | j                   j                         S ri   )rk   r   rj   s    re   r   zPandasLikeSeries.mean  s    {{!!rg   c                    | j                   j                         sd}t        |      | j                  j	                         S )Nz<`median` operation not supported for non-numeric input type.)r   
is_numericr#   rk   medianrq   s     re   r{  zPandasLikeSeries.median  s5    zz$$&PC',,{{!!##rg   c               :    | j                   j                  |      S Nddof)rk   stdra   r  s     re   r  zPandasLikeSeries.std      {{D))rg   c               :    | j                   j                  |      S r}  )rk   varr  s     re   r  zPandasLikeSeries.var  r  rg   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      ?rk   dropnar   floatr   )ra   ser_not_nullmm2m3s        re   skewzPandasLikeSeries.skew	  s    {{))+|!|!<|!<,,..d[[]d[[]!#qrRW~:eEl:rg   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  )ra   r  r  r  m4s        re   kurtosiszPandasLikeSeries.kurtosis  s    {{))+|!|!<<,,..d[[]d[[]%'1WrRU|c!>%,>rg   c                ,    t        | j                        S ri   )r   rk   rj   s    re   r   zPandasLikeSeries.len!  s    4;;rg   c                X    | j                  | j                  j                         d      S )NTr   )r{   rk   r   rj   s    re   is_nullzPandasLikeSeries.is_null&  s%      !1!1!3 MMrg   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   )rk   r   rz  r#   r{   )ra   r   rr   s      re   is_nanzPandasLikeSeries.is_nan)  sS    kkzz$$&G

|SmnC',,   EErg   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'  )rk   r^   r   r   r   warningscatch_warningsfilterwarningsFutureWarningr   r{   fillnaffillbfill)	ra   r  strategyr  r   kwargsr  native_valueres_sers	            re   	fill_nullzPandasLikeSeries.fill_null1  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                  d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`?FT)inplacer   )r^   r   r   r   rz  r#   rk   arrayna_valuer  r{   mask)ra   r  rr   r   fillr  s         re   fill_nanzPandasLikeSeries.fill_nanP  s    '')u}JC%c**zz$$&I$**UqrC',,KK).qww}}%%EAvE4(  d!3 MMrg   c                T    | j                  | j                  j                               S ri   )r{   rk   r  rj   s    re   
drop_nullszPandasLikeSeries.drop_nulls`  s       !3!3!566rg   c                :    | j                   j                  d      S )NF)r  )rk   nuniquerj   s    re   n_uniquezPandasLikeSeries.n_uniquec  s    {{""%"00rg   c               ^    | j                  | j                  j                  ||||            S )N)nfracreplacerandom_state)r{   rk   sample)ra   r  fractionwith_replacementseeds        re   r  zPandasLikeSeries.samplef  s8       KK(,<4  
 	
rg   c                T    | j                  | j                  j                               S ri   )r{   rk   absrj   s    re   r  zPandasLikeSeries.abst  s      !233rg   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S NT)skipnar  )rk   cumsumr{   ra   reverser   s      re   cum_sumzPandasLikeSeries.cum_sumw  ]      KKd+TrT")))6tt< 	
   ((rg   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{   ro   rk   uniquer[   )ra   r  s     re   r  zPandasLikeSeries.unique  s9    
   !2dkk!24;;3E3E3Gdii!XYYrg   c                T    | j                  | j                  j                               S ri   )r{   rk   diffrj   s    re   r  zPandasLikeSeries.diff  s       !1!1!344rg   c                V    | j                  | j                  j                  |            S ri   )r{   rk   shiftra   r  s     re   r  zPandasLikeSeries.shift  s"      !2!21!566rg   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: )rs   r   rk   r^   r   r   r   r_   Indexget_indexerr   r[   convert_dtypesr|   wherer   r   notnar   r{   r  r   r#   r   )ra   defaultoldnewreturn_dtype	namespacearray_funcsrk   implr   r   idxswas_matched
new_seriesnative_resultunmatched_maskunmatched_valuesrr   r  default_natives                       re   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  //rg   c                   |rdnd}| j                  | j                  j                  | |            j                  | j                        S )Nr   r  )	ascendingna_position)r{   rk   sort_valuesr   r[   )ra   
descending
nulls_lastr  s       re   sortzPandasLikeSeries.sort  sE     *f  KK##*n+#V

%		
	rg   c                    || j                   k7  r3| j                  t        | j                  || j                        d      S | S )Nr   Tr   )r[   r{   r   rk   r^   )ra   r[   s     re   r   zPandasLikeSeries.alias  sF    499$$t{{D9M9MN#' %   rg   c               (    | j                  ||      S )N)r   r   )to_numpy)ra   r   r   s      re   	__array__zPandasLikeSeries.__array__  s     }}5t}44rg   )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'  )r_   dtypesrx   r   Datetime	time_zonedtconvert_time_zonereplace_time_zonerk   r   r   r^   r   strPANDAS_TO_NUMPY_DTYPE_MISSINGupdater   PANDAS_TO_NUMPY_DTYPE_NO_MISSINGr  )ra   r   r   r  r   has_missingr  s          re   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0rg   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: )	r^   r   r   rk   r   	to_pandasMODIN
_to_pandasrp   rq   s     re   r  zPandasLikeSeries.to_pandas  s    >#8#88;;>#6#66;;((**>#7#77;;))++()=)=(>?S!!rg   c                J    dd l } |j                  | j                               S r   )polarsfrom_pandasr  )ra   pls     re   	to_polarszPandasLikeSeries.to_polars  s    r~~dnn.//rg   c                    | j                  | j                  j                  d             j                  | j                        S )NFkeepr{   rk   
duplicatedr   r[   rj   s    re   	is_uniquezPandasLikeSeries.is_unique  s7      $++"8"8e"8"D!DEKKDIIVVrg   c                R    | j                   j                         j                         S ri   )rk   r   ru  rj   s    re   
null_countzPandasLikeSeries.null_count  s    {{!%%''rg   c                    | j                  | j                  j                  d             j                  | j                        S )Nr  r  r  rj   s    re   is_first_distinctz"PandasLikeSeries.is_first_distinct  s7      $++"8"8g"8"F!FGMMdiiXXrg   c                    | j                  | j                  j                  d             j                  | j                        S )Nr   r  r  rj   s    re   is_last_distinctz!PandasLikeSeries.is_last_distinct  s7      $++"8"8f"8"E!EFLLTYYWWrg   c                   t        |t              sdt        |       }t        |      |r| j                  j
                  S | j                  j                  S )Nz/argument 'descending' should be boolean, found )rx   r  ro   	TypeErrorrk   is_monotonic_decreasingis_monotonic_increasing)ra   r  rr   s      re   	is_sortedzPandasLikeSeries.is_sorted  sK    *d+CDDTCUVCC. ;;666{{222rg   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   r.   r   
proportionrw  F)r  r  	normalize)r  r   )	r   r/   r\   rk   value_countsreset_indexcolumnsr  r   )	ra   r  parallelr[   r  r/   index_name_value_name_	val_counts	            re   r  zPandasLikeSeries.value_counts  s     	H!%!3gFy|gKK,,u	 - 

+- 	 )+6	!--kU-KI."..y$GGrg   c                <    | j                   j                  ||      S )N)qinterpolation)rk   quantile)ra   r)  r(  s      re   r)  zPandasLikeSeries.quantile!  s     {{##hm#LLrg   c                    | j                   }t        | |      \  }}t        | |      \  }}|j                  ||      }| j                  |      S ri   )rk   r   r  r{   )ra   r  r  r   r  r  s         re   zip_withzPandasLikeSeries.zip_with&  sL    kk*464+D%85iie$  %%rg   c                V    | j                  | j                  j                  |            S ri   )r{   rk   headr  s     re   r-  zPandasLikeSeries.head-  "      !1!1!!455rg   c                V    | j                  | j                  j                  |            S ri   )r{   rk   tailr  s     re   r0  zPandasLikeSeries.tail0  r.  rg   c                X    | j                  | j                  j                  |            S )N)decimals)r{   rk   round)ra   r2  s     re   r3  zPandasLikeSeries.round3  s%      !2!2H!2!EFFrg   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rk   is_native_dtype_pyarrowr   pyarrow.computecompute_apply_pyarrow_compute_funcfloorr   _apply_array_funcr{   ra   rk   pcresult_native
array_funcs        re   r9  zPandasLikeSeries.floor6  sj    ''5( <<VRXXNM**00J 226:FM  //rg   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rk   r5  r   r6  r7  r8  ceilr   r:  r{   r;  s        re   r@  zPandasLikeSeries.ceilA  sj    ''5( <<VRWWMM**//J 226:FM  //rg   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   r.   r   nullrK   )prefix
prefix_sep
drop_firstdummy_nar   )r!  rc   r   )r   r/   rs   rk   r\   r  r   r   get_dummiesrz   r!  r   r   r^   r   )ra   	separatorrE  r/   plxr   r[   null_col_pl	has_nullsr   colsnull_col_pdoutput_orders                re   
to_dummieszPandasLikeSeries.to_dummiesL  s    G'')"&**s4::"yk.KKM%%'	 ! ! 
 !%fnn!5T;'/$/L&v|T=Q=QR$k2#33F
 /"..vtDDrg   c                X    | j                  | j                  j                  |d |         S ri   )r{   rk   r|   )ra   r  offsets      re   gather_everyzPandasLikeSeries.gather_everyi  s(      !1!1&)!)!<==rg   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   r^   is_modinrk   r   r   r  r{   clip)	ra   r   r   r  lowerupperr  r  r   s	            re   rX  zPandasLikeSeries.clipl  s    +D+>5+D+>5##04&!R~~ u%fou=u%fou=  UE!DV!DEErg   c                0   t        | |      \  }}| j                  }|j                         rddini }| j                  }|j	                         s(| j                  |      r|j                  ||k\  |      }d }| j                   |j                  |fi |      S rT  rV  )ra   r   r  rY  r  r  r   s          re   
clip_lowerzPandasLikeSeries.clip_lower  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  U!=f!=>>rg   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 )NrU  r   rZ  r'  rV  )ra   r   r  rZ  r  r  r   s          re   
clip_upperzPandasLikeSeries.clip_upper  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  !C5!CF!CDDrg   c                    | j                   t        j                  u r| j                  j	                         S dd l}|j                  j                  | j                        S r   )r^   r   r   rk   r   pyarrowArrayr  )ra   pas     re   r   zPandasLikeSeries.to_arrow  sE    >#6#66;;''))xx##DKK00rg   c                   | j                   j                         }| j                  |_        | j                  |dk(  r|j	                  d            S |      S )Nr   r   )rk   moder[   r{   r-  )ra   r  r   s      re   rd  zPandasLikeSeries.mode  sF    !!#ii  45=QMMfMMrg   c                   | j                   j                          }|s|j                         n!t        |       |j                         z
  |z   dz
  }| j	                  |      S Nr   )rk   r   r  r   r{   )ra   r  not_na_seriesr   s       re   	cum_countzPandasLikeSeries.cum_count  sa    ))++    "T]1133mCaG 	
   ((rg   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rk   cumminr{   r  s      re   cum_minzPandasLikeSeries.cum_min  r  rg   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rk   cummaxr{   r  s      re   cum_maxzPandasLikeSeries.cum_max  r  rg   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rk   cumprodr{   r  s      re   cum_prodzPandasLikeSeries.cum_prod  s]      KKt,TrT"**$*7"= 	
   ((rg   c               |    | j                   j                  |||      j                         }| j                  |      S Nwindowmin_periodscenter)rk   rollingru  r{   ra   window_sizer   rw  r   s        re   rolling_sumzPandasLikeSeries.rolling_sum  s?    $$K % 

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

$& 	   ((rg   c                   | j                   j                  |||      j                  |      }| j                  |      S Nrt  r~  )rk   rx  r  r{   ra   rz  r   rw  r  r   s         re   rolling_varzPandasLikeSeries.rolling_var  E     $$K % 

#4#. 	   ((rg   c                   | j                   j                  |||      j                  |      }| j                  |      S r  )rk   rx  r  r{   r  s         re   rolling_stdzPandasLikeSeries.rolling_std  r  rg   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)r^   r   r   rk   __iter__rq   s     re   r  zPandasLikeSeries.__iter__  sF     ''){  &c**;;'')))s   AAAAc                    |(| j                   j                         j                         S | j                   |k(  j                         S ri   )rk   r   r   r  s     re   __contains__zPandasLikeSeries.__contains__  s9    +0=t{{!%%'Zt{{e?S>X>X>ZZrg   c                r    | j                   }| j                  |t        d      kD  |t        d      k  z        S )Nz-infinf)rk   r{   r  )ra   r   s     re   	is_finitezPandasLikeSeries.is_finite  s3    KK  !eFm"3E%L8H!IJJrg   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[   r^   r   r   r   r   rk   r   
is_integerr  r   rv   r   with_columns_expr_from_seriesr   r{   groupbyrankr|   )	ra   r  r  	pd_methodr[   	null_mask	mask_namerI  dfs	            re   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  
 	
rg   c               j    t         j                  | |      j                  |      j                         S N)include_breakpoint)_PandasHistfrom_series	with_binsr   )ra   binsr  s      re   hist_from_binszPandasLikeSeries.hist_from_bins  s-     ##D=O#PYt_XZ	
rg   c               j    t         j                  | |      j                  |      j                         S r  )r  r  with_bin_countr   )ra   	bin_countr  s      re   hist_from_bin_countz$PandasLikeSeries.hist_from_bin_count'  s.     ##D=O#P^I&XZ	
rg   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 ri   )logb)cabaser<  s    re   pc_logz$PandasLikeSeries.log.<locals>.pc_log5  s    wwr4((rg   c                &     |              z  S ri   r'  )r   r  log_funcs    re   	array_logz'PandasLikeSeries.log.<locals>.array_log<  s    }x~55rg   )r  r,   returnr,   )r   r2   r  r2   )
rk   r5  r   r6  r7  r8  r   logr:  r{   )ra   r  rk   r  r=  r  r  r<  s    `    @@re   r  zPandasLikeSeries.log0  su    ''5() !<<VVLM((,,H6 !2269EM  //rg   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rk   r5  r   r6  r7  r8  expr   r:  r{   r;  s        re   r  zPandasLikeSeries.expB  sj    ''5( <<VRVVLM**..J 226:FM  //rg   c                V    | j                  | j                  j                  d            S )N      ?)r{   rk   rb  rj   s    re   sqrtzPandasLikeSeries.sqrtN  s       !566rg   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rk   r5  r   r6  r7  r8  sinr   r:  r{   r;  s        re   r  zPandasLikeSeries.sinQ  p    ''5( <<M
 **..J 226:FM  //rg   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rk   r5  r   r6  r7  r8  cosr   r:  r{   r;  s        re   r  zPandasLikeSeries.cos`  r  rg   c                :    | j                   }t        ||      dk(  S )Nr   r`  )r^   r   )ra   r   r  s      re   r5  z(PandasLikeSeries.is_native_dtype_pyarrowo  s    ## dCyPPrg   c                   ddl m} t        |      } ||j                  j                        } ||j                  | j
                        }t        |d| j                  | j
                        } ||||j                  |j                        S )Nr   )r   r`  )r   r   r[   )
narwhals._arrow.utilsr   ro   r  	_pa_arrayr_   r   r^   r   r[   )ra   rk   pc_funcr   
native_cls
result_arrnw_dtype	out_dtypes           re   r8  z,PandasLikeSeries._apply_pyarrow_compute_funcs  sv     	C&\
V\\334
+JOOT]]K,i!5!5t}}
	 iv||&++
 	
rg   c                    t        |      } ||      }| j                  j                         r |||j                  |j                        S |S )N)r   r[   )ro   r^   r   r   r[   )ra   rk   r>  r  r  s        re   r:  z"PandasLikeSeries._apply_array_func  sP     &\
'
 ##++- zFKKH	
 	
rg   c               b    |r| j                         j                         S | j                         S ri   )r  r  )ra   r   s     re   	any_valuezPandasLikeSeries.any_value  s%    ,8t &&(JdjjlJrg   c                    t        |       S ri   r   rj   s    re   r  zPandasLikeSeries.str  s    .t44rg   c                    t        |       S ri   r   rj   s    re   r  zPandasLikeSeries.dt  s    066rg   c                    t        |       S ri   r
   rj   s    re   catzPandasLikeSeries.cat  s    +D11rg   c                ^    t        | j                  d      sd}t        |      t        |       S )Nrz   z>Series must be of PyArrow List type to support list namespace.)hasattrrk   r  r   rq   s     re   rz   zPandasLikeSeries.list  s*    t{{F+RCC. ,T22rg   c                ^    t        | j                  d      sd}t        |      t        |       S )NstructzBSeries must be of PyArrow Struct type to support struct namespace.)r  rk   r  r   rq   s     re   r  zPandasLikeSeries.struct  s*    t{{H-VCC. .t44rg   )rb   r   rc   r   rd   r4   r  None)r  r   )r  r(   )r  r1   )r~   z'SizedMultiIndexSelector[pd.Series[Any]]r  r)   )r~   z_SliceIndex | ranger  r)   )rd   r4   r  r)   )r   r   r   r  r  r)   )r   zIterable[Any]r   r5   r[   r  r   IntoDType | Noner   r   r  r)   )r   r   r  zTypeIs[Any])r   r   r   r5   r  r)   )r   r9   r   r5   r  r)   )r   r)   r  zSequence[Self])r  r  )r  r6   )r   float | Noner   r  r   r  r   r  r   r  r   intr   r  r  r)   )r   zint | Sequence[int]r   r   r  r)   )r   r)   r   r)   r  r  )r   r:   r  r)   ri   )r   
int | Noner  r   r  r/   )r  z	list[Any])r   r   r   r   r  r7   r  r)   )r  r   r  r)   )r  r)   )r  r  )r  r   r  r)   )r  r=   )r#  zCallable[..., PandasLikeSeries]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  r)   )
r  zPandasLikeSeries | NoDefaultr  Sequence[Any]r  r  r  r  r  rY   )r  r  r  r  r  rY   )r[   zstr | Hashabler  r)   )r   r   r   zbool | Noner  rA   )r  pd.Series[Any])r  z	pl.Series)r  r  r  r  )
r  r  r"  r  r[   z
str | Noner  r  r  r/   )r)  r  r(  r?   r  r  )r  r   r  r   r  r)   )r2  r  r  r)   )rH  r  rE  r  r  r/   )r  r  rQ  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)   )rz  r  r   r  rw  r  r  r)   )
rz  r  r   r  rw  r  r  r  r  r)   )r  zIterator[Any])r  r   r  r  )r  r>   r  r  r  r)   )r  list[float]r  r  r  r/   )r  r  r  r  r  r/   )r  r  r  r)   )r   r   r  r  )rk   r2   r  z,Callable[[ChunkedArrayAny], ChunkedArrayAny]r  r2   )rk   r2   r>  z(Callable[[NativeSeriesT], NativeSeriesT]r  r2   )r   r  r  r=   )r  r   )r  r   )r  r   )r  r   )r  r   )__name__
__module____qualname__rf   propertyrk   rs   rv   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   r$  r+  r/  r3  r5  r7  r9  r;  r>  r@  rC  rF  rJ  rL  rO  rQ  rT  rV  rY  r[  r^  r`  rc  re  rh  rj  rl  r   rp  rr  r   ru  rw  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-  r0  r3  r9  r@  rO  rR  rX  r\  r^  r   rd  rh  rk  rn  rq  r{  r}  r  r  r  r  r  r  r  r  r  r  r  r  r  r5  r8  r:  r  r  r  r  rz   r  r'  rg   re   rY   rY   q   s      5C NU 	  # #"H
9



 GL   "&TT !	T
 T  T T 
T T, * * [ [ 8 8  ,   
 
 9 9) ) 	)
  ) ) ) ) ) 
)>
$="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 5rg   rY   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  rY   _seriesc                    | j                   j                         j                  j                  }| j                   j	                         j
                  } | || j                        | j                         S )Nr   )r  rv   
_dataframer   rs   	DataFrame_data)ra   r   r  s      re   r   z_PandasHist.to_frame  sR    ll99;FFRRLL557AA	9TZZ0$,,GGrg   c                <    | j                   j                         dk  S rf  )r  rw  rj   s    re   is_empty_seriesz_PandasHist.is_empty_series  s    ||!!#a''rg   c               l    | j                  |      }| j                  r| j                  |      |dS d|iS )N
breakpointrw  rw  )_zeros_breakpoint_calculate_breakpoint)ra   argrw  s      re   series_emptyz_PandasHist.series_empty  s:    C "&"<"<S"AERRrg   c                   | j                   j                  j                  }t        |t              r ||      S  |t        |      dz
        S rf  )r  r   zerosrx   r  r   )ra   r  r  s      re   r  z_PandasHist._zeros  s<    ))//'S1uSzJuSX\7JJrg   Nr   )labelsr  c               ~    | j                   j                         j                  } || j                  ||dk(  |d      S )Nr   T)r  r   r  include_lowest)r  rs   cutrk   )ra   breaksr  r  r  s        re   _cutz_PandasHist._cut  sA     ll//155KKG#
 	
rg   r   )r  c               Z    | j                   j                  j                  ||||dk(        S )Nr   )r   r   numendpoint)r  r   linspace)ra   r   endnum_samplesr  s        re   _linear_spacez_PandasHist._linear_space  s4     ||((11c{Vv=M 2 
 	
rg   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   )rk   rr  r   r   )ra   r  rY  rZ  s       re   _calculate_binsz_PandasHist._calculate_bins  sS    {{($++//*;uE>SLESLE!!%	A>>rg   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  rw  )r  r  reindexr  
categoriesr   r  )ra   r  r  rw  s       re   _calculate_histz_PandasHist._calculate_hist  s     YYt_
 ''t%'@HHNN%%! I 
 	tT2"&qr(U;;rg   r  r  )r  int | list[float]r  rC   )r  r	  r  rA   )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  rA   )r  r  r  rA   )r  r
  r  rC   )r  r  r  __annotations__r   r  r  r  r  r   r  r  r'  rg   re   r  r    s    H(
 K (,+2
&
 %	

 )
 

. +1



 

 	

 (

 


? rg   r  )r  r  )c
__future__r   r-  r  typingr   r   r   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   narwhals._typing_compatr   narwhals._utilsr   r   r   r    narwhals.dependenciesr!   r"   narwhals.exceptionsr#   collections.abcr$   r%   r&   r'   typesr(   pandaspdr  r	  r`  rb  typing_extensionsr)   r*   r+   narwhals._arrow.typingr,   narwhals._compliant.seriesr-   r   r/   ru   r1   narwhals._pandas_like.typingr2   narwhals._typingr3   r4   r5   narwhals.dtypesr6   narwhals.typingr7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rC   r  r   r  rY   r  r'  rg   re   <module>r$     s   "   8 8  < I M K L O   1 Q Q J 5FF 99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#!$ "!)! 0w5{3' w5t!J /"AB J rg   