σ mάJ]c@`s½dZddlmZmZmZmZddlZejeƒZ ddl m Z dZ d „Z d ddd„Zd„Zd„Zd dd„Zd„Zd ddd„Zd„ZdS(u© Provide a set of decorators useful for repeatedly updating a a function parameter in a specified way each time the function is called. These decorators can be especially useful in conjunction with periodic callbacks in a Bokeh server application. Example: As an example, consider the ``bounce`` forcing function, which advances a sequence forwards and backwards: .. code-block:: python from bokeh.driving import bounce @bounce([0, 1, 2]) def update(i): print(i) If this function is repeatedly called, it will print the following sequence on standard out: .. code-block:: none 0 1 2 2 1 0 0 1 2 2 1 ... i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tpartialubounceucosineucountuforceulinearurepeatusinec`s4tˆƒ‰‡‡fd†}ttdt|ƒƒS(u Return a driver function that can advance a "bounced" sequence of values. .. code-block:: none seq = [0, 1, 2, 3] # bounce(seq) => [0, 1, 2, 3, 3, 2, 1, 0, 0, 1, 2, ...] Args: sequence (seq) : a sequence of values for the driver to bounce c`sAt|ˆƒ\}}|ddkr-ˆ|Sˆˆ|dSdS(Niii(tdivmod(titdivtmod(tNtsequence(s,lib/python2.7/site-packages/bokeh/driving.pytfXsR (tlenRtforcet_advance(R R ((R R s,lib/python2.7/site-packages/bokeh/driving.pytbounceIs ic`sAddlm‰‡‡‡‡‡fd†}ttdt|ƒƒS(u– Return a driver function that can advance a sequence of cosine values. .. code-block:: none value = A * cos(w*i + phi) + offset Args: w (float) : a frequency for the cosine driver A (float) : an amplitude for the cosine driver phi (float) : a phase offset to start the cosine driver with offset (float) : a global offset to add to the driver values i(tcosc`sˆˆˆ|ˆƒˆS(N((R(tARtoffsettphitw(s,lib/python2.7/site-packages/bokeh/driving.pyR osR (tmathRRR R(RRRRR ((RRRRRs,lib/python2.7/site-packages/bokeh/driving.pytcosine`scC`sttdtd„ƒƒS(u@ Return a driver function that can advance a simple count. R cS`s|S(N((tx((s,lib/python2.7/site-packages/bokeh/driving.pytwt(RR R(((s,lib/python2.7/site-packages/bokeh/driving.pytcountssc`s‡‡fd†}|S(uΝ Return a decorator that can "force" a function with an arbitrary supplied generator Args: sequence (iterable) : generator to drive f with Returns: decorator c`sˆtˆƒƒdS(N(tnext((R R (s,lib/python2.7/site-packages/bokeh/driving.pytwrapper…s((R R R((R R s,lib/python2.7/site-packages/bokeh/driving.pyR ys c`s(‡‡fd†}ttdt|ƒƒS(uσ Return a driver function that can advance a sequence of linear values. .. code-block:: none value = m * i + b Args: m (float) : a slope for the linear driver x (float) : an offset for the linear driver c`s ˆ|ˆS(N((R(tbtm(s,lib/python2.7/site-packages/bokeh/driving.pyR •sR (RR R(RRR ((RRs,lib/python2.7/site-packages/bokeh/driving.pytlinear‰s c`s4tˆƒ‰‡‡fd†}ttdt|ƒƒS(u  Return a driver function that can advance a repeated of values. .. code-block:: none seq = [0, 1, 2, 3] # repeat(seq) => [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, ...] Args: sequence (seq) : a sequence of values for the driver to bounce c`s ˆ|ˆS(N((R(R R (s,lib/python2.7/site-packages/bokeh/driving.pyR §sR (R RR R(R R ((R R s,lib/python2.7/site-packages/bokeh/driving.pytrepeat™s c`sAddlm‰‡‡‡‡‡fd†}ttdt|ƒƒS(uŽ Return a driver function that can advance a sequence of sine values. .. code-block:: none value = A * sin(w*i + phi) + offset Args: w (float) : a frequency for the sine driver A (float) : an amplitude for the sine driver phi (float) : a phase offset to start the sine driver with offset (float) : a global offset to add to the driver values i(tsinc`sˆˆˆ|ˆƒˆS(N((R(RRRR!R(s,lib/python2.7/site-packages/bokeh/driving.pyR ΊsR (RR!RR R(RRRRR ((RRRR!Rs,lib/python2.7/site-packages/bokeh/driving.pytsine«scc`s,d}xtr'||ƒV|d7}q WdS(uλ Yield a sequence generated by calling a given function with successively incremented integer values. Args: f (callable) : The function to advance Yields: f(i) where i increases each call iiN(tTrue(R R((s,lib/python2.7/site-packages/bokeh/driving.pyRΖs   (ubounceucosineucountuforceulinearurepeatusine(t__doc__t __future__RRRRtloggingt getLoggert__name__tlogt functoolsRt__all__RRRR RR R"R(((s,lib/python2.7/site-packages/bokeh/driving.pyt"s&"