
    .i׻                       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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" 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- er}d dl.m/Z/m0Z0m1Z1m2Z2 d dl3m4Z4 d dl5Z6d dl7Z8d dl9Z:d dl;m<Z<m=Z=m>Z> d dl?m@Z@ d dlAmBZB d dlCmDZD d dlEmFZF d dlGmHZH d dlImJZJ d dl%mKZKmLZL d dlMmNZN d dlOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[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         Z` G d< d=ed>         Zay)?    )annotationsN)TYPE_CHECKINGAnyCallableLiteraloverload)EagerSeriesEagerSeriesHistPandasLikeSeriesCatNamespace!PandasLikeSeriesDateTimeNamespace)PandasLikeSeriesListNamespacePandasLikeSeriesStringNamespace)PandasLikeSeriesStructNamespace)NUMPY_VERSION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)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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ZN	 	 	 	 	 	 	 	 ddQZOddRZPddSZQddTZR	 	 	 	 	 	 	 	 	 	 ddUZSddVZTddWZUdXdYddZZVdd[ZWdd\ZX	 	 	 	 	 	 	 	 	 	 dd]ZYdd^ZZdd_Z[dd`Z\dddaddbZ]ddcZ^dddZ_ddeZ`ddfZaddgZbddhZcddiZd	 	 	 	 	 	 	 	 	 	 ddjZe	 	 	 	 	 	 ddkZfddlZgddmZhddnZiddoZjddpZkddqZlddrZmddsZnddtZodduZpddvZqddwZrddxZsddyZtddzZudd{Zvdd|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       Y/opt/house_gps_flutter/.venv/lib/python3.12/site-packages/narwhals/_pandas_like/series.py__init__zPandasLikeSeries.__init__q   s1     #''
