
    /_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 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! 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.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)EagerSeriesEagerSeriesHistPandasLikeSeriesCatNamespace!PandasLikeSeriesDateTimeNamespace)PandasLikeSeriesListNamespacePandasLikeSeriesStringNamespace)PandasLikeSeriesStructNamespace)	align_and_extract_native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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       [/var/www/html/land_sniper/venv/lib/python3.12/site-packages/narwhals/_pandas_like/series.py__init__zPandasLikeSeries.__init__q   s1     #''
+-      c                    | j                   S N)r\   r`   s    rd   nativezPandasLikeSeries.native   s    """rf   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r`   msgs     rd   __native_namespace__z%PandasLikeSeries.__native_namespace__   sL    ..0'';;==1$t7K7K2L1MNS!!rf   c                H    ddl m}  || j                  | j                        S )Nr   r/   )narwhals._pandas_like.namespacer0   r]   r^   )r`   r0   s     rd   __narwhals_namespace__z'PandasLikeSeries.__narwhals_namespace__   s    G"4#7#7GGrf   c                    t        |t              rt        |      n|}| j                  | j                  j
                  |         S rh   )
isinstancetuplelist_with_nativerj   ilocr`   rowss     rd   _gatherzPandasLikeSeries._gather   s6    'e4tDz$  !1!1$!788rf   c                    | j                  | j                  j                  t        |j                  |j
                  |j                                 S rh   )rz   rj   r{   slicestartstopstepr|   s     rd   _gather_slicezPandasLikeSeries._gather_slice   s<      KKU4::tyy$))DE
 	
rf   c                R    | j                  | j                  | j                  |      S N)rb   rc   )	__class__rj   r]   )r`   rc   s     rd   _with_versionzPandasLikeSeries._with_version   s)    ~~KK(<(<g  
 	
rf   Fpreserve_broadcastc               |    | j                  || j                  | j                        }|r| j                  |_        |S r   )r   r]   r^   r_   )r`   seriesr   results       rd   rz   zPandasLikeSeries._with_native   s<    4#7#7   
  $Frf    N)rZ   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   rZ   context)r]   r^   rm   r   	is_pandaslenfrom_nativeSeries)
clsdatar   rZ   r   r   rb   rc   nskwdss
             rd   from_iterablezPandasLikeSeries.from_iterable   s     !00""//1!4UD.RYZDM'')$V SZ %WyryyADADA7SSrf   c                    t        |       S rh   )r!   )objs    rd   
_is_nativezPandasLikeSeries._is_native   s    $S))rf   c              @     | ||j                   |j                        S r   )r]   r^   )r   r   r   s      rd   r   zPandasLikeSeries.from_native   s    4(?(?IYIYZZrf   c                  |j                   }t        |      r|n|g}|j                         j                  |d      }| j	                  ||      S )Nr   rZ   r   )r]   r    rm   r   r   )r   r   r   rb   arrrj   s         rd   
from_numpyzPandasLikeSeries.from_numpy   sN     00'-dD6335<<Sr<Jvw77rf   c                   |d   j                         j                  }|D cg c]  }t        |       }}t        d t	        ||      D              }||j                  |         j                  j
                  }g }|D ]  }|j                  rS ||j                  j                  d   ||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rh   )r_   ).0lengthss      rd   	<genexpr>z9PandasLikeSeries._align_full_broadcast.<locals>.<genexpr>   s      
 vqF
s   )r   rZ   r   rb   )rr   r   r   maxzipr   rj   r_   r{   rZ   r   rz   r   r]   append)
r   r   r   r   lengthstarget_lengthidx	reindexedrj   	compliants
             rd   _align_full_broadcastz&PandasLikeSeries._align_full_broadcast   s   //188#)*a3q6** 
