ó šxŠ\c@sIdZddlZddlmZmZddlmZddlZddlZddl m Z m Z ddl j Z ddl mZmZmZddlmZddlmZmZmZmZdd lmZmZmZdd lmZdd lmZm Z m!Z!d e"fd „ƒYZ#de$fd„ƒYZ%d„Z&d„Z'd„Z(d„Z)e j*Z*d„Z+d„Z,d„Z-d„Z.d„Z/d„Z0d„Z1d„Z2d„Z3d„Z4dd„Z6dd„Z7d „Z8d!„Z9d"„Z:d#„Z;d$„Z<d%„Z=d&„Z>d'„Z?d(„Z@dd)„ZAd*„ZBd+„ZCdS(,sh Misc tools for implementing data structures Note: pandas.core.common is *not* part of the public API. iÿÿÿÿN(tdatetimet timedelta(tpartial(tlibttslibs(tPY36t OrderedDictt iteritems(t'construct_1d_object_array_from_listlike(t is_array_liket is_bool_dtypetis_extension_array_dtypet is_integer(tABCIndext ABCIndexClasst ABCSeries(t_iterable_not_string(tisnatisnulltnotnulltSettingWithCopyErrorcBseZRS((t__name__t __module__(((s1lib/python2.7/site-packages/pandas/core/common.pyRstSettingWithCopyWarningcBseZRS((RR(((s1lib/python2.7/site-packages/pandas/core/common.pyRsccsEx>|D]6}t|ƒr8x!t|ƒD] }|Vq&Wq|VqWdS(süFlatten an arbitrarily nested sequence. Parameters ---------- l : sequence The non string sequence to flatten Notes ----- This doesn't consider strings sequences. Returns ------- flattened : generator N(Rtflatten(tltelts((s1lib/python2.7/site-packages/pandas/core/common.pyR"s    cCs\|dj}xH|dD]<}y|j|kr9d}nWqtk rSd}qXqW|S(Nii(tnametNonet ValueError(tobjsRtobj((s1lib/python2.7/site-packages/pandas/core/common.pytconsensus_name_attr:s   cCs't|tjƒr#||j|ƒS|S(N(t isinstancetnptndarraytget_loc(tindexertvaluesR tkey((s1lib/python2.7/site-packages/pandas/core/common.pyt maybe_boxEscCsXt|tjtfƒr*tj|ƒ}n*t|tjtfƒrTtj|ƒ}n|S(N( R"R#t datetime64RRt Timestampt timedelta64Rt Timedelta(tvalue((s1lib/python2.7/site-packages/pandas/core/common.pytmaybe_box_datetimelikeOs cCsMd}t|ttjtfƒs<t|ƒrçt|jƒrç|jtjkr›tj t |ƒƒ}t j |ƒs—t |ƒjƒr“t|ƒ‚ntStSt|jƒrIt|jƒràtj|j ƒƒràt|ƒ‚qàntSnbt|tƒrIy;tj |ƒ}|jtjko/t|ƒt|ƒkSWqItk rEtSXntS(s 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 Raises ------ ValueError When the array is an object-dtype ndarray or ExtensionArray and contains missing values. s3cannot index with vector containing NA / NaN values(R"RR#R$R R R tdtypetobject_tasarraytvalues_from_objectRt is_bool_arrayRtanyRtFalsetTrueR tlisttbool_tlent TypeError(R(tna_msgtarr((s1lib/python2.7/site-packages/pandas/core/common.pytis_bool_indexer]s,, cCs/tj|ƒr+|t|ƒkr+t|ƒS|S(s­ To avoid numpy DeprecationWarnings, cast float to integer where valid. Parameters ---------- val : scalar Returns ------- outval : scalar (Rtis_floattint(tval((s1lib/python2.7/site-packages/pandas/core/common.pytcast_scalar_indexers ! cGsd„|DƒS(sAReturns a generator consisting of the arguments that are not Nonecss!|]}|dk r|VqdS(N(R(t.0targ((s1lib/python2.7/site-packages/pandas/core/common.pys ¤s((targs((s1lib/python2.7/site-packages/pandas/core/common.pyt _not_none¢scGs%x|D]}|dkrtSqWtS(s4Returns a boolean indicating if any argument is NoneN(RR7R6(RERD((s1lib/python2.7/site-packages/pandas/core/common.pyt _any_none§s  cGs%x|D]}|dk rtSqWtS(s6Returns a boolean indicating if all arguments are NoneN(RR6R7(RERD((s1lib/python2.7/site-packages/pandas/core/common.pyt _all_none¯s  cGs%x|D]}|dk rtSqWtS(s8Returns a boolean indicating if any argument is not NoneN(RR7R6(RERD((s1lib/python2.7/site-packages/pandas/core/common.pyt _any_not_none·s  cGs%x|D]}|dkrtSqWtS(s:Returns a boolean indicating if all arguments are not NoneN(RR6R7(RERD((s1lib/python2.7/site-packages/pandas/core/common.pyt _all_not_none¿s  cGstd„|DƒƒS(s0Returns the count of arguments that are not Nonecss|]}|dk VqdS(N(R(RCtx((s1lib/python2.7/site-packages/pandas/core/common.pys És(tsum(RE((s1lib/python2.7/site-packages/pandas/core/common.pytcount_not_noneÇscCs3t|ƒ}yt|ƒSWntk r.|SXdS(N(R8tsortedt Exception(titerabletlisted((s1lib/python2.7/site-packages/pandas/core/common.pyttry_sortÌs   cCs:tst|tƒr*t|jƒƒ}n t|ƒ}|S(N(RR"RR8tkeysRR(tmappingRS((s1lib/python2.7/site-packages/pandas/core/common.pytdict_keys_to_ordered_listÔs cCsýt|ttfƒp!t|dƒs3t|ƒ}nt|tƒrI|jSt|tƒrw|tjtgkrwt |ƒStj |d|ƒ}t |j j tjƒr¼tj |dtƒ}n|jdkrùg|D]}t|ƒ^qÒ}t |ƒ}n|S(Nt __array__R0i(R"R8ttuplethasattrRR'R#R1tobjectRR2t issubclassR0ttypetcompatt string_typestndim(R'R0tresultRK((s1lib/python2.7/site-packages/pandas/core/common.pytasarray_tuplesafeÞs$$ cCs‚t|tjtfƒr$|g}nt|ttjfƒslyt|ƒ}Wqltk rh|g}qlXnt|d|ƒ}|S(së 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 R0( R"R\R]RWR8R#R$R;R`(tlabelsR0((s1lib/python2.7/site-packages/pandas/core/common.pytindex_labels_to_arrayös   cCs-|dk r)t|ttfƒ r)|gS|S(N(RR"RWR8(R ((s1lib/python2.7/site-packages/pandas/core/common.pytmaybe_make_lists"cCs:t|tƒo9|jdko9|jdko9|jdkS(s we have a null slice N(R"tslicetstartRtstoptstep(R ((s1lib/python2.7/site-packages/pandas/core/common.pyt is_null_slicescCs-g|D]"}t|tƒo&t|ƒ ^qS(sU Find non-trivial slices in "l": return a list of booleans with same length. (R"RdRh(Rtk((s1lib/python2.7/site-packages/pandas/core/common.pytis_true_slicesscCs:t|tƒo9|jdko9|j|ko9|jdkS(s we have a full length slice iN(R"RdReRfRgR(R R((s1lib/python2.7/site-packages/pandas/core/common.pyt is_full_slice%s-cCsUt|dƒrt|dƒSt|tƒr8t|jƒSt|dƒrQ|jjSdS(NRt__call__( RXtgetattrR"Rtget_callable_nametfunct __class__RR(R ((s1lib/python2.7/site-packages/pandas/core/common.pyRn+s   cKst|ƒr|||S|S(s× 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 (tcallable(tmaybe_callableR tkwargs((s1lib/python2.7/site-packages/pandas/core/common.pytapply_if_callable<s  cCsd„t|ƒDƒS(s¯ Helper function to convert datetimelike-keyed dicts to Timestamp-keyed dict Parameters ---------- d: dict like object Returns ------- dict cSs%i|]\}}|t|ƒ“qS((R/(RCR(R.((s1lib/python2.7/site-packages/pandas/core/common.pys [s (R(td((s1lib/python2.7/site-packages/pandas/core/common.pyt dict_compatNs cCs’tj|ƒsCt|tjƒr4ttj|jƒSt|ƒ}nt|t j ƒspt dj d|ƒƒ‚n|tjkrŽt dƒ‚n|S(s' Helper function to standardize a supplied mapping. .. versionadded:: 0.21.0 Parameters ---------- into : instance or subclass of collections.Mapping Must be a class, an initialized collections.defaultdict, or an instance of a collections.Mapping subclass. Returns ------- mapping : a collections.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 sunsupported type: {into}tintos/to_dict() only accepts initialized defaultdicts( tinspecttisclassR"t collectionst defaultdictRtdefault_factoryR[RZR\tMappingR;tformat(Rw((s1lib/python2.7/site-packages/pandas/core/common.pytstandardize_mapping^s cCsdtfd„ƒY}|ƒS(NtSentinelcBseZRS((RR(((s1lib/python2.7/site-packages/pandas/core/common.pyR€ƒs(RY(R€((s1lib/python2.7/site-packages/pandas/core/common.pytsentinel_factory‚scCsXt|ƒrtjj|ƒSt|tjjƒr5|S|dkrHtjStdƒ‚dS(sÛ Helper function for processing random_state arguments. Parameters ---------- state : int, np.random.RandomState, None. If receives an int, passes to np.random.RandomState() as seed. If receives an np.random.RandomState object, just returns object. If receives `None`, returns np.random. If receives anything else, raises an informative ValueError. Default None. Returns ------- np.random.RandomState s=random_state must be an integer, a numpy RandomState, or NoneN(R R#trandomt RandomStateR"RR(tstate((s1lib/python2.7/site-packages/pandas/core/common.pyt random_state‰s  cOskt|tƒrW|\}}||kr@d|}t|ƒ‚n|||<|||ŽS||||ŽSdS(sr 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, string) 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``. s1%s is both the pipe target and a keyword argumentN(R"RWR(R RoRERsttargettmsg((s1lib/python2.7/site-packages/pandas/core/common.pyt_pipe¦s     cs4tˆtjtfƒr*‡fd†}nˆ}|S(sv Returns a function that will map names/labels, dependent if mapper is a dict, Series or just a function. cs|ˆkrˆ|S|SdS(N((RK(tmapper(s1lib/python2.7/site-packages/pandas/core/common.pytfÐs (R"R\R}R(R‰RŠ((R‰s1lib/python2.7/site-packages/pandas/core/common.pyt_get_rename_functionÉs(Dt__doc__RzRRt functoolsRRxtnumpyR#t pandas._libsRRt pandas.compatR\RRRtpandas.core.dtypes.castRtpandas.core.dtypes.commonR R R R tpandas.core.dtypes.genericR RRtpandas.core.dtypes.inferenceRtpandas.core.dtypes.missingRRRRRtWarningRRR!R)R/R3R>RBRFRGRHRIRJRMRRRURR`RbRcRhRjRkRnRtRvRRR…RˆR‹(((s1lib/python2.7/site-packages/pandas/core/common.pytsX   "   3                  $   #