Ë
|
nñúh+ ã óH d dl mZ d dlmZ d dlZd dlmZ d dlmZm Z m
|
Z
|
m Z d dl Z d dl Zd dlmZmZ d dlmZmZ d dlmZ d d lmZ d d
|
lmZm Z d d l m Z d d l m!Z! d d l"m#Z# d dl$m%Z%m&Z&m'Z' d dl(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z. d dl/mZm0Z0m1Z1m2Z2 d dl3m4Z4 d dl5m6Z6 d dl7m8Z8 d dl9m:Z:m;Z; d dl<m=Z=m>Z> d dl?m@Z@ d dlAmBZB d dlCmDZD d dlEmFZF d dlGmHZH er(d dlImJZJ d dlKZKd d lLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZV d d lWmXZX e' G d d e&« « ZY G d d!e8« ZZ G d" d#eZe@« Z[ G d$ d%e[« Z\y)&é )Ú annotations)ÚpartialN)ÚPath)Ú TYPE_CHECKINGÚAnyÚLiteralÚcast)Ú
|
get_optionÚusing_string_dtype)ÚlibÚmissing)Ú NDArrayBacked)Úensure_string_array)Ú HAS_PYARROWÚpa_version_under10p1)Úfunction)Údoc)Úfind_stack_level)ÚExtensionDtypeÚStorageExtensionDtypeÚregister_extension_dtype)Ú is_array_likeÚ is_bool_dtypeÚis_integer_dtypeÚis_object_dtypeÚis_string_dtypeÚ pandas_dtype)r ÚnanopsÚopsÚ roperator)Úisin)Úmasked_reductions)ÚExtensionArray)Ú FloatingArrayÚ FloatingDtype)Ú IntegerArrayÚ IntegerDtype)ÚNumpyExtensionArray)Ú extract_array)Úcheck_array_indexer)Úisna)Úprinting)ÚMutableMapping)
|
Ú ArrayLikeÚAxisIntÚDtypeÚDtypeObjÚ NumpySorterÚNumpyValueArrayLikeÚScalarÚSelfÚnptÚtype_t)ÚSeriesc óÞ e Zd ZdZedd« Zedd« ZdZdej f ddZ
|
ddZ ddZ dd Z d fd
|
Zd Zedd « Zedd « Z ddZddZ ddZ xZS ) Ú StringDtypea
|
Extension dtype for string data.
|
|
.. warning::
|
|
StringDtype is considered experimental. The implementation and
|
parts of the API may change without warning.
|
|
Parameters
|
----------
|
storage : {"python", "pyarrow"}, optional
|
If not given, the value of ``pd.options.mode.string_storage``.
|
na_value : {np.nan, pd.NA}, default pd.NA
|
Whether the dtype follows NaN or NA missing value semantics.
|
|
Attributes
|
----------
|
None
|
|
Methods
|
-------
|
None
|
|
Examples
|
--------
|
>>> pd.StringDtype()
|
string[python]
|
|
>>> pd.StringDtype(storage="pyarrow")
|
string[pyarrow]
|
c ó> | j t j u ryy)NÚstringÚstr)Ú _na_valueÚ
|
libmissingÚNA©Úselfs úMH:\Change_password\venv_build\Lib\site-packages\pandas/core/arrays/string_.pyÚnamezStringDtype.name s à >>Z]]Ñ *Øàó c ó | j S ©N)r> rA s rC Úna_valuezStringDtype.na_value s à~~Ð rE )Ústorager> Nc ó4 |@|t j ur t d« }|dk( r t rd}nd}nt d« }|dk( rd}|dk( r6t j
|
dt t « ¬« d}t j }|dvrt d | d
|
« |dk( rt r t d « t |t « r&t j |« rt j }n |t j urt d | « t! t" |« | _ || _ y ) Nzmode.string_storageÚautoÚpyarrowÚpythonÚ pyarrow_numpya] The 'pyarrow_numpy' storage option name is deprecated and will be removed in pandas 3.0. Use 'pd.StringDtype(storage="pyarrow", na_value-np.nan)' to construct the same dtype.
|
Or enable the 'pd.options.future.infer_string = True' option globally and use the "str" alias as a shorthand notation to specify a dtype (instead of "string[pyarrow_numpy]").©Ú
|
stacklevel> rM rL z+Storage must be 'python' or 'pyarrow'. Got z instead.z;pyarrow>=10.0.1 is required for PyArrow backed StringArray.z('na_value' must be np.nan or pd.NA, got )r? r@ r
|
r ÚwarningsÚwarnÚ FutureWarningr ÚnpÚnanÚ
|
ValueErrorr Ú ImportErrorÚ
|
isinstanceÚfloatÚisnanr r= rI r> )rB rI rH s rC Ú__init__zStringDtype.__init__ s ð ?Øz}}Ñ,Ü$Ð%:Ó;ØfÒ$Ý"Ø"+à"*ä$Ð%:Ó;ØfÒ$Ø &Gà oÒ %Ü MMð8ô Ü+Ó-õ ð GÜvvHð Ð/Ñ /Ü Ø=¸g¸YÀiÐPóð ð iÒ Õ$8Ü ØMóð ô h¤Ô &¬2¯8©8°HÔ+=ô vvHØ Z]]Ñ *Ü Ð GÈÀzÐ RÓSÐ SäC Ó) Ø!rE c ó¾ | j t j u r | j d| j dS | j dk( rdnd}d| d| j dS ) Nú[ú]rL Ú zstorage='python', z <StringDtype(z na_value=z)>)r> r? r@ rD rI )rB rI s rC Ú__repr__zStringDtype.__repr__Ä sZ Ø >>Z]]Ñ *Øii[ $§,¡, ¨qÐ1Ð 1à LL¨IÒ 5bÐ;OGØ" 7 )¨9°T·^±^Ð4DÀBÐGÐ GrE c ó, t |t « r'|dk( s|| j k( ry | j |« }t |t | « « r3| j |j k( xr | j |j u S y# t t
|
f$ r Y yw xY w)Nr< TF) rX r= rD Úconstruct_from_stringÚ TypeErrorrW ÚtyperI rH )rB Úothers rC Ú__eq__zStringDtype.__eq__Ë s ô eSÔ !àÒ E¨T¯Y©YÒ$6Øð Ø ×2Ñ2°5Ó9ô
|
eT $ZÔ (Ø<< 5§=¡=Ñ0ÒT°T·]±]ÀeÇnÁnÐ5TÐ TØøô {Ð+ò ñ ð ús §B ÂBÂBc ó| |j dd« | _ |j dt j « | _ y )NrI rM r> )ÚpoprI r? r@ r> )rB Ústates rC Ú __setstate__zStringDtype.__setstate__Ü s* à yy ¨HÓ5 Ø ;´
|
· ± Ó>rE c ó t | « S rG )ÚsuperÚ__hash__)rB Ú __class__s rC rm zStringDtype.__hash__á s ø äwÑ Ó!Ð!rE c ó> t | j | j ffS rG )r: rI rH rA s rC Ú
|
__reduce__zStringDtype.__reduce__å s ÜT\\¨4¯=©=Ð 9Ð9Ð9rE c ó t S rG )r= rA s rC rd zStringDtype.typeè s ä
|
rE c ó@ t |t « st dt |« « |dk( r | « S |dk( r!t « r | t
|
j ¬« S |dk( r | d¬« S |dk( r | d ¬« S |d
|
k( r | d ¬« S t d | j d | d« )a|
|
Construct a StringDtype from a string.
|
|
Parameters
|
----------
|
string : str
|
The type of the name. The storage type will be taking from `string`.
|
Valid options and their storage types are
|
|
========================== ==============================================
|
string result storage
|
========================== ==============================================
|
``'string'`` pd.options.mode.string_storage, default python
|
``'string[python]'`` python
|
``'string[pyarrow]'`` pyarrow
|
========================== ==============================================
|
|
Returns
|
-------
|
StringDtype
|
|
Raise
|
-----
|
TypeError
|
If the string is not a valid option.
|
z.'construct_from_string' expects a string, got r< r= ©rH zstring[python]rM ©rI zstring[pyarrow]rL zstring[pyarrow_numpy]rN zCannot construct a 'z' from 'ú')rX r= rc rd r rT rU Ú__name__)Úclsr< s rC rb z!StringDtype.construct_from_stringì s² ô8 &¤#Ô&ÜØ@ÄÀfà ÀÐOóð ð XÒ Ù5LØ u_Ô!3Ô!5Ù¤§¡Ô'Ð 'Ø Ð'Ò 'ÙxÔ(Ð (Ø Ð(Ò (ÙyÔ)Ð )Ø Ð.Ò .áÔ/Ð /äÐ 2°3·<±<°.ÀÈÈÐPQÐ RÓSÐ SrE c óü ddl m}m} | j dk( r"| j t
|
j u rt S | j dk( r | j t
|
j u r|S | j dk( rt S |S )zq
|
Return the array type associated with this dtype.
|
|
Returns
|
-------
|
type
|
r )ÚArrowStringArrayÚ ArrowStringArrayNumpySemanticsrM rL ) Ú pandas.core.arrays.string_arrowry rz rI r> r? r@ Ú StringArrayÚStringArrayNumpySemantics)rB ry rz s rC Úconstruct_array_typez StringDtype.construct_array_type sc ÷
|
ð
|
<<8Ò #¨¯©¼*¿-¹-Ñ(GÜ Ð Ø \\YÒ &¨4¯>©>¼Z¿]¹]Ñ+JØ#Ð #Ø \\XÒ %Ü,Ð ,à1Ð 1rE c óä t « }t « }|D ]s }t |t « r7|j |j « |j |j
|
« Jt |t j « r|j dv rs y t |« dk( rd}nt t |« « }t |« dk( rt j }nt t |« « }t ||¬« S )N)ÚUÚTé rL ©rI rH )ÚsetrX r: ÚaddrI rH rT ÚdtypeÚkindÚlenÚnextÚiterr? r@ )rB ÚdtypesÚstoragesÚ na_valuesr rI rH s rC Ú_get_common_dtypez StringDtype._get_common_dtype5 s» Ü5ÜE àò EÜ%¤Ô-Ø U]]Ô+Ø ennÕ-ÜE¤2§8¡8Ô,°·±¸zÑ1IØáð ô x=AÒ à Gä4 >Ó*Gô y>QÒ ä!}}HäD OÓ,Hä 7°XÔ>Ð>rE c óL | j dk( r8| j t j u rddlm} ||« S ddlm} ||« S ddl}t ||j « r|g}n |j }g }|D ]< }|j d¬« }t || j ¬« }|j |« > t |« dk( r t! j" g t$ ¬ « }nt! j& |« }t( j+ t( « }t- j. ||| « |S )
|
zH
|
Construct StringArray from pyarrow Array/ChunkedArray.
|
rL r )ry )rz NF)Úzero_copy_onlyrs ©r )rI r> r? r@ r{ ry rz rL rX ÚArrayÚchunksÚto_numpyr rH Úappendr rT ÚarrayÚobjectÚ concatenater| Ú__new__r r[ ) rB r ry rz rL r ÚresultsÚarrÚnew_string_arrays rC Ú__from_arrow__zStringDtype.__from_arrow__Q sÿ ð <<9Ò $Ø~~¤§ ¡ Ñ.ÝLá'¨Ó.Ð.õñ 6°eÓ<Ð<ó ä% § ¡ Ô/Ø ð àGØ ò $ð ll°%lÓ8Ü)¨#¸¿ ¹ ÔFØsÕ#ð $ô v;!Ò Ü((2¤VÔ,Cä.. Ó)Cô '×.Ñ.¬{Ó;ÐÜ× Ñ Ð /°°dÔ;Ø Ð rE )Úreturnr= )r úlibmissing.NAType | float)rI z
|
str | NonerH r r ÚNone)re r r Úbool)ri zMutableMapping[str, Any]r r )r Úint)r z type[str])r r5 )r ztype_t[BaseStringArray])r zlist[DtypeObj]r zDtypeObj | None)r z$pyarrow.Array | pyarrow.ChunkedArrayr ÚBaseStringArray)rv Ú
|
__module__Ú __qualname__Ú__doc__ÚpropertyrD rH Ú _metadatar? r@ r[ r` rf rj rm rp rd Ú classmethodrb r~ r r Ú __classcell__©rn s @rC r: r: ^ sÒ ø ñ ð@ òó ðð ò ó ð ð )Ið #Ø.8¯m©mð3"àð3"ð ,ð3"ð
|
ó 3"ójHóó"?õ
|
"ò:ð òó ðð ò+Tó ð+Tð`2à ó2ó0?ð8+ Ø9ð+ à ÷+ rE r: c óè e Zd ZU dZded< d Z eej « d « Ze dd« Z
|
dddZ e j dd f dd
|
Z dd Ze j dd f dd Zdd fd Z xZS )r£ z8
|
Mixin class for StringArray, ArrowStringArray.
|
r: r c ó¨ |t j t j t j fv rt |t
|
j « r|j t k( ro|j dd j d« }t j d| d| j dt t « ¬« ||| j t « « S t S )Né Ú_ru z'' operations between boolean dtype and z| are deprecated and will raise in a future version. Explicitly cast the strings to a boolean dtype before operating instead.rO )r Úror_Úrand_ÚrxorrX rT Úndarrayr r¡ rv ÚstriprQ rR ÚDeprecationWarningr ÚastypeÚNotImplemented)rB re ÚopÚop_names rC Ú_logical_methodz BaseStringArray._logical_method s§ à 9>>¤9§?¡?´I·N±NÐCÑ CÜ5¤"§*¡*Ô-Ø tÒ#ð kk ! "o×+Ñ+¨CÓ0GÜ MMØG9Ð CÀDÇJÁJÀ<ð PPð Pô #Ü+Ó-õ ñ eT[[¬Ó .Ó/Ð /Ü Ð rE c ó | j dkD r | D cg c] }|j « c}S t | j « « S c c}w )Nr® )ÚndimÚtolistÚlistr )rB Úxs rC r½ zBaseStringArray.tolist s: à 99q=Ø(,Ö- 1AHHJÒ-Ð -ÜDMMOÓ$Ð$ùò .s Ac óf t j |d¬« dvrt | j ||¬« S )NT©Úskipna)r< Úemptyr )r Ú infer_dtyperV Ú_from_sequence)rw Úscalarsr s rC Ú _from_scalarsz BaseStringArray._from_scalars s2 ä ??7¨4Ô 0Ð8KÑ Kä Ð Ø×!Ñ! '°Ð!Ó7Ð7rE c ó@ t t j d| ¬« }|S )N)ú ú ú
|
)Ú escape_charsÚ quote_strings)r r, Ú pprint_thing)rB ÚboxedÚ formatters rC Ú
|
_formatterzBaseStringArray._formatter§ s% ÜÜ × !Ñ !Ø+Ø #)ô
|
ð
|
ÐrE NTc óÊ | j j t j u r| j ||||¬« S ddlm} | | j }|t j u r| j j }t | « }t j | « }t |« s t |« r¢t |« rt }n|}t |« } | rd}n#|t j d« k( r t |« }t j |||j! d« d|t j t# t$ |« « ¬« }
|
| sd|d d ||
|
|« S | j' |||||« S ) N)rH r Úconvertr )Ú BooleanArrayr® r¡ Úuint8F©rÓ rH r )r rH rT rU Ú_str_map_nan_semanticsÚ pandas.arraysrÔ r Ú
|
no_defaultr+ Úasarrayr r r& r¡ Úmap_infer_maskÚviewr rd Ú_str_map_str_or_object) rB ÚfrH r rÓ rÔ Úmaskr Ú constructorÚna_value_is_naÚresults rC Ú_str_mapzBaseStringArray._str_map¯ s? ð ::× Ñ ¤"§&¡&Ñ (Ø×.Ñ.ØH¨E¸7ð /ó ð õ /à =ØJJEØ s~~Ñ %Øzz×*Ñ*HäDzÜjjÓ ä EÔ "¤m°EÔ&:ä Ô&Ü * à * ä ! (^NÙ Ø Ø"(( 6Ó*Ò*ä >Ü×'Ñ'ØØØ 'Ó"Ø Ø!ô hht¤D¨%Ó 0Ó1ô
|
Fñ "Ø Qá v tÓ,Ð ,ð ×.Ñ.¨u°hÀÀQÈÓMÐ MrE c ón t |« r
t |« szt j |||j d« d|¬« }| j
|
j dk( r'dd l}|j |||j « d¬« } t | « |« S t j |||j d« « S )NrÕ F)rÓ rH rL r T)rß rd Ú from_pandas) r r r rÛ rÜ r rI rL r Ú large_stringrd )rB r rH r rÞ rß râ Úpas rC rÝ z&BaseStringArray._str_map_str_or_objectæ s¤ ô 5Ô !¬/¸%Ô*@ä×'Ñ'ØQ 'Ó*°EÀHôFð zz×!Ñ! YÒ.Û$àØ ¨B¯O©OÓ,=È4ð "ó ð 4:fÓ%Ð %ô ×%Ñ% c¨1¨d¯i©i¸Ó.@ÓAÐ ArE c óv | | j }|t j u r$t |« rd}n| j j }t | « }t j | « }t |« s t |« r«t |« }|rt |« rd}nd}t j |||j d« d|t j t t |« « ¬« }|r?t |« r4|j « r$|j d« }t j ||< |S | j! |||||« S )NFr rÕ rÖ Úfloat64)r r rÙ r rH r+ rT rÚ r rÛ rÜ r rd Úanyr¶ rU rÝ ) rB rÞ rH r rÓ rß r rá râ s rC r× z&BaseStringArray._str_map_nan_semantics s ð =ØJJEØ s~~Ñ %Ü UÔ#à à ::×.Ñ.äDzÜjjÓ ä EÔ "¤m°EÔ&:Ü ! (^NÙ Ü# EÔ*Ø Hð %Hä×'Ñ'ØØØ 'Ó"Ø Ø!Ühht¤D¨%Ó 0Ó1ô Fñ Ô"2°5Ô"9¸d¿h¹h¼jð yÓ1Ü !vvt àMð ×.Ñ.¨u°hÀÀQÈÓMÐ MrE c ó> | t d« t | |¬« S )Nz)Cannot change data-type for string array.r )rc rl rÜ )rB r rn s rC rÜ zBaseStringArray.view4 s& ø Ø Ð ÜÐ GÓHÐ HÜw| %|Ó(Ð(rE )r r1 r r5 ©F)rÏ r¡ )r ú Dtype | NonerÓ r¡ )r z
|
np.ndarrayrß únpt.NDArray[np.bool_]rG )r rí r r. )rv r¤ r¥ r¦ Ú__annotations__rº r r# r½ r© rÇ rÑ r rÙ rã rÝ r× rÜ rª r« s @rC r£ r£ sÌ ø
ñð Óò ñ$ × Ñ Ó ñ%ó ð%ð
|
ò8ó ð8ô ð Ø "Ø ð 5Nð ð 5Nð
|
ó 5Nðn Bð ð Bð $ó BðB Ø "Ø ð .Nð ð .Nð
|
ó .N÷`)ò )rE r£ c óÈ e Zd ZU dZdZdZej Zde d< d&d' fd Z
|
d Z d Z e d
|
dd d(d « Ze d
|
dd d(d « Ze d)d« Zd*dZd+dZd Zd, fd Zd-dZd.dZd/dZd0d1 fd Zdddd d2dZddd3d Zd4 fd Zd5d6d Z d5d6d Z d
|
ddd d7d!Z d0d8d"Z d&d9d#Z e!e"jF « d: d; fd$ « Z#d% Z$e$Z% xZ&S )<r| aY
|
Extension array for string data.
|
|
.. warning::
|
|
StringArray is considered experimental. The implementation and
|
parts of the API may change without warning.
|
|
Parameters
|
----------
|
values : array-like
|
The array of data.
|
|
.. warning::
|
|
Currently, this expects an object-dtype ndarray
|
where the elements are Python strings
|
or nan-likes (``None``, ``np.nan``, ``NA``).
|
This may change without warning in the future. Use
|
:meth:`pandas.array` with ``dtype="string"`` for a stable way of
|
creating a `StringArray` from any sequence.
|
|
.. versionchanged:: 1.5.0
|
|
StringArray now accepts array-likes containing
|
nan-likes(``None``, ``np.nan``) for the ``values`` parameter
|
in addition to strings and :attr:`pandas.NA`
|
|
copy : bool, default False
|
Whether to copy the array of data.
|
|
Attributes
|
----------
|
None
|
|
Methods
|
-------
|
None
|
|
See Also
|
--------
|
:func:`pandas.array`
|
The recommended function for creating a StringArray.
|
Series.str
|
The string methods are available on Series backed by
|
a StringArray.
|
|
Notes
|
-----
|
StringArray returns a BooleanArray for comparison methods.
|
|
Examples
|
--------
|
>>> pd.array(['This is', 'some text', None, 'data.'], dtype="string")
|
<StringArray>
|
['This is', 'some text', <NA>, 'data.']
|
Length: 4, dtype: string
|
|
Unlike arrays instantiated with ``dtype="object"``, ``StringArray``
|
will convert the values to strings.
|
|
>>> pd.array(['1', 1], dtype="object")
|
<NumpyExtensionArray>
|
['1', 1]
|
Length: 2, dtype: object
|
>>> pd.array(['1', 1], dtype="string")
|
<StringArray>
|
['1', '1']
|
Length: 2, dtype: string
|
|
However, instantiating StringArrays directly with non-strings will raise an error.
|
|
For comparison methods, `StringArray` returns a :class:`pandas.BooleanArray`:
|
|
>>> pd.array(["a", None, "c"], dtype="string") == "a"
|
<BooleanArray>
|
[True, <NA>, False]
|
Length: 3, dtype: boolean
|
Ú extensionrM r r> Fc ó t |« }t | ||¬« t |t | « « s| j « t j | | j t | j | j ¬« « y )N©Úcopyr ) r) rl r[ rX rd Ú _validater Ú_ndarrayr: Ú_storager> )rB Úvaluesrô rn s rC r[ zStringArray.__init__ sa ø Ü vÓ&ä Ñ dÐÔ+Ü&¤$ t£*Ô-Ø NNÔ Ü× Ñ Ø Ø MMÜ § ¡ ¸¿¹Ô Gõ
|
rE c óÌ t | j « r,t j | j d¬« s t d« | j j
|
dk7 r#t d| j j
|
d« | j j dkD r/t j | j j d« « y t j | j « y )
|
z*Validate that we only store NA or strings.TrÁ z7StringArray requires a sequence of strings or pandas.NAr z>StringArray requires a sequence of strings or pandas.NA. Got 'ú' dtype instead.r ÚKN) r rö r Úis_string_arrayrV r r¼ Úconvert_nans_to_NAÚravelrA s rC rõ zStringArray._validate s ä t}}Ô ¤c×&9Ñ&9¸$¿-¹-ÐPTÕ&UÜ Ð VÓWÐ WØ ==× Ñ (Ò *Ü ðØMM×'Ñ'Ð(Ð(8ð:óð ð
|
==× Ñ Ò !ä × "Ñ " 4§=¡=×#6Ñ#6°sÓ#;Õ <ä × "Ñ " 4§=¡=Õ 1rE c
|
óÌ t |« r| j j S t |t « s2t d| d| j dt |« j d« |S )NúInvalid value 'ú ' for dtype 'ú3'. Value should be a string or missing value, got 'ú
|
' instead.)r+ r rH rX r= rc rd rv ©rB Úvalues rC Ú_validate_scalarz StringArray._validate_scalar® sf ä ;Ø::×&Ñ&Ð &ÜE¤3Ô'ÜØ! % ¨ °d·j±j°\ð B1Ü15°e³×1EÑ1EÐ0FÀjðRóð ð rE N©r rô c ól |rAt |t « r|dk( s,t |« }t |t « r|j dk( s4J t « r t dt j ¬« }n t d¬« }ddlm } |j }t ||« r6|j }|j }t j ||d¬« }|||< nBt j |« rt j |« }t j |||¬ « }| j# | « }t% j& |||« |S )
|
Nr< rM r rt r )ÚBaseMaskedArrayF)rô Úconvert_na_value)rH rô )rX r= r r: rI r rT rU Úpandas.core.arrays.maskedr rH Ú_maskÚ_datar r Úis_pyarrow_arrayr r r r[ ) rw rÆ r rô r rH r râ r s rC rÅ zStringArray._from_sequence¹ sÿ á * U¬CÔ0°U¸hÒ5FÜ Ó'EÜ e¤[Ô1°e·m±mÀxÒ6OÐ OÐOä!Ô#Ü#¨H¼r¿v¹vÔFä#¨HÔ5å=à>>Ü gÔ /à IØ ]]FÜ×,Ñ,¨V¸$ÐQVÔWFØ (F9Ò ô ×#Ñ# GÔ,ô (( 7Ó+ä×,Ñ,¨W¸xÈdÔSFð ;; sÓ+ÐÜ× Ñ Ð /°¸Ô?à Ð rE c ó* | j |||¬« S )Nr )rÅ )rw Ústringsr rô s rC Ú_from_sequence_of_stringsz%StringArray._from_sequence_of_stringsÞ s ð ×!Ñ! '°¸TÐ!ÓBÐBrE c ó t j |t ¬« }t j |d d | |« j |d¬« S )Nr Fró )rT rà r r? r@ r¶ )rw Úshaper rø s rC Ú_emptyzStringArray._emptyä s9 ä%¤vÔ.Ü MMq Ù6{×!Ñ! %¨eÐ!Ó4Ð4rE c ó° ddl }||j « }| j j « }d|| j « < |j ||d¬« S )z6
|
Convert myself into a pyarrow Array.
|
r NT)rd rå )rL r< rö rô r+ r )rB rd rç rø s rC Ú__arrow_array__zStringArray.__arrow_array__ê sN ó à <Ø99;Dà ×#Ñ#Ó%Ø "tyy{ÑØxx T°txÓ<Ð<rE c óf | j j « }|| j j fS rG )rö rô r rH )rB r s rC Ú_values_for_factorizez!StringArray._values_for_factorize÷ s) Ømm× Ñ Ó"àDJJ×'Ñ'Ð'Ð'rE c
|
ó@ t j |« rgt |« r| j j }|S t |t « s2t d| d| j dt |« j d« |S t |d¬« }t |« s t j |t ¬« }n@t |j t | j « « r|S t j |« }t |« r"t j |d¬« s t d « |S )
|
z-Maybe convert value to be pyarrow compatible.r r r r T)Ú extract_numpyr rÁ z]Invalid value for dtype 'str'. Value should be a string or missing value (or array of those).)r Ú is_scalarr+ r rH rX r= rc rd rv r) r rT rÚ r r rü r s rC Ú _maybe_convert_setitem_valuez(StringArray._maybe_convert_setitem_valueü sÿ ä ==Ô ÜE{Ø
|
|
×+Ñ+ð, ô+ ¤sÔ+Ü Ø% e W¨M¸$¿*¹*¸ ð F:Ü:>¸u»+×:NÑ:NÐ9Oð P ð óð ð( ô " %°tÔ<EÜ Ô'Ü
|
|
5´Ô7ÜEKK¬¨d¯j©jÓ)9Ô:Ø ô
|
|
5Ó)Ü5z¤#×"5Ñ"5°eÀDÕ"IÜ ðCóð ð rE c óæ | j |« }t | |« }t j |« }t j |« }|r |s t d« |s|j
|
| j
|
k( r |j }nbt j |« }t |« }|j « r2|j « }| j
|
j |t |« < t | 9 ||« y )Nz)setting an array element with a sequence.)r r* r r rV r rö rT rÚ r+ rê rô rH rl Ú __setitem__)rB Úkeyr Ú
|
scalar_keyÚ scalar_valuerß rn s rC r zStringArray.__setitem__ sº ø Ø×1Ñ1°%Ó8ä! $¨Ó,Ü]] 3Ó'
|
Ü}} UÓ+ Ù lÜ Ð HÓIÐ IáØ{{djjÒ(Ø ä
|
|
5Ó)ÜE{Ø88:Ø !JJLEØ)-¯©×)<Ñ)<E$u+Ñ&ä ÑC Õ'rE c ó2 t j | ||« y rG )r# Ú_putmask©rB rß r s rC r# zStringArray._putmask- s ô × Ñ d¨EÕ2rE c ó0 t j | ||« S rG )r# Ú_wherer$ s rC r& zStringArray._where3 s ô ×$Ñ$ T¨4°Ó7Ð7rE c ó t |t « s%t |t « r3t |j « r |j | j d¬« }n¼t j t j |« d¬« sut j |D cg c] }t |t « s t |« s |" c}t ¬« }t |« s%t j | j t" ¬« S | j% || j ¬« }t' t j | « t j |« « S c c}w )NFró TrÁ r )rX r£ r# r r r¶ r rü rT rÚ r r= r+ r r Úzerosr r¡ rÅ r! )rB rø Úvals rC r! zStringArray.isin9 sÚ Ü foÔ .Ü v~Ô .´?À6Ç<Á<Ô3Pà]] 4§:¡:°E]Ó:Fä×&Ñ&¤r§z¡z°&Ó'9À$ÕGÜØ$*ÖPS¬j¸¼cÔ.BÄdÈ3ÅiSÒPÜ ôô 6{Ü 88 D§J¡J´dÔ;Ð;à×(Ñ(¨°t·z±zÐ(ÓBFäBJJtÓ$¤b§j¡j°Ó&8Ó9Ð9ùò Qs  EÂ2ETc óL t |« }|| j k( r|r| j « S | S t |t « rX| j
|
j « }| j « }d||< |j |j « }t ||d¬« S t |t « rN| j « }| j « }d||< |j |j « }t ||d¬« S t |t « rt j | ||« S t j |t j « rU| j
|
j « }| j « }d||< |j |« }t j" ||< |S t$ | ||« S )Nr Fró Ú0)r r rô rX r' rö r+ r¶ Ú numpy_dtyper& r% r$ r r# rT Ú
|
issubdtypeÚfloatingrU rl )rB r rô r rß rø rn s rC r¶ zStringArray.astypeK sT ø Ü UÓ#à DJJÒ ÙØyy{Ð"ØKä |Ô ,Ø--×$Ñ$Ó&CØ99;DØCIØZZ × 1Ñ 1Ó2FÜ ¨°5Ô9Ð 9Ü }Ô -Ø))+CØ99;DØCIØZZ × 1Ñ 1Ó2FÜ ¨°EÔ:Ð :Ü ~Ô .ä!×(Ñ(¨¨u°dÓ;Ð ;Ü ]]5¤"§+¡+Ô .Ø--×$Ñ$Ó&CØ99;DØCIØZZ Ó&FÜ 66F4LØMäw~e TÓ*Ð*rE r )r ÚkeepdimsÚaxisc óx | j j t j u rK|dv rG|dk( r!t j
|
| j |¬« S t j | j |¬« S |dv r7 t | |« d ||d|¤}|r | j |g| j ¬« S |S t d| d« )
|
N)rê Úallrê rÁ )ÚminÚmaxÚargminÚargmaxÚsum)r r0 r zCannot perform reduction 'z' with string dtype© ) r rH rT rU r Únananyrö ÚnanallÚgetattrrÅ rc )rB rD r r/ r0 Úkwargsrâ s rC Ú_reducezStringArray._reducel s² ð ::× Ñ ¤"§&¡&Ñ (¨T°^Ñ-CØu}Ü }} T§]¡]¸6ÔBÐBä }} T§]¡]¸6ÔBÐBà Ð<Ñ <Ø(WT 4Ó(ÐL°¸TÑLÀVÑLFÙØ×*Ñ*¨F¨8¸4¿:¹:Ð*ÓFÐFØMÜÐ4°T°FÐ:MÐNÓOÐOrE rÁ c ó´ |dk( r d| d| j d}t |« d}d}| j }t j t j
|
j t j j d| }| j rñt dt |« « }t j |« r t | « |« S |r^|dk( rt j |d |« }n|j « }t j |d
|
d ¬ « t j |d d ¬ « nVt j" |« } t j$ t' |« | z
|
d¬« }| j j( |dd |d| } ||« }
|
|t j* |
|
|f« }
|
n-|+t j || j j( |
|
« }
|
t | « |
|
« } | S )a¶
|
Return an ExtensionArray performing an accumulation operation.
|
|
The underlying data type might change.
|
|
Parameters
|
----------
|
name : str
|
Name of the function, supported values are:
|
- cummin
|
- cummax
|
- cumsum
|
- cumprod
|
skipna : bool, default True
|
If True, skip NA values.
|
**kwargs
|
Additional keyword arguments passed to the accumulation function.
|
Currently, there is no supported kwarg.
|
|
Returns
|
-------
|
array
|
|
Raises
|
------
|
NotImplementedError : subclass does not define accumulations
|
Úcumprodz operation 'z' not supported for dtype 'ru N)ÚcumsumÚcumminÚcummaxrî r@ r_ Úpadr )Úmethodr0 Úbackfillr r )r rc rö rT r@ ÚminimumÚ
|
accumulateÚmaximumÚ_hasnar r+ r2 rd Úwhererô r Úpad_or_backfill_inplacer6 rà r rH Úhstack) rB rD r r< ÚmsgÚtailÚna_maskr³ Únp_funcÚidxÚ np_resultrâ s rC Ú _accumulatezStringArray._accumulate s© ð8 9Ò Ø vÐ%@ÀÇÁÀ ÈAÐNCÜC.Ð ð #'Ø%)Ø--äiiÜjj×+Ñ+Üjj×+Ñ+ñ
|
ð ñ ð ;;ÜÐ2´D¸³MÓBGÜvvgØ!tDz 'Ó*Ð*ÙØ8Ò#Ü hh w°°GÓ <Gð &llnGÜ×3Ñ3Ø Ø $Ø õô
|
×3Ñ3Ø Ø )Ø öô ii Ó(Üxx¤ G£ ¨sÑ 2¸(ÔCØ **×-Ñ-QØ! $ 3-ñ GÓ$ à Ð Ü 9¨dÐ"3Ó4IØ Ð ä ¨$¯*©*×*=Ñ*=¸yÓIIàdIÓ&Ø rE c ó´ | j j t j u r"|t j
|
u rt j S t | ||« S rG )r rH rT rU r? r@ rl Ú_wrap_reduction_result)rB r0 râ rn s rC rU z"StringArray._wrap_reduction_resultÔ s? ø Ø ::× Ñ ¤"§&¡&Ñ (¨V´z·}±}Ñ-Dä66MÜwÑ-¨d°FÓ;Ð;rE c óº t j d|« t j | j « | j « |¬« }| j ||« S ©Nr8 )rø rß r )ÚnvÚ validate_minr" r3 r r+ rU ©rB r0 r r< râ s rC r3 zStringArray.minÚ óH Ü
|
FÔ#Ü"×&Ñ&Ø==?¨¯©«¸Vô
|
ð ×*Ñ*¨4°Ó8Ð8rE c óº t j d|« t j | j « | j « |¬« }| j ||« S rW )rX Ú validate_maxr" r4 r r+ rU rZ s rC r4 zStringArray.maxá r[ rE )r0 rÂ Ú min_countc ó² t j d|« t j | j | j « |¬« }| j ||« S rW )rX Ú validate_sumr" r7 rö r+ rU )rB r0 r r^ r< râ s rC r7 zStringArray.sumè sH ô FÔ#Ü"×&Ñ&Ø== t§y¡y£{¸6ô
|
ð ×*Ñ*¨4°Ó8Ð8rE c óD ddl m} || j |¬« j d« } || j d|¬« }|j j | j
|
« |_ | j
|
j t j u r|j d« }|S )Nr )Úvalue_counts_internal)ÚdropnaÚInt64F)Úsortrc ) Úpandas.core.algorithmsrb rö r¶ Úindexr rH r? r@ )rB rc Ú value_countsrâ s rC rh zStringArray.value_countsö su ÝPá dmm°FÔ;×BÑBÀ7ÓKÙ dmm°%ÀÔGØ ||×*Ñ*¨4¯:©:Ó6 à ::× Ñ ¤*§-¡-Ñ /Ø]] 7Ó+FØ rE c óz | j j }|r"|t j | j « z S |S rG )rö Únbytesr Úmemory_usage_of_objects)rB Údeeprâ s rC Ú memory_usagezStringArray.memory_usage s3 Ø ×%Ñ%Ù ØC× 7Ñ 7¸¿ ¹ Ó FÑFÐ FØ rE c óV | j r t d« t | |||¬« S )NzOsearchsorted requires array to be sorted, which is impossible with NAs present.)r ÚsideÚsorter)rI rV rl Ú searchsorted)rB r ro rp rn s rC rq zStringArray.searchsorted s7 ø ð ;;Ü ð$óð ô wÑ#¨%°dÀ6Ð#ÓJÐJrE c óÈ ddl m}m} t |t « rR| j
|
j t j ur,|j
|
j t j u rt S t ||« rht |t « rR| j
|
j t j u r&|j
|
j t j us t S t S t |t « r |j }t | « t |« z }| }t j |« r_t |« t | « k7 r#t! dt | « dt |« « t# |« st% j& |« }|| }|j( t* j, v rvt% j. | j d¬« }| j
|
j ||< || j | |« ||< t |t0 « r|S | j3 |« S t% j4 t | j « d¬« } || j | |« ||< |||« }| j
|
j t$ j6 u rU|t8 j: k( r!|j= t$ j> d¬ « S |j= t$ j> d
|
¬ « S |S ) Nr )ÚArrowExtensionArrayrÔ z"Lengths of operands do not match: z != r r r¡ Trs F) rØ rs rÔ rX r£ r rH r? r@ r· r| rö r+ r Ú is_list_liker rV r rT rÚ rv r ÚARITHMETIC_BINOPSÚ
|
empty_liker Ú_from_backing_datar( rU ÚoperatorÚner Úbool_) rB re r¸ rs rÔ rß Úvalidrâ Úres_arrs rC Ú _cmp_methodzStringArray._cmp_method s3 ÷
|
ô uoÔ .Ø
|
|
×#Ñ#¬:¯=©=Ñ8Ø ×$Ñ$¬
|
¯ © Ñ5ô "Ð !ä eÐ 0Ô 1Ü%¤ Ô1ð JJ×'Ñ'¬:¯=©=Ñ8Ø ×,Ñ,´J·M±MÑAä)Ð)ä%Ð%ä e[Ô )ØNNEäDzD KÑ'Øä × Ñ EÔ "Ü5zS YÒ&ä Ø8¼¸T»¸ À4ÌÈEË
|
À|ÐTóð ô
|
! Ô'Ü
|
|
5Ó)Ø%LEà ;;#×/Ñ/Ñ /Ü]] 4§=¡=¸ÔAFØ ::×.Ñ.F4LÙ t}}¨UÑ 3°UÓ ;F5MÜ%¤Ô&à Ø×*Ñ*¨6Ó2Ð 2ô XXc $§-¡-Ó 0¸Ô?FÙ t}}¨UÑ 3°UÓ ;F5MÙ" 6¨4Ó0GØzz×"Ñ"¤b§f¡fÑ,ØÒ$Ø"×+Ñ+¬B¯H©H¸tÐ+ÓDÐDà"×+Ñ+¬B¯H©H¸uÐ+ÓEÐEØNrE rì )rô r¡ r r )r rí rô r¡ )r r| rG )r z,tuple[np.ndarray, libmissing.NAType | float]©r r )rß rî r r )rß rî r r5 )rø r. r rî )T)rô r¡ )rD r= r r¡ r/ r¡ r0 úAxisInt | None)rD r= r r¡ r r| )r0 r r r )NT)r r¡ r r4 )r0 r r r¡ r^ r¢ r r4 )rc r¡ r r8 )rl r¡ r r¢ )ÚleftN)r z$NumpyValueArrayLike | ExtensionArrayro zLiteral['left', 'right']rp zNumpySorter | Noner z npt.NDArray[np.intp] | np.intp)'rv r¤ r¥ r¦ Ú_typr÷ r? r@ r> rï r[ rõ r r© rÅ r r r r r r r# r& r! r¶ r= rS rU r3 r4 r7 rh rm r r# rq r} Ú _arith_methodrª r« s @rC r| r| < s± ø
ñNðb DØHØ+5¯=©=IÐ(Ó8ö
|
|
ò2ò ð Ø>BÐQVô " ó ð" ðH à/3À%ñCØ ,ðCØ;?òCó ðCð
|
ò5ó ð5ó
|
=ó(ò
|
õ8(ó*3ó 8ó :ö$ +ðJ Ø Ø ñ PàðPð ð Pð
|
ð Pð ó Pð, 8<õ Põd<ô 9ô9ð $ØØñ 9ð ð 9ð ð 9ð
|
ð 9ð
|
ó 9ô ôñ × $Ñ $Ó%ð *0Ø%)ð Kà3ð Kð 'ð Kð #ð Kð
|
|
(ô Kó &ð Kò>ð@ MrE r| c ó` e Zd ZdZej
|
ZddZeddd d fd« Z xZ
|
S ) r} rM c óþ t | j « r,t j | j d¬« s t d« | j j
|
dk7 r#t d| j j
|
d« y)z+Validate that we only store NaN or strings.TrÁ z?StringArrayNumpySemantics requires a sequence of strings or NaNr zFStringArrayNumpySemantics requires a sequence of strings or NaN. Got 'rú N)r rö r rü rV r rA s rC rõ z#StringArrayNumpySemantics._validate\ su ä t}}Ô ¤c×&9Ñ&9¸$¿-¹-ÐPTÕ&UÜ ØQóð ð ==× Ñ (Ò *Ü ðØMM×'Ñ'Ð(Ð(8ð:óð ð +rE NFr c ób |t dt j ¬« }t | |||¬« S )NrM r r )r: rT rU rl rÅ )rw rÆ r rô rn s rC rÅ z(StringArrayNumpySemantics._from_sequencei s1 ø ð =Ü ¨¼2¿6¹6ÔBEÜwÑ% g°UÀÐ%ÓFÐFrE r~ )r rí rô r¡ r r5 ) rv r¤ r¥ r÷ rT rU r> rõ r© rÅ rª r« s @rC r} r} X sL ø ØHØIó
|
ð à/3À%ñGØ ,ðGØ;?ðGà ôGó ôGrE r} )]Ú
|
__future__r Ú functoolsr rx Úpathlibr Útypingr r r r rQ ÚnumpyrT Úpandas._configr
|
r Ú pandas._libsr r r? Úpandas._libs.arraysr Úpandas._libs.libr Ú pandas.compatr r Úpandas.compat.numpyr rX Úpandas.util._decoratorsr Úpandas.util._exceptionsr Úpandas.core.dtypes.baser r r Úpandas.core.dtypes.commonr r r r r r Ú pandas.corer r r rf r! Úpandas.core.array_algosr" Úpandas.core.arrays.baser# Úpandas.core.arrays.floatingr$ r% Úpandas.core.arrays.integerr& r' Úpandas.core.arrays.numpy_r( Úpandas.core.constructionr) Úpandas.core.indexersr* Úpandas.core.missingr+ Úpandas.io.formatsr, Úcollections.abcr- rL Úpandas._typingr. r/ r0 r1 r2 r3 r4 r5 r6 r7 Úpandasr8 r: r£ r| r} r8 rE rC ú<module>r¢ sõ ðÝ "å Û Ý ÷ó ó ã ÷÷
|
õ .Ý 0÷õ /Ý 'Ý 4÷ñ ÷
|
÷ ÷ó õ (Ý 5Ý 2÷÷õ :Ý 2Ý 4Ý $å &áÝ.ã÷ ÷ ÷ õ ð ô] Ð'ó ] ó ð] ô@ x)nô x)ôzY /Ð#6ô Y ôxG õ GrE
|