$'$8
 
 W]]=1299??	 	(A||HHMM!$CaffAHHNN NN62	s*"188SARARSNN62		Y'	( % +s   Ec                    | j                   S rh   )r[   ri   s    rd   rZ   zPandasLikeSeries.name   s    zzrf   c                    | j                   j                  }|dk7  r!t        || j                  | j                        S t        | j                   | j                  | j                        S )Nobject)rj   r   r   r^   r]   r   )r`   native_dtypes     rd   r   zPandasLikeSeries.dtype   s\    {{(( x' %\4==$BVBVW	
 1T]]D,@,@	
rf   c                D    t         rdd l}|S t        | j                        S Nr   )r   numpyr   r]   )r`   nps     rd   _array_funcszPandasLikeSeries._array_funcs   s    I"4#7#788rf   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)
rj   isnar]   r   CUDFanyewmmeanNotImplementedErrorrz   )r`   r   r   	half_lifer   r   min_samplesignore_nullssermask_nar   rq   s               rd   ewm_meanzPandasLikeSeries.ewm_mean   s     kk((*>#6#66q w{{}$%PV ! $& 
K  *#..WWT9e[&L  df  w  ((rf   c                :   t        || j                        r9t        |j                  | j                  j                  |   | j
                        }| j                  j                  d      }||j                  |<   | j                  |_        | j                  |      S )Nr   T)deep)
