o $jD@stddlmZddlmZmZddlZddlmZddl m Z ddl m Z ddl mZddlmZddlZdd lmZmZdd lmZdd lmZmZdd lmZmZmZmZdd lm Z m!Z!m"Z"erhddlm#Z#ej$ej%ej&ej'ej(ej)ej)dZ*ej&ej+dfej)ej,e fej$ej-dfej%ej-dfej'ej-dfej.ej,dfej(ej/dfiZ0ej-dej+dej,diZ1GdddeZ2dS)) annotations) TYPE_CHECKINGAnyN) infer_dtype)iNaT)NoBufferPresent)cache_readonly)BaseMaskedDtype) ArrowDtypeDatetimeTZDtype)is_string_dtype) PandasBufferPandasBufferPyarrow)Column ColumnBuffersColumnNullType DtypeKind) ArrowCTypes Endiannessdtype_to_arrow_c_fmt)Buffer)iufbUMmzThis column is non-nullablezThis column uses NaN as nullz!This column uses a sentinel valuec@seZdZdZd1d2d d Zd3d d Zed3ddZed4ddZ d4ddZ eddZ eddZ ed3ddZ ed5ddZd3ddZd6d7d#d$Zd8d&d'Zd9d)d*Zd:d,d-Zd;d/d0Zd S)< PandasColumna A column object, with only the methods and properties required by the interchange protocol defined. A column can contain one or more chunks. Each chunk can contain up to three buffers - a data buffer, a mask buffer (depending on null representation), and an offsets buffer (if variable-size binary; e.g., variable-length strings). Note: this Column object can only be produced by ``__dataframe__``, so doesn't need its own version or ``__column__`` protocol. Tcolumn pd.Series allow_copyboolreturnNonecCsNt|tjrtd|jdt|tjstdt|d||_||_ dS)zu Note: doesn't deal with extension arrays yet, just assume a regular Series/ndarray for now. zExpected a Series, got a DataFrame. This likely happened because you called __dataframe__ on a DataFrame which, after converting column names to string, resulted in duplicated names: zD. Please rename these columns before using the interchange protocol.zColumns of type  not handled yetN) isinstancepdZ DataFrame TypeErrorcolumnsSeriesNotImplementedErrortype_col _allow_copy)selfr r"r1_/var/www/html/Deteccion_Ine/venv/lib/python3.10/site-packages/pandas/core/interchange/column.py__init__Ts   zPandasColumn.__init__intcCs|jjS)z2 Size of the column, in elements. )r.sizer0r1r1r2r5hszPandasColumn.sizecCdS)z7 Offset of first element. Always zero. rr1r6r1r1r2offsetnszPandasColumn.offsettuple[DtypeKind, int, str, str]cCs~|jj}t|tjr!|jjj}||j\}}}}tj ||t j fSt |r:t |jdvr6tjdt|t j fStd||S)N)stringemptyz.Non-string object dtypes are not supported yet)r.dtyper'r(ZCategoricalDtypevaluescodes_dtype_from_pandasdtyper CATEGORICALrNATIVEr rSTRINGrr,)r0r=r?_ZbitwidthZc_arrow_dtype_f_strr1r1r2r=vs.    zPandasColumn.dtypecCst|jd}|durtd|dt|tr|jj}nt|tr'|j j}n t|t r1|jj}n|j}|dkr@||j t j |fS||j dt||fS)z/ See `self.dtype` for details. N Data type z& not supported by interchange protocolz bool[pyarrow]r<) _NP_KINDSgetkind ValueErrorr'r Z numpy_dtype byteorderr baser itemsizerBOOLr)r0r=rHrJr1r1r2r@s"      z$PandasColumn._dtype_from_pandasdtypecCs:|jdtjks td|jjjdtt |jjj dS)a: If the dtype is categorical, there are two options: - There are only values in the data buffer. - There is a separate non-categorical Column encoding for categorical values. Raises TypeError if the dtype is not categorical Content of returned dict: - "is_ordered" : bool, whether the ordering of dictionary indices is semantically meaningful. - "is_dictionary" : bool, whether a dictionary-style mapping of categorical values to other objects exists - "categories" : Column representing the (implicit) mapping of indices to category values (e.g. an array of cat1, cat2, ...). None if not a dictionary-style categorical. rzCdescribe_categorical only works on a column with categorical dtype!T)Z is_orderedZ is_dictionary categories) r=rrAr)r.catorderedrr(r+rNr6r1r1r2describe_categoricalsz!PandasColumn.describe_categoricalcCst|jjtrtj}d}||fSt|jjtr/|jjjj d ddur*tj dfStj dfS|jd}z t |\}}W||fStyNtd|dw)NrrEz not yet supported)r'r.r=r r USE_BYTEMASKr array _pa_arraychunksbuffers NON_NULLABLEZ USE_BITMASK_NULL_DESCRIPTIONKeyErrorr,)r0Zcolumn_null_dtypeZ null_valuerHnullvaluer1r1r2 describe_nulls    zPandasColumn.describe_nullcCs|jS)zB Number of null elements. Should always be known. )r.Zisnasumitemr6r1r1r2 null_countszPandasColumn.null_countdict[str, pd.Index]cCs d|jjiS)z8 Store specific metadata of the column. z pandas.index)r.indexr6r1r1r2metadatas zPandasColumn.metadatacCr7)zE Return the number of chunks the column consists of. rRr1r6r1r1r2 num_chunksszPandasColumn.num_chunksNn_chunks int | Noneccsv|r6|dkr6t|j}||}||dkr|d7}td|||D]}t|jj||||jVq"dS|VdS)zy Return an iterator yielding the chunks. See `DataFrame.get_chunks` for details on ``n_chunks``. rRrN)lenr.rangerZilocr/)r0rer5stepstartr1r1r2 get_chunkss    zPandasColumn.get_chunksrcCs\|ddd}z||d<Wn tyYnwz ||d<W|Sty-Y|Sw)a` Return a dictionary containing the underlying buffers. The returned dictionary has the following contents: - "data": a two-element tuple whose first element is a buffer containing the data and whose second element is the data buffer's associated dtype. - "validity": a two-element tuple whose first element is a buffer containing mask values indicating missing data and whose second element is the mask value buffer's associated dtype. None if the null representation is not a bit or byte mask. - "offsets": a two-element tuple whose first element is a buffer containing the offset values for variable-size binary data (e.g., variable-length strings) and whose second element is the offsets buffer's associated dtype. None if the data buffer does not have an associated offsets buffer. N)datavalidityoffsetsrmrn)_get_data_buffer_get_validity_bufferr_get_offsets_buffer)r0rWr1r1r2 get_buffers s   zPandasColumn.get_buffers.tuple[Buffer, tuple[DtypeKind, int, str, str]]c Cs|jdtjtjtjtjtjfvri|j}|jdtjkr/t|jddkr/|jj d }n/|jj }t |jjtr>|j}n t |jjtr[|jjd}t|dt|d}||fS|j}t||jd}||fS|jdtjkr|jjj}t||jd}||j}||fS|jdtjkr|j }t}|D]}t |tr||j dd qtt!j"|d d }|j}||fSt#d |jjd )zZ Return the buffer containing the data and the buffer's associated dtype. rNrRlength)r"utf-8encodingZuint8)r=rEr&)$r=rINTUINTFLOATrMDATETIMErgr.dtZ tz_convertto_numpyrTr'r _datar rUrVrrWZ_ndarrayr r/rAr>_codesr@rC bytearraystrextendencodenpZ frombufferr,) r0r=Znp_arrarrbufferr?bufrobjr1r1r2ro0sN "      zPandasColumn._get_data_buffertuple[Buffer, Any] | Nonec Cs`|j\}}t|jjtr7|jjjjd}tj dt j t j f}| ddur'dSt| dt|d}||fSt|jjtrT|jjj}t|}tj dt j t j f}||fS|jdtjkr|j}|dk}| }tjt|ftjd}t|D]\} } t| tr|n||| <qwt|}tj dt j t j f}||fSz t|d} Wt| tytdw) z Return the buffer containing the mask values indicating missing data and the buffer's associated dtype. Raises NoBufferPresent if null representation is not a bit or byte mask. rrRNrvr<shaper=z! so does not have a separate maskzSee self.describe_null)r]r'r.r=r rTrUrVrrMrrrBrWrrgr Z_maskr rCrrzerosZbool_ enumerater_NO_VALIDITY_BUFFERrZr,r) r0r[invalidrr=rmaskrvalidrrmsgr1r1r2rpns@     z!PandasColumn._get_validity_buffertuple[PandasBuffer, Any]c Cs|jdtjkrM|j}d}tjt|dftjd}t |D]\}}t |t r5|j dd}|t|7}|||d<q t |}tjdtjtjf}||fStd)a Return the buffer containing the offset values for variable-size binary data (e.g., variable-length strings) and the buffer's associated dtype. Raises NoBufferPresent if the data buffer does not have an associated offsets buffer. rrRrrxry@zJThis column has a fixed-length dtype so it does not have an offsets buffer)r=rrCr.rrrrgZint64rr'rrr r{rZINT64rrBr) r0r>ptrrnrvrrr=r1r1r2rqs&     z PandasColumn._get_offsets_buffer)T)r r!r"r#r$r%)r$r4)r$r9)r$ra)N)rerf)r$r)r$rs)r$r)r$r)__name__ __module__ __qualname____doc__r3r5propertyr8rr=r@rQr]r`rcrdrkrrrorprqr1r1r1r2rHs.    !        % >9r)3 __future__rtypingrrnumpyrZpandas._libs.librZpandas._libs.tslibsrZ pandas.errorsrZpandas.util._decoratorsrZpandas.core.dtypes.dtypesr Zpandasr(r r Zpandas.api.typesr Zpandas.core.interchange.bufferr rZ*pandas.core.interchange.dataframe_protocolrrrrZpandas.core.interchange.utilsrrrrr{r|r}rMrCr~rFZUSE_NANZ USE_SENTINELrXrArSrYrrr1r1r1r2sJ