+-      c                    | j                   S N)r^   rb   s    rf   nativezPandasLikeSeries.native   s    """rh   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rb   msgs     rf   __native_namespace__z%PandasLikeSeries.__native_namespace__   sL    ..0'';;==1$t7K7K2L1MNS!!rh   c                H    ddl m}  || j                  | j                        S )Nr   r1   )narwhals._pandas_like.namespacer2   r_   r`   )rb   r2   s     rf   __narwhals_namespace__z'PandasLikeSeries.__narwhals_namespace__   s    G"4#7#7GGrh   c                    t        |t              rt        |      n|}| j                  | j                  j
                  |         S rj   )
isinstancetuplelist_with_nativerl   ilocrb   rowss     rf   _gatherzPandasLikeSeries._gather   s6    'e4tDz$  !1!1$!788rh   c                    | j                  | j                  j                  t        |j                  |j
                  |j                                 S rj   )r|   rl   r}   slicestartstopstepr~   s     rf   _gather_slicezPandasLikeSeries._gather_slice   s<      KKU4::tyy$))DE
 	
rh   c                R    | j                  | j                  | j                  |      S N)rd   re   )	__class__rl   r_   )rb   re   s     rf   _with_versionzPandasLikeSeries._with_version   s)    ~~KK(<(<g  
 	
rh   Fpreserve_broadcastc               |    | j                  || j                  | j                        }|r| j                  |_        |S r   )r   r_   r`   ra   )rb   seriesr   results       rf   r|   zPandasLikeSeries._with_native   s<    4#7#7   
  $Frh    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)r_   r`   ro   r   	is_pandaslenfrom_nativeSeries)
clsdatar   r\   r   r   rd   re   nskwdss
             rf   from_iterablezPandasLikeSeries.from_iterable   s     !00""//1!4UD.RYZDM'')$V SZ %WyryyADADA7SSrh   c                    t        |       S rj   )r#   )objs    rf   
_is_nativezPandasLikeSeries._is_native   s    $S))rh   c              @     | ||j                   |j                        S r   )r_   r`   )r   r   r   s      rf   r   zPandasLikeSeries.from_native   s    4(?(?IYIYZZrh   c                  |j                   }t        |      r|n|g}|j                         j                  |d      }| j	                  ||      S )Nr   r\   r   )r_   r"   ro   r   r   )r   r   r   rd   arrrl   s         rf   
from_numpyzPandasLikeSeries.from_numpy   sN     00'-dD6335<<Sr<Jvw77rh   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rj   )ra   ).0lengthss      rf   	<genexpr>z9PandasLikeSeries._align_full_broadcast.<locals>.<genexpr>   s      
 vqF
s   )	is_nestedseries_classrd   )rt   r   r   maxzipr   rl   ra   r   r   r   r|   r   r_   append)
r   r   r   r   lengthstarget_lengthidx	reindexedrl   	compliants
             rf   _align_full_broadcastz&PandasLikeSeries._align_full_broadcast   s   //188#)*a3q6** 
$'$8
 
 W]]=1299??	 	(A||2HHcQWW->->-@v NN62	s*"188SARARSNN62		Y'	( % +s   D3c                    | j                   S rj   )r]   rk   s    rf   r\   zPandasLikeSeries.name   s    zzrh   c                    | j                   j                  }|dk7  r!t        || j                  | j                        S t        | j                   | j                  | j                        S )Nobject)rl   r   r   r`   r_   r   )rb   native_dtypes     rf   r   zPandasLikeSeries.dtype   s\    {{(( x' %\4==$BVBVW	
 1T]]D,@,@	
rh   c                D    t         rdd l}|S t        | j                        S Nr   )r   numpyr   r_   )rb   nps     rf   _array_funcszPandasLikeSeries._array_funcs   s    I"4#7#788rh   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)
rl   isnar_   r   CUDFanyewmmeanNotImplementedErrorr|   )rb   r   r   	half_lifer   r   min_samplesignore_nullssermask_nar   rs   s               rf   ewm_meanzPandasLikeSeries.ewm_mean   s     kk((*>#6#66q w{{}$%PV ! $& 
K  *#..WWT9e[&L  df  w  ((rh   c                    y rj    rb   indicesvaluesin_places       rf   scatterzPandasLikeSeries.scatter       rh   )r   c                    y rj   r   r   s       rf   r   zPandasLikeSeries.scatter  r   rh   c                  | j                   }| j                  |j                  }}t        |j                  |j                  |   |      }|r|n|j	                  d      }|j                         r:|rt        dk  r|j	                         }| j                  dk  r|j                         }||j                  |<   |rd S | j                  |      S )Nr   T)deep)   )   r   )r_   rl   r   r   r   r   r   _backend_versionto_numpyr}   r|   )	rb   r   r   r   implrc   indices_nativevalues_nativer   s	            rf   r   zPandasLikeSeries.scatter#  s    
 ##(,W^^~!MM=..~>t
 #+0B0B0B0M>>MD0 - 2 2 4$$v-!/!8!8!:&3N#t>T%6%6v%>>rh   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_backendrd   re   )r   rl   r|   r   r   r_   r`   astype)rb   r   pd_dtypes      rf   castzPandasLikeSeries.cast9  s    ::4;;#4#4#@ $$T[[T$JJ++DKK,=,=t?S?ST//MM	
   !3!3H!=RV WWrh   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   
ValueErrorrl   r}   )rb   r   rs   s      rf   itemzPandasLikeSeries.itemG  sf    =4yA~NNQRVi[XY[  !o%;;##A&&{{&&rh   c                ~    ddl m}  || j                  j                         | j                  | j
                  d      S )Nr   r/   F)rd   re   validate_column_names)narwhals._pandas_like.dataframer0   rl   to_framer_   r`   )rb   r0   s     rf   r   zPandasLikeSeries.to_frameS  s5    G"KK  "//MM"'	
 	
rh   c                    | j                   j                         }|r(| j                  j                         j	                         S | j                  j                         S rj   )r_   is_cudfrl   to_arrow	to_pylistto_list)rb   r   s     rf   r   zPandasLikeSeries.to_list]  sF    &&..05<t{{##%//1W$++BUBUBWWrh   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)
rl   r   geltgtler   r|   aliasr\   )rb   lower_boundupper_boundclosedr   _ress          rf   
is_betweenzPandasLikeSeries.is_betweena  s     kk1$D;1$D;V&&%{(;;Cw&&%{(;;Cv&&%{(;;Cv&&%{(;;C   %++CHH55rh   c                V    | j                  | j                  j                  |            S rj   )r|   rl   isinrb   others     rf   is_inzPandasLikeSeries.is_ins  s"      !1!1%!899rh   c                    | j                   }t        |      }| j                  j                  |      }|j	                  ||j
                  |j                        j                  |   }| j                  |      S )N)r\   r   )	rl   r   r   aranger   r\   r   locr|   )rb   r   sizer   r   s        rf   arg_truezPandasLikeSeries.arg_truev  sb    kk3x  ''-t#((#))DHHM  ((rh   c                6    | j                   j                         S rj   )rl   argminrk   s    rf   arg_minzPandasLikeSeries.arg_min}      {{!!##rh   c                6    | j                   j                         S rj   )rl   argmaxrk   s    rf   arg_maxzPandasLikeSeries.arg_max  r  rh   c                    t        |t              st        | |      \  }}n|}| j                  | j                  j
                  |         j                  | j                        S rj   )r    boolr   r|   rl   r  r  r\   )rb   	predicater  other_natives       rf   filterzPandasLikeSeries.filter  sN    )T*6tYGOA|$L  !>?EEdiiPPrh   c                b    t        | j                        r| j                  j                  d   S d S r   r   rl   r}   rk   s    rf   firstzPandasLikeSeries.first  s'    &)$++&6t{{"@D@rh   c                b    t        | j                        r| j                  j                  d   S d S )Nr!  rk   s    rf   lastzPandasLikeSeries.last  s'    '*4;;'7t{{#ATArh   c                   t        | |      \  }}| j                  xr t        |dd      }t        | j                  j
                        dk(  rFt        |t              r6|j                  dk(  r'dd l} |j                  | |j                               }| j                   |||      |      j                  | j                        S )Nra   Tzlarge_string[pyarrow]addr   )rp   r   )r   ra   getattrstrrl   r   ry   __name__pyarrowscalarlarge_stringr|   r  r\   )rb   opr  r   r  r   pas          rf   _with_binaryzPandasLikeSeries._with_binary  s    4T5A\!__Sd1S!!"&==<-u$ !$299\8IJL  sL!6H ! 

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

|SmnC',,   EErh   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   )rl   r_   r   PANDASr   warningscatch_warningsfilterwarningsFutureWarningr   r|   fillnaffillbfill)	rb   r  strategyr  r   kwargsr  native_valueres_sers	            rf   	fill_nullzPandasLikeSeries.fill_null=  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   r  r$   rl   arrayna_valuer  r|   mask)rb   r  rs   r   fillr  s         rf   fill_nanzPandasLikeSeries.fill_nan\  s    '')u}JC%c**zz$$&I$**UqrC',,KK).qww}}%%EAvE4(  d!3 MMrh   c                T    | j                  | j                  j                               S rj   )r|   rl   r  rk   s    rf   
drop_nullszPandasLikeSeries.drop_nullsl  s       !3!3!566rh   c                :    | j                   j                  d      S )NF)r  )rl   nuniquerk   s    rf   n_uniquezPandasLikeSeries.n_uniqueo  s    {{""%"00rh   c               ^    | j                  | j                  j                  ||||            S )N)nfracreplacerandom_state)r|   rl   sample)rb   r  fractionwith_replacementseeds        rf   r  zPandasLikeSeries.sampler  s8       KK(,<4  
 	
rh   c                T    | j                  | j                  j                               S rj   )r|   rl   absrk   s    rf   r  zPandasLikeSeries.abs  s      !233rh   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S NT)skipnar$  )rl   cumsumr|   rb   reverser   s      rf   cum_sumzPandasLikeSeries.cum_sum  ]      KKd+TrT")))6tt< 	
   ((rh   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|   rp   rl   uniquer\   )rb   r  s     rf   r  zPandasLikeSeries.unique  s9    
   !2dkk!24;;3E3E3Gdii!XYYrh   c                T    | j                  | j                  j                               S rj   )r|   rl   diffrk   s    rf   r  zPandasLikeSeries.diff  s       !1!1!344rh   c                V    | j                  | j                  j                  |            S rj   )r|   rl   shiftrb   r  s     rf   r  zPandasLikeSeries.shift  s"      !2!21!566rh   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: )rt   r   rl   r_   r   r   r   r`   Indexget_indexerr   r\   convert_dtypesr}   wherer   r!   notnar   r|   r  r   r$   r   )rb   defaultoldnewreturn_dtype	namespacearray_funcsrl   r   r   r   idxswas_matched
new_seriesnative_resultunmatched_maskunmatched_valuesrs   r  default_natives                       rf   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  //rh   c                   |rdnd}| j                  | j                  j                  | |            j                  | j                        S )Nr%  r"  )	ascendingna_position)r|   rl   sort_valuesr  r\   )rb   
descending
nulls_lastr  s       rf   sortzPandasLikeSeries.sort  sE     *f  KK##*n+#V

%		
	rh   c                    || j                   k7  r3| j                  t        | j                  || j                        d      S | S )Nr   Tr   )r\   r|   r   rl   r_   )rb   r\   s     rf   r  zPandasLikeSeries.alias  sF    499$$t{{D9M9MN#' %   rh   c               (    | j                  ||      S )N)r   r   )r   )rb   r   r   s      rf   	__array__zPandasLikeSeries.__array__  s     }}5t}44rh   )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`   dtypesry   r   Datetime	time_zonedtconvert_time_zonereplace_time_zonerl   r   r   r_   r   r)  PANDAS_TO_NUMPY_DTYPE_MISSINGupdater   PANDAS_TO_NUMPY_DTYPE_NO_MISSINGr   )rb   r   r   r   r   has_missingr  s          rf   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0rh   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  rl   r   	to_pandasMODIN
_to_pandasrq   rr   s     rf   r  zPandasLikeSeries.to_pandas  s    >#8#88;;>#6#66;;((**>#7#77;;))++()=)=(>?S!!rh   c                J    dd l } |j                  | j                               S r   )polarsfrom_pandasr  )rb   pls     rf   	to_polarszPandasLikeSeries.to_polars  s    r~~dnn.//rh   c                    | j                  | j                  j                  d             j                  | j                        S )NFkeepr|   rl   
duplicatedr  r\   rk   s    rf   	is_uniquezPandasLikeSeries.is_unique  s7      $++"8"8e"8"D!DEKKDIIVVrh   c                R    | j                   j                         j                         S rj   )rl   r   r  rk   s    rf   
null_countzPandasLikeSeries.null_count  s    {{!%%''rh   c                    | j                  | j                  j                  d             j                  | j                        S )Nr"  r  r  rk   s    rf   is_first_distinctz"PandasLikeSeries.is_first_distinct  s7      $++"8"8g"8"F!FGMMdiiXXrh   c                    | j                  | j                  j                  d             j                  | j                        S )Nr%  r  r  rk   s    rf   is_last_distinctz!PandasLikeSeries.is_last_distinct  s7      $++"8"8f"8"E!EFLLTYYWWrh   c                   t        |t              sdt        |       }t        |      |r| j                  j
                  S | j                  j                  S )Nz/argument 'descending' should be boolean, found )ry   r  rp   	TypeErrorrl   is_monotonic_decreasingis_monotonic_increasing)rb   r  rs   s      rf   	is_sortedzPandasLikeSeries.is_sorted  sK    *d+CDDTCUVCC. ;;666{{222rh   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   
proportionr  F)r  r  	normalize)r  r   )	r   r0   r]   rl   value_countsreset_indexcolumnsr  r   )	rb   r  parallelr\   r&  r0   index_name_value_name_	val_counts	            rf   r'  zPandasLikeSeries.value_counts  s     	H!%!3gFy|gKK,,u	 - 

+- 	 )+6	!--kU-KI."..y$GGrh   c                <    | j                   j                  ||      S )N)qinterpolation)rl   quantile)rb   r1  r0  s      rf   r1  zPandasLikeSeries.quantile-  s     {{##hm#LLrh   c                    | j                   }t        | |      \  }}t        | |      \  }}|j                  ||      }| j                  |      S rj   )rl   r   r  r|   )rb   r  r  r   r  r  s         rf   zip_withzPandasLikeSeries.zip_with2  sL    kk*464+D%85iie$  %%rh   c                V    | j                  | j                  j                  |            S rj   )r|   rl   headr  s     rf   r5  zPandasLikeSeries.head9  "      !1!1!!455rh   c                V    | j                  | j                  j                  |            S rj   )r|   rl   tailr  s     rf   r8  zPandasLikeSeries.tail<  r6  rh   c                X    | j                  | j                  j                  |            S )N)decimals)r|   rl   round)rb   r:  s     rf   r;  zPandasLikeSeries.round?  s%      !2!2H!2!EFFrh   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rl   is_native_dtype_pyarrowr   pyarrow.computecompute_apply_pyarrow_compute_funcfloorr   _apply_array_funcr|   rb   rl   pcresult_native
array_funcs        rf   rA  zPandasLikeSeries.floorB  sj    ''5( <<VRXXNM**00J 226:FM  //rh   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rl   r=  r   r>  r?  r@  ceilr   rB  r|   rC  s        rf   rH  zPandasLikeSeries.ceilM  sj    ''5( <<VRWWMM**//J 226:FM  //rh   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   nullrL   )prefix
prefix_sep
drop_firstdummy_nar   )r)  rd   r   )r   r0   rt   rl   r]   r)  r   r   get_dummiesr{   r)  r   r   r_   r   )rb   	separatorrM  r0   plxr   r\   null_col_pl	has_nullsr   colsnull_col_pdoutput_orders                rf   
to_dummieszPandasLikeSeries.to_dummiesX  s    G'')"&**s4::"yk.KKM%%'	 ! ! 
 !%fnn!5T;'/$/L&v|T=Q=QR$k2#33F
 /"..vtDDrh   c                X    | j                  | j                  j                  |d |         S rj   )r|   rl   r}   )rb   r  offsets      rf   gather_everyzPandasLikeSeries.gather_everyu  s(      !1!1&)!)!<==rh   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_modinrl   r   r   r  r|   clip)	rb   r  r  r  lowerupperr   r  r   s	            rf   r`  zPandasLikeSeries.clipx  s    +D+>5+D+>5##04&!R~~ u%fou=u%fou=  UE!DV!DEErh   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\  r^  )rb   r  r  ra  r   r  r   s          rf   
clip_lowerzPandasLikeSeries.clip_lower  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  U!=f!=>>rh   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 )Nr]  r   rb  r   r^  )rb   r  r  rb  r   r  r   s          rf   
clip_upperzPandasLikeSeries.clip_upper  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  !C5!CF!CDDrh   c                    | j                   t        j                  u r| j                  j	                         S dd l}|j                  j                  | j                        S r   )r_   r   r   rl   r   r+  Arrayr  )rb   r/  s     rf   r   zPandasLikeSeries.to_arrow  sE    >#6#66;;''))xx##DKK00rh   c                   | j                   j                         }| j                  |_        | j                  |dk(  r|j	                  d            S |      S )Nr   r   )rl   moder\   r|   r5  )rb   r  r   s      rf   rj  zPandasLikeSeries.mode  sF    !!#ii  45=QMMfMMrh   c                   | j                   j                          }|s|j                         n!t        |       |j                         z
  |z   dz
  }| j	                  |      S Nr   )rl   r   r  r   r|   )rb   r  not_na_seriesr   s       rf   	cum_countzPandasLikeSeries.cum_count  sa    ))++    "T]1133mCaG 	
   ((rh   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rl   cumminr|   r  s      rf   cum_minzPandasLikeSeries.cum_min  r  rh   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rl   cummaxr|   r  s      rf   cum_maxzPandasLikeSeries.cum_max  r  rh   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rl   cumprodr|   r  s      rf   cum_prodzPandasLikeSeries.cum_prod  s]      KKt,TrT"**$*7"= 	
   ((rh   c               |    | j                   j                  |||      j                         }| j                  |      S Nwindowmin_periodscenter)rl   rollingr  r|   rb   window_sizer   r}  r   s        rf   rolling_sumzPandasLikeSeries.rolling_sum  s?    $$K % 

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

$& 	   ((rh   c                   | j                   j                  |||      j                  |      }| j                  |      S Nrz  r  )rl   r~  r  r|   rb   r  r   r}  r  r   s         rf   rolling_varzPandasLikeSeries.rolling_var  E     $$K % 

#4#. 	   ((rh   c                   | j                   j                  |||      j                  |      }| j                  |      S r  )rl   r~  r  r|   r  s         rf   rolling_stdzPandasLikeSeries.rolling_std  r  rh   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   rl   __iter__rr   s     rf   r  zPandasLikeSeries.__iter__  sF     ''){  &c**;;'')))s   AAAAc                    |(| j                   j                         j                         S | j                   |k(  j                         S rj   )rl   r   r   r  s     rf   __contains__zPandasLikeSeries.__contains__  s9    +0=t{{!%%'Zt{{e?S>X>X>ZZrh   c                r    | j                   }| j                  |t        d      kD  |t        d      k  z        S )Nz-infinf)rl   r|   r  )rb   r   s     rf   	is_finitezPandasLikeSeries.is_finite  s3    KK  !eFm"3E%L8H!IJJrh   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   rl   r   
is_integerr  r   rw   r   with_columns_expr_from_seriesr  r|   groupbyrankr}   )	rb   r  r  	pd_methodr\   	null_mask	mask_namerQ  dfs	            rf   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  
 	
rh   c               j    t         j                  | |      j                  |      j                         S N)include_breakpoint)_PandasHistfrom_series	with_binsr   )rb   binsr  s      rf   hist_from_binszPandasLikeSeries.hist_from_bins*  s-     ##D=O#PYt_XZ	
rh   c               j    t         j                  | |      j                  |      j                         S r  )r  r  with_bin_countr   )rb   	bin_countr  s      rf   hist_from_bin_countz$PandasLikeSeries.hist_from_bin_count3  s.     ##D=O#P^I&XZ	
rh   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 rj   )logb)cabaserD  s    rf   pc_logz$PandasLikeSeries.log.<locals>.pc_logA  s    wwr4((rh   c                &     |              z  S rj   r   )r   r  log_funcs    rf   	array_logz'PandasLikeSeries.log.<locals>.array_logH  s    }x~55rh   )r  r-   returnr-   )r   r3   r  r3   )
rl   r=  r   r>  r?  r@  r   logrB  r|   )rb   r  rl   r  rE  r  r  rD  s    `    @@rf   r  zPandasLikeSeries.log<  su    ''5() !<<VVLM((,,H6 !2269EM  //rh   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rl   r=  r   r>  r?  r@  expr   rB  r|   rC  s        rf   r  zPandasLikeSeries.expN  sj    ''5( <<VRVVLM**..J 226:FM  //rh   c                V    | j                  | j                  j                  d            S )N      ?)r|   rl   rl  rk   s    rf   sqrtzPandasLikeSeries.sqrtZ  s       !566rh   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rl   r=  r   r>  r?  r@  sinr   rB  r|   rC  s        rf   r  zPandasLikeSeries.sin]  p    ''5( <<M
 **..J 226:FM  //rh   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rl   r=  r   r>  r?  r@  cosr   rB  r|   rC  s        rf   r  zPandasLikeSeries.cosl  r  rh   c                :    | j                   }t        ||      dk(  S )Nr   r+  )r_   r   )rb   r   r   s      rf   r=  z(PandasLikeSeries.is_native_dtype_pyarrow{  s    ## dCyPPrh   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   rp   r  	_pa_arrayr`   r   r_   r   r\   )rb   rl   pc_funcr   
native_cls
result_arrnw_dtype	out_dtypes           rf   r@  z,PandasLikeSeries._apply_pyarrow_compute_func  sv     	C&\
V\\334
+JOOT]]K,i!5!5t}}
	 iv||&++
 	
rh   c                    t        |      } ||      }| j                  j                         r |||j                  |j                        S |S )N)r   r\   )rp   r_   r   r   r\   )rb   rl   rF  r  r  s        rf   rB  z"PandasLikeSeries._apply_array_func  sP     &\
'
 ##++- zFKKH	
 	
rh   c               b    |r| j                         j                         S | j                         S rj   )r  r"  )rb   r   s     rf   	any_valuezPandasLikeSeries.any_value  s%    ,8t &&(JdjjlJrh   c                    t        |       S rj   r   rk   s    rf   r)  zPandasLikeSeries.str  s    .t44rh   c                    t        |       S rj   r   rk   s    rf   r  zPandasLikeSeries.dt  s    066rh   c                    t        |       S rj   r   rk   s    rf   catzPandasLikeSeries.cat  s    +D11rh   c                ^    t        | j                  d      sd}t        |      t        |       S )Nr{   z>Series must be of PyArrow List type to support list namespace.)hasattrrl   r   r   rr   s     rf   r{   zPandasLikeSeries.list  s*    t{{F+RCC. ,T22rh   c                ^    t        | j                  d      sd}t        |      t        |       S )NstructzBSeries must be of PyArrow Struct type to support struct namespace.)r  rl   r   r   rr   s     rf   r  zPandasLikeSeries.struct  s*    t{{H-VCC. .t44rh   )rc   r   rd   r   re   r5   r  None)r  r   )r  r)   )r  r2   )r   z'SizedMultiIndexSelector[pd.Series[Any]]r  r*   )r   z_SliceIndex | ranger  r*   )re   r5   r  r*   )r   r   r   r  r  r*   )r   zIterable[Any]r   r6   r\   r)  r   IntoDType | Noner   r   r  r*   )r   r   r  zTypeIs[Any])r   r   r   r6   r  r*   )r   r:   r   r6   r  r*   )r   r*   r  zSequence[Self])r  r)  )r  r7   )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*   rj   )r   
int | Noner  r   r  r0   )r  z	list[Any])r  r   r  r   r  r8   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  rZ   )r  r  r  r  r  rZ   )r\   zstr | Hashabler  r*   )r   r   r   zbool | Noner  rB   )r  pd.Series[Any])r  z	pl.Series)r  r  r  r  )
r  r  r*  r  r\   z
str | Noner&  r  r  r0   )r1  r  r0  r@   r  r  )r  r   r  r   r  r*   )r:  r  r  r*   )rP  r)  rM  r  r  r0   )r  r  rY  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  r?   r  r  r  r*   )r  list[float]r  r  r  r0   )r  r  r  r  r  r0   )r  r  r  r*   )r   r   r  r  )rl   r3   r  z,Callable[[ChunkedArrayAny], ChunkedArrayAny]r  r3   )rl   r3   rF  z(Callable[[NativeSeriesT], NativeSeriesT]r  r3   )r   r  r  r>   )r  r   )r  r   )r  r   )r  r   )r  r   )r*  
__module____qualname__rg   propertyrl   rt   rw   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  rv  r   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'  r1  r3  r5  r8  r;  rA  rH  rW  rZ  r`  rd  rf  r   rj  rn  rq  rt  rw  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r=  r@  rB  r  r)  r  r  r{   r  r   rh   rf   rZ   rZ   p   s      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 5rh   rZ   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  rZ   _seriesc                    | j                   j                         j                  j                  }| j                   j	                         j
                  } | || j                        | j                         S )Nr   )r  rw   
_dataframer   rt   	DataFrame_data)rb   r   r  s      rf   r   z_PandasHist.to_frame  sR    ll99;FFRRLL557AA	9TZZ0$,,GGrh   c                <    | j                   j                         dk  S rl  )r  r  rk   s    rf   is_empty_seriesz_PandasHist.is_empty_series  s    ||!!#a''rh   c               l    | j                  |      }| j                  r| j                  |      |dS d|iS )N
breakpointr  r  )_zeros_breakpoint_calculate_breakpoint)rb   argr  s      rf   series_emptyz_PandasHist.series_empty  s:    C "&"<"<S"AERRrh   c                   | j                   j                  j                  }t        |t              r ||      S  |t        |      dz
        S rl  )r  r   zerosry   r  r   )rb   r  r  s      rf   r  z_PandasHist._zeros  s<    ))//'S1uSzJuSX\7JJrh   Nr   )labelsr  c               ~    | j                   j                         j                  } || j                  ||dk(  |d      S )Nr   T)r  r   r  include_lowest)r  rt   cutrl   )rb   breaksr  r  r  s        rf   _cutz_PandasHist._cut  sA     ll//155KKG#
 	
rh   r   )r  c               Z    | j                   j                  j                  ||||dk(        S )Nr   )r   r   numendpoint)r  r   linspace)rb   r   endnum_samplesr  s        rf   _linear_spacez_PandasHist._linear_space  s4     ||((11c{Vv=M 2 
 	
rh   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   )rl   r|  r   r  )rb   r  ra  rb  s       rf   _calculate_binsz_PandasHist._calculate_bins  sS    {{($++//*;uE>SLESLE!!%	A>>rh   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  )rb   r  r  r  s       rf   _calculate_histz_PandasHist._calculate_hist  s     YYt_
 ''t%'@HHNN%%! I 
 	tT2"&qr(U;;rh   r  r  )r  int | list[float]r  rD   )r  r  r  rB   )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  rB   )r  r  r  rB   )r  r  r  rD   )r*  r  r  __annotations__r   r  r  r  r  r  r  r  r   rh   rf   r  r    s    H(
 K (,+2
&
 %	

 )
 

. +1



 

 	

 (

 


? rh   r  )r  r  )b
__future__r   r8  r  typingr   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   r   narwhals._typing_compatr   narwhals._utilsr   r    r!   narwhals.dependenciesr"   r#   narwhals.exceptionsr$   collections.abcr%   r&   r'   r(   typesr)   pandaspdr  r  r+  r/  typing_extensionsr*   r+   r,   narwhals._arrow.typingr-   narwhals._compliant.seriesr.   r   r0   rv   r2   narwhals._pandas_like.typingr3   narwhals._typingr4   r5   r6   narwhals.dtypesr7   narwhals.typingr8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rC   rD   r  r  r  rZ   r  r   rh   rf   <module>r)     s   "   B B < I M K L O    1 B B 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#!$ "!)! 0D5{3' D5N"J /"AB J rh   