rw   r   r   rj   r   r]   r   r{   rZ   rz   )r`   indicesvaluesr   s       rd   scatterzPandasLikeSeries.scatter  s~    fdnn-!!'*#33F
 KK$' w  ##rf   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   rj   r   r   PANDASr   r   r   r{   r   )r`   r   r   rb   backend_versionvalues_nativemin_pd_versions          rd   _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^^,rf   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_backendrb   rc   )r   rj   rz   r   r   r]   r^   astype)r`   r   pd_dtypes      rd   castzPandasLikeSeries.cast5  s    ::4;;#4#4#@ $$T[[T$JJ++DKK,=,=t?S?ST//MM	
   !3!3H!=RV WWrf   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   
ValueErrorrj   r{   )r`   r   rq   s      rd   itemzPandasLikeSeries.itemC  sf    =4yA~NNQRVi[XY[  !o%;;##A&&{{&&rf   c                ~    ddl m}  || j                  j                         | j                  | j
                  d      S )Nr   r-   F)rb   rc   validate_column_names)narwhals._pandas_like.dataframer.   rj   to_framer]   r^   )r`   r.   s     rd   r   zPandasLikeSeries.to_frameO  s5    G"KK  "//MM"'	
 	
rf   c                    | j                   j                         }|r(| j                  j                         j	                         S | j                  j                         S rh   )r]   is_cudfrj   to_arrow	to_pylistto_list)r`   r   s     rd   r   zPandasLikeSeries.to_listY  sF    &&..05<t{{##%//1W$++BUBUBWWrf   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)
rj   r   geltgtler   rz   aliasrZ   )r`   lower_boundupper_boundclosedr   _ress          rd   
is_betweenzPandasLikeSeries.is_between]  s     kk1$D;1$D;V&&%{(;;Cw&&%{(;;Cv&&%{(;;Cv&&%{(;;C   %++CHH55rf   c                V    | j                  | j                  j                  |            S rh   )rz   rj   isinr`   others     rd   is_inzPandasLikeSeries.is_ino  s"      !1!1%!899rf   c                    | j                   }t        |      }| j                  j                  |      }|j	                  ||j
                  |j                        j                  |   }| j                  |      S )N)rZ   r   )	rj   r   r   aranger   rZ   r   locrz   )r`   r   sizer   r   s        rd   arg_truezPandasLikeSeries.arg_truer  sb    kk3x  ''-t#((#))DHHM  ((rf   c                6    | j                   j                         S rh   )rj   argminri   s    rd   arg_minzPandasLikeSeries.arg_miny      {{!!##rf   c                6    | j                   j                         S rh   )rj   argmaxri   s    rd   arg_maxzPandasLikeSeries.arg_max|  r  rf   c                    t        |t              st        | |      \  }}n|}| j                  | j                  j
                  |         j                  | j                        S rh   )r   boolr   rz   rj   r	  r   rZ   )r`   	predicater   other_natives       rd   filterzPandasLikeSeries.filter  sN    )T*6tYGOA|$L  !>?EEdiiPPrf   c                b    t        | j                        r| j                  j                  d   S d S r   r   rj   r{   ri   s    rd   firstzPandasLikeSeries.first  s'    &)$++&6t{{"@D@rf   c                b    t        | j                        r| j                  j                  d   S d S )Nr  ri   s    rd   lastzPandasLikeSeries.last  s'    '*4;;'7t{{#ATArf   c                    t        | |      \  }}| j                  xr t        |dd      }| j                   |||      |      j	                  | j
                        S )Nr_   Tr   )r   r_   getattrrz   r   rZ   )r`   opr  r   r  r   s         rd   _with_binaryzPandasLikeSeries._with_binary  s^    4T5A\!__Sd1S  sL!6H ! 

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

|SmnC',,   EErf   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$  )rj   r]   r   r   r   warningscatch_warningsfilterwarningsFutureWarningr   rz   fillnaffillbfill)	r`   r  strategyr  r   kwargsr   native_valueres_sers	            rd   	fill_nullzPandasLikeSeries.fill_null0  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   rw  r"   rj   arrayna_valuer  rz   mask)r`   r  rq   r   fillr  s         rd   fill_nanzPandasLikeSeries.fill_nanO  s    '')u}JC%c**zz$$&I$**UqrC',,KK).qww}}%%EAvE4(  d!3 MMrf   c                T    | j                  | j                  j                               S rh   )rz   rj   r  ri   s    rd   
drop_nullszPandasLikeSeries.drop_nulls_  s       !3!3!566rf   c                :    | j                   j                  d      S )NF)r  )rj   nuniqueri   s    rd   n_uniquezPandasLikeSeries.n_uniqueb  s    {{""%"00rf   c               ^    | j                  | j                  j                  ||||            S )N)nfracreplacerandom_state)rz   rj   sample)r`   r  fractionwith_replacementseeds        rd   r  zPandasLikeSeries.samplee  s8       KK(,<4  
 	
rf   c                T    | j                  | j                  j                               S rh   )rz   rj   absri   s    rd   r  zPandasLikeSeries.abss  s      !233rf   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S NT)skipnar  )rj   cumsumrz   r`   reverser   s      rd   cum_sumzPandasLikeSeries.cum_sumv  ]      KKd+TrT")))6tt< 	
   ((rf   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   )rz   rn   rj   uniquerZ   )r`   r  s     rd   r  zPandasLikeSeries.unique~  s9    
   !2dkk!24;;3E3E3Gdii!XYYrf   c                T    | j                  | j                  j                               S rh   )rz   rj   diffri   s    rd   r  zPandasLikeSeries.diff  s       !1!1!344rf   c                V    | j                  | j                  j                  |            S rh   )rz   rj   shiftr`   r  s     rd   r  zPandasLikeSeries.shift  s"      !2!21!566rf   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   rZ   )r   Fr  zYreplace_strict did not replace all non-null values.

The following did not get replaced: )rr   r   rj   r]   r   r   r   r^   Indexget_indexerr   rZ   convert_dtypesr{   wherer   r   notnar   rz   r  r   r"   r   )r`   defaultoldnewreturn_dtype	namespacearray_funcsrj   implr   r   idxswas_matched
new_seriesnative_resultunmatched_maskunmatched_valuesrq   r   default_natives                       rd   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  //rf   c                   |rdnd}| j                  | j                  j                  | |            j                  | j                        S )Nr  r  )	ascendingna_position)rz   rj   sort_valuesr   rZ   )r`   
descending
nulls_lastr  s       rd   sortzPandasLikeSeries.sort  sE     *f  KK##*n+#V

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

