
    I j?<                      S SK Jr  S SKrS SKrS SKJrJrJrJrJ	r	J
r
  S SKrS SKrS SKJrJrJr  S SKJrJr  S SKJr  S SKJrJrJr  S SKJr  S S	KJr  S S
K J!r!  S SK"J#r#J$r$  S SK%J&r&J'r'J(r(J)r)J*r*  S SK+J,r,J-r-J.r.J/r/J0r0J1r1  S SK2J3r3J4r4J5r5J6r6J7r7  S SK8J9r9J:r:J;r;J<r<  S SK=J>r>  S SK?J@r@JArAJBrB  S SKCJDrD  S SKEJFs  JGrH  S SKIJJrJJKrKJLrLJMrMJNrN  S SKOJPrP  S SKQJRrRJSrSJTrT  S SKUJVrV  S SKWJXrXJYrYJZrZJ[r[J\r\J]r]  S SK^J_r_  S SK`Jara  S SKbJFs  Jcrd  S SKeJfrf  S SKgJhrhJiri  S SKjJkrk  S SKlJmrm  \(       a0  S SKnJoroJprpJqrqJrrr  S SKsJtrtJuruJvrvJwrwJxrxJyryJzrzJ{r{J|r|J}r}  S S K~Jr  S S!KJr  \GR                  " S"5      r " S# S$\a\GR                  5      r " S% S&\5      r " S' S(\5      r " S) S*\5      r " S+ S,\5      r " S- S.\5      rS9S/ jrS:S0 jr S;       S<S1 jjrSS2.       S=S3 jjrS>S4 jr        S?S5 jrS;S@S6 jjrSASBS7 jjrS9S8 jrg)C    )annotationsN)TYPE_CHECKINGAnyLiteralSelfcastfinal)NaT	internalslib)BlockPlacementBlockValuesRefs)NA)AbstractMethodErrorOutOfBoundsDatetimePandas4Warning)cache_readonly)find_stack_level)validate_bool_kwarg)astype_array_safeastype_is_view)LossySetitemErrorcan_hold_elementconvert_dtypesfind_result_typenp_can_hold_element)is_1d_only_ea_dtypeis_float_dtypeis_integer_dtypeis_list_like	is_scalaris_string_dtype)DatetimeTZDtypeExtensionDtypeIntervalDtypeNumpyEADtypePeriodDtype)ABCDataFrameABCIndexABCNumpyExtensionArray	ABCSeries)is_re)is_valid_na_for_dtypeisnana_value_for_dtype)missing)extract_bool_arrayputmask_inplaceputmask_without_repeatsetitem_datetimelike_compatvalidate_putmask)quantile_compat)compare_or_regex_searchreplace_regexshould_use_regex)shift)DatetimeArrayExtensionArrayIntervalArrayNumpyExtensionArrayPeriodArrayTimedeltaArray)StringDtype)PandasObject)expressions)ensure_wrapped_if_datetimelikeextract_array)check_setitem_lengths)get_values_for_csv)Callable	GeneratorIterableSequence)
	ArrayLikeAxisIntDtypeBackendDtypeObjFillnaOptionsIgnoreRaiseInterpolateOptionsQuantileInterpolationShapenpt)Index)NDArrayBackedExtensionArrayobjectc                  R   \ rS rSr% SrS\S'   S\S'   S\S'   S	\S
'   SrSr\\	SQS j5       5       r
\\	SQS j5       5       r\\	SQS j5       5       r\\	SQS j5       5       r\\	S 5       5       r\\	SQS j5       5       r\\SQS j5       5       r\S 5       r\\	S 5       5       r\S 5       r\SRS j5       r\R,                  SSS j5       r\  ST     SUS jj5       r\  ST     SVS jj5       r\SWS j5       r\SXS j5       r\SYS j5       r\SZS j5       r\ S[       S\S  jj5       r\S]S! j5       r\S^S" j5       r\S_S# j5       r \S`S$ j5       r!\SaS% j5       r"\SbS& j5       r#\S_S' j5       r$\ScS( j5       r%\S_S) j5       r&      Sd             SeS* jjr'\\	SfS+ j5       5       r(\  Sg       ShS, jj5       r)\S-SS..   SiS/ jj5       r*\SjS0 j5       r+SkSlS1 jjr,\SmS2 j5       r-\  Sn     SoS3 jj5       r.\  Sn   SpS4 jj5       r/\  Sq         SrS5 jj5       r0\  Ss       StS6 jj5       r1SuS7 jr2S8 r3\SvS9 j5       r4SwS: jr5    SxS; jr6S[SyS< jjr7\S\8Rr                  4       SzS= jj5       r:    S{S> jr;S`S? jr<S_S@ jr=S_SA jr>  S|     S}SB jjr?SSSSC.         S~SD jjr@\SSSESSF.             SSG jj5       rA\SSH j5       rBSSSI jjrC\ S     SSJ jj5       rD\SSK j5       rES_SL jrF\SQSM j5       rG\SSN j5       rHSSSO jjrISPrJg)Block   z
Canonical n-dimensional unit of homogeneous dtype contained in a pandas
data structure

