a 鴫j)D2@sdZddlmZddlZddlmZmZddlmZm 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/ddl0m1Z1ddZ2ddZ3dddddZ4ddZ5ddZ6ddddZ7ddd d!Z8ddd"d#Z9ddd$d%Z:d&dd'd(Z;edd*d+d,d-d.d/Zd:d;d<d=d>Z?ddd?d@Z@dddAdBZAdCddDdEZBd&ddFdGdHZCdIdJZDdKdLZEdMdNZFedOdOdPdQdRZGedSdTdPdUdRZGddVdWdXdRZGdYdZd[d\d]ZHd^d_ZId`dadbdcddZJe jKddfddgdhdidjZLdkdldmdndoZMejNejNejOejPjQejRejSjQiZTejNdpejOdqejRdriZUejNdsejOdtejRduejVdvejWdwejNdsejXdsejYdxejZdxej[dyej\dyej]dzej^dzej_d{ej`d{ejad|ejbd|ejOdtejcdtejRduejdduejed}ejfd}ejgd~ejhd~iZidddddZjddZkdddddZldS)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)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/laksyashrimp/venv/lib/python3.9/site-packages/pandas/core/common.pyr >sr c CsJ|dj}|ddD].}z|j|kr*d}WqtyBd}Yq0q|S)Nr)name ValueError)objsr&objr#r#r$consensus_name_attrVs    r*r bool)keyreturncCst|ttjttfrpt|tsp|jtjkr`t |}t |s\d}t j |ddrXt |dSdSt |jrdSn4t|trt|dkrt|turt|}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 valuesT)ZskipnaFr) isinstancernpndarrayrrrdtypeobject_asarrayrZ is_bool_arrayr'rlistlentypeZ is_bool_list)r,Z key_arrayZna_msgr#r#r$is_bool_indexeras*        r7cCst|r|rtd|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.)rZis_floatr IndexError)valr#r#r$cast_scalar_indexers r:cGsdd|DS)zL Returns a generator consisting of the arguments that are not None. css|]}|dur|VqdSNr#.0argr#r#r$ znot_none..r#argsr#r#r$not_nonesrC)r-cGstdd|DS)z? Returns a boolean indicating if any argument is None. css|]}|duVqdSr;r#r<r#r#r$r?r@zany_none..anyrAr#r#r$any_nonesrFcGstdd|DS)zA Returns a boolean indicating if all arguments are None. css|]}|duVqdSr;r#r<r#r#r$r?r@zall_none..allrAr#r#r$all_nonesrIcGstdd|DS)zC Returns a boolean indicating if any argument is not None. css|]}|duVqdSr;r#r<r#r#r$r?r@zany_not_none..rDrAr#r#r$ any_not_nonesrJcGstdd|DS)zE Returns a boolean indicating if all arguments are not None. css|]}|duVqdSr;r#r<r#r#r$r?r@zall_not_none..rGrAr#r#r$ all_not_nonesrKintcGstdd|DS)z; Returns the count of arguments that are not None. css|]}|duVqdSr;r#r=xr#r#r$r?r@z!count_not_none..)sumrAr#r#r$count_not_nonesrP.zArrayLike | list | tuple | zipzNpDtype | Nonez np.ndarray)valuesr1r-cCsdSr;r#rQr1r#r#r$asarray_tuplesafesrSrrcCsdSr;r#rRr#r#r$rSscCs t|ttfs"t|ds"t|}n t|tr2|jSt|trB|jSt|trb|tjt fvrbt |SzLt 0t st dtjtj||d}Wdn1s0YWntyt |YS0t|jjtrtj|t d}|jdkrdd|D}t |}|S)NZ __array__ignorer1cSsg|] }t|qSr#)tuplerMr#r#r$ r@z%asarray_tuplesafe..)r.r4rWhasattrrZ_valuesrr/r2objectrwarningscatch_warningsr simplefilterZVisibleDeprecationWarningr3r' issubclassr1r6strndim)rQr1resultr#r#r$rSs*    0  znp.ndarray | Iterable)labelsr1r-cCsZt|ttfr|g}t|ttjfsJz t|}WntyH|g}Yn0t||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 rU)r.r_rWr4r/r0 TypeErrorrS)rbr1r#r#r$index_labels_to_array s    rdcCs |durt|ttfs|gS|Sr;)r.rWr4r)r#r#r$maybe_make_list'srfzIterable[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. )r.rrSizedr4rrrer#r#r$maybe_iterable_to_list-s rhcCs(t|to&|jduo&|jduo&|jduS)z We have a null slice. Nr.slicestartstopsteprer#r#r$ is_null_slice7s rncCs*t|to(|jduo(|jduo(|j|jkS)z> We have an empty slice, e.g. no values are selected. N)r.rjrkrlrer#r#r$is_empty_sliceCs  roz list[bool]cCsdd|DS)zX Find non-trivial slices in "line": return a list of booleans with same length. cSs g|]}t|tot| qSr#)r.rjrn)r=kr#r#r$rXSr@z"is_true_slices..r#)r!r#r#r$is_true_slicesOsrq)r!r-cCs(t|to&|jdko&|j|ko&|jduS)z& We have a full length slice. rNri)r)r!r#r#r$ is_full_sliceWs rrcCs>t|drt|dSt|tr(t|jSt|r:t|jSdS)N__name__) rYgetattrr.r get_callable_namefunccallabler6rsrer#r#r$rucs     rucKst|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 )rw)Zmaybe_callabler)kwargsr#r#r$apply_if_callablets rycCsVt|s(t|tr tt|jSt|}t|tj sBt d||tkrRt 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) inspectisclassr.rr default_factoryr6r^rMappingrc)Zintor#r#r$standardize_mappings    r~znp.random.Generator)stater-cCsdSr;r#rr#r#r$ random_statesrzHint | np.ndarray | np.random.BitGenerator | np.random.RandomState | Noneznp.random.RandomStatecCsdSr;r#rr#r#r$rszRandomState | NonercCsft|st|tjtjjfr(tj|St|tjjr:|St|tjjrL|S|durZtjStddS)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) rr.r/r0randomZ BitGeneratorrrr'rr#r#r$rs z/Callable[..., T] | tuple[Callable[..., T], str]r)rvr-cOs\t|trB|\}}||vr,|d}t||||<||i|S||g|Ri|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)r.rWr')r)rvrBrxtargetmsgr#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|SdSr;r#)rNmapperr#r$fszget_rename_function..f)r.rr}r)rrr#rr$get_rename_functions rz"Hashable | Iterable | AnyArrayLikezlist | AnyArrayLike)rQr-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. ) r.r4r/r0rrrrrr_)rQr#r#r$convert_to_list_likes rTr_zGenerator[None, None, None])attr conditionr-c csL|rt||}t|||z|VW|rHt|||n|rFt|||0dS)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)rtsetattr)r)rvaluer old_valuer#r#r$ temp_setattrs  rrNone)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)r5r')datarr#r#r$require_length_match8srznp.sumznp.maximum.reduceznp.minimum.reducerOmaxminrHrEmeanprodstdvarmediancumprodcumsumr z str | None)r>r-cCs t|S)zH if we define an internal function for this argument, return it ) _cython_tablegetr>r#r#r$get_cython_funcrsrcCs t||S)zd if we define a builtin function for this argument, return it, otherwise return the arg )_builtin_tablerrr#r#r$is_builtin_funcysrzSequence[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|]\}}|durd|n|qS)NZlevel_r#)r=ir&r#r#r$rXr@z&fill_missing_names..) enumerate)rr#r#r$fill_missing_namessr).).)N)N)N)T)m__doc__ __future__rbuiltins collectionsrrcollections.abcrrrrr contextlib functoolsr rztypingr r r rrr[numpyr/Z pandas._libsrZpandas.compat.numpyrZpandas.core.dtypes.castrZpandas.core.dtypes.commonrrZpandas.core.dtypes.genericrrrrZpandas.core.dtypes.inferencerZpandas._typingrrrrrZpandasrr r*r7r:rCrFrIrJrKrPrSrdrfrhrnrorqrrruryr~rrrrcontextmanagerrrrOrmaximumreducerminimumrZ_builtin_table_aliasrHrEZnansumrZnanmeanrZnanprodrZnanstdrZnanvarrZ nanmedianZnanmaxZnanminrZ nancumprodrZ nancumsumrrrrr#r#r#r$s        7 $     #%