+- 	 )+6	!--kU-KI."..y$GGrf   c                <    | j                   j                  ||      S )N)qinterpolation)rj   quantile)r`   r&  r%  s      rd   r&  zPandasLikeSeries.quantile   s     {{##hm#LLrf   c                    | j                   }t        | |      \  }}t        | |      \  }}|j                  ||      }| j                  |      S rh   )rj   r   r  rz   )r`   r  r  r   r   r   s         rd   zip_withzPandasLikeSeries.zip_with%  sL    kk*464+D%85iie$  %%rf   c                V    | j                  | j                  j                  |            S rh   )rz   rj   headr  s     rd   r*  zPandasLikeSeries.head,  "      !1!1!!455rf   c                V    | j                  | j                  j                  |            S rh   )rz   rj   tailr  s     rd   r-  zPandasLikeSeries.tail/  r+  rf   c                X    | j                  | j                  j                  |            S )N)decimals)rz   rj   round)r`   r/  s     rd   r0  zPandasLikeSeries.round2  s%      !2!2H!2!EFFrf   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rj   is_native_dtype_pyarrowr   pyarrow.computecompute_apply_pyarrow_compute_funcfloorr   _apply_array_funcrz   r`   rj   pcresult_native
array_funcs        rd   r6  zPandasLikeSeries.floor5  sj    ''5( <<VRXXNM**00J 226:FM  //rf   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rj   r2  r   r3  r4  r5  ceilr   r7  rz   r8  s        rd   r=  zPandasLikeSeries.ceil@  sj    ''5( <<VRWWMM**//J 226:FM  //rf   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   nullrJ   )prefix
prefix_sep
drop_firstdummy_nar   )r  rb   r   )r   r.   rr   rj   r[   r  r   r   get_dummiesry   r  r   r   r]   r   )r`   	separatorrB  r.   plxr   rZ   null_col_pl	has_nullsr   colsnull_col_pdoutput_orders                rd   
to_dummieszPandasLikeSeries.to_dummiesK  s    G'')"&**s4::"yk.KKM%%'	 ! ! 
 !%fnn!5T;'/$/L&v|T=Q=QR$k2#33F
 /"..vtDDrf   c                X    | j                  | j                  j                  |d |         S rh   )rz   rj   r{   )r`   r  offsets      rd   gather_everyzPandasLikeSeries.gather_everyh  s(      !1!1&)!)!<==rf   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_modinrj   r   r   r  rz   clip)	r`   r   r   r   lowerupperr  r  r   s	            rd   rU  zPandasLikeSeries.clipk  s    +D+>5+D+>5##04&!R~~ u%fou=u%fou=  UE!DV!DEErf   c                0   t        | |      \  }}| j                  }|j                         rddini }| j                  }|j	                         s(| j                  |      r|j                  ||k\  |      }d }| j                   |j                  |fi |      S rQ  rS  )r`   r   r   rV  r  r  r   s          rd   
clip_lowerzPandasLikeSeries.clip_lower  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  U!=f!=>>rf   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 )NrR  r   rW  r$  rS  )r`   r   r   rW  r  r  r   s          rd   
clip_upperzPandasLikeSeries.clip_upper  s    +D+>5##04&!R~~DOOE$: \\&E/59FE  !C5!CF!CDDrf   c                    | j                   t        j                  u r| j                  j	                         S dd l}|j                  j                  | j                        S r   )r]   r   r   rj   r   pyarrowArrayr  )r`   pas     rd   r   zPandasLikeSeries.to_arrow  sE    >#6#66;;''))xx##DKK00rf   c                   | j                   j                         }| j                  |_        | j                  |dk(  r|j	                  d            S |      S )Nr   r   )rj   moderZ   rz   r*  )r`   r
  r   s      rd   ra  zPandasLikeSeries.mode  sF    !!#ii  45=QMMfMMrf   c                   | j                   j                          }|s|j                         n!t        |       |j                         z
  |z   dz
  }| j	                  |      S Nr   )rj   r   r  r   rz   )r`   r  not_na_seriesr   s       rd   	cum_countzPandasLikeSeries.cum_count  sa    ))++    "T]1133mCaG 	
   ((rf   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rj   cumminrz   r  s      rd   cum_minzPandasLikeSeries.cum_min  r  rf   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rj   cummaxrz   r  s      rd   cum_maxzPandasLikeSeries.cum_max  r  rf   c                   |s| j                   j                  d      n'| j                   d d d   j                  d      d d d   }| j                  |      S r  )rj   cumprodrz   r  s      rd   cum_prodzPandasLikeSeries.cum_prod  s]      KKt,TrT"**$*7"= 	
   ((rf   c               |    | j                   j                  |||      j                         }| j                  |      S Nwindowmin_periodscenter)rj   rollingrr  rz   r`   window_sizer   rt  r   s        rd   rolling_sumzPandasLikeSeries.rolling_sum  s?    $$K % 

