bMh)DdZddlmZddlZddlmZmZddlmZm Z m Z m Z m Z ddl Z ddlmZddlZddlmZmZmZmZmZddlZddlZddlmZdd lmZdd lmZdd l m!Z!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)erddl*m+Z+m,Z,m-Z-m.Z.m/Z/ddl0m1Z1dZ2dZ3dmdZ4dZ5dZ6dndZ7dndZ8dndZ9dndZ:dodZ;e dpdqd%Zdud1Z?dnd2Z@dnd3ZAdvd5ZBdwd7ZCd8ZDd9ZEd:ZFedxd=ZGedyd@ZGdsdzdBZGd{dFZHdGZId|dJZJe jK d}d~dPZLddTZMejNejNejOejPjQejRejSjQiZTejNdUejOdVejRdWiZUiejNdXejOdYejRdZejVd[ejWd\ejNdXejXdXejYd]ejZd]ej[d^ej\d^ej]d_ej^d_ej_d`ej`d`ejadaejbdaejOdYejcdYejRdZejddZejedbejfdbejgdcejhdciZiddgZjdhZkddlZldS)zh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. ) annotationsN)abc defaultdict) Collection GeneratorHashableIterableSequence)partial) TYPE_CHECKINGAnyCallablecastoverload)lib)np_version_gte1p24)'construct_1d_object_array_from_listlike) is_bool_dtype is_integer)ABCExtensionArrayABCIndex ABCMultiIndex ABCSeries)iterable_not_string) AnyArrayLike ArrayLikeNpDtype RandomStateT)Indexc#fK|D]+}t|rt|Ed{V'|V,dS)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)lineelements R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/pandas/core/common.pyr"r">s_" w ' ' w'' ' ' ' ' ' ' ' 'MMMM cz|dj}|ddD]"} |j|krd}#t$rd}YwxYw|S)Nr)name ValueError)objsr)objs r%consensus_name_attrr-Vse 7znot_none..s" 3 3C3?C???? 3 3r&rIargss r%not_nonerPs 4 34 3 3 33r&c4td|DS)z? Returns a boolean indicating if any argument is None. c3K|]}|duV dSrHrIrJs r%rMzany_none..&++ssd{++++++r&anyrNs r%any_nonerV! ++d+++ + ++r&c4td|DS)zA Returns a boolean indicating if all arguments are None. c3K|]}|duV dSrHrIrJs r%rMzall_none..rSr&allrNs r%all_noner\rWr&c4td|DS)zC Returns a boolean indicating if any argument is not None. c3K|]}|duV dSrHrIrJs r%rMzany_not_none..&//3s$//////r&rTrNs r% any_not_noner`! //$/// / //r&c4td|DS)zE Returns a boolean indicating if all arguments are not None. c3K|]}|duV dSrHrIrJs r%rMzall_not_none..r_r&rZrNs r% all_not_nonerdrar&intc4td|DS)z; Returns the count of arguments that are not None. c3K|]}|duV dSrHrIrKxs r%rMz!count_not_none..s&++q}++++++r&)sumrNs r%count_not_nonerkrWr&.valuesArrayLike | list | tuple | zipr6NpDtype | None np.ndarraycdSrHrIrlr6s r%asarray_tuplesaferrs Cr&r rcdSrHrIrqs r%rrrrCr&c0t|ttfs t|dst|}n8t|tr|jSt|t r|jSt|tr$|tjtfvrt|S tj 5tstjdtjtj||}dddn #1swxYwYn#t"$rt|cYSwxYwt%|jjt*rtj|t}|jdkrd|D}t|}|S)N __array__ignorer6c,g|]}t|SrI)tuplerhs r% z%asarray_tuplesafe..s+++q%((+++r&)r3r:r{hasattrr_valuesrr4r7objectrwarningscatch_warningsr simplefilterVisibleDeprecationWarningr8r* issubclassr6r<strndim)rlr6results r%rrrrs ve} - -1M1Mf FH % %~ FI & &~&$?Ebj&-A$A$A6v>>> ?  $ & & 5 5% N%h0LMMMZe444F  5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 ??? 7v>>>>> ?&,#S))2F&111 {a++F+++8@@ Ms6/D=D ? D DDDDD32D3labelsnp.ndarray | Iterablect|ttfr|g}t|ttjfs$ t|}n#t $r|g}YnwxYwt||}|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 rx)r3rr{r:r4r5 TypeErrorrr)rr6s r%index_labels_to_arrayr s&3,'' ftRZ0 1 1 &\\FF   XFFF vU 3 3 3F MsA A"!A"cH|t|ttfs|gS|SrH)r3r{r:r,s r%maybe_make_listr's% z#t}==u Jr&r,Iterable[T] | TCollection[T] | Tct|tjr)t|tjst |St t |}|S)zB If obj is Iterable but not list-like, consume into list. )r3rr Sizedr:rrrs r%maybe_iterable_to_listr-sK#s|$$ZSY-G-GCyy z3  C Jr&cbt|to|jduo|jduo|jduS)z We have a null slice. Nr3slicestartstopsteprs r% is_null_slicer7sE 3  I   H   H  r&cpt|to!|jduo|jduo|j|jkS)z> We have an empty slice, e.g. no values are selected. N)r3rrrrs r%is_empty_slicerCsG 3 " IT ! " HD  " I ! r& list[bool]cd|DS)zX Find non-trivial slices in "line": return a list of booleans with same length. cXg|]'}t|tot| (SrI)r3rr)rKks r%r|z"is_true_slices..Ss2 H H HaJq% 9q)9)9%9 H H Hr&rI)r#s r%is_true_slicesrOs I H4 H H HHr&r#cjt|to|jdko|j|ko|jduS)z& We have a full length slice. rNr)r,r#s r% is_full_slicerWsD 3  IN  H   H  r&ct|drt|dSt|trt |jSt |rt|jSdS)N__name__) r}getattrr3r get_callable_namefunccallabler<rrs r%rrcsjsJ(sJ'''#w+ ***}}"Cyy!! 4r&c 6t|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,kwargss r%apply_if_callablerts2-~c,,V,,, r&c6tj|s>t|trt t|jSt |}t|tj std||tkrtd|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) inspectisclassr3rr default_factoryr<rrMappingr)intos r%standardize_mappingrs* ?4  dK ( ( >;(<== =Dzz dCK ( (53T33444 {IJJJ Kr&statenp.random.GeneratorcdSrHrIrs r% random_staterrtr&Hint | np.ndarray | np.random.BitGenerator | np.random.RandomState | Nonenp.random.RandomStatecdSrHrIrs r%rrs Cr&RandomState | Nonecrt|s+t|tjtjjfrtj|St|tjjr|St|tjjr|S| tjStd)aq 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. 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) rr3r4r5random BitGeneratorrrr*rs r%rrs(%  Jurz29;Q.RSS  y$$U+++ E290 1 1   E29. / /  y +   r&r/Callable[..., T] | tuple[Callable[..., T], str]rct|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)r3r{r*)r,rrOrtargetmsgs r%pipers4$* f V  LLLCS// !vtT$V$$$tC)$)))&)))r&cXfd}ttjtfr|nS)zv Returns a function that will map names/labels, dependent if mapper is a dict, Series or just a function. c |vr|S|SrHrI)rimappers r%fzget_rename_function..fs ;;!9 Hr&)r3rrr)rrs` r%get_rename_functionrs>  6CK#;<< H11&Hr&"Hashable | Iterable | AnyArrayLikelist | AnyArrayLikect|ttjtt t fr|St|tjr$t|tst|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. ) r3r:r4r5rrrrr r)rls r%convert_to_list_likersa&4XyBSTUU FCL ) )*VS2I2IF|| 8Or&Tattrr conditionGenerator[None, None, None]c#K|r!t||}t||| |V|rt|||dSdS#|rt|||wwxYw)a Temporarily set attribute on an object. Parameters ---------- obj : object Object whose attribute will be modified. attr : str Attribute to modify. value : Any Value to temporarily set attribute to. condition : bool, default True Whether to set the attribute. Provided in order to not have to conditionally use this context manager. Yields ------ object : obj with modified attribute. N)rsetattr)r,rvaluer old_values r% temp_setattrrs."C&& T5!!!*  * Cy ) ) ) ) ) * *9 * Cy ) ) ) ) *s AAindexr Nonect|t|kr0tdt|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*)datars r%require_length_matchr8sg 4yyCJJ D   E       r&znp.sumznp.maximum.reduceznp.minimum.reducerjmaxminr[rUmeanprodstdvarmediancumprodcumsumrLr str | Nonec6t|S)zH if we define an internal function for this argument, return it ) _cython_tablegetrLs r%get_cython_funcrrs   S ! !!r&c8t||S)zd if we define a builtin function for this argument, return it, otherwise return the arg )_builtin_tablerrs r%is_builtin_funcrys   c3 ' ''r&namesSequence[Hashable | None]list[Hashable]c4dt|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. c&g|]\}}|d|n|S)Nlevel_rI)rKir)s r%r|z&fill_missing_names..s* S S Swq$DLLQLLLd S S Sr&) enumerate)rs r%fill_missing_namesrs! T S)EBRBR S S SSr&)r.r r/r0)r/r0)r/re).)rlrmr6rnr/ro)rlr r6rnr/rrH)rrr6rnr/ro)r,rr/r)r/r)r#rer/r0)rrr/r)rrr/r)rr)rrr/r)rlrr/r)T)rrrr0r/r)rr r/r)rLrr/r)rrr/r)m__doc__ __future__rbuiltins collectionsrrcollections.abcrrrr r contextlib functoolsr rtypingr r rrrrnumpyr4 pandas._libsrpandas.compat.numpyrpandas.core.dtypes.castrpandas.core.dtypes.commonrrpandas.core.dtypes.genericrrrrpandas.core.dtypes.inferencerpandas._typingrrrrrpandasr r"r-r@rErPrVr\r`rdrkrrrrrrrrrrrrrrrrcontextmanagerrrrjrmaximumreducerminimumr_builtin_table_aliasr[rUnansumrnanmeanrnanprodrnanstdrnanvarr nanmediannanmaxnanminr nancumprodr nancumsumrrrrrIr&r%rs #"""""222222KKKKKK =<<<<< 04444n,444,,,,,,,,00000000,,,, DG        H<@:         IIII    ""@          F"*"*"*"*J I I I     -1*****@     " L"& L"*# L"*# L( L% L%  L% L% L%FE  FE  FE IuGVJGVJFEIuFEIu Ix!"L(#$FEIuFEIuJ M9IxL(3 :""""(((TTTTTTr&