σ mάJ]c@`sZdZddlmZmZmZmZddlZejeƒZ ddl Z ddl Z ddl Z ddlZddlmZddlZddlZddlmZddlmZdd lmZed ƒZeejejƒejejƒejejƒejejƒejej ƒejej!ƒejej"ƒejej#ƒgƒZ$ee j e j%e j&ej'gƒZ(erψy ej)Z*Wne+k r±ej,j)Z*nXe(j-e*ƒe(j-ej.ƒe(j-ej/ƒe(j-e0ej1ƒƒnej'dd ƒZ2ej3dd ƒZ4e j j5dƒZ6eed d j7d„e$DƒƒƒZd4Z8d „Z9d!„Z:d"„Z;d#„Z<d$„Z=d%„Z>d&„Z?d'„Z@ee@jd d(j7d)„e$Dƒƒƒe@_eAdd*„ZCd+„ZDeAdd,„ZEeAdd-„ZFeGdd.„ZHddd/„ZId0„ZJd1„ZKd2„ZLd3aMeƒZNeOe(ƒZPdS(5uι Functions for helping with serialization and deserialization of Bokeh objects. Certain NumPy array dtypes can be serialized to a binary format for performance and efficiency. The list of supported dtypes is: {binary_array_types} i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tLocki(tsettingsi(tformat_docstring(timport_optionalupandasumstbinary_array_typesu cc`s#|]}dt|ƒdVqdS(u* ``np.u``N(tstr(t.0tx((s7lib/python2.7/site-packages/bokeh/util/serialization.pys Usuarray_encoding_disableduconvert_datetime_arrayuconvert_datetime_typeuconvert_timedelta_typeudecode_base64_dictuencode_binary_dictuencode_base64_dictuis_datetime_typeuis_timedelta_typeumake_globally_unique_idumake_iduserialize_arrayutransform_arrayutransform_array_to_listutransform_column_source_datau traverse_datautransform_seriescC`s t|tƒS(uΙ Whether an object is any date, time, or datetime type recognized by Bokeh. Arg: obj (object) : the object to test Returns: bool : True if ``obj`` is a datetime type (t isinstancet _dt_tuple(tobj((s7lib/python2.7/site-packages/bokeh/util/serialization.pytis_datetime_typeos cC`st|tjtjfƒS(uΈ Whether an object is any timedelta type recognized by Bokeh. Arg: obj (object) : the object to test Returns: bool : True if ``obj`` is a timedelta type (R tdtt timedeltatnpt timedelta64(R((s7lib/python2.7/site-packages/bokeh/util/serialization.pytis_timedelta_type|s cC`s>t|tjƒr |jƒdSt|tjƒr:|tSdS(uΌ Convert any recognized timedelta value to floating point absolute milliseconds. Arg: obj (object) : the object to convert Returns: float : milliseconds g@@N(R RRt total_secondsRRt NP_MS_DELTA(R((s7lib/python2.7/site-packages/bokeh/util/serialization.pytconvert_timedelta_typeˆs cC`s[tr|tjkrtjStrEt|tjƒrE|jƒjd Stret|tƒre|jd Strˆt|tj ƒrˆ|jd St|t j ƒrΎ|j dd ƒt}|jƒdSt|t jƒrυt j |jƒd ŒtjƒdSt|tjƒr|t}|tSt|t jƒrW|jd|jd|jd|jdSd S( uΝ Convert any recognized date, time, or datetime value to floating point milliseconds since epoch. Arg: obj (object) : the object to convert Returns: float : milliseconds i g@ttzinfog@@iiθii<Ng€„.Ag€„.Ag€„.A(tpdtNaTRtnanR tPeriodt to_timestamptvaluet _pd_timestampt TimedeltaRtdatetimetreplacetNonetDT_EPOCHRtdatet timetuplet datetime64tNP_EPOCHRttimethourtminutetsecondt microsecond(Rtdifft epoch_delta((s7lib/python2.7/site-packages/bokeh/util/serialization.pytconvert_datetime_type˜s$   % cC`s9t|tjƒs|Sy:tjdƒ}|jdƒ|jdƒjdƒk}WnItk r›}|jdkr’dtjkr‰t }q˜|‚qœ|‚nX|j j dkr|rε|j tj dƒkr|jdƒd}qq5|jd ƒjdƒd }n1|j j d kr5|jd ƒjdƒd }n|S(u Convert NumPy datetime arrays to arrays to milliseconds since epoch. Args: array : (obj) A NumPy array of datetime to convert If the value passed in is not a NumPy array, it will be returned as-is. Returns: array u2001uint64udatetime64[ms]u-'module' object has no attribute 'datetime64'uPyPyuMudatetime64[ns]i g@udatetime64[us]g@@umutimedelta64[us](u-'module' object has no attribute 'datetime64'g€„.A( R RtndarrayR'tastypetAttributeErrortargstsystversiontFalsetdtypetkind(tarraytdt2001tlegacy_datetime64te((s7lib/python2.7/site-packages/bokeh/util/serialization.pytconvert_datetime_arrayΓs*   cC`s>tjtƒr3ttd7attƒSWdQXntƒSdS(uŒ Return a new unique ID for a Bokeh object. Normally this function will return simple monotonically increasing integer IDs (as strings) for identifying Bokeh objects within a Document. However, if it is desirable to have globally unique for every object, this behavior can be overridden by setting the environment variable ``BOKEH_SIMPLE_IDS=no``. Returns: str iN(Rt simple_idstTruet_simple_id_lockt _simple_idR tmake_globally_unique_id(((s7lib/python2.7/site-packages/bokeh/util/serialization.pytmake_idπs  cC`sttjƒƒS(u΅ Return a globally unique UUID. Some situations, e.g. id'ing dynamically created Divs in HTML documents, always require globally unique IDs. Returns: str (R tuuidtuuid4(((s7lib/python2.7/site-packages/bokeh/util/serialization.pyRCs cC`s |jtkS(uέ Determine whether an array may be binary encoded. The NumPy array dtypes that can be encoded are: {binary_array_types} Args: array (np.ndarray) : the array to check Returns: bool (R8tBINARY_ARRAY_TYPES(R:((s7lib/python2.7/site-packages/bokeh/util/serialization.pytarray_encoding_disabledsu cc`s#|]}dt|ƒdVqdS(u* ``np.u``N(R (R R ((s7lib/python2.7/site-packages/bokeh/util/serialization.pys $scC`s"t|ƒ}t|d|d|ƒS(u Transform a NumPy arrays into serialized format Converts un-serializable dtypes and returns JSON serializable format Args: array (np.ndarray) : a NumPy array to be transformed force_list (bool, optional) : whether to only output to standard lists This function can encode some dtypes using a binary encoding, but setting this argument to True will override that and cause only standard Python lists to be emitted. (default: False) buffers (set, optional) : If binary buffers are desired, the buffers parameter may be provided, and any columns that may be sent as binary buffers will be added to the set. If None, then only base64 encoding will be used (default: None) If force_list is True, then this value will be ignored, and no buffers will be generated. **This is an "out" parameter**. The values it contains will be modified in-place. Returns: JSON t force_listtbuffers(R>tserialize_array(R:RIRJ((s7lib/python2.7/site-packages/bokeh/util/serialization.pyttransform_array's cC`sέ|jjd krztj|ƒjƒrz|jdƒ}d|tj|ƒ΅sRJuNaNiuInfinityu -Infinity( tallRLttypetfloattmathROtisinftappendR tlistttuplet traverse_data(Rt use_numpyRJRbtobj_copytitem((s7lib/python2.7/site-packages/bokeh/util/serialization.pyRk§s #     cC`sΞ|dkrt|ƒn t|ƒ}i}x|D]•}tryt||tjtjfƒryt||d|ƒ||>, 'shape' : << array shape >>, 'dtype' : << dtype name >>, 'order' : << byte order at origin (little or big)>> } Args: array (np.ndarray) : an array to encode buffers (set) : Set to add buffers to **This is an "out" parameter**. The values it contains will be modified in-place. Returns: dict tidu __buffer__ushapeudtypeuorder( RDtdictttobytesRhtshapeR8tnameR5t byteorder(R:RJt buffer_idtbuf((s7lib/python2.7/site-packages/bokeh/util/serialization.pyRaξs    cC`s7itj|jƒjdƒd6|jd6|jjd6S(u… Encode a NumPy array using base64: The encoded format is a dict with the following structure: .. code:: python { '__ndarray__' : << base64 encoded array data >>, 'shape' : << array shape >>, 'dtype' : << dtype name >>, } Args: array (np.ndarray) : an array to encode Returns: dict uutf-8u __ndarray__ushapeudtype(tbase64t b64encodeRrtdecodeR{R8R|(R:((s7lib/python2.7/site-packages/bokeh/util/serialization.pyR`s cC`setj|dƒ}tjtj|d|dƒƒ}t|dƒdkra|j|dƒ}n|S(uί Decode a base64 encoded array into a NumPy array. Args: data (dict) : encoded array data to decode Data should have the format encoded by :func:`encode_base64_dict`. Returns: np.ndarray u __ndarray__R8udtypeushapei(R€t b64decodeRtcopyt frombuffertlentreshape(Rrtb64R:((s7lib/python2.7/site-packages/bokeh/util/serialization.pytdecode_base64_dict/s "iη(uarray_encoding_disableduconvert_datetime_arrayuconvert_datetime_typeuconvert_timedelta_typeudecode_base64_dictuencode_binary_dictuencode_base64_dictuis_datetime_typeuis_timedelta_typeumake_globally_unique_idumake_iduserialize_arrayutransform_arrayutransform_array_to_listutransform_column_source_datau traverse_datautransform_series(Qt__doc__t __future__RRRRtloggingt getLoggert__name__tlogR€R!RRfR5t threadingRREtnumpyRRtstringRt dependenciesRRRoR8tfloat32tfloat64tuint8tint8tuint16tint16tuint32tint32RGR%R)R'tDATETIME_TYPESt TimestampRR3ttslibtaddR RRdRR(RRtutcfromtimestampR$tjoint__all__RRRR0R>RDRCRHR7R#RLRURZRKR@RkRwRaR`R‰RBRARjR (((s7lib/python2.7/site-packages/bokeh/util/serialization.pyts’"           %  + -    # "%#$ &