#% 	   ((rf   c               |    | j                   j                  |||      j                         }| j                  |      S rp  )rj   ru  r   rz   rv  s        rd   rolling_meanzPandasLikeSeries.rolling_mean  s?    $$K % 

$& 	   ((rf   c                   | j                   j                  |||      j                  |      }| j                  |      S Nrq  r{  )rj   ru  r  rz   r`   rw  r   rt  r|  r   s         rd   rolling_varzPandasLikeSeries.rolling_var  E     $$K % 

#4#. 	   ((rf   c                   | j                   j                  |||      j                  |      }| j                  |      S r|  )rj   ru  r}  rz   r}  s         rd   rolling_stdzPandasLikeSeries.rolling_std  r  rf   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   rj   __iter__rp   s     rd   r  zPandasLikeSeries.__iter__  sF     ''){  &c**;;'')))s   AAAAc                    |(| j                   j                         j                         S | j                   |k(  j                         S rh   )rj   r   r   r  s     rd   __contains__zPandasLikeSeries.__contains__  s9    +0=t{{!%%'Zt{{e?S>X>X>ZZrf   c                r    | j                   }| j                  |t        d      kD  |t        d      k  z        S )Nz-infinf)rj   rz   r  )r`   r   s     rd   	is_finitezPandasLikeSeries.is_finite  s3    KK  !eFm"3E%L8H!IJJrf   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   )rZ   r]   r   r   r   r   rj   r   
is_integerr  r   ru   r   with_columns_expr_from_seriesr   rz   groupbyrankr{   )	r`   r  r  	pd_methodrZ   	null_mask	mask_namerF  dfs	            rd   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  
 	
rf   c               j    t         j                  | |      j                  |      j                         S N)include_breakpoint)_PandasHistfrom_series	with_binsr   )r`   binsr  s      rd   hist_from_binszPandasLikeSeries.hist_from_bins  s-     ##D=O#PYt_XZ	
rf   c               j    t         j                  | |      j                  |      j                         S r  )r  r  with_bin_countr   )r`   	bin_countr  s      rd   hist_from_bin_countz$PandasLikeSeries.hist_from_bin_count&  s.     ##D=O#P^I&XZ	
rf   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 rh   )logb)cabaser9  s    rd   pc_logz$PandasLikeSeries.log.<locals>.pc_log4  s    wwr4((rf   c                &     |              z  S rh   r$  )r   r  log_funcs    rd   	array_logz'PandasLikeSeries.log.<locals>.array_log;  s    }x~55rf   )r  r+   returnr+   )r   r1   r  r1   )
rj   r2  r   r3  r4  r5  r   logr7  rz   )r`   r  rj   r  r:  r  r  r9  s    `    @@rd   r  zPandasLikeSeries.log/  su    ''5() !<<VVLM((,,H6 !2269EM  //rf   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rj   r2  r   r3  r4  r5  expr   r7  rz   r8  s        rd   r  zPandasLikeSeries.expA  sj    ''5( <<VRVVLM**..J 226:FM  //rf   c                V    | j                  | j                  j                  d            S )N      ?)rz   rj   r_  ri   s    rd   sqrtzPandasLikeSeries.sqrtM  s       !566rf   c                   | j                   }| j                  |j                        r#dd lm} | j                  ||j                        }n(| j                  j                  }| j                  ||      }| j                  |      S r   )
rj   r2  r   r3  r4  r5  sinr   r7  rz   r8  s        rd   r  zPandasLikeSeries.sinP  sp    ''5( <<M
 **..J 226:FM  //rf   c                :    | j                   }t        ||      dk(  S )Nr   r]  )r]   r   )r`   r   r  s      rd   r2  z(PandasLikeSeries.is_native_dtype_pyarrow_  s    ## dCyPPrf   c                   ddl m} t        |      } ||j                  j                        } ||j                  | j
                        }t        |d| j                  | j
                        } ||||j                  |j                        S )Nr   )r   r]  )r   r   rZ   )
