U `{jK2@sdZddlmZddlZddlmZmZddlZddlm Z ddl Z ddl m Z m Z mZmZmZmZmZmZmZmZddlZddlZddlmZddlmZmZmZmZm Z dd l!m"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/ddl0m1Z1e rddl2m3Z3ddZ4ddZ5dddddZ6dddddZ7ddZ8ddd d!Z9ddd"d#Z:ddd$d%Z;ddd&d'Zedd2d-d3d/d4d1Z>dd2d-d3d/d5d1Z>dd6d-d.d7d8d9Z?d:d;Z@dd?d@ZAdddAdBZBdCddDdEZCd(ddFdGdHZDdIdJZEdKdLZFdMdNZGedOdOdPdQdRZHedSdTdPdUdRZHddVdWdXdRZHdYdZd[d\d]ZId^d_ZJd`dadbdcddZKejLdedfdgdhdiZMdjdkdldmdnZNejOejOejPejQjRejSejTjRiZUejOdoejPdpejSdqejVdrejWdsejOdoejXdoejYdtejZdtej[duej\duej]dvej^dvej_dwej`dwejadxejbdxejPdpejcdpejSdqejddqejedyejfdyejgdzejhdziZid{d|d}d~dZjddZkdddddZldddddZmdddeddkdddZndS)zh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. ) annotationsN)abc defaultdict)partial) TYPE_CHECKINGAnyCallable CollectionHashableIterableIteratorSequencecastoverload)lib) AnyArrayLike ArrayLikeNpDtype RandomStateT)find_stack_level)'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|r t|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%Q/var/www/html/bwave/python/venv/lib/python3.8/site-packages/pandas/core/common.pyr"=sr"c CsL|dj}|ddD]0}z|j|kr*d}Wqtk rDd}YqXq|S)Nr)name ValueError)Zobjsr(objr%r%r&consensus_name_attrUs   r+rbool)keyreturncCst|ttjtfs$t|rt|jr|jtjkrrt |}t |snd}t |dkrjt |rjt|dSdSt|jrdSn4t|trt|dkrt|tk rt|}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_asarrayrZ is_bool_arrayZ infer_dtyper anyr)rlistlentypeZ is_bool_list)r-Z key_arrayZna_msgr%r%r&is_bool_indexer`s*        r:F) warn_floatcCs:t|r6|r6|r.tjdtttdt |S|S)a To avoid numpy DeprecationWarnings, cast float to integer where valid. Parameters ---------- val : scalar warn_float : bool, default False If True, issue deprecation warning for a float indexer. Returns ------- outval : scalar zIndexing with a float is deprecated, and will raise an IndexError in pandas 2.0. You can manually convert to an integer key instead. stacklevel) rZis_floatrwarningswarn FutureWarningrinspect currentframeint)valr;r%r%r&cast_scalar_indexers rEcGsdd|DS)zL Returns a generator consisting of the arguments that are not None. css|]}|dk r|VqdSNr%.0argr%r%r& sznot_none..r%argsr%r%r&not_nonesrM)r.cGstdd|DS)z? Returns a boolean indicating if any argument is None. css|]}|dkVqdSrFr%rGr%r%r&rJszany_none..r6rKr%r%r&any_nonesrOcGstdd|DS)zA Returns a boolean indicating if all arguments are None. css|]}|dkVqdSrFr%rGr%r%r&rJszall_none..allrKr%r%r&all_nonesrRcGstdd|DS)zC Returns a boolean indicating if any argument is not None. css|]}|dk VqdSrFr%rGr%r%r&rJszany_not_none..rNrKr%r%r& any_not_nonesrScGstdd|DS)zE Returns a boolean indicating if all arguments are not None. css|]}|dk VqdSrFr%rGr%r%r&rJszall_not_none..rPrKr%r%r& all_not_nonesrTrCcGstdd|DS)z; Returns the count of arguments that are not None. css|]}|dk VqdSrFr%rHxr%r%r&rJsz!count_not_none..)sumrKr%r%r&count_not_nonesrX.zArrayLike | list | tuple | zipzNpDtype | Nonez np.ndarray)valuesr3r.cCsdSrFr%rYr3r%r%r&asarray_tuplesafesr[r rcCsdSrFr%rZr%r%r&r[scCst|ttfs"t|ds"t|}nt|tr2|jSt|trR|tjtfkrRt |Stj ||d}t |j j tr|tj |td}|jdkrdd|D}t |}|S)NZ __array__r3cSsg|] }t|qSr%)tuplerUr%r%r& sz%asarray_tuplesafe..)r0r7r^hasattrrZ_valuesr1r4objectrr5 issubclassr3r9strndim)rYr3resultr%r%r&r[s   znp.ndarray | Iterable)labelsr3r.cCs\t|ttfr|g}t|ttjfsLz t|}Wntk rJ|g}YnXt||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 r\)r0rcr^r7r1r2 TypeErrorr[)rfr3r%r%r&index_labels_to_arrays   rhcCs |dk rt|ttfs|gS|SrF)r0r^r7r*r%r%r&maybe_make_listsrjzIterable[T] | TzCollection[T] | T)r*r.cCs.t|tjr t|tjs t|Stt|}|S)zB If obj is Iterable but not list-like, consume into list. )r0rr Sizedr7rr rir%r%r&maybe_iterable_to_list%s rlcCs(t|to&|jdko&|jdko&|jdkS)z We have a null slice. Nr0slicestartstopsteprir%r%r& is_null_slice/s rrz list[bool]cCsdd|DS)zX Find non-trivial slices in "line": return a list of booleans with same length. cSs g|]}t|tot| qSr%)r0rnrr)rHkr%r%r&r_?sz"is_true_slices..r%)r#r%r%r&is_true_slices;srt)r#r.cCs(t|to&|jdko&|j|ko&|jdkS)z& We have a full length slice. rNrm)r*r#r%r%r& is_full_sliceCs rucCs>t|drt|dSt|tr(t|jSt|r:t|jSdS)N__name__) r`getattrr0rget_callable_namefunccallabler9rvrir%r%r&rxOs     rxcKst|r||f|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 )rz)Zmaybe_callabler*kwargsr%r%r&apply_if_callable`s  r|cCsXt|s(t|tr tt|jSt|}t|tj sDt d|n|tkrTt 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) rAisclassr0rrdefault_factoryr9rbrMappingrg)Zintor%r%r&standardize_mappingqs    rznp.random.Generator)stater.cCsdSrFr%rr%r%r& random_statesrzGint | ArrayLike | np.random.BitGenerator | np.random.RandomState | Noneznp.random.RandomStatecCsdSrFr%rr%r%r&rszRandomState | NonercCsht|st|st|tjjr*tj|St|tjjr<|St|tjjrN|S|dkr\tjStddS)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) rrr0r1randomZ BitGeneratorr Generatorr)rr%r%r&rs   z/Callable[..., T] | tuple[Callable[..., T], str]r)ryr.cOsRt|tr>|\}}||kr,|d}t||||<|||S||f||SdS)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 argumentN)r0r^r))r*ryrLr{targetmsgr%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|kr|S|SdSrFr%)rVmapperr%r&fszget_rename_function..f)r0rrr)rrr%rr&get_rename_functions rz"Hashable | Iterable | AnyArrayLikezlist | AnyArrayLike)rYr.cCs>t|ttjtttfr|St|tjr8t|t s8t|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. ) r0r7r1r2rrrrr rc)rYr%r%r&convert_to_list_like s rrczIterator[None])attrr.c cs4t||}t|||z |VW5t|||XdS)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)rwsetattr)r*rvalue old_valuer%r%r& temp_setattrs   rr!None)indexr.cCs2t|t|kr.tdt|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)r8r))datarr%r%r&require_length_match,srrWmaxminrQr6meanprodstdvarmediancumprodcumsumrz str | None)rIr.cCs t|S)zH if we define an internal function for this argument, return it ) _cython_tablegetrIr%r%r&get_cython_func_srcCs t||S)zd if we define a builtin function for this argument, return it, otherwise return the arg )_builtin_tablerrr%r%r&is_builtin_funcfsrzSequence[Hashable | None]zlist[Hashable])namesr.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|]\}}|dkrd|n|qS)NZlevel_r%)rHir(r%r%r&r_~sz&fill_missing_names..) enumerate)rr%r%r&fill_missing_namesnsrzbool | None | lib.NoDefault) numeric_onlyr.cCs&|tjkrd}n|dkrd}n|}|S)aDetermine the Boolean value of numeric_only. See GH#46560 for details on the deprecation. Parameters ---------- numeric_only : bool, None, or lib.no_default Value passed to the method. Returns ------- Resolved value of numeric_only. TNF)rZ no_default)rrer%r%r&resolve_numeric_onlys  rr9)clsr(deprecate_noner.cCsl|dkrd}nd}d|d|jd|d}|r@|d|d 7}|d |d 7}tj|tttd d S)aEmit FutureWarning message for deprecation of numeric_only. See GH#46560 for details on the deprecation. Parameters ---------- cls : type pandas type that is generating the warning. name : str Name of the method that is generating the warning. deprecate_none : bool, default False Whether to also warn about the deprecation of specifying ``numeric_only=None``. )rQr6Z bool_onlyrzThe default value of z in .z? is deprecated. In a future version, it will default to False. zIn addition, specifying 'z=None' is deprecated. z2Select only valid columns or specify the value of z to silence this warning.r<N)rvr>r?r@rrArB)rr(rZarg_namerr%r%r&deprecate_numeric_only_defaults  r)F).).)N)N)N)F)o__doc__ __future__rbuiltins collectionsrr contextlib functoolsrrAtypingrrrr r r r r rrr>numpyr1Z pandas._libsrZpandas._typingrrrrrZpandas.util._exceptionsrZpandas.core.dtypes.castrZpandas.core.dtypes.commonrrrrZpandas.core.dtypes.genericrrrZpandas.core.dtypes.inferencerZpandas.core.dtypes.missingr Zpandasr!r"r+r:rErMrOrRrSrTrXr[rhrjrlrrrtrurxr|rrrrrcontextmanagerrrrWrmaximumreducerminimumrrQr6ZnansumrZnanmeanrZnanprodrZnanstdrZnanvarrZ nanmedianZnanmaxZnanminrZ nancumprodrZ nancumsumrrrrrrr%r%r%r&s  0        7     8%