-e5%>dZddlmZddlZejeZddlmZddl m Z ddl m Z ddl mZmZmZmZmZmZmZmZmZmZmZmZmZdd lmZd Ze Gd d eZGd deZGddeZ GddeZ!e GddeZ"Gdde"Z#Gdde"Z$e GddeZ%Gdde%Z&e GddeZ'Gdd e'Z(Gd!d"e'Z)dS)#ag Represent array expressions to be computed on the client (browser) side by BokehJS. Expression models are useful as ``DataSpec`` values when it is desired that the array values be computed in the browser: .. code-block:: python p.circle(x={'expr': some_expression}, ...) or using the ``expr`` convenience function: .. code-block:: python from bokeh.core.properties import expr p.circle(x=expr(some_expression), ...) In this case, the values of the ``x`` coordinates will be computed in the browser by the JavaScript implementation of ``some_expression`` using a ``ColumnDataSource`` as input. ) annotationsN)inf) Direction)abstract) AngleSpecAnyRefBoolDictEnumFloatInstanceNullable NumberSpecRequiredSeqStringfield)Model)CumSum CustomJSExpr ExpressionPolarTransformStackc$eZdZdZdfd ZxZS)ra Base class for ``Expression`` models that represent a computation to be carried out on the client-side. JavaScript implementations should implement the following methods: .. code-block v_compute(source: ColumnarDataSource): Arrayable { # compute and return array of values } .. note:: If you wish for results to be cached per source and updated only if the source changes, implement ``_v_compute: (source)`` instead. returnNonec:tj|i|dSNsuper__init__selfargskwargs __class__s 8lib/python3.11/site-packages/bokeh/models/expressions.pyr"zExpression.__init__f%$)&)))))rr__name__ __module__ __qualname____doc__r" __classcell__r's@r(rrRsG$**********r*rcZeZdZdZd fd ZeeedZedd Z xZ S) ra` Evaluate a JavaScript function/generator. .. warning:: The explicit purpose of this Bokeh Model is to embed *raw JavaScript code* for a browser to execute. If any part of the code is derived from untrusted user inputs, then you must take appropriate care to sanitize the user input prior to passing to Bokeh. rrc:tj|i|dSrr r#s r(r"zCustomJSExpr.__init__vr)r*a A mapping of names to Python objects. In particular those can be bokeh's models. These objects are made available to the callback's code snippet as the values of named parameters to the callback. There is no need to manually include the data source of the associated glyph renderer, as it is available within the scope of the code via `this` keyword (e.g. `this.data` will give access to raw data). helpa A snippet of JavaScript code to execute in the browser. The code is made into the body of a generator function, and all of of the named objects in ``args`` are available as parameters that the code can use. One can either return an array-like object (array, typed array, nd-array), an iterable (which will be converted to an array) or a scalar value (which will be converted into an array of an appropriate length), or alternatively yield values that will be collected into an array. defaultr6r+) r-r.r/r0r"r rr r%coder1r2s@r(rrjs{****** 4&   D 6"$   DDDDDr*rcXeZdZdZd fd ZeedZedd Z xZ S) rzs An expression for generating arrays by cumulatively summing a single column from a ``ColumnDataSource``. rrc:tj|i|dSrr r#s r(r"zCumSum.__init__r)r*zW The name of a ``ColumnDataSource`` column to cumulatively sum for new values. r5Fa Whether to include zero at the start of the result. Note that the length of the result is always the same as the input column. Therefore if this property is True, then the last value of the column will not be included in the sum. .. code-block:: python source = ColumnDataSource(data=dict(foo=[1, 2, 3, 4])) CumSum(field='foo') # -> [1, 3, 6, 10] CumSum(field='foo', include_zero=True) # -> [0, 1, 3, 6] r8r+) r-r.r/r0r"rrrr include_zeror1r2s@r(rrsy ****** HV#   E4-   LLLLLr*rc@eZdZdZdfd ZeegdZxZS)rz An expression for generating arrays by summing different columns from a ``ColumnDataSource``. This expression is useful for implementing stacked bar charts at a low level. rrc:tj|i|dSrr r#s r(r"zStack.__init__r)r*a= A sequence of fields from a ``ColumnDataSource`` to sum (elementwise). For example: .. code-block:: python Stack(fields=['sales', 'marketing']) Will compute an array of values (in the browser) by adding the elements of the ``'sales'`` and ``'marketing'`` columns of a data source. r8r+) r-r.r/r0r"rrfieldsr1r2s@r(rrs\******S +    FFFFFr*rc$eZdZdZdfd ZxZS)ScalarExpressionz( Base class for for scalar expressions. rrc:tj|i|dSrr r#s r(r"zScalarExpression.__init__r)r*r+r,r2s@r(rBrBsC22**********r*rBcTeZdZdZdfd ZeeZee e Z xZ S)Minimumz3 Computes minimum value of a data source's column. rrc:tj|i|dSrr r#s r(r"zMinimum.__init__r)r*r9r+ r-r.r/r0r"rrrrr rinitialr1r2s@r(rErEs\==****** HV  Ehuc***GGGGGr*rEcVeZdZdZdfd ZeeZee e Z xZ S)Maximumz3 Computes maximum value of a data source's column. rrc:tj|i|dSrr r#s r(r"zMaximum.__init__r)r*rGr+rHr2s@r(rKrKs^==****** HV  Ehusd+++GGGGGr*rKcPeZdZdZdfd ZedZedZxZS)CoordinateTransformz' Base class for coordinate transforms. rrc:tj|i|dSrr r#s r(r"zCoordinateTransform.__init__r)r*c"t|SN) transform) XComponentr$s r(xzCoordinateTransform.xD))))r*c"t|SrQ) YComponentrTs r(yzCoordinateTransform.yrVr*r+) r-r.r/r0r"propertyrUrYr1r2s@r(rNrNsy11********X***X*****r*rNceZdZdZd fd ZeeddZeedd Z e e e j d Z xZS) rz0 Transform from polar to cartesian coordinates. rrc:tj|i|dSrr r#s r(r"zPolarTransform.__init__r)r*radiusz The radial coordinate (i.e. the distance from the origin). Negative radius is allowed, which is equivalent to using positive radius and changing ``direction`` to the opposite value. r8anglezJ The angular coordinate (i.e. the angle from the reference axis). zY Whether ``angle`` measures clockwise or anti-clockwise from the reference axis. r+)r-r.r/r0r"rrr]rr^r r anticlock directionr1r2s@r(rrs::******Zh7   F IeeGnn4   EY (;C   IIIIIr*rc:eZdZdZdfd ZeeZxZS) XYComponentz( Base class for bi-variate expressions. rrc:tj|i|dSrr r#s r(r"zXYComponent.__init__r)r*r+) r-r.r/r0r"rrNrRr1r2s@r(rbrbsI22******,--IIIIIr*rbc$eZdZdZdfd ZxZS)rSzH X-component of a coordinate system transform to cartesian coordinates. rrc:tj|i|dSrr r#s r(r"zXComponent.__init__r)r*r+r,r2s@r(rSrSCRR**********r*rSc$eZdZdZdfd ZxZS)rXzH Y-component of a coordinate system transform to cartesian coordinates. rrc:tj|i|dSrr r#s r(r"zYComponent.__init__%r)r*r+r,r2s@r(rXrX!rfr*rX)*r0 __future__rlogging getLoggerr-logmathr core.enumsrcore.has_propsrcore.propertiesrr r r r r rrrrrrrmodelr__all__rrrrrBrErKrNrrbrSrXr*r(rts`6#"""""g!!#"""""%%%%%%   ******* *.     :   D     Z   B     J   4 *****u** *++++++++,,,,,,,,  * * * * ** * *  *      (   . .....*.. .******************r*