Index-ignorant; let the container take care of that
znp.ndarray | ExtensionArrayvaluesintndimr   refsrH   __init__ Fc                6    [        U R                  5      (       + $ )z
We validate dimension for blocks that can hold 2D values, which for now
means numpy dtypes or EA dtypes like DatetimeTZDtype and PeriodDtype.
)r   dtypeselfs    m/root/GenerationalWealth/GenerationalWealth/venv/lib/python3.13/site-packages/pandas/core/internals/blocks.py_validate_ndimBlock._validate_ndim   s     'tzz222    c                <    U R                   R                  [        :H  $ N)r\   rc   
_dtype_objrd   s    rf   	is_objectBlock.is_object   s     {{  J..ri   c                `    [         R                  " U R                  R                  5      (       + $ rk   )r   is_np_dtyper\   rc   rd   s    rf   is_extensionBlock.is_extension   s      ??4;;#4#4555ri   c                $    U R                   (       + $ rk   )rq   rd   s    rf   _can_consolidateBlock._can_consolidate   s     $$$$ri   c                F    U R                   U R                  R                  4$ rk   )rt   rc   namerd   s    rf   _consolidate_keyBlock._consolidate_key   s     $$djjoo55ri   c                    U R                   n[        U[        R                   5      (       a  UR                  S;  $ UR                  $ )z'
Can we store NA values in this Block?
iub)rc   
isinstancenpkind_can_hold_nare   rc   s     rf   r   Block._can_hold_na   s9     

eRXX&&::U**!!!ri   c                d    U R                   R                  [        R                  " [        5      :H  $ )zN
We can be bool if a) we are bool dtype or b) object dtype with bool objects.
)r\   rc   r}   boolrd   s    rf   is_boolBlock.is_bool   s!     {{  BHHTN22ri   c                ,    [        U R                  5      $ rk   )external_valuesr\   rd   s    rf   r   Block.external_values   s    t{{++ri   c                *    [        U R                  SS9$ )NF)compat)r/   rc   rd   s    rf   
fill_valueBlock.fill_value   s     "$**U;;ri   c                z    U R                   [        :w  a&  [        XR                   5      (       a  U R                  nU$ rk   )rc   rl   r-   r   re   values     rf   _standardize_fill_valueBlock._standardize_fill_value   s-     ::#(=eZZ(P(POOEri   c                    U R                   $ rk   	_mgr_locsrd   s    rf   mgr_locsBlock.mgr_locs   s    ~~ri   c                    Xl         g rk   r   )re   new_mgr_locss     rf   r   r      s    %ri   Nc                    Uc  U R                   nU R                  (       a  [        XR                  S9n[	        XU R                  US9$ )zU
Create a new block, with type inference propagate any values that are
not specified
r^   	placementr^   r_   )r   rq   ensure_block_shaper^   	new_blockre   r\   r   r_   s       rf   
make_blockBlock.make_block   s=     I'YY?F4994PPri   c                V    Uc  U R                   n[        U 5      " XU R                  US9$ )z2Wrap given values in a block of same type as self.r   )r   typer^   r   s       rf   make_block_same_classBlock.make_block_same_class   s,     I Dz&DIIDQQri   c                X   [        U 5      R                  nU R                  S:X  a  U S[        U 5       SU R                   3nU$ SR                  U R                   Vs/ s H  n[        U5      PM     sn5      nU SU R                  R                   SU SU R                   3nU$ s  snf )N   z: z dtype: z x z, z	, dtype: )
r   __name__r^   lenrc   joinshapestrr   indexer)re   rw   resultsr   s        rf   __repr__Block.__repr__  s     Dz""99>vRD	{(4::,?F
  JJ

;
1A
;<EvR 5 56byUF  <s   B'c                ,    [        U R                  5      $ rk   )r   r\   rd   s    rf   __len__Block.__len__  s    4;;ri   c                    U R                   U   nU R                  U5      nU R                  n[        U 5      " X2U R                  US9$ )z3
Perform __getitem__-like, return result as block.
r_   )r   _slicer_   r   r^   )re   slcr   
new_valuesr_   s        rf   slice_block_columnsBlock.slice_block_columns  s@    
 ~~c*[[%
yyDz*DIIDIIri   c                x    U R                   U   nU R                  U5      n[        U 5      " X2U R                  SS9$ zg
Perform __getitem__-like, return result as block.

Only supports slices that preserve dimensionality.
Nr   )r   r   r   r^   )re   indicesr   r   s       rf   take_block_columnsBlock.take_block_columns!  s7     ~~g.[[)
Dz*DIIDIIri   c                    U R                  U5      nU(       a  U R                  R                  5       (       a  U R                  OSn[        U 5      " XBU R                  US9$ r   )r   r_   has_referencer   r^   )re   slicerr   ref_inplace_opr   r_   s         rf   getitem_block_columnsBlock.getitem_block_columns0  sI     [[(
 .$))2I2I2K2KtyyQUDz*DIIDIIri   c                B    [        USS9n[        U R                  U5      $ )z#require the same dtype as ourselvesTextract_numpy)rE   r   r\   )re   elements     rf   _can_hold_elementBlock._can_hold_element=  s!      t<W55ri   c                4    UR                   U R                   :H  $ )z
Should we set self.values[indexer] = value inplace or do we need to cast?

Parameters
----------
value : np.ndarray or ExtensionArray

Returns
-------
bool
rc   r   s     rf   should_storeBlock.should_storeC  s     {{djj((ri   c                `    U" U R                   40 UD6n[        U5      nU R                  U5      $ )zC
apply the function to my values; return a block if we are not
one
)r\   maybe_coerce_values_split_op_result)re   funckwargsr   s       rf   applyBlock.applyU  s2     dkk,V,$V,$$V,,ri   c                    U R                   S:X  d   eU" U R                  5      nU R                  R                   S:X  a  UnOUR                  SS5      nU R                  U5      $ )N   r   )r^   r\   reshaper   )re   r   r   
res_valuess       rf   reduceBlock.reduce`  sX     yyA~~dkk";;q JA.Jz**ri   c                n   UR                   S:  a  [        UR                  [        5      (       as  / n[	        U R
                  5       HV  u  p4[        UR                  5      (       d  XUS-    nOX   n[        U5      nU R                  XVS9nUR                  U5        MX     U$ U R                  U5      nU/$ )Nr   )r\   r   )
r^   r|   rc   r$   	enumerater   r   r   r   append)	re   r   nbsilocvalsbpblocknbs	            rf   r   Block._split_op_resulto  s     ;;?z&,,GG C#DNN3*6<<88!a!e,D!9D#C(tB

5! 4 J__V$tri   c              #     #    U R                   S:X  d   e[        U R                  5       HJ  u  pU R                  [	        XS-   5         n[        U5      n[        U 5      " X4SU R                  S9nUv   ML     g7f)z4
Split a block into a list of single-column blocks.
r   r   r   N)r^   r   r   r\   slicer   r   r_   )re   r   ref_locr   r   r   s         rf   _splitBlock._split  sg     
 yyA~~#DNN3JA;;uQA/D(BdDQTYYGBH 4s   A7A9c                    U R                   S:X  a  U R                  S   S:w  d   e/ nU R                  5        H   nU" U/UQ70 UD6nUR                  U5        M"     U$ )z
Split the block and apply func column-by-column.

Parameters
----------
func : Block method
*args
**kwargs

Returns
-------
List[Block]
r   r   r   )r^   r   r   extend)re   r   argsr   
res_blocksr   rbss          rf   split_and_operateBlock.split_and_operate  sc     yyA~$**Q-1"444
++-Br+D+F+Cc"   ri   c                   [        U R                  R                  U5      nX0R                  :X  a  [        S5      e[	        U5      (       a  [        U R                  R                  5      (       af  [        U5      (       aV  U[        LaM  [        U[        R                  [        R                  45      (       a  [        R                  " U5      (       d  SnO[        U[        R                  5      (       ak  UR                  S:X  a[  [        U R                  R                  5      (       a7  [        UR                  5      (       a  [         R"                  " U5      (       a  SnU(       a&  [%        SU SU R                  R                   S35      eU R                  R                  U:X  a&  [        SU SU R                  R                   S	35      e U R'                  U5      $ ! [(         a  n[)        S
U R                   S35      UeSnAff = f)z
coerce the current block to a dtype compat for other
we will return a block, possibly object, and not raise

we can also safely try to coerce to the same dtype
and will receive the same block
z\Something has gone wrong, please report a bug at https://github.com/pandas-dev/pandas/issuesFr   zInvalid value 'z' for dtype ''zDid not expect new dtype z to equal self.dtype zE. Please report a bug at https://github.com/pandas-dev/pandas/issues.z0Incompatible (high-resolution) value for dtype='z$'. Explicitly cast before operating.N)r   r\   rc   AssertionErrorr!   r   r.   r
   r|   r}   
datetime64timedelta64isnatndarrayr^   r   r   has_only_ints_or_nan	TypeErrorastyper   )re   otherraise_on_upcast	new_dtypeerrs        rf   coerce_to_target_dtypeBlock.coerce_to_target_dtype  s    %T[[%6%6>	

" >  e !2!233US 52==".."ABBrxxPU $Oubjj))

a !2!233u{{++((//#OoeWM$++BSBSATTUVWW;;	) +I;6K;;$$% &?? 

	;;y))" 	
 &B4::, O4 4 	s   G 
H(HHc                R   U R                   (       d  U R                  SS9/$ U R                  S:w  a[  U R                  S   S:w  aH  U R	                  [
        R                  5      n[        S U 5       5      (       a  U R                  SS9/$ U$ U R                  nUR                  S:X  a  US   n[        R                  " USS9nS	nX2L d$  [        U[        5      (       a  UR                  UL a  U R                  n[        X0R                  5      n[!        U5      nU R#                  X4S
9/$ )zb
Attempt to coerce any object types to better types. Return a copy
of the block (if copy = True).
Fdeepr   r   c              3  R   #    U  H  oR                   R                  S :H  v   M     g7f)ONrc   r~   ).0blks     rf   	<genexpr> Block.convert.<locals>.<genexpr>  s     ;FS99>>S(Fs   %'r   T)convert_non_numericNr   )rm   copyr^   r   r   rZ   convertallr\   r   maybe_convert_objectsr|   r>   _ndarrayr_   r   r   r   )re   blocksr\   r   r_   s        rf   r  Block.convert  s    ~~II5I)**99>djjmq0++EMM:F;F;;;		u	-..M;;! AYF.. $

 z#677##v-99D'
II>
(4

677ri   c                  ^ U(       a"  U R                   (       a  U R                  5       nOU /n[        XSXB/5      (       d  U Vs/ s H  oR                  SS9PM     sn$ / n	U H  mTR                  S:X  d  TR
                  S   S:X  a  T/O[        TR                  5       5      n
U
 Vs/ s H  n[        UR                  UUUUUU5      PM      nn[        U4S jU 5       5      (       a   U	R                  TR                  SS95        M  [        XSS9 H0  u  pU	R                  UR                  XR                  S:g  S95        M2     M     U	$ s  snf s  snf )	NFr  r   r   c              3  @   >#    U  H  oTR                   :H  v   M     g 7frk   r   )r  rc   r  s     rf   r  'Block.convert_dtypes.<locals>.<genexpr>1  s     :6%CII%6s   Tstrict)rc   squeeze)rm   r  anyr  r^   r   listr   r   r\   r  r   zipr   )re   infer_objectsconvert_stringconvert_integerconvert_booleanconvert_floatingdtype_backendblksbr   sub_blksdtypesrc   r  s                @rf   r   Block.convert_dtypes  sJ    T^^<<>D6DP
 
 1551FFF&55C Q#))A,!*;cjjlAS  " "A HH"##$!! "   :6:::

3888/0>

188%18EF ?- 0 
7 6s   E)%Ec                .    U R                   R                  $ rk   )r\   rc   rd   s    rf   rc   Block.dtype=  s     {{   ri   c                D   U R                   nU(       aG  UR                  S:X  a7  [        U5      (       a'  UR                  S   S:w  a  [	        S5      eUSSS24   n[        XAUS9n[        U5      nSn[        UR                  UR                  5      (       a  U R                  nU R                  XVS9nUR                  U R                  :w  aT  [        SU R                  R                   S	U R                   S
UR                  R                   S	UR                   S3	5      eU$ )am  
Coerce to the new dtype.

Parameters
----------
dtype : np.dtype or ExtensionDtype
errors : str, {'raise', 'ignore'}, default 'raise'
    - ``raise`` : allow exceptions to be raised
    - ``ignore`` : suppress exceptions. On error return original object
squeeze : bool, default False
    squeeze values to ndim=1 if only one column is given

Returns
-------
Block
r   r   r   z*Can not squeeze with more than one column.N)errorsr   zcannot set astype for dtype (z [z]) to different shape (z]))r\   r^   r   r   
ValueErrorr   r   r   rc   r_   r   r   rw   )re   rc   r/  r  r\   r   r_   newbs           rf   r   Block.astypeB  s    . v{{a',?,F,F||A!# !MNNAqD\F&vVD
(4
&,,
(8(89999Dz5::#JJOO$Btzzl 3JJOO$Btzzl"6 
 ri   nan)na_repquotingc          	     T    [        U R                  UUUUUS9nU R                  U5      $ )z"convert to our native types format)r4  r5  float_formatdate_formatdecimal)rG   r\   r   )re   r7  r8  r9  r4  r5  r   s          rf   rG   Block.get_values_for_csvp  s5    
 $KK%#
 v&&ri   c                   U R                   nU(       a  UR                  5       nSnOUR                  5       nU R                  n[	        U 5      " X R
                  U R                  US9$ )zcopy constructorNr   )r\   r  viewr_   r   r   r^   )re   r  r\   r_   s       rf   r  
Block.copy  sP     [[]FD[[]F99DDz&NNQUVVri   c                p    U(       a!  U R                   R                  5       (       d  U $ U R                  US9$ )Nr  )r_   r   r  )re   inplacer  s      rf   _maybe_copyBlock._maybe_copy  s-    4992244Kyydy##ri   c                    S nU(       + nU(       a0  U R                   R                  5       (       a  SnX24$ U R                   nX24$ )NT)r_   r   )re   r?  r_   r  s       rf   _get_refs_and_copyBlock._get_refs_and_copy  sF    {yy&&(( z yyzri   c                H   U R                   nU R                  U5      (       d  U R                  USS9/$ Uc  [        R                  " XQ5      nUR                  5       (       d  U R                  USS9/$ U R                  U5      (       d   U R                  S:X  a:  [        U5      (       a*  U R                  U5      n[        UR                   XB5        U/$ U R                  S:X  d  U R                  S   S:X  aX  Ub	  U[        L a*  U R                  [        R                  " [        5      5      nOU R                  USS9nUR!                  UUSUS9$ / n[#        U R%                  5       5       H5  u  pUR'                  [)        U 5      R!                  U	UUSXHUS-    S95        M7     U$ )	zm
replace the to_replace value with value, possible to create new
blocks here this is just a call to putmask.
Fr  stringr   r   r  T
to_replacer   r?  mask)r\   r   r@  r0   mask_missingr  rc   r,   r2   r^   r   r   r   r}   rX   r  replacer   r   r   r   )
re   rI  r   r?  rJ  r\   r  r  r   r   s
             rf   rL  Block.replace  s   " %%j11
 $$W5$9::<'';Dxxzz $$W5$9::##E**tzzX/E%PU,, ""7+CCJJ45LYY!^tzz!}1}kk"((6"2311%1O;;%	    F"4;;=1J&&#-# $!a!e_ '  2 Mri   c                   [        U5      (       d&  U R                  U5      (       d  U R                  SS9/$ [        U5      (       a&  U R                  [        S4;  a  U R                  SS9/$ U R                  U5      (       dJ  U R                  S:X  a  [        U5      (       d*  U R                  [        R                  " [        5      5      nOU R                  U5      n[        R                  " U5      n[        UR                  XbU5        U/$ )an  
Replace elements by the given value.

Parameters
----------
to_replace : object or pattern
    Scalar to replace or regular expression to match.
value : object
    Replacement object.
inplace : bool, default False
    Perform inplace modification.
mask : array-like of bool, optional
    True indicate corresponding element is ignored.

Returns
-------
List[Block]
Fr  rF  )r,   r   r  rc   rX   r   r}   r@  recompiler8   r\   )re   rI  r   r?  rJ  r   rxs          rf   _replace_regexBlock._replace_regex  s    4 Z  )?)?
)K)K II5I)**FH3E!E II5I)** ""5))djjH.DuKK 01E$$W-EZZ
#ellBt4wri   c           
       ^^^ U R                   m[        XSS9 VVs/ s HB  u  pVU R                  U5      (       d$  U R                  S:X  d  M-  [	        U5      (       d  M?  XV4PMD     nnnU(       d  U R                  SS9/$ [        U5      S-
  n[        TR                  5      (       a  [        T5      ) mUUU4S jU 5       n	OU4S jU 5       n	U(       a  [        U	5      n	U /n
[        [        XySS95       GHX  u  nu  u  pn/ n[        U
5       GH8  u  nn[        U
5      S:X  a  UnO!Un[        U[        5      (       a   eUUUS-    nUR                  UUUUTS	9nWU:w  a  [        U R                  R                  5       VVs0 s H  u  nn[!        U" 5       5      U_M     nnnU H  nUR                  U R                  L aK  [!        U5      U;   a:  UU La3  U R                  R                  R#                  U[!        U5         5        Mc  Me  Mg  UR                  R                  R%                  5         M     UR'                  U5        GM;     Un
GM[     U
$ s  snnf s  snnf )
z*
See BlockManager.replace_list docstring.
Tr  rF  Fr  r   c           
   3  T   >#    U  H  n[        [        TUS    TTS95      v   M     g7f)r   )regexrJ  N)r1   r7   )r  r   na_maskrV  r\   s     rf   r  %Block.replace_list.<locals>.<genexpr>1  s8      6 A #+FAaDGT  s   %(c              3  X   >#    U  H  n[         R                  " TUS    5      v   M!     g7f)r   N)r0   rK  )r  r   r\   s     rf   r  rX  9  s%     GAW))&!A$77s   '*)rI  r   rJ  r?  rV  )r\   r   r   rc   r,   r  r   r"   r.   r  r   r|   r   _replace_coercer_   referenced_blocksidpopclearr   )re   src_list	dest_listr?  rV  xypairssrc_lenmasksrbr   srcdestrJ  new_rbblk_numr  mmibr   r(  self_blk_idsrW  r\   s       `                  @@rf   replace_listBlock.replace_list  sX    
 H=