narwhals._arrow.utilsr   rn   r  	_pa_arrayr^   r   r]   r   rZ   )r`   rj   pc_funcr   
native_cls
result_arrnw_dtype	out_dtypes           rd   r5  z,PandasLikeSeries._apply_pyarrow_compute_funcc  sv     	C&\
V\\334
+JOOT]]K,i!5!5t}}
	 iv||&++
 	
rf   c                    t        |      } ||      }| j                  j                         r |||j                  |j                        S |S )N)r   rZ   )rn   r]   r   r   rZ   )r`   rj   r;  r  r  s        rd   r7  z"PandasLikeSeries._apply_array_funcr  sP     &\
'
 ##++- zFKKH	
 	
rf   c               b    |r| j                         j                         S | j                         S rh   )r  r  )r`   r   s     rd   	any_valuezPandasLikeSeries.any_value}  s%    ,8t &&(JdjjlJrf   c                    t        |       S rh   r   ri   s    rd   r  zPandasLikeSeries.str  s    .t44rf   c                    t        |       S rh   r   ri   s    rd   r  zPandasLikeSeries.dt  s    066rf   c                    t        |       S rh   r
   ri   s    rd   catzPandasLikeSeries.cat  s    +D11rf   c                ^    t        | j                  d      sd}t        |      t        |       S )Nry   z>Series must be of PyArrow List type to support list namespace.)hasattrrj   r  r   rp   s     rd   ry   zPandasLikeSeries.list  s*    t{{F+RCC. ,T22rf   c                ^    t        | j                  d      sd}t        |      t        |       S )NstructzBSeries must be of PyArrow Struct type to support struct namespace.)r  rj   r  r   rp   s     rd   r  zPandasLikeSeries.struct  s*    t{{H-VCC. .t44rf   )ra   r   rb   r   rc   r3   r  None)r  r   )r  r'   )r  r0   )r}   z'SizedMultiIndexSelector[pd.Series[Any]]r  r(   )r}   z_SliceIndex | ranger  r(   )rc   r3   r  r(   )r   r   r   r  r  r(   )r   zIterable[Any]r   r4   rZ   r  r   IntoDType | Noner   r   r  r(   )r   r   r  zTypeIs[Any])r   r   r   r4   r  r(   )r   r8   r   r4   r  r(   )r   r(   r  zSequence[Self])r  r  )r  r5   )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   r9   r  r(   rh   )r   
int | Noner  r   r  r.   )r  z	list[Any])r   r   r   r   r   r6   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  rX   )r  r  r  r  r  rX   )rZ   zstr | Hashabler  r(   )r   r   r   zbool | Noner  r@   )r  pd.Series[Any])r  z	pl.Series)r  r  r  r  )
r  r  r  r  rZ   z
str | Noner  r  r  r.   )r&  r  r%  r>   r  r  )r  r   r  r   r  r(   )r/  r  r  r(   )rE  r  rB  r  r  r.   )r  r  rN  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(   )rw  r  r   r  rt  r  r  r(   )
rw  r  r   r  rt  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  )rj   r1   r  z,Callable[[ChunkedArrayAny], ChunkedArrayAny]r  r1   )rj   r1   r;  z(Callable[[NativeSeriesT], NativeSeriesT]r  r1   )r   r  r  r<   )r  r   )r  r   )r  r   )r  r   )r  r   )__name__
__module____qualname__re   propertyrj   rr   ru   r~   r   r   rz   classmethodr   staticmethodr   r   r   r   rZ   r   r   r   r   r   r   r   r   r   r  r  r  r  r  r  r  r  r!  r(  r,  r0  r2  r4  r6  r8  r;  r=  r@  rC  rG  rI  rL  rN  rQ  rS  rV  rX  r[  r]  r`  rb  re  rg  ri  r   rm  ro  r   rr  rt  r   rx  r}  r  r  r  r   r  r  r  r  r  r  r  r  r  r  r  r  r  r  r   r  r  r   r  r  r  r  r  r  r  r&  r(  r*  r-  r0  r6  r=  rL  rO  rU  rY  r[  r   ra  re  rh  rk  rn  rx  rz  r~  r  r  r  r  r  r  r  r  r  r  r  r2  r5  r7  r  r  r  r  ry   r  r$  rf   rd   rX   rX   p   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Q
#
.Z
	
	
#	
1Y	
		
K 5 5 7 7 2 2 3 3 5 5rf   rX   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  rX   _seriesc                    | j                   j                         j                  j                  }| j                   j	                         j
                  } | || j                        | j                         S )Nr   )r  ru   
