o dE@sTdZddlmZddlZddlmZmZddlZddlm Z ddl Z ddl m Z m Z mZmZmZmZmZmZmZmZddlZddlZddlmZddlmZmZmZmZm Z dd l!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*m+Z+dd l,m-Z-dd l.m/Z/e rddl0m1Z1ddZ2ddZ3dddZ4ddZ5ddZ6dddZ7ddd Z8dd!d"Z9dd#d$Z:dd&d'Z;e (ddd.d/Zdd=d>Z?dd?d@Z@ddAdBZAddDdEZBddGdHZCdIdJZDdKdLZEdMdNZFeddQdRZGeddUdRZGdddWdRZGdd[d\ZHd]d^ZIddadbZJejKddfdgZLddkdlZMejNejNejOejPjQejRejSjQiZTiejNdmejOdnejRdoejUdpejVdqejNdmejWdmejXdrejYdrejZdsej[dsej\dtej]dtej^duej_duej`dvejadvejOdnejbdnejRdoejcdoejddwejedwejfdxejgdxiZhdd|d}Zid~dZjdddZkdS)zh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. ) annotationsN)abc defaultdict)partial) TYPE_CHECKINGAnyCallable Collection GeneratorHashableIterableSequencecastoverload)lib) AnyArrayLike ArrayLikeNpDtype RandomStateT)'construct_1d_object_array_from_listlike) is_array_like is_bool_dtypeis_extension_array_dtype is_integer)ABCExtensionArrayABCIndex ABCSeries)iterable_not_string)isna)Indexccs.|D]}t|rt|EdHq|VqdS)a Flatten an arbitrarily nested sequence. Parameters ---------- line : sequence The non string sequence to flatten Notes ----- This doesn't consider strings sequences. Returns ------- flattened : generator N)rflatten)lineelementr$W/var/www/html/visualizacion-main/env/lib/python3.10/site-packages/pandas/core/common.pyr!<s r!c CsH|dj}|ddD]}z |j|krd}Wq ty!d}Yq w|S)Nr)name ValueError)objsr'objr$r$r%consensus_name_attrTs   r+keyrreturnboolcCst|ttjtfst|rBt|jrB|jtjkr9t |}t |s7d}t |dkr5t |r5t|dSdSt|jr@dSdSt|tr\t|dkr\t|turWt|}t |SdS)a Check whether `key` is a valid boolean indexer. Parameters ---------- key : Any Only list-likes may be considered boolean indexers. All other types are not considered a boolean indexer. For array-like input, boolean ndarrays or ExtensionArrays with ``_is_boolean`` set are considered boolean indexers. Returns ------- bool Whether `key` is a valid boolean indexer. Raises ------ ValueError When the array is an object-dtype ndarray or ExtensionArray and contains missing values. See Also -------- check_array_indexer : Check that `key` is a valid array to index, and convert to an ndarray. z=Cannot mask with non-boolean array containing NA / NaN valuesbooleanFTr) isinstancernpndarrayrrrdtypeobject_asarrayr is_bool_array infer_dtyperanyr(rlistlentype is_bool_list)r, key_arrayna_msgr$r$r%is_bool_indexer_s,       r?cCst|r |r td|S)z Disallow indexing with a float key, even if that key is a round number. Parameters ---------- val : scalar Returns ------- outval : scalar zYIndexing with a float is no longer supported. Manually convert to an integer key instead.)ris_floatr IndexError)valr$r$r%cast_scalar_indexers  rCcGdd|DS)zL Returns a generator consisting of the arguments that are not None. css|] }|dur|VqdSNr$.0argr$r$r% sznot_none..r$argsr$r$r%not_nonerLcGtdd|DS)z? Returns a boolean indicating if any argument is None. cs|]}|duVqdSrEr$rFr$r$r%rIzany_none..r8rJr$r$r%any_nonerRcGrN)zA Returns a boolean indicating if all arguments are None. csrOrEr$rFr$r$r%rIrPzall_none..allrJr$r$r%all_nonerSrVcGrN)zC Returns a boolean indicating if any argument is not None. cs|]}|duVqdSrEr$rFr$r$r%rIrPzany_not_none..rQrJr$r$r% any_not_nonerSrXcGrN)zE Returns a boolean indicating if all arguments are not None. csrWrEr$rFr$r$r%rIrPzall_not_none..rTrJr$r$r% all_not_nonerSrYintcGrN)z; Returns the count of arguments that are not None. csrWrEr$rGxr$r$r%rIrPz!count_not_none..)sumrJr$r$r%count_not_nonerSr^.valuesArrayLike | list | tuple | zipr3NpDtype | None np.ndarraycCdSrEr$r_r3r$r$r%asarray_tuplesafesrer rcCrcrEr$rdr$r$r%recCst|ttfst|dst|}nt|tr|jSt|tr)|tjtfvr)t |Sz$t t dtj tj||d}Wdn1sGwYWn tyZt |YSwt|jjtritj|td}|jdkrydd|D}t |}|S)N __array__ignorer3cSsg|]}t|qSr$)tupler[r$r$r% sz%asarray_tuplesafe..)r0r9rkhasattrr_valuesr1r4objectrwarningscatch_warnings simplefilterVisibleDeprecationWarningr5r( issubclassr3r;strndim)r_r3resultr$r$r%res*      labelsnp.ndarray | IterablecCsZt|ttfr |g}t|ttjfs%zt|}Wn ty$|g}Ynwt||d}|S)z Transform label or iterable of labels to array, for use in Index. Parameters ---------- dtype : dtype If specified, use as dtype of the resulting array, otherwise infer. Returns ------- array ri)r0rurkr9r1r2 TypeErrorre)rxr3r$r$r%index_labels_to_arrays    r{cCs |durt|ttfs|gS|SrE)r0rkr9r*r$r$r%maybe_make_list"sr}r*Iterable[T] | TCollection[T] | TcCs.t|tjrt|tjst|Stt|}|S)zB If obj is Iterable but not list-like, consume into list. )r0rr Sizedr9rr r|r$r$r%maybe_iterable_to_list(s rcCs(t|to|jduo|jduo|jduS)z We have a null slice. Nr0slicestartstopstepr|r$r$r% is_null_slice2 rcCs*t|to|jduo|jduo|j|jkS)z> We have an empty slice, e.g. no values are selected. N)r0rrrr|r$r$r%is_empty_slice>s  r list[bool]cCrD)zX Find non-trivial slices in "line": return a list of booleans with same length. cSs g|] }t|to t| qSr$)r0rr)rGkr$r$r%rlNs z"is_true_slices..r$)r"r$r$r%is_true_slicesJrMrr"cCs(t|to|jdko|j|ko|jduS)z& We have a full length slice. rNr)r*r"r$r$r% is_full_sliceRrrcCs>t|dr t|dSt|trt|jSt|rt|jSdS)N__name__) rmgetattrr0rget_callable_namefunccallabler;rr|r$r$r%r^s     rcKst|r ||fi|S|S)z Evaluate possibly callable input using obj and kwargs if it is callable, otherwise return as it is. Parameters ---------- maybe_callable : possibly a callable obj : NDFrame **kwargs )r)maybe_callabler*kwargsr$r$r%apply_if_callableos rcCsVt|st|trtt|jSt|}t|tj s!t d||tkr)t d|S)a Helper function to standardize a supplied mapping. Parameters ---------- into : instance or subclass of collections.abc.Mapping Must be a class, an initialized collections.defaultdict, or an instance of a collections.abc.Mapping subclass. Returns ------- mapping : a collections.abc.Mapping subclass or other constructor a callable object that can accept an iterator to create the desired Mapping. See Also -------- DataFrame.to_dict Series.to_dict zunsupported type: z/to_dict() only accepts initialized defaultdicts) inspectisclassr0rrdefault_factoryr;rtrMappingrz)intor$r$r%standardize_mappings    rstatenp.random.GeneratorcCrcrEr$rr$r$r% random_staterfrGint | ArrayLike | np.random.BitGenerator | np.random.RandomState | Nonenp.random.RandomStatecCrcrEr$rr$r$r%rsRandomState | NonecCsdt|st|st|tjjrtj|St|tjjr|St|tjjr'|S|dur.tjStd)a Helper function for processing random_state arguments. Parameters ---------- state : int, array-like, BitGenerator, Generator, np.random.RandomState, None. If receives an int, array-like, or BitGenerator, passes to np.random.RandomState() as seed. If receives an np.random RandomState or Generator, just returns that unchanged. If receives `None`, returns np.random. If receives anything else, raises an informative ValueError. .. versionchanged:: 1.1.0 array-like and BitGenerator object now passed to np.random.RandomState() as seed Default None. Returns ------- np.random.RandomState or np.random.Generator. If state is None, returns np.random Nzdrandom_state must be an integer, array-like, a BitGenerator, Generator, a numpy RandomState, or None) rrr0r1random BitGeneratorrr r(rr$r$r%rs   r/Callable[..., T] | tuple[Callable[..., T], str]rcOsXt|tr!|\}}||vr|d}t||||<||i|S||g|Ri|S)as Apply a function ``func`` to object ``obj`` either by passing obj as the first argument to the function or, in the case that the func is a tuple, interpret the first element of the tuple as a function and pass the obj to that function as a keyword argument whose key is the value of the second element of the tuple. Parameters ---------- func : callable or tuple of (callable, str) Function to apply to this object or, alternatively, a ``(callable, data_keyword)`` tuple where ``data_keyword`` is a string indicating the keyword of ``callable`` that expects the object. *args : iterable, optional Positional arguments passed into ``func``. **kwargs : dict, optional A dictionary of keyword arguments passed into ``func``. Returns ------- object : the return type of ``func``. z/ is both the pipe target and a keyword argument)r0rkr()r*rrKrtargetmsgr$r$r%pipes  rcs$fdd}ttjtfr|SS)zv Returns a function that will map names/labels, dependent if mapper is a dict, Series or just a function. cs|vr|S|SrEr$)r\mapperr$r%fszget_rename_function..f)r0rrr)rrr$rr%get_rename_function s r"Hashable | Iterable | AnyArrayLikelist | AnyArrayLikecCs>t|ttjtttfr |St|tjrt|t st|S|gS)z Convert list-like or scalar input to list-like. List, numpy and pandas array-like inputs are returned unmodified whereas others are converted to list. ) r0r9r1r2rrrrr ru)r_r$r$r%convert_to_list_likes rattrruGenerator[None, None, None]c cs@t||}t|||z |VWt|||dSt|||w)zTemporarily set attribute on an object. Args: obj: Object whose attribute will be modified. attr: Attribute to modify. value: Value to temporarily set attribute to. Yields: obj with modified attribute. N)rsetattr)r*rvalue old_valuer$r$r% temp_setattr's  rindexr NonecCs2t|t|krtdt|dt|ddS)zC Check the length of data matches the length of the index. zLength of values (z") does not match length of index ()N)r:r()datarr$r$r%require_length_match;srr]maxminrUr8meanprodstdvarmediancumprodcumsumrHr str | NonecCs t|S)zH if we define an internal function for this argument, return it ) _cython_tablegetrHr$r$r%get_cython_funcns rcCs t||S)zd if we define a builtin function for this argument, return it, otherwise return the arg )_builtin_tablerrr$r$r%is_builtin_funcus rnamesSequence[Hashable | None]list[Hashable]cCsddt|DS)a, If a name is missing then replace it by level_n, where n is the count .. versionadded:: 1.4.0 Parameters ---------- names : list-like list of column names or None values. Returns ------- list list of column names with the None values replaced. cSs&g|]\}}|durd|n|qS)Nlevel_r$)rGir'r$r$r%rls&z&fill_missing_names..) enumerate)rr$r$r%fill_missing_names}sr)r,rr-r.)r-r.)r-rZ).)r_r`r3rar-rb)r_r r3rar-rrE)rxryr3rar-rb)r*r~r-r)r-r)r"rZr-r.)rrr-r)rrr-r)rr)rrr-r)r_rr-r)rrur-r)rr r-r)rHrr-r)rrr-r)l__doc__ __future__rbuiltins collectionsrr contextlib functoolsrrtypingrrrr r r r r rrrpnumpyr1 pandas._libsrpandas._typingrrrrrpandas.core.dtypes.castrpandas.core.dtypes.commonrrrrpandas.core.dtypes.genericrrrpandas.core.dtypes.inferencerpandas.core.dtypes.missingrpandasr r!r+r?rCrLrRrVrXrYr^rer{r}rrrrrrrrrrrrcontextmanagerrrr]rmaximumreducerminimumrrUr8nansumrnanmeanrnanprodrnanstdrnanvarr nanmediannanmaxnanminr nancumprodr nancumsumrrrrr$r$r$r%s  0       7       !        8%