=&&q))djjH.D INq QF= 	 

 II5I)**e*q.6<<(( F|mG6 	6E HGE KE V&/E0N&O"A"T"$F
 !*"r7a<AC)#t4444Ggk2A
 ,,"# -  <
 099T9T/U$/Utq!13
/U ! $ $66TYY.!!u4$ $		 ; ; ? ?RPQU@S T :G4 FF44::< $ f%I !.J BW 'PX 	Y
z$s   ,IIII
c                   [        XQ5      (       a  U R                  UUUUS9$ Uc  UR                  5       (       a  U R                  R	                  5       nU R                  [        R                  " [        5      5      nU(       d  UR                  SS9nO<U(       a5  U(       a.  UR                  R	                  5       (       a  UR                  SS9n[        UR                  X25        U/$ U R                  SS9/$ U R                  UUUUS9$ )a  
Replace value corresponding to the given boolean array with another
value.

Parameters
----------
to_replace : object or pattern
    Scalar to replace or regular expression to match.
value : object
    Replacement object.
mask : np.ndarray[bool]
    True indicate corresponding element is ignored.
inplace : bool, default True
    Perform inplace modification.
regex : bool, default False
    If true, perform regular expression substitution.

Returns
-------
List[Block]
)r?  rJ  Tr  FrH  )r9   rR  r  r_   r   r   r}   rc   rX   r  r2   r\   rL  )re   rI  r   rJ  r?  rV  has_refr   s           rf   rZ  Block._replace_coerceq  s    < E..&&	 '   }88::"ii557GRXXf%56B"WW$W/ W1F1F1H1HWW$W/#BIIt;4K		u	-..<<%	    ri   c                    U$ z1
For compatibility with 1D-only ExtensionArrays.
ra   re   args     rf   _maybe_squeeze_argBlock._maybe_squeeze_arg  s	     
ri   c                    U$ rt  ra   )re   r   s     rf   _unwrap_setitem_indexerBlock._unwrap_setitem_indexer  s	     ri   c                .    U R                   R                  $ rk   )r\   r   rd   s    rf   r   Block.shape  s    {{   ri   c                     U R                   U   $ rk   r\   )re   r   s     rf   iget
Block.iget  s     {{1~ri   c                     U R                   U   $ )zreturn a slice of my valuesr  )re   r   s     rf   r   Block._slice  s    
 {{6""ri   c                l    U(       a  U R                   R                  5       U l         X R                   U'   g)a`  
Modify block values in-place with new item value.

If copy=True, first copy the underlying values in place before modifying
(for Copy-on-Write).

Notes
-----
`set_inplace` never creates a new array or new Block, whereas `setitem`
_may_ create a new array and always creates a new Block.

Caller is responsible for checking values.dtype == self.dtype.
Nr\   r  re   locsr\   r  s       rf   set_inplaceBlock.set_inplace  s'     ++**,DK"Dri   c                   U R                   nU[        R                  L a  U R                  nSnOSn[        R
                  " XQX&US9n[        U [        5      (       a  U R                  S:X  a  Uc   eUS:X  a  Uc   eUc  U R                  nUR                  U R                  :w  a  U R                  Xs5      $ U R                  Xs5      $ )z>
Take values according to indexer and return them as a block.
FT)axis
allow_fillr   r   r   )r\   r   
no_defaultr   algostake_ndr|   ExtensionBlockr^   r   rc   r   r   )re   r   r  r   r   r\   r  r   s           rf   r  Block.take_nd  s     'JJJ ]]$*

 dN++ 		Q<+?@@AI,"677>>Ltzz)??:<<--jGGri   c                    UR                  U R                  R                  US9u  pVUR                  S5      nUR                  U   nX6   n[	        U5      n[        XWS9/nX4$ )a  
Return a list of unstacked blocks of self

Parameters
----------
unstacker : reshape._Unstacker
fill_value : int
    Only used in ExtensionBlock._unstack
new_placement : np.ndarray[np.intp]
allow_fill : bool
needs_masking : np.ndarray[bool]

Returns
-------
blocks : list of Block
    New blocks of unstacked values.
mask : array-like of bool
    The mask of columns of `blocks` we should keep.
r   r   r   )get_new_valuesr\   Tr  r   new_block_2d)	re   	unstackerr   new_placementneeds_maskingr   rJ  r   r  s	            rf   _unstackBlock._unstack  so    4 %33KKMMj 4 

 xx{  \\$'
%+M*z89|ri   c                   U R                  U5      n[        [        R                  U R                  5      nU R
                  S:X  a  UR                  n[        XU5        U R                  [        :w  a
  [        USS9n [        UR                  U5      nU R                  [        :X  a5  X1   n[        R                  " U5      (       a  [        U[        U5      U5      nU R!                  SS9n [        [        R                  U R                  R                  5      n[#        U[        R                  5      (       a$  UR
                  S:X  a  [        U5      S:X  a  US   n XCU'   U $ ! [$        [&        4 a"  n[        U5      (       a  ['        S5      Uee SnAff = f! [(         a$    U R+                  USS	9nUR-                  X5      s $ f = f)
aT  
Attempt self.values[indexer] = value, possibly creating a new array.

Parameters
----------
indexer : tuple, list-like, array-like, slice, int
    The subset of self.values to set
value : object
    The value being set

Returns
-------
Block

Notes
-----
`indexer` is a direct slice/positional indexer. `value` must
be a compatible shape.
r   Tr   r?  r   )r   .z)setting an array element with a sequence.NrG  )r   r   r}   r   r\   r^   r  rF   rc   rl   rE   r   r   r    r4   r   r@  r|   r   r0  r   r  setitem)re   r   r   r\   castedvir  r   s           rf   r  Block.setitem9  s   * ,,U3bjj$++.99>XXF 	gf5::#!%t<E	(u=F zzZ'_##B'' 9R&QF##D#1D"**dkkmm4F&"**--&++2Bs6{VWGW"(w  z* ''$C ) ! 	.,,UD,IB::g--	.s*   =F E# #F3FF+GGc                V   Un[        [        R                  U R                  5      n[	        UR
                  U5      u  p[        U[        [        [        45      (       a   eU[        R                  L a  U R                  nU R                  U5      n[        USS9nU(       a  U R                  SS9/$  [!        UR"                  U5      nU R%                  SS9n [        [        R                  U R                  5      n['        UR
                  X5        U /$ ! [(         Ga    U R*                  S:X  d  U R,                  S   S:X  a]  [/        U5      (       d!  U R1                  USS9R3                  X5      s $ UR5                  5       S   nU R7                  XrU   5      nU/s $ [        U[        R                  5      n	/ n
[9        U R;                  5       5       HJ  u  pUnU	(       a  US	S	2XS-   24   nUS	S	2XS-   24   nUR3                  X5      nU
R=                  U5        ML     U
s $ f = f)
z
putmask the data to the block; it is possible that we may create a
new dtype of block

Return the resulting block(s).

Parameters
----------
mask : np.ndarray[bool], SparseArray[bool], or BooleanArray
new : an ndarray/object

Returns
-------
List[Block]
Tr   Fr  r  r   r   rG  N)r   r}   r   r\   r5   r  r|   r)   r+   r(   r   r  r   r   rE   r  r   rc   r@  r3   r   r^   r   r    r  putmasknonzeror  r   r   r   )re   rJ  new	orig_maskr\   noopr  r   r   is_arrayr   r   nsubmaskr   s                  rf   r  Block.putmaskx  s     	bjj$++.%fhh5
cHi#FGGGG#.. //C**3/Ct4II5I)**#	"(s;F##D#1D"**dkk2F"688T:6M  	"yyA~A!!3 $C((66T 7 gd() #llnQ/Gg7|<B4K &c2::6
&t{{}5EAA11u9-'11u95G**W0C%%c* 6 "!7	"s!   3A!D AH(4*H( BH('H(c                l   UR                   U R                   :X  d   e[        U[        [        [        45      (       a   eU R                   S:H  n[        U5      n[        [        R                  U R                  5      nUnU(       a  UR                  n[        XB) 5      u  pgU(       a  U R                  SS9/$ U[        R                  L a  U R                  nU R!                  U5      n [#        UR$                  U5      nUn['        XFR)                  5       U5      n	XLas  [+        U5      (       a;  [-        U5      [-        U5      :  a#  [        R.                  " U) XA5        [1        S5      eUR                  5       n
[        R2                  " XU	5        O[+        U5      (       aj  [        U[        R                  5      (       dK  [-        U5      U R4                  S   :X  a/  [        R6                  " U5      R9                  UR4                  5      n[:        R.                  " U) XA5      n
 U(       a  U
R                  n
U RM                  U
5      /$ ! [<        [>        [@        4 a    U R                   S:X  d  U R4                  S   S:X  a#  U RC                  USS9nUR/                  XR5      s $ [        U[        R                  [D        45      n/ n[G        U RI                  5       5       HK  u  pUnU(       a  US	S	2XS-   24   nUS	S	2XS-   24   nUR/                  UU5      nURK                  U5        MM     Us $ f = f)
z
evaluate the block; return result block(s) from the result

Parameters
----------
other : an ndarray/object
cond : np.ndarray[bool], SparseArray[bool], or BooleanArray

Returns
-------
List[Block]
r   Fr  zThis should not be reached; call to np.where above is expected to raise ValueError. Please report a bug at github.com/pandas-dev/pandasr   r   r   rG  N)'r^   r|   r)   r+   r(   r1   r   r}   r   r\   r  r5   r  r   r  r   r   r   rc   r4   sumr    r   whereNotImplementedErrorr  r   arrayr   rC   r0  r   r   r  r<   r   r   r   r   )re   r   cond	transposer\   
orig_othericondr  r  altr   r   r  r   r   r   othr  r   s                      rf   r  Block.where  s    yyDII%%%eh	<%HIIIIIIN	!$' bjj$++.
XXF&vu5II5I)**CNN"OOE,,U3;	B )u=F4 E-fiik5IC&&3u:F+CHHeVV3-7 
  

6#.
 !''&ubjj99E
djjn4
 HHUO33FLLAE
 %**E66A XXF'(({ I'89 	" yyA~A!!3 33E53Q{{:44 &ebjj.-IJ
&t{{}5EAC#Aqq5yL1"1aa%i<0G((30C%%c* 6 "!-	"s   (I	 	AL3$BL32L3c                   [        US5      nU R                  (       d  SnO-[        U R                  5      n[	        U R                  U5      u  pTU(       a  U R                  SS9/$ Ub.  SWUR                  U R                  R                  S-
  5      U:  '   U(       a  U R                  WR                  U5      nOU R                  UWR                  ) 5      n[        U5      $ )zm
fillna on the block with the value. If we fail, then convert to
block to hold objects instead and try again
r?  TFr  r   )r   r   r.   r\   r5   r  cumsumr^   r  r  r  extend_blocks)re   r   limitr?  r  rJ  r   s          rf   fillnaBlock.fillna"  s     &gy9  D$D)$++t<JDII5I)**>CDT[[--12U:;,,tvvu-C**UTVVG,CS!!ri   r?  r  
limit_areac                  U R                   (       d  U R                  SS9/$ U R                  U5      u  pV[        [        U R
                  5      nUR                  R                  UUUUS9R                  n[        USS9n	U R                  XS9/$ )NFr  )methodr  r  r  Tr   r   )
r   r  rC  r   r>   array_valuesr  _pad_or_backfillrE   r   )
re   r  r?  r  r  r  r_   r   r   datas
             rf   pad_or_backfillBlock.pad_or_backfillC  s       II5I)**,,W5
 '):):;VV,,!	 - 

 ! 	 Zt<**4*;<<ri   forward)r?  r  limit_directionr  c                  [        US5      nUS:X  a  [        R                  " U5        U R                  (       d  U R	                  SS9/$ U R
                  [        :X  a   SSS.U R                     n[        U S35      eU R                  U5      u  pU R                  R                  " SUU R                  S	-
  UUUUU	S
.UD6n[        USS9nU R                  XS9/$ )Nr?  asfreqFr  Series	DataFrame)r   r   z& cannot interpolate with object dtype.r   )r  r  indexr  r  r  r  Tr   r   ra   )r   r0   clean_fill_methodr   r  rc   rl   r^   r   rC  r  interpolaterE   r   )re   r  r  r?  r  r  r  r   rw   r  r_   r   r  s                rf   r  Block.interpolate^  s     &gy9X%%f-  II5I)**::#K0;Dtf$JKLL,,W5
 &&22 	
Q+!	
 	

 Zt<**4*;<<ri   c                    [         R                  " U R                  R                  USS9R                  nU R	                  US9/$ )z'return block for the diff of the valuesr   r  r  )r  diffr\   r  r   )re   r  r   s      rf   r  
Block.diff  s8    
 ZZqq9;;
z233ri   c                r   U R                   S-
  n[        R                  " U5      (       d  U R                  [        :w  a  [        S5      eU R                  U5      n [        U R                  U5      n[        [        R                  U R                  5      n[        XQX45      nU R                  U5      /$ ! [         ax    U R                  R                  S;  d  [!        X R                  5      (       d"  ["        R$                  " S[&        [)        5       S9  U R+                  USS9nUR                  XS9s $ f = f)	z+shift the block by periods, possibly upcastr   zfill_value must be a scalarr{   zshifting with a fill value that cannot be held by original dtype is deprecated and will raise in a future version. Explicitly cast to the desired dtype before shifting instead.
stacklevelFrG  r  )r^   r   r!   rc   rl   r0  r   r   r   r}   r   r\   r:   r   r   r~   r-   warningswarnr   r   r  )re   periodsr   r  r  r\   r   r   s           rf   r:   Block.shift  s    yy1} }}Z((TZZ:-E :;;11*=
	< )

F* "**dkk2Fv=J..z:;;' ! 	<zze+3HJJ4 4 ( #/1 ,,Z,OB88G8;;	<s   B4 4A?D65D6c                    U R                   S:X  d   e[        U5      (       d   e[        U R                  [        R
                  " UR                  5      U5      n[        USS9n[        X0R                  S9$ )z
compute the quantiles of the

Parameters
----------
qs : Index
    The quantiles to be computed in float64.
interpolation : str, default 'linear'
    Type of interpolation.

Returns
-------
Block
r   r   r  )
r^   r    r6   r\   r}   asarray_valuesr   r  r   )re   qsinterpolationr   s       rf   quantileBlock.quantile  sa    * yyA~~B bjj.DmT $F3Fnn==ri   c                   U R                   (       a  U R                  (       a[  [        U R                  [        [
        [        45      (       a"  [        R                  " S[        [        5       S9  U R                  SS9$ U R                  R                  U5      nSnX R                  L a  U R                  nU R                  X#S9$ )a(  
Rounds the values.
If the block is not of an integer or float dtype, nothing happens.
This is consistent with DataFrame.round behavior.
(Note: Series.round would raise)

Parameters
----------
decimals: int,
    Number of decimal places to round to.
    Caller is responsible for validating this
zbobj.round has no effect with datetime, timedelta, or period dtypes. Use obj.dt.round(...) instead.r  Fr  Nr   )
is_numericr   r|   r\   r;   r@   r?   r  r  UserWarningr   r  roundr_   r   )re   decimalsr\   r_   s       rf   r  Block.round  s     $,,$++~{'STT G/1	 99%9((
 ""8,[[ 99D))&)<<ri   c                X   [        U5      (       d  U/nU R                  S:X  ap  [        [        R                  U R
                  5      n[        R                  " X!5      nU R                  R                  U5      n[        U 5      " X#U R                  S9/$ [        R                  " U5      U R
                  R                  S   :  a  [        e[        R                  " XR
                  R                  S   //5      nU R                  R                  n/ nSnU R                  R                  5       (       a  U R                  OSnU Hc  nXS-   :X  a  OUU R
                  US-   U2SS24   nXFS-   U n	[        U 5      " U[!        U	5      U R                  US9n
UR#                  U
5        UnMe     U$ )zDeletes the locs from the block.

We split the block to avoid copying the underlying data. We create new
blocks for every connected segment of the initial block that is not deleted.
The new blocks point to the initial array.
r   r   r^   r   r   Nr   )r    r^   r   r}   r   r\   deleter   r   maxr   
IndexErrorconcatenateas_arrayr_   r   r   r   )re   r   r\   r   mgr_locs_arr
new_blocksprevious_locr_   idxr  r   s              rf   r  Block.delete  su    C  %C99>"**dkk2FYYv+F~~,,S1HJv		JKK66#;$++++A.. nncKK$5$5a$8#9:;~~.."$
 !II3355tyy4CQ&& \A%5%;Q%>?#1$4s;$ZnT&:QU !!"%L   ri   c                    [        U 5      e)(return a boolean if I am possibly a viewr   rd   s    rf   is_viewBlock.is_view5  s     "$''ri   c                    [        U 5      e)z@
The array that Series.array returns. Always an ExtensionArray.
r  rd   s    rf   r  Block.array_values:      
 "$''ri   c                    [        U 5      e)zs
return an internal format, currently just the ndarray
this is often overridden to handle to_dense like operations
r  r   s     rf   
get_valuesBlock.get_valuesA  r  ri   )r   r\   returnr   )r  r   )r   r   r  None)NN)r   BlockPlacement | Noner_   BlockValuesRefs | Noner  rZ   )r   r  r_   r  r  r   )r  r   )r  r]   )r   r   r  r   )r   npt.NDArray[np.intp]r  r   F)r   r   r   r   r   r   r  r   )r   r   r  r   )r   rL   r  r   r  list[Block])r  rZ   )r   rL   r  r	  )r  zGenerator[Block])r  r   r  rZ   )TTTTTnumpy_nullable)r!  r   r"  r   r#  r   r$  r   r%  r   r&  rN   r  r	  )r  rO   )raiseF)rc   rO   r/  rQ   r  r   r  rZ   )r4  r   r  rZ   )r  r   r  r   )T)r?  r   r  r   r  r   )r?  r   )FN)r?  r   rJ  znpt.NDArray[np.bool_] | Noner  r	  )r?  r   r  r	  )FF)
r_  zIterable[Any]r`  zSequence[Any]r?  r   rV  r   r  r	  )TF)rJ  npt.NDArray[np.bool_]r?  r   rV  r   r  r	  )rv  
np.ndarrayr  r  r  rT   )r   )int | tuple[int, int] | tuple[slice, int]r  r  )r   4slice | npt.NDArray[np.bool_] | npt.NDArray[np.intp]r  rL   r\   rL   r  r   r  r  )r   r  r  rM   r   r  r  rZ   r  r  r  r  NFr  
int | Noner?  r   r  r	  
r  rP   r?  r   r  r  r  #Literal['inside', 'outside'] | Noner  r	  )r  rR   r  rV   r?  r   r  r  r  z&Literal['forward', 'backward', 'both']r  r  r  r	  )r  r]   r  r	  rk   r  r]   r   r   r  r	  )linear)r  rV   r  rS   r  rZ   )r  r]   r  r   r  r<   rc   DtypeObj | Noner  r  )Kr   
__module____qualname____firstlineno____doc____annotations__	__slots__r  r	   r   rg   rm   rq   rt   rx   r   propertyr   r   r   r   r   setterr   r   r   r   r   r   r   r   r   r   r   r   r   r   r  r  r   rc   r   rG   r  r@  rC  rL  rR  rn  rZ  rw  rz  r   r  r   r  r   r  r  r  r  r  r  r  r  r  r  r:   r  r  r  r  r  r  __static_attributes__ra   ri   rf   rZ   rZ      sm    ('
I
IJ
3  3 /  / 6  6 %  % 6  6 "  " 3  3 , , <  <     __& &  ,0'+	Q )Q %	Q
 
Q Q"  ,0'+	R )R %	R
 
R R 	 	     J J J J RW
J
J+9
JKO
J	
J 
J 6 6
 ) )" - - + +  *    2 7 7r "8 "8L ## $ $!%&6,, , 	,
 , , $, 
,b !  !  &	++ + 	+
 
+ +Z CHRV'=@'	' ' 
W 
W$
   
 -1@ 	@ +@ 
@ @D 
 - 	- 
- -^ 
 YY !Y 	Y
 Y 
Y Yv  7 $	7
 7 7 
7 7z ! !#J#	##$ 
 /3>>%H%%H %H ,	%H 
%H %HN* ,	*
 -*\=~A"Fe)T !	" " 	"
 
"J  :>= = 	=
 = 8= 
=6   BK:>(= #(= 	(=
 (= (= @(= 8(= 
(= (=T 4 4,<\  08>> -> 
	> >: "= "=N.` ( ( ( (( (ri   rZ   c                     ^  \ rS rSr% SrS\S'   \SSS jj5       r\S 5       r\SS j5       r	\SS	 j5       r
\SU 4S
 jj5       r\\SS j5       5       r\SSS jj5       r\SSSS.         SS jj5       rSrU =r$ )EABackedBlockiI  z6
Mixin for Block subclasses backed by ExtensionArray.
r<   r\   Nc                    U R                   R                  R                  XS9R                  nU R                  U5      /$ )zk
Shift the block by `periods`.

Dispatches to underlying ExtensionArray and re-boxes in an
ExtensionBlock.
)r  r   )r\   r  r:   r   )re   r  r   r   s       rf   r:   EABackedBlock.shiftP  s9     [[]](((PRR
**:677ri   c                   UnUnU R                  U5      nU R                  U5      nU R                  nUR                  S:X  a  UR                  n[        XU5         X%U'   U $ ! [        [        4 a|    [        U R                  [        5      (       a#  U R                  USS9nUR                  X45      s $ [        U [        5      (       a#  U R                  USS9nUR                  X45      s $ e f = f)a  
Attempt self.values[indexer] = value, possibly creating a new array.

This differs from Block.setitem by not allowing setitem to change
the dtype of the Block.

Parameters
----------
indexer : tuple, list-like, array-like, slice, int
    The subset of self.values to set
value : object
    The value being set

Returns
-------
Block

Notes
-----
`indexer` is a direct slice/positional indexer. `value` must
be a compatible shape.
r   TrG  )rz  rw  r\   r^   r  rF   r0  r   r|   rc   r%   r  r  NDArrayBackedExtensionBlock)re   r   r   orig_indexer
orig_valuer\   r   s          rf   r  EABackedBlock.setitem]  s    0 
..w7''.;;! XXFgf5	#7O K I& 	$**m4400T0Rzz,;;D"=>>00T0Rzz,;; 	s   A" "AC.46C.,C.c                   U R                   R                  n[        U5      nUnUnU R                  U5      nU R                  U5      nU[        R
                  L a  U R                  n[        X2) 5      u  pgU(       a  U R                  SS9/$  UR                  X!5      R                  nU R;                  U5      nU/$ ! [         a    e [        [        4 Ga    U R                  S:X  d  U R                  S   S:X  a  [        U R                   ["        [$        45      (       a  U R'                  USS9n	U R                  S:X  aR  [        U[(        R*                  5      (       a3  UR                  S:X  a#  [-        U	R                   5      (       d	  US S 2S 4   nU	R/                  XE5      s $ [        U [0        5      (       a#  U R'                  USS9n	U	R/                  XE5      s $ e [        U[(        R*                  [2        45      n
/ n[5        U R7                  5       5       HJ  u  pUnU
(       a  US S 2XS-   24   nUS S 2XS-   24   nUR/                  X5      nUR9                  U5        ML     Us $ f = f)NFr  r   r   rG  r   )r\   r  r1   rw  r   r  r   r5   r  _wherer   r0  r   r^   r   r|   rc   r%   rA   r  r}   r   r   r  r+  r<   r   r   r   r   )re   r   r  arrr  	orig_condr  r  r   r  r  r   r   r   r  r  r   s                    rf   r  EABackedBlock.where  s0   kkmm!$'
	''.&&t,CNN"OOE&sE2 II5I)**)	"D022JT ''
3tU # 	I& %	"yyA~A!!3djj=+*FGG55jRW5XC		Q&y"**==%NNa/ 3CII > >$-ag$6	99Z;;&ABB 55jRW5XC99Z;;  &j2::~2NO
&t{{}5EA"A&q!!e)|4'11u95G((1.C%%c* 6 "!K%	"s    B< <C&I+$6I+BI+*I+c                   [        U5      nU[        R                  L a  U R                  nUnUnU R	                  U5      nU R	                  U5      nUR                  5       (       d  U R                  SS9/$ U R                  SS9n U R                  nUR                  S:X  a  UR                  n UR                  X5        U /$ ! [         a    e [        [        4 Ga,    U R                  S:X  d  U R                  S   S:X  a{  [!        U R"                  [$        5      (       a#  U R'                  USS9nUR)                  XC5      s $ [!        U [*        5      (       a#  U R'                  USS9nUR)                  XC5      s $ e [!        U[,        R.                  [0        45      n/ n[3        U R5                  5       5       HJ  u  pUnU(       a  US	S	2XS-   24   nUS	S	2XS-   24   nU
R)                  X5      nUR7                  U5        ML     Us $ f = f)
z
See Block.putmask.__doc__
Fr  Tr  r   r   r   rG  N)r1   r   r  r   rw  r  r  r@  r\   r^   r  _putmaskr   r   r0  r   r|   rc   r%   r  r  r+  r}   r   r<   r   r   r   )re   rJ  r  orig_newr  r\   r  r  r   r   r   r  r  r   s                 rf   r  EABackedBlock.putmask  s   
 "$'#.. //C	%%c*&&t,xxzzII5I)**-;;!XXF$	"OOD&H vG # 	:& 	"yyA~A!!3djj-88 55hPT5UC;;y;;&ABB 55hPT5UC;;y;;  &h^0LM
&t{{}5EA A$QE	\2'11u95G**W0C%%c* 6 "!?	"s    .C A>H	6H	:BH	H	c                  > U R                   S:X  aQ  U R                  R                  U5      nU R                  R                  U5      n[	        U 5      " X#U R                   S9/$ U R                  R                   S:X  a  / $ [
        TU ]	  U5      $ )Nr   r  )r^   r\   r  r   r   super)re   r   r\   r   	__class__s       rf   r  EABackedBlock.delete  sv     99>[['',F~~,,S1HJv		JKK[["Iw~c""ri   c                    U R                   $ rk   r  rd   s    rf   r  EABackedBlock.array_values   s     {{ri   c                    U R                   nU[        :X  a  UR                  [        5      n[        R
                  " U5      R                  U R                  5      $ )zC
return object dtype as boxed values, such as Timestamps/Timedelta
)r\   rl   r   rX   r}   r  r   r   )re   rc   r\   s      rf   r  EABackedBlock.get_values%  sA    
 !KKJ]]6*Fzz&!))$**55ri   Fr  c                  U R                   nXS.nS[        R                  " UR                  5      R                  ;   a  XFS'   O$Ub!  [        [        U5      R                   S35      eUR                  S:X  a'  UR                  R                  " S0 UD6R                  nOUR                  " S0 UD6nU R                  U5      /$ )N)r  r  r  z does not implement limit_area (added in pandas 2.2). 3rd-party ExtensionArray authors need to add this argument to _pad_or_backfill.r   ra   )r\   inspect	signaturer  
parametersr  r   r   r^   r  r   )re   r  r?  r  r  r\   r   r   s           rf   r  EABackedBlock.pad_or_backfill0  s     ,2!C7,,V-D-DEPPP#-< #%<(() *A A  ;;!22<V<>>J00:6:J**:677ri   ra   rk   r  r  r  r  r  )r   r  r  r  r   r!  r	   r:   r  r  r  r  r   r  r  r  r%  __classcell__r:  s   @rf   r'  r'  I  s     

8 
8 4 4l ? ?B ; ;z 	# 	#    6 6 
  :>8 8 	8
 8 88 
8 8ri   r'  c                     ^  \ rS rSr% SrS\S'     S     SU 4S jjjr\SS j5       rSS jr	SSS jjr
S	 rS
 r\SS j5       r\SS j5       r    SS jr\SS j5       r    SS jrSrU =r$ )r  iM  z
Block for holding extension types.

Notes
-----
This holds all 3rd-party extension array types. It's also the immediate
parent class for our internal extension types' blocks.

ExtensionArrays are limited to 1-D.
r<   r\   c                  > [        U R                  [        [        45      (       a<  [        U R                  [        5      (       a  Ub  [	        S5      e[
        TU ]  UUUS9$ U R                  (       a4  U R                  R                  (       d  U R                  nU R                  nO.U R                  U5      u  pd U R                  R                  XUS9nU R'                  XTS9/$ ! [         aa    S nU R                  R                  XS9n[        R                  " S[        U R                  5      R                    S3["        [%        5       S9   Nzf = f)	Nzlimit must be None)r   r  r?  )r   r  r  )r   r  zExtensionArray.fillna added a 'copy' keyword in pandas 2.1.0. In a future version, ExtensionArray subclasses will need to implement this keyword or an exception will be raised. In the interim, the keyword is ignored by .r  r   )r|   rc   r%   rA   r0  r9  r  r   r\   _hasnar_   rC  r   r  r  r   r   r   r   r   )re   r   r  r?  r_   r   r  r:  s          rf   r  ExtensionBlock.fillna[  s8    djj=+">??$**m449J !5667> "  
 T[[%7%799DJ009JD![[//et/T
$ **:*ABB#  ![[//e/I
 I DKK(112!	5
 #/1	s   <C& &A(EEc                    U R                   S:X  a  [        U R                  5      4$ [        U R                  5      [        U R                  5      4$ )Nr   )r^   r   r\   r   rd   s    rf   r   ExtensionBlock.shape  s>     99>$&&4>>"C$444ri   c                x   [        U[        5      (       a  Uu  p#[        R                  " U5      (       d  US:w  a  [	        U  S35      e[        U[
        5      (       a/  US:  a  U[        U R                  5      -  nU R                  X3S-    $ U R                  U   $ US:w  a  [	        U  S35      eU R                  $ )Nr   z only contains one itemr   )r|   tuplecomis_null_slicer  r   r   r\   )re   r   colr   s       rf   r  ExtensionBlock.iget  s     aHC$$S))cQh D6)@!ABB#u%% 73t{{++C {{3q11;;s##Av D6)@!ABB;;ri   c                l    U(       a  U R                   R                  5       U l         X R                   S S & g rk   r  r  s       rf   r  ExtensionBlock.set_inplace  s&     ++**,DKAri   c                f   [        U[        R                  [        45      (       aG  UR                  U R
                  R                  S-   :X  a   UR                  S   S:X  d   eUSS2S4   nU$ [        U[        5      (       a/  UR                  S   S:X  d   eUR                  SSS9R                  nU$ )z0
If necessary, squeeze a (N, 1) ndarray to (N,)
r   Nr   r  )
r|   r}   r   r<   r^   r\   r   r(   _ixsr  ru  s     rf   rw  !ExtensionBlock._maybe_squeeze_arg  s     sRZZ899DKK,,q00 99Q<1$$$ ad)C 
 \** 99Q<1$$$((11(%--C
ri   c                .   [        U[        5      (       a  [        U5      S:X  a  [        S U 5       5      (       aU  Uu  p#UR                  S:X  a+  US:H  R                  5       (       a  UR
                  S   S:X  d  [        S5      eUSS2S4   nU$ [        R                  " US   5      (       a  US   S:X  a  US   nU$ [        R                  " US   5      (       a  US   nU$ [        US   5      (       a  US   S   S:X  a  US   nU$ [        S5      eU$ )z_
Adapt a 2D-indexer to our 1D values.

This is intended for 'setitem', not 'iget' or '_slice'.
r   c              3     #    U  H5  n[        U[        R                  5      =(       a    UR                  S :H  v   M7     g7f)r   N)r|   r}   r   r^   )r  ra  s     rf   r  9ExtensionBlock._unwrap_setitem_indexer.<locals>.<genexpr>  s+     Ng:a,<1<gs   =?r   r   zPThis should not be reached. Please report a bug at github.com/pandas-dev/pandas/N)r|   rO  r   r  sizer   r  r   
is_integerrP  rQ  r    )re   r   firstseconds       rf   rz  &ExtensionBlock._unwrap_setitem_indexer  s-    gu%%#g,!*;
 NgNNN 'KK1$&A+):):)<)<QSTAT-8   1+"  
++
a!!*  ""71:..!!*  gaj))gajmq.@!!* 	 *4  ri   c                    g)z,Extension arrays are never treated as views.Fra   rd   s    rf   r  ExtensionBlock.is_view  s     ri   c                B    U R                   R                  R                  $ rk   )r\   rc   _is_numericrd   s    rf   r  ExtensionBlock.is_numeric  s    {{  ,,,ri   c                    U R                   S:X  aV  [        U[        5      (       d  [        SU5      e[	        S5      U   n[        U5      (       d  [        SU5      e[        S5      nU R                  U   $ )z
Return a slice of my values.

Parameters
----------
slicer : slice, ndarray[int], or ndarray[bool]
    Valid (non-reducing) indexer for self.values.

Returns
-------
ExtensionArray
r   z+invalid slicing for a 1-ndim ExtensionArrayr   N)r^   r|   r   r   ranger   r\   )re   r   new_locss      rf   r   ExtensionBlock._slice  su    & 99> fe,,$A6  Qx'Hx==$A6  4[F{{6""ri   c                ~    U R                   U   n[        U 5      " X R                  U R                  U R                  S9$ )z>
Perform __getitem__-like specialized to slicing along index.
)r^   r_   )r\   r   r   r^   r_   )re   r   r   s      rf   slice_block_rowsExtensionBlock.slice_block_rows!  s1     [[(
Dz*nn499499UUri   c                   UR                   u  pVUR                  U   nX6   n[        [        XSSS95       VVV	s/ s H=  u  nu  p[	        U 5      " U R
                  R                  XU   US9[        U	5      SS9PM?     n
nnn	X4$ s  sn	nnf )NTr  )r  r   r   r   )arange_resultr  r   r   r   r\   taker   )re   r  r   r  r  r   rJ  r   r   placer  s              rf   r  ExtensionBlock._unstack+  s     %22
  \\$'
%+ (1Jd;(
(##G J  a(8Z !  u%( 	 
 |
s   AB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  rw  rz  r#  r  r  r   r	   rk  r  r%  rE  rF  s   @rf   r  r  M  s    	 
 !	(C (C 	(C
 
(C (CT 5 58 ,(T  
 - -&#J&#	&#P V V) ,	)
 -) )ri   r  c                  n    \ rS rSr% S\S'   Sr\S
S j5       r\SS j5       rSSS jjr	\
S
S	 j5       rSrg)
NumpyBlockiW  r  r\   ra   c                2    U R                   R                  SL$ r  N)r\   baserd   s    rf   r  NumpyBlock.is_view[  s     {{t++ri   c                ,    [        U R                  5      $ rk   )r>   r\   rd   s    rf   r  NumpyBlock.array_values`  s    "4;;//ri   Nc                l    U[         :X  a  U R                  R                  [         5      $ U R                  $ rk   )rl   r\   r   r   s     rf   r  NumpyBlock.get_valuesd  s)    J;;%%j11{{ri   c                P    U R                   R                  nUR                  nUS;   $ )Nfciub)r\   rc   r~   )re   rc   r~   s      rf   r  NumpyBlock.is_numerici  s$    !!zzwri   r  r  rk   r  )r   r  r  r  r!  r"  r#  r  r  r  r   r  r%  ra   ri   rf   rs  rs  W  sL    I, , 0 0
  ri   rs  c                  8    \ rS rSr% SrS\S'   \SS j5       rSrg)	r+  iq  z0
Block backed by an NDArrayBackedExtensionArray
rW   r\   c                F    U R                   R                  R                  SL$ ru  )r\   r  rv  rd   s    rf   r  #NDArrayBackedExtensionBlock.is_viewx  s     {{##((44ri   ra   Nr  )	r   r  r  r  r   r!  r#  r  r%  ra   ri   rf   r+  r+  q  s!     ('5 5ri   r+  c                  ,    \ rS rSr% SrSrSrS\S'   Srg)DatetimeLikeBlocki  z*Block for datetime64[ns], timedelta64[ns].ra   FzDatetimeArray | TimedeltaArrayr\   N)	r   r  r  r  r   r"  r  r!  r%  ra   ri   rf   r  r    s    4IJ**ri   r  c                P   [        U [        R                  5      (       aM  [        U 5      n [	        U R
                  R                  [        5      (       a  [        R                  " U [        S9n [        U [        [        45      (       a  U R                  b  U R                  S5      n U $ )a  
Input validation for values passed to __init__. Ensure that
any datetime64/timedelta64 dtypes are in nanoseconds.  Ensure
that we do not have string dtypes.

Parameters
----------
values : np.ndarray or ExtensionArray

Returns
-------
values : np.ndarray or ExtensionArray
r   N)r|   r}   r   rD   
issubclassrc   r   r   r  rX   r;   r@   freq
_with_freqr  s    rf   r   r     sv      &"**%%/7fll''--XXfF3F&=.9::v{{?V""4(Mri   c                    [        U [        5      (       a  [        $ [        U [        5      (       a  [        $ [        U [
        5      (       a  [        $ U R                  nUS;   a  [        $ [        $ )z
Find the appropriate Block subclass to use for the given values and dtype.

Parameters
----------
dtype : numpy or pandas dtype

Returns
-------
cls : class, subclass of Block
Mm)	r|   r#   r  r'   r+  r$   r  r~   rs  r  s     rf   get_block_typer    s[     %))  	E;	'	'**	E>	*	* ::Dt|  ri   c                R    [        U R                  5      n[        U 5      n U" U SXS9$ )Nr   r^   r   r_   )r  rc   r   )r\   r   r_   klasss       rf   r  r    s+     6<<(E (Fa9@@ri   r   c               :    [        U R                  5      nU" XXS9$ )Nr  )r  rc   )r\   r   r^   r_   r  s        rf   r   r     s     6<<(EiCCri   c                   U R                   U:  a  [        SU R                    SU S35      e[        U R                  5      (       dh  U R                   U:w  a  [        SU R                    SU S35      e[	        U5      [	        U 5      :w  a#  [        S[	        U 5       S[	        U5       35      egUS:X  a  [	        U5      S	:w  a  [        S
5      egg)a&  
ndim inference and validation.

Validates that values.ndim and ndim are consistent.
Validates that len(values) and len(placement) are consistent.

Parameters
----------
values : array-like
placement : BlockPlacement
ndim : int

Raises
------
ValueError : the number of dimensions do not match
z0Wrong number of dimensions. values.ndim > ndim [z > ]z1Wrong number of dimensions. values.ndim != ndim [z != zWrong number of items passed z, placement implies r   r   zneed to splitN)r^   r0  r   rc   r   )r\   r   r^   s      rf   
check_ndimr    s    $ {{T>v{{m3tfTUV
 	
 v||,,;;$((.}DaA  y>S[(/F} =%%(^$46  )
 
s9~*)) +ri   c                    [        U [        5      (       a3  U R                  5       n U(       a  US:  a  [        R                  " U 5      n [        U[
        5      (       a  UR                  nX4$ )zM
Ensure that we don't allow NumpyExtensionArray / NumpyEADtype in internals.
r   )r|   r*   to_numpyr}   
atleast_2dr&   numpy_dtype)r\   rc   r^   s      rf   extract_pandas_arrayr  
	  sU     &011"D1H]]6*F%&&!!=ri   c                .   Uc  / n[        U [        5      (       aD  U  H<  n[        U[        5      (       a  UR                  U5        M+  UR                  U5        M>     U$ [        U [        5      (       d   [        U 5      5       eUR                  U 5        U$ )z.return a new extended blocks, given the result)r|   r  r   r   rZ   r   )r   r  rs      rf   r  r   	  s~    ~&$A!T""a a 	  M &%((6$v,6(fMri   c                    U R                   U:  a8  [        U R                  5      (       d  [        SU 5      n U R	                  SS5      n U $ )z2
Reshape if possible to have values.ndim == ndim.
z+np.ndarray | DatetimeArray | TimedeltaArrayr   r   )r^   r   rc   r   r   )r\   r^   s     rf   r   r   0	  sC    
 {{T"6<<00 GPF^^Ar*FMri   c                :   [        U [        [        45      (       a  U R                  [        5      $ [        U [
        [        45      (       a  U R                  n [        U [        R                  5      (       a#  U R                  5       n SU R                  l        U $  U $ )a  
The array that Series.values returns (public attribute).

This has some historical constraints, and is overridden in block
subclasses to return the correct array (e.g. period returns
object ndarray and datetimetz a datetime64[ns] ndarray instead of
proper extension array).
F)r|   r?   r=   r   rX   r;   r@   r  r}   r   r<  flags	writeabler  s    rf   r   r   @	  s{     &;677}}V$$	F]N;	<	< &"**%%!& M 	Mri   )r\   rL   r  rL   )rc   rO   r  ztype[Block]rk   )r\   rL   r   r   r_   r  r  rZ   )r   r   r^   r]   r_   r  r  rZ   )r   r   r^   r]   r  r  )r\   rL   rc   r  r^   r]   r  z!tuple[ArrayLike, DtypeObj | None]r  )r   )r\   rL   r^   r]   r  rL   )
__future__r   rA  rO  typingr   r   r   r   r   r	   r  numpyr}   pandas._libsr
   r   libinternalsr   pandas._libs.internalsr   r   pandas._libs.missingr   pandas.errorsr   r   r   pandas.util._decoratorsr   pandas.util._exceptionsr   pandas.util._validatorsr   pandas.core.dtypes.astyper   r   pandas.core.dtypes.castr   r   r   r   r   pandas.core.dtypes.commonr   r   r   r    r!   r"   pandas.core.dtypes.dtypesr#   r$   r%   r&   r'   pandas.core.dtypes.genericr(   r)   r*   r+   pandas.core.dtypes.inferencer,   pandas.core.dtypes.missingr-   r.   r/   pandas.corer0   pandas.core.algorithmscore
algorithmsr  pandas.core.array_algos.putmaskr1   r2   r3   r4   r5    pandas.core.array_algos.quantiler6   pandas.core.array_algos.replacer7   r8   r9   "pandas.core.array_algos.transformsr:   pandas.core.arraysr;   r<   r=   r>   r?   r@   pandas.core.arrays.string_rA   pandas.core.baserB   pandas.core.commoncommonrP  pandas.core.computationrC   pandas.core.constructionrD   rE   pandas.core.indexersrF   pandas.core.indexes.baserG   collections.abcrH   rI   rJ   rK   pandas._typingrL   rM   rN   rO   rP   rQ   rR   rS   rT   rU   pandas.core.apirV   pandas.core.arrays._mixinsrW   rc   rl   rZ   r'  r  rs  r+  r  r   r  r  r   r  r  r  r   r   ra   ri   rf   <module>r     s   "  	    
 $ 
 3 4 7     /    & &  = 
 5  3 )     / 7 7    &F XXh
|(L,,, |(~-A8E A8HG] GT 45- 5+3 +:< RV
A
A"0
A8N
A

A$ $(DD 	D
 !D D&*R-58&,  ri   