_dataframer   rr   	DataFrame_data)r`   r   r  s      rd   r   z_PandasHist.to_frame  sR    ll99;FFRRLL557AA	9TZZ0$,,GGrf   c                <    | j                   j                         dk  S rc  )r  rt  ri   s    rd   is_empty_seriesz_PandasHist.is_empty_series  s    ||!!#a''rf   c               l    | j                  |      }| j                  r| j                  |      |dS d|iS )N
breakpointrt  rt  )_zeros_breakpoint_calculate_breakpoint)r`   argrt  s      rd   series_emptyz_PandasHist.series_empty  s:    C "&"<"<S"AERRrf   c                   | j                   j                  j                  }t        |t              r ||      S  |t        |      dz
        S rc  )r  r   zerosrw   r  r   )r`   r  r  s      rd   r  z_PandasHist._zeros  s<    ))//'S1uSzJuSX\7JJrf   Nr   )labelsr   c               ~    | j                   j                         j                  } || j                  ||dk(  |d      S )Nr   T)r  r   r  include_lowest)r  rr   cutrj   )r`   breaksr  r   r  s        rd   _cutz_PandasHist._cut  sA     ll//155KKG#
 	
rf   r   )r   c               Z    | j                   j                  j                  ||||dk(        S )Nr   )r   r   numendpoint)r  r   linspace)r`   r   endnum_samplesr   s        rd   _linear_spacez_PandasHist._linear_space  s4     ||((11c{Vv=M 2 
 	
rf   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   )rj   ro  r   r  )r`   r  rV  rW  s       rd   _calculate_binsz_PandasHist._calculate_bins  sS    {{($++//*;uE>SLESLE!!%	A>>rf   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  rt  )r  r  reindexr  
categoriesr  r  )r`   r  r  rt  s       rd   _calculate_histz_PandasHist._calculate_hist  s     YYt_
 ''t%'@HHNN%%! I 
 	tT2"&qr(U;;rf   r  r  )r  int | list[float]r  rB   )r  r  r  r@   )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  r@   )r  r  r  r@   )r  r  r  rB   )r  r  r  __annotations__r   r  r  r  r  r  r  r  r$  rf   rd   r  r    s    H(
 K (,+2
&
 %	

 )
 

. +1



 

 	

 (

 


? rf   r  )r  r  )b
__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   narwhals._typing_compatr   narwhals._utilsr   r   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   r.   rt   r0   narwhals._pandas_like.typingr1   narwhals._typingr2   r3   r4   narwhals.dtypesr5   narwhals.typingr6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   r  r  r  rX   r  r$  rf   rd   <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#!$ "!)! 0h5{3' h5V!J /"AB J rf   