注释#
用于可以添加到图表中的各种注释的渲染器。
- class Angular(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基础类:
CustomDimensional角度测量单位。
JSON Prototype
{ "basis": { "entries": [ [ "\u00b0", [ 1, "^\\circ", "degree" ] ], [ "'", [ 0.016666666666666666, "^\\prime", "minute" ] ], [ "''", [ 0.0002777777777777778, "^{\\prime\\prime}", "second" ] ] ], "type": "map" }, "exclude": [], "id": "p51909", "include": null, "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [], "ticks": [ 1, 3, 6, 12, 60, 120, 240, 360 ] }
- basis = {'°': (1, '^\\circ', 'degree'), "'": (0.016666666666666666, '^\\prime', 'minute'), "''": (0.0002777777777777778, '^{\\prime\\prime}', 'second')}#
-
定义测量单位的基础。
这包括短单位名称与其对应的缩放因子、TeX名称和可选的完整名称之间的映射。例如,定义角度测量单位的基础是:
basis = { "°": (1, "^\circ", "degree"), "'": (1/60, "^\prime", "minute"), "''": (1/3600, "^{\prime\prime}", "second"), }
- name = None#
-
此模型的任意用户提供的名称。
在查询文档以检索特定Bokeh模型时,此名称可能很有用。
>>> plot.circle([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,没有强制执行唯一性保证或其他条件,Bokeh也不会直接使用这些名称。
- syncable = True#
- Type:
指示当在网页浏览器中更新时,此模型是否应同步回Bokeh服务器。设置为
False可能有助于在处理频繁更新的对象时减少网络流量,这些对象的更新值我们不需要。注意
将此属性设置为
False将阻止此对象上的任何on_change()回调触发。然而,任何JS端的回调仍然会工作。
- tags = []#
- Type:
一个可选的任意用户提供的值列表,用于附加到此模型。
在查询文档以检索特定Bokeh模型时,这些数据可能很有用:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者只是将任何必要的元数据附加到模型的一种便捷方式,这些元数据可以通过
CustomJS回调等方式访问。注意
对于提供的任何标签,没有强制执行唯一性保证或其他条件,Bokeh也不会出于任何原因直接使用这些标签。
- apply_theme(property_values: dict[str, Any]) None#
应用一组主题值,这些值将用于替代默认值,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享以节省内存(因此调用者和
HasProps实例都不应修改它)。- Parameters:
property_values (dict) – 用于替换默认值的主题值
- Returns:
无
- classmethod clear_extensions() None#
清除当前定义的所有自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]]#
属性描述符的列表,按定义的顺序排列。
- equals(other: HasProps) bool#
模型的结构相等性。
- Parameters:
其他 (HasProps) – 要比较的其他实例
- Returns:
如果属性在结构上相等,则为True,否则为False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None#
使用JavaScript链接两个Bokeh模型属性。
这是一个便捷的方法,简化了添加一个
CustomJS回调的过程,以便在另一个属性值发生变化时更新一个 Bokeh 模型属性。- Parameters:
在版本1.1中添加
- Raises:
示例
这段代码使用了
js_link:select.js_link('value', plot, 'sizing_mode')
等同于以下内容:
from bokeh.models import CustomJS select.js_on_change('value', CustomJS(args=dict(other=plot), code="other.sizing_mode = this.value" ) )
此外,使用attr_selector将范围滑块的左侧附加到绘图的x_range:
range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)
这相当于:
from bokeh.models import CustomJS range_slider.js_on_change('value', CustomJS(args=dict(other=plot.x_range), code="other.start = this.value[0]" ) )
- js_on_change(event: str, *callbacks: JSChangeCallback) None#
将一个
CustomJS回调附加到任意的BokehJS模型事件。在BokehJS方面,模型属性的更改事件具有
"change:property_name"的形式。为了方便起见,如果传递给此方法的事件名称也是模型上属性的名称,那么它将自动加上"change:"前缀:# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
然而,除了属性更改事件之外,还有其他类型的事件可能对响应有用。例如,每当数据流式传输到
ColumnDataSource时运行回调,可以在源上使用"stream"事件:source.js_on_change('streaming', callback)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None#
在类上找到Bokeh属性的
PropertyDescriptor,给定属性名称。- Parameters:
- Returns:
名为
name的属性的描述符- Return type:
- on_change(attr: str, *callbacks: PropertyCallback) None#
在此对象上添加一个回调,当
attr发生变化时触发。- Parameters:
attr (str) – 此对象上的一个属性名称
*callbacks (callable) – 要注册的回调函数
- Returns:
无
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None#
当此模型上发生指定事件时运行回调
并非所有模型都支持所有事件。 有关哪些模型能够触发它们的更多信息,请参见bokeh.events中的具体事件。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]]#
收集此类的属性名称。
警告
在Bokeh的未来版本中,此方法将返回一个将属性名称映射到属性对象的字典。为了使当前使用此方法的方式具有未来兼容性,请将返回值包装在
list中。- Returns:
属性名称
- classmethod properties_with_refs() dict[str, Property[Any]]#
收集此类上所有具有引用的属性的名称。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
- properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
收集一个将属性名称映射到其值的字典。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,属性值以“序列化”格式呈现,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损重构对象实例所需的信息。
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
使用谓词查询
HasProps实例的属性值。
- select(selector: SelectorType) Iterable[Model]#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
- Returns:
序列[模型]
- select_one(selector: SelectorType) Model | None#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何内容,则返回None :param selector: :type selector: JSON-like
- Returns:
模型
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#
从JSON设置此对象的属性值。
- Parameters:
name (str) – 要设置的属性名称
value (JSON-value) – 要设置给属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对Bokeh应用程序的“回旋镖”更新。
在Bokeh服务器应用程序的上下文中,对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较,并抑制源自自身的任何更新。
- Returns:
无
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None#
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
更新 (dict)
- Returns:
无
- themed_values() dict[str, Any] | None#
获取任何主题提供的覆盖。
结果以属性名称到值的字典形式返回,如果此实例没有主题覆盖任何值,则返回
None。- Returns:
字典或无
- to_serializable(serializer: Serializer) ObjectRefRep#
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None#
- class Annotation(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基础类:
CompositeRenderer所有注释模型的基类。
注意
这是一个抽象基类,用于帮助组织Bokeh模型类型的层次结构。单独实例化它没有用处。
JSON Prototype
{ "context_menu": null, "coordinates": null, "css_classes": [], "css_variables": { "type": "map" }, "elements": [], "group": null, "id": "p51917", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "level": "annotation", "name": null, "propagate_hover": false, "renderers": [], "styles": { "type": "map" }, "stylesheets": [], "subscribed_events": { "type": "set" }, "syncable": true, "tags": [], "visible": true, "x_range_name": "default", "y_range_name": "default" }
- css_variables = {}#
-
允许定义动态计算的CSS变量。
例如,这可以用于协调canvas渲染器和/或视觉效果与基于HTML的UI元素之间的定位和样式。
这里定义的变量等同于在CSS样式表中的
:host { ... }下设置相同的变量。注意
此属性是实验性的,可能会随时更改。
- elements = []#
- Type:
附加到此渲染器的基于DOM的UI元素集合。
这可以包括像工具提示这样的浮动元素,允许在此渲染器与其UI元素之间建立父子关系。
注意
此属性相当于基于DOM的用户界面中的
Pane.elements。
- group = None#
- Type:
注意
此属性是实验性的,可能会随时更改。
- level = 'annotation'#
- Type:
指定绘制此渲染器的层级。
- name = None#
-
此模型的任意用户提供的名称。
在查询文档以检索特定Bokeh模型时,此名称可能很有用。
>>> plot.circle([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,没有强制执行唯一性保证或其他条件,Bokeh也不会直接使用这些名称。
- stylesheets = []#
- Type:
用于底层DOM元素的附加样式表。
请注意,所有Bokeh的组件都使用影子DOM,因此任何包含的样式表都必须反映这一点,例如使用
:hostCSS伪选择器来访问根DOM元素。
- syncable = True#
- Type:
指示当在网页浏览器中更新时,此模型是否应同步回Bokeh服务器。设置为
False可能有助于在处理频繁更新的对象时减少网络流量,这些对象的更新值我们不需要。注意
将此属性设置为
False将阻止此对象上的任何on_change()回调触发。然而,任何JS端的回调仍然会工作。
- tags = []#
- Type:
一个可选的任意用户提供的值列表,用于附加到此模型。
在查询文档以检索特定Bokeh模型时,这些数据可能很有用:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者只是将任何必要的元数据附加到模型的一种便捷方式,这些元数据可以通过
CustomJS回调等方式访问。注意
对于提供的任何标签,没有强制执行唯一性保证或其他条件,Bokeh也不会出于任何原因直接使用这些标签。
- apply_theme(property_values: dict[str, Any]) None#
应用一组主题值,这些值将用于替代默认值,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享以节省内存(因此调用者和
HasProps实例都不应修改它)。- Parameters:
property_values (dict) – 用于替换默认值的主题值
- Returns:
无
- classmethod clear_extensions() None#
清除当前定义的所有自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]]#
属性描述符的列表,按定义的顺序排列。
- equals(other: HasProps) bool#
模型的结构相等性。
- Parameters:
其他 (HasProps) – 要比较的其他实例
- Returns:
如果属性在结构上相等,则为True,否则为False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None#
使用JavaScript链接两个Bokeh模型属性。
这是一个便捷的方法,简化了添加一个
CustomJS回调的过程,以便在另一个属性值发生变化时更新一个 Bokeh 模型属性。- Parameters:
在版本1.1中添加
- Raises:
示例
这段代码使用了
js_link:select.js_link('value', plot, 'sizing_mode')
等同于以下内容:
from bokeh.models import CustomJS select.js_on_change('value', CustomJS(args=dict(other=plot), code="other.sizing_mode = this.value" ) )
此外,使用attr_selector将范围滑块的左侧附加到绘图的x_range:
range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)
这相当于:
from bokeh.models import CustomJS range_slider.js_on_change('value', CustomJS(args=dict(other=plot.x_range), code="other.start = this.value[0]" ) )
- js_on_change(event: str, *callbacks: JSChangeCallback) None#
将一个
CustomJS回调附加到任意的BokehJS模型事件。在BokehJS方面,模型属性的更改事件具有
"change:property_name"的形式。为了方便起见,如果传递给此方法的事件名称也是模型上属性的名称,那么它将自动加上"change:"前缀:# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
然而,除了属性更改事件之外,还有其他类型的事件可能对响应有用。例如,每当数据流式传输到
ColumnDataSource时运行回调,可以在源上使用"stream"事件:source.js_on_change('streaming', callback)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None#
在类上找到Bokeh属性的
PropertyDescriptor,给定属性名称。- Parameters:
- Returns:
名为
name的属性的描述符- Return type:
- on_change(attr: str, *callbacks: PropertyCallback) None#
在此对象上添加一个回调,当
attr发生变化时触发。- Parameters:
attr (str) – 此对象上的一个属性名称
*callbacks (callable) – 要注册的回调函数
- Returns:
无
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None#
当此模型上发生指定事件时运行回调
并非所有模型都支持所有事件。 有关哪些模型能够触发它们的更多信息,请参见bokeh.events中的具体事件。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]]#
收集此类的属性名称。
警告
在Bokeh的未来版本中,此方法将返回一个将属性名称映射到属性对象的字典。为了使当前使用此方法的方式具有未来兼容性,请将返回值包装在
list中。- Returns:
属性名称
- classmethod properties_with_refs() dict[str, Property[Any]]#
收集此类上所有具有引用的属性的名称。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
- properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
收集一个将属性名称映射到其值的字典。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,属性值以“序列化”格式呈现,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损重构对象实例所需的信息。
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
使用谓词查询
HasProps实例的属性值。
- select(selector: SelectorType) Iterable[Model]#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
- Returns:
序列[模型]
- select_one(selector: SelectorType) Model | None#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何内容,则返回None :param selector: :type selector: JSON-like
- Returns:
模型
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#
从JSON设置此对象的属性值。
- Parameters:
name (str) – 要设置的属性名称
value (JSON-value) – 要设置给属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对Bokeh应用程序的“回旋镖”更新。
在Bokeh服务器应用程序的上下文中,对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较,并抑制源自自身的任何更新。
- Returns:
无
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None#
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
更新 (dict)
- Returns:
无
- themed_values() dict[str, Any] | None#
获取任何主题提供的覆盖。
结果以属性名称到值的字典形式返回,如果此实例没有主题覆盖任何值,则返回
None。- Returns:
字典或无
- to_serializable(serializer: Serializer) ObjectRefRep#
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None#
- class Arrow(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基础类:
DataAnnotation将箭头渲染为注释。
请参阅Arrows以获取关于绘制箭头的信息。
JSON Prototype
{ "context_menu": null, "coordinates": null, "css_classes": [], "css_variables": { "type": "map" }, "elements": [], "end": { "id": "p51938", "name": "OpenHead", "type": "object" }, "end_units": "data", "group": null, "id": "p51934", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "level": "annotation", "line_alpha": { "type": "value", "value": 1.0 }, "line_cap": { "type": "value", "value": "butt" }, "line_color": { "type": "value", "value": "black" }, "line_dash": { "type": "value", "value": [] }, "line_dash_offset": { "type": "value", "value": 0 }, "line_join": { "type": "value", "value": "bevel" }, "line_width": { "type": "value", "value": 1 }, "name": null, "propagate_hover": false, "renderers": [], "source": { "attributes": { "data": { "type": "map" }, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p51936", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p51937", "name": "UnionRenderers", "type": "object" } }, "id": "p51935", "name": "ColumnDataSource", "type": "object" }, "start": null, "start_units": "data", "styles": { "type": "map" }, "stylesheets": [], "subscribed_events": { "type": "set" }, "syncable": true, "tags": [], "visible": true, "x_end": { "field": "x_end", "type": "field" }, "x_range_name": "default", "x_start": { "field": "x_start", "type": "field" }, "y_end": { "field": "y_end", "type": "field" }, "y_range_name": "default", "y_start": { "field": "y_start", "type": "field" } }
- css_variables = {}#
-
允许定义动态计算的CSS变量。
例如,这可以用于协调canvas渲染器和/或视觉效果与基于HTML的UI元素之间的定位和样式。
这里定义的变量等同于在CSS样式表中的
:host { ... }下设置相同的变量。注意
此属性是实验性的,可能会随时更改。
- elements = []#
- Type:
附加到此渲染器的基于DOM的UI元素集合。
这可以包括像工具提示这样的浮动元素,允许在此渲染器与其UI元素之间建立父子关系。
注意
此属性相当于基于DOM的用户界面中的
Pane.elements。
- end_units = 'data'#
- Type:
end_x 和 end_y 属性的单位类型。默认情况下解释为“数据空间”单位。
- group = None#
- Type:
注意
此属性是实验性的,可能会随时更改。
- level = 'annotation'#
- Type:
指定绘制此渲染器的层级。
- line_cap = 'butt'#
- Type:
LineCapSpec
箭头主体的线帽值。
- line_dash = []#
- Type:
DashPatternSpec
箭头主体的虚线值。
- line_dash_offset = 0#
- Type:
IntSpec
箭头主体的虚线偏移值。
- line_join = 'bevel'#
- Type:
LineJoinSpec
箭头主体的线条连接值。
- line_width = 1#
- Type:
箭头主体的线宽值。
- name = None#
-
此模型的任意用户提供的名称。
在查询文档以检索特定Bokeh模型时,此名称可能很有用。
>>> plot.circle([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,没有强制执行唯一性保证或其他条件,Bokeh也不会直接使用这些名称。
- source = ColumnDataSource(id='p52035', ...)#
- Type:
在图表上渲染注释时使用的本地数据源。
- start_units = 'data'#
- Type:
start_x 和 start_y 属性的单位类型。默认情况下解释为“数据空间”单位。
- stylesheets = []#
- Type:
用于底层DOM元素的附加样式表。
请注意,所有Bokeh的组件都使用影子DOM,因此任何包含的样式表都必须反映这一点,例如使用
:hostCSS伪选择器来访问根DOM元素。
- syncable = True#
- Type:
指示当在网页浏览器中更新时,此模型是否应同步回Bokeh服务器。设置为
False可能有助于在处理频繁更新的对象时减少网络流量,这些对象的更新值我们不需要。注意
将此属性设置为
False将阻止此对象上的任何on_change()回调触发。然而,任何JS端的回调仍然会工作。
- tags = []#
- Type:
一个可选的任意用户提供的值列表,用于附加到此模型。
在查询文档以检索特定Bokeh模型时,这些数据可能很有用:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者只是将任何必要的元数据附加到模型的一种便捷方式,这些元数据可以通过
CustomJS回调等方式访问。注意
对于提供的任何标签,没有强制执行唯一性保证或其他条件,Bokeh也不会出于任何原因直接使用这些标签。
- x_end = Field(field='x_end', transform=Unspecified, units=Unspecified)#
- Type:
用于定位箭头终点的x坐标。
- x_start = Field(field='x_start', transform=Unspecified, units=Unspecified)#
- Type:
箭头起始位置的x坐标。
- y_end = Field(field='y_end', transform=Unspecified, units=Unspecified)#
- Type:
用于定位箭头终点的y坐标。
- y_start = Field(field='y_start', transform=Unspecified, units=Unspecified)#
- Type:
用于定位箭头起点的y坐标。
- apply_theme(property_values: dict[str, Any]) None#
应用一组主题值,这些值将用于替代默认值,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享以节省内存(因此调用者和
HasProps实例都不应修改它)。- Parameters:
property_values (dict) – 用于替换默认值的主题值
- Returns:
无
- classmethod clear_extensions() None#
清除当前定义的所有自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]]#
属性描述符的列表,按定义的顺序排列。
- equals(other: HasProps) bool#
模型的结构相等性。
- Parameters:
其他 (HasProps) – 要比较的其他实例
- Returns:
如果属性在结构上相等,则为True,否则为False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None#
使用JavaScript链接两个Bokeh模型属性。
这是一个便捷的方法,简化了添加一个
CustomJS回调的过程,以便在另一个属性值发生变化时更新一个 Bokeh 模型属性。- Parameters:
在版本1.1中添加
- Raises:
示例
这段代码使用了
js_link:select.js_link('value', plot, 'sizing_mode')
等同于以下内容:
from bokeh.models import CustomJS select.js_on_change('value', CustomJS(args=dict(other=plot), code="other.sizing_mode = this.value" ) )
此外,使用attr_selector将范围滑块的左侧附加到绘图的x_range:
range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)
这相当于:
from bokeh.models import CustomJS range_slider.js_on_change('value', CustomJS(args=dict(other=plot.x_range), code="other.start = this.value[0]" ) )
- js_on_change(event: str, *callbacks: JSChangeCallback) None#
将一个
CustomJS回调附加到任意的BokehJS模型事件。在BokehJS方面,模型属性的更改事件具有
"change:property_name"的形式。为了方便起见,如果传递给此方法的事件名称也是模型上属性的名称,那么它将自动加上"change:"前缀:# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
然而,除了属性更改事件之外,还有其他类型的事件可能对响应有用。例如,每当数据流式传输到
ColumnDataSource时运行回调,可以在源上使用"stream"事件:source.js_on_change('streaming', callback)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None#
在类上找到Bokeh属性的
PropertyDescriptor,给定属性名称。- Parameters:
- Returns:
名为
name的属性的描述符- Return type:
- on_change(attr: str, *callbacks: PropertyCallback) None#
在此对象上添加一个回调,当
attr发生变化时触发。- Parameters:
attr (str) – 此对象上的一个属性名称
*callbacks (callable) – 要注册的回调函数
- Returns:
无
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None#
当此模型上发生指定事件时运行回调
并非所有模型都支持所有事件。 有关哪些模型能够触发特定事件的更多信息,请参见bokeh.events中的具体事件。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]]#
收集此类的属性名称。
警告
在Bokeh的未来版本中,此方法将返回一个将属性名称映射到属性对象的字典。为了使当前使用此方法的方式具有未来兼容性,请将返回值包装在
list中。- Returns:
属性名称
- classmethod properties_with_refs() dict[str, Property[Any]]#
收集此类上所有具有引用的属性的名称。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
- properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
收集一个将属性名称映射到其值的字典。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,属性值以“序列化”格式呈现,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损重构对象实例所需的信息。
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
使用谓词查询
HasProps实例的属性值。
- select(selector: SelectorType) Iterable[Model]#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
- Returns:
序列[模型]
- select_one(selector: SelectorType) Model | None#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何内容,则返回None :param selector: :type selector: JSON-like
- Returns:
模型
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#
从JSON设置此对象的属性值。
- Parameters:
name (str) – 要设置的属性名称
value (JSON-value) – 要设置给属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对Bokeh应用程序的“回旋镖”更新。
在Bokeh服务器应用程序的上下文中,对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较,并抑制源自自身的任何更新。
- Returns:
无
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None#
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
更新 (dict)
- Returns:
无
- themed_values() dict[str, Any] | None#
获取任何主题提供的覆盖。
结果以属性名称到值的字典形式返回,如果此实例没有主题覆盖任何值,则返回
None。- Returns:
字典或无
- to_serializable(serializer: Serializer) ObjectRefRep#
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None#
- class ArrowHead(*args: Any, id: ID | None = None, **kwargs: Any)[源代码]#
基础类:
Marking箭头基类。
注意
这是一个抽象基类,用于帮助组织Bokeh模型类型的层次结构。单独实例化它没有用处。
JSON Prototype
{ "id": "p52103", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "size": { "type": "value", "value": 25 }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- name = None#
-
此模型的任意用户提供的名称。
在查询文档以检索特定Bokeh模型时,此名称可能很有用。
>>> plot.circle([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,没有强制执行唯一性保证或其他条件,Bokeh也不会直接使用这些名称。
- size = 25#
- Type:
箭头的大小,以像素为单位。
- syncable = True#
- Type:
指示当在网页浏览器中更新时,此模型是否应同步回Bokeh服务器。设置为
False可能有助于在处理频繁更新的对象时减少网络流量,这些对象的更新值我们不需要。注意
将此属性设置为
False将阻止此对象上的任何on_change()回调触发。然而,任何JS端的回调仍然会工作。
- tags = []#
- Type:
一个可选的任意用户提供的值列表,用于附加到此模型。
在查询文档以检索特定Bokeh模型时,这些数据可能很有用:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者只是将任何必要的元数据附加到模型的一种便捷方式,这些元数据可以通过
CustomJS回调等方式访问。注意
对于提供的任何标签,没有强制执行唯一性保证或其他条件,Bokeh也不会出于任何原因直接使用这些标签。
- apply_theme(property_values: dict[str, Any]) None#
应用一组主题值,这些值将用于替代默认值,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享以节省内存(因此调用者和
HasProps实例都不应修改它)。- Parameters:
property_values (dict) – 用于替换默认值的主题值
- Returns:
无
- classmethod clear_extensions() None#
清除当前定义的所有自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]]#
属性描述符的列表,按定义的顺序排列。
- equals(other: HasProps) bool#
模型的结构相等性。
- Parameters:
其他 (HasProps) – 要比较的其他实例
- Returns:
如果属性在结构上相等,则为True,否则为False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None#
使用JavaScript链接两个Bokeh模型属性。
这是一个便捷的方法,简化了添加一个
CustomJS回调的过程,以便在另一个属性值发生变化时更新一个 Bokeh 模型属性。- Parameters:
在版本1.1中添加
- Raises:
示例
这段代码使用了
js_link:select.js_link('value', plot, 'sizing_mode')
等同于以下内容:
from bokeh.models import CustomJS select.js_on_change('value', CustomJS(args=dict(other=plot), code="other.sizing_mode = this.value" ) )
此外,使用attr_selector将范围滑块的左侧附加到绘图的x_range:
range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)
这相当于:
from bokeh.models import CustomJS range_slider.js_on_change('value', CustomJS(args=dict(other=plot.x_range), code="other.start = this.value[0]" ) )
- js_on_change(event: str, *callbacks: JSChangeCallback) None#
将一个
CustomJS回调附加到任意的BokehJS模型事件。在BokehJS方面,模型属性的更改事件具有
"change:property_name"的形式。为了方便起见,如果传递给此方法的事件名称也是模型上属性的名称,那么它将自动加上"change:"前缀:# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
然而,除了属性更改事件之外,还有其他类型的事件可能对响应有用。例如,每当数据流式传输到
ColumnDataSource时运行回调,可以在源上使用"stream"事件:source.js_on_change('streaming', callback)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None#
在类上找到Bokeh属性的
PropertyDescriptor,给定属性名称。- Parameters:
- Returns:
名为
name的属性的描述符- Return type:
- on_change(attr: str, *callbacks: PropertyCallback) None#
在此对象上添加一个回调,当
attr发生变化时触发。- Parameters:
attr (str) – 此对象上的一个属性名称
*callbacks (callable) – 要注册的回调函数
- Returns:
无
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None#
当此模型上发生指定事件时运行回调
并非所有模型都支持所有事件。 有关哪些模型能够触发特定事件的更多信息,请参见bokeh.events中的具体事件。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]]#
收集此类的属性名称。
警告
在Bokeh的未来版本中,此方法将返回一个将属性名称映射到属性对象的字典。为了使当前使用此方法的方式具有未来兼容性,请将返回值包装在
list中。- Returns:
属性名称
- classmethod properties_with_refs() dict[str, Property[Any]]#
收集此类上所有具有引用的属性的名称。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
- properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
收集一个将属性名称映射到其值的字典。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,属性值以“序列化”格式呈现,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损重构对象实例所需的信息。
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
使用谓词查询
HasProps实例的属性值。
- select(selector: SelectorType) Iterable[Model]#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
- Returns:
序列[模型]
- select_one(selector: SelectorType) Model | None#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何内容,则返回None :param selector: :type selector: JSON-like
- Returns:
模型
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#
从JSON设置此对象的属性值。
- Parameters:
name (str) – 要设置的属性名称
value (JSON-value) – 要设置给属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对Bokeh应用程序的“回旋镖”更新。
在Bokeh服务器应用程序的上下文中,对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较,并抑制源自自身的任何更新。
- Returns:
无
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None#
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
更新 (dict)
- Returns:
无
- themed_values() dict[str, Any] | None#
获取任何主题提供的覆盖。
结果以属性名称到值的字典形式返回,如果此实例没有主题覆盖任何值,则返回
None。- Returns:
字典或无
- to_serializable(serializer: Serializer) ObjectRefRep#
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None#
- class Band(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基础类:
DataAnnotation沿着一个维度渲染一个填充区域带。
请参阅Bands以获取关于绘制波段的信息。
JSON Prototype
{ "base": { "field": "base", "type": "field" }, "context_menu": null, "coordinates": null, "css_classes": [], "css_variables": { "type": "map" }, "dimension": "height", "elements": [], "fill_alpha": 0.4, "fill_color": "#fff9ba", "group": null, "id": "p52108", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "level": "annotation", "line_alpha": 0.3, "line_cap": "butt", "line_color": "#cccccc", "line_dash": [], "line_dash_offset": 0, "line_join": "bevel", "line_width": 1, "lower": { "field": "lower", "type": "field" }, "name": null, "propagate_hover": false, "renderers": [], "source": { "attributes": { "data": { "type": "map" }, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p52110", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p52111", "name": "UnionRenderers", "type": "object" } }, "id": "p52109", "name": "ColumnDataSource", "type": "object" }, "styles": { "type": "map" }, "stylesheets": [], "subscribed_events": { "type": "set" }, "syncable": true, "tags": [], "upper": { "field": "upper", "type": "field" }, "visible": true, "x_range_name": "default", "y_range_name": "default" }
- base_units = 'data'#
- Type:
用于关联属性的单位:canvas、screen 或 data
- css_variables = {}#
-
允许定义动态计算的CSS变量。
例如,这可以用于协调canvas渲染器和/或视觉效果与基于HTML的UI元素之间的定位和样式。
这里定义的变量等同于在CSS样式表中的
:host { ... }下设置相同的变量。注意
此属性是实验性的,可能会随时更改。
- elements = []#
- Type:
附加到此渲染器的基于DOM的UI元素集合。
这可以包括像工具提示这样的浮动元素,允许在此渲染器与其UI元素之间建立父子关系。
注意
此属性相当于基于DOM的用户界面中的
Pane.elements。
- group = None#
- Type:
注意
此属性是实验性的,可能会随时更改。
- level = 'annotation'#
- Type:
指定绘制此渲染器的层级。
- line_dash = []#
- Type:
波段的虚线值。
- lower_units = 'data'#
- Type:
用于关联属性的单位:canvas、screen 或 data
- name = None#
-
此模型的任意用户提供的名称。
在查询文档以检索特定Bokeh模型时,此名称可能很有用。
>>> plot.circle([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,没有强制执行唯一性保证或其他条件,Bokeh也不会直接使用这些名称。
- source = ColumnDataSource(id='p52208', ...)#
- Type:
在图表上渲染注释时使用的本地数据源。
- stylesheets = []#
- Type:
用于底层DOM元素的附加样式表。
请注意,所有Bokeh的组件都使用影子DOM,因此任何包含的样式表都必须反映这一点,例如使用
:hostCSS伪选择器来访问根DOM元素。
- syncable = True#
- Type:
指示当在网页浏览器中更新时,此模型是否应同步回Bokeh服务器。设置为
False可能有助于在处理频繁更新的对象时减少网络流量,这些对象的更新值我们不需要。注意
将此属性设置为
False将阻止此对象上的任何on_change()回调触发。然而,任何JS端的回调仍然会工作。
- tags = []#
- Type:
一个可选的任意用户提供的值列表,用于附加到此模型。
在查询文档以检索特定Bokeh模型时,这些数据可能很有用:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者只是将任何必要的元数据附加到模型的一种便捷方式,这些元数据可以通过
CustomJS回调等方式访问。注意
对于提供的任何标签,没有强制执行唯一性保证或其他条件,Bokeh也不会出于任何原因直接使用这些标签。
- upper_units = 'data'#
- Type:
用于关联属性的单位:canvas、screen 或 data
- apply_theme(property_values: dict[str, Any]) None#
应用一组主题值,这些值将用于替代默认值,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享以节省内存(因此调用者和
HasProps实例都不应修改它)。- Parameters:
property_values (dict) – 用于替换默认值的主题值
- Returns:
无
- classmethod clear_extensions() None#
清除当前定义的所有自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]]#
属性描述符的列表,按定义的顺序排列。
- equals(other: HasProps) bool#
模型的结构相等性。
- Parameters:
其他 (HasProps) – 要比较的其他实例
- Returns:
如果属性在结构上相等,则为True,否则为False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None#
使用JavaScript链接两个Bokeh模型属性。
这是一个便捷的方法,简化了添加一个
CustomJS回调的过程,以便在另一个属性值发生变化时更新一个 Bokeh 模型属性。- Parameters:
在版本1.1中添加
- Raises:
示例
这段代码使用了
js_link:select.js_link('value', plot, 'sizing_mode')
等同于以下内容:
from bokeh.models import CustomJS select.js_on_change('value', CustomJS(args=dict(other=plot), code="other.sizing_mode = this.value" ) )
此外,使用attr_selector将范围滑块的左侧附加到绘图的x_range:
range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)
这相当于:
from bokeh.models import CustomJS range_slider.js_on_change('value', CustomJS(args=dict(other=plot.x_range), code="other.start = this.value[0]" ) )
- js_on_change(event: str, *callbacks: JSChangeCallback) None#
将一个
CustomJS回调附加到任意的BokehJS模型事件。在BokehJS方面,模型属性的更改事件具有
"change:property_name"的形式。为了方便起见,如果传递给此方法的事件名称也是模型上属性的名称,那么它将自动加上"change:"前缀:# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
然而,除了属性更改事件之外,还有其他类型的事件可能对响应有用。例如,每当数据流式传输到
ColumnDataSource时运行回调,可以在源上使用"stream"事件:source.js_on_change('streaming', callback)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None#
在类上找到Bokeh属性的
PropertyDescriptor,给定属性名称。- Parameters:
- Returns:
名为
name的属性的描述符- Return type:
- on_change(attr: str, *callbacks: PropertyCallback) None#
在此对象上添加一个回调,当
attr发生变化时触发。- Parameters:
attr (str) – 此对象上的一个属性名称
*callbacks (callable) – 要注册的回调函数
- Returns:
无
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None#
当此模型上发生指定事件时运行回调
并非所有模型都支持所有事件。 有关哪些模型能够触发特定事件的更多信息,请参见bokeh.events中的具体事件。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]]#
收集此类的属性名称。
警告
在Bokeh的未来版本中,此方法将返回一个将属性名称映射到属性对象的字典。为了使当前使用此方法的方式具有未来兼容性,请将返回值包装在
list中。- Returns:
属性名称
- classmethod properties_with_refs() dict[str, Property[Any]]#
收集此类上所有具有引用的属性的名称。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
- properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
收集一个将属性名称映射到其值的字典。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,属性值以“序列化”格式呈现,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损重构对象实例所需的信息。
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
使用谓词查询
HasProps实例的属性值。
- select(selector: SelectorType) Iterable[Model]#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
- Returns:
序列[模型]
- select_one(selector: SelectorType) Model | None#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何内容,则返回None :param selector: :type selector: JSON-like
- Returns:
模型
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#
从JSON设置此对象的属性值。
- Parameters:
name (str) – 要设置的属性名称
value (JSON-value) – 要设置给属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对Bokeh应用程序的“回旋镖”更新。
在Bokeh服务器应用程序的上下文中,对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较,并抑制源自自身的任何更新。
- Returns:
无
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None#
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
更新 (dict)
- Returns:
无
- themed_values() dict[str, Any] | None#
获取任何主题提供的覆盖。
结果以属性名称到值的字典形式返回,如果此实例没有主题覆盖任何值,则返回
None。- Returns:
字典或无
- to_serializable(serializer: Serializer) ObjectRefRep#
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None#
- class BoxAnnotation(*args: Any, id: ID | None = None, **kwargs: Any)[源代码]#
基础类:
Annotation,AreaVisuals渲染一个带阴影的矩形区域作为注释。
请参阅Box annotations以获取有关绘制箱形注释的信息。
JSON Prototype
{ "border_radius": 0, "bottom": { "attributes": { "symbol": "bottom", "target": "frame" }, "id": "p52251", "name": "Node", "type": "object" }, "bottom_limit": null, "bottom_units": "data", "context_menu": null, "coordinates": null, "css_classes": [], "css_variables": { "type": "map" }, "editable": false, "elements": [], "fill_alpha": 0.4, "fill_color": "#fff9ba", "group": null, "handles": { "attributes": { "all": { "attributes": { "fill_color": "white", "hover_fill_color": "lightgray" }, "id": "p52252", "name": "AreaVisuals", "type": "object" } }, "id": "p52253", "name": "BoxInteractionHandles", "type": "object" }, "hatch_alpha": 1.0, "hatch_color": "black", "hatch_extra": { "type": "map" }, "hatch_pattern": null, "hatch_scale": 12.0, "hatch_weight": 1.0, "hover_fill_alpha": 0.4, "hover_fill_color": null, "hover_hatch_alpha": 1.0, "hover_hatch_color": "black", "hover_hatch_extra": { "type": "map" }, "hover_hatch_pattern": null, "hover_hatch_scale": 12.0, "hover_hatch_weight": 1.0, "hover_line_alpha": 0.3, "hover_line_cap": "butt", "hover_line_color": null, "hover_line_dash": [], "hover_line_dash_offset": 0, "hover_line_join": "bevel", "hover_line_width": 1, "id": "p52247", "inverted": false, "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "left": { "attributes": { "symbol": "left", "target": "frame" }, "id": "p52248", "name": "Node", "type": "object" }, "left_limit": null, "left_units": "data", "level": "annotation", "line_alpha": 0.3, "line_cap": "butt", "line_color": "#cccccc", "line_dash": [], "line_dash_offset": 0, "line_join": "bevel", "line_width": 1, "max_height": { "type": "number", "value": "+inf" }, "max_width": { "type": "number", "value": "+inf" }, "min_height": 0, "min_width": 0, "movable": "both", "name": null, "propagate_hover": false, "renderers": [], "resizable": "all", "right": { "attributes": { "symbol": "right", "target": "frame" }, "id": "p52249", "name": "Node", "type": "object" }, "right_limit": null, "right_units": "data", "styles": { "type": "map" }, "stylesheets": [], "subscribed_events": { "type": "set" }, "symmetric": false, "syncable": true, "tags": [], "top": { "attributes": { "symbol": "top", "target": "frame" }, "id": "p52250", "name": "Node", "type": "object" }, "top_limit": null, "top_units": "data", "use_handles": false, "visible": true, "x_range_name": "default", "y_range_name": "default" }
- border_radius = 0#
- Type:
Either(NonNegative,Tuple(NonNegative,NonNegative,NonNegative,NonNegative),Struct)
允许盒子具有圆角。
注意
此属性是实验性的,可能会随时更改。
- bottom = Node(id='p52268', ...)#
-
框注释底边的y坐标。
- bottom_limit = None#
-
盒子移动的可选底部限制。
注意
此属性是实验性的,可能会随时更改。
- css_variables = {}#
-
允许定义动态计算的CSS变量。
例如,这可以用于协调canvas渲染器和/或视觉效果与基于HTML的UI元素之间的定位和样式。
这里定义的变量等同于在CSS样式表中的
:host { ... }下设置相同的变量。注意
此属性是实验性的,可能会随时更改。
- elements = []#
- Type:
附加到此渲染器的基于DOM的UI元素集合。
这可以包括像工具提示这样的浮动元素,允许在此渲染器与其UI元素之间建立父子关系。
注意
此属性相当于基于DOM的用户界面中的
Pane.elements。
- group = None#
- Type:
注意
此属性是实验性的,可能会随时更改。
- handles = BoxInteractionHandles(id='p52347', ...)#
- Type:
配置交互手柄的外观。
可以按递增的特定级别批量配置句柄,每个级别如果定义了,将覆盖更通用的设置:
all -> move, resize
resize -> sides, corners
sides -> left, right, top, bottom
corners -> top_left, top_right, bottom_left, bottom_right
注意
此属性是实验性的,可能会随时更改。
- hover_line_dash = []#
- Type:
悬停时框的虚线值。
- left = Node(id='p52509', ...)#
-
框注释左侧边缘的x坐标。
- left_limit = None#
-
盒子移动的可选左限。
注意
此属性是实验性的,可能会随时更改。
- level = 'annotation'#
- Type:
指定绘制此渲染器的层级。
- line_dash = []#
- Type:
盒子的虚线值。
- min_height = 0#
- Type:
允许设置盒子的最大宽度。
注意
此属性是实验性的,可能会随时更改。
- min_width = 0#
- Type:
允许设置盒子的最小宽度。
注意
此属性是实验性的,可能会随时更改。
- name = None#
-
此模型的任意用户提供的名称。
在查询文档以检索特定Bokeh模型时,此名称可能很有用。
>>> plot.circle([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,没有强制执行唯一性保证或其他条件,Bokeh也不会直接使用这些名称。
- resizable = 'all'#
-
如果设置了
editable,此属性允许配置哪些边的组合可以被移动,从而允许对框的大小调整进行限制。注意
此属性是实验性的,可能会随时更改。
- right = Node(id='p52650', ...)#
-
框注释右侧边缘的x坐标。
- right_limit = None#
-
盒子移动的可选右限。
注意
此属性是实验性的,可能会随时更改。
- stylesheets = []#
- Type:
用于底层DOM元素的附加样式表。
请注意,所有Bokeh的组件都使用影子DOM,因此任何包含的样式表都必须反映这一点,例如使用
:hostCSS伪选择器来访问根DOM元素。
- syncable = True#
- Type:
指示当在网页浏览器中更新时,此模型是否应同步回Bokeh服务器。设置为
False可能有助于在处理频繁更新的对象时减少网络流量,这些对象的更新值我们不需要。注意
将此属性设置为
False将阻止此对象上的任何on_change()回调触发。然而,任何JS端的回调仍然会工作。
- tags = []#
- Type:
一个可选的任意用户提供的值列表,用于附加到此模型。
在查询文档以检索特定Bokeh模型时,这些数据可能很有用:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者只是将任何必要的元数据附加到模型的一种便捷方式,这些元数据可以通过
CustomJS回调等方式访问。注意
对于提供的任何标签,没有强制执行唯一性保证或其他条件,Bokeh也不会出于任何原因直接使用这些标签。
- top = Node(id='p52707', ...)#
-
框注释顶部边缘的y坐标。
- top_limit = None#
-
盒子移动的可选上限。
注意
此属性是实验性的,可能会随时更改。
- use_handles = False#
- Type:
是否显示交互(移动、调整大小等)手柄。
如果不使用手柄,那么整个注释、其边框和角落的行为就像它们是交互手柄一样。
注意
此属性是实验性的,可能会随时更改。
- apply_theme(property_values: dict[str, Any]) None#
应用一组主题值,这些值将用于替代默认值,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享以节省内存(因此调用者和
HasProps实例都不应修改它)。- Parameters:
property_values (dict) – 用于替换默认值的主题值
- Returns:
无
- classmethod clear_extensions() None#
清除当前定义的所有自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]]#
属性描述符的列表,按定义的顺序排列。
- equals(other: HasProps) bool#
模型的结构相等性。
- Parameters:
其他 (HasProps) – 要比较的其他实例
- Returns:
如果属性在结构上相等,则为True,否则为False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None#
使用JavaScript链接两个Bokeh模型属性。
这是一个便捷的方法,简化了添加一个
CustomJS回调的过程,以便在另一个属性值发生变化时更新一个 Bokeh 模型属性。- Parameters:
在版本1.1中添加
- Raises:
示例
这段代码使用了
js_link:select.js_link('value', plot, 'sizing_mode')
等同于以下内容:
from bokeh.models import CustomJS select.js_on_change('value', CustomJS(args=dict(other=plot), code="other.sizing_mode = this.value" ) )
此外,使用attr_selector将范围滑块的左侧附加到绘图的x_range:
range_slider.js_link('value', plot.x_range, 'start', attr_selector=0)
这相当于:
from bokeh.models import CustomJS range_slider.js_on_change('value', CustomJS(args=dict(other=plot.x_range), code="other.start = this.value[0]" ) )
- js_on_change(event: str, *callbacks: JSChangeCallback) None#
将一个
CustomJS回调附加到任意的BokehJS模型事件。在BokehJS方面,模型属性的更改事件具有
"change:property_name"的形式。为了方便起见,如果传递给此方法的事件名称也是模型上属性的名称,那么它将自动加上"change:"前缀:# these two are equivalent source.js_on_change('data', callback) source.js_on_change('change:data', callback)
然而,除了属性更改事件之外,还有其他类型的事件可能对响应有用。例如,每当数据流式传输到
ColumnDataSource时运行回调,可以在源上使用"stream"事件:source.js_on_change('streaming', callback)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None#
在类上找到Bokeh属性的
PropertyDescriptor,给定属性名称。- Parameters:
- Returns:
名为
name的属性的描述符- Return type:
- on_change(attr: str, *callbacks: PropertyCallback) None#
在此对象上添加一个回调,当
attr发生变化时触发。- Parameters:
attr (str) – 此对象上的一个属性名称
*callbacks (callable) – 要注册的回调函数
- Returns:
无
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None#
当此模型上发生指定事件时运行回调
并非所有模型都支持所有事件。 有关哪些模型能够触发特定事件的更多信息,请参见bokeh.events中的具体事件。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]]#
收集此类的属性名称。
警告
在Bokeh的未来版本中,此方法将返回一个将属性名称映射到属性对象的字典。为了使当前使用此方法的方式具有未来兼容性,请将返回值包装在
list中。- Returns:
属性名称
- classmethod properties_with_refs() dict[str, Property[Any]]#
收集此类上所有具有引用的属性的名称。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
- properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
收集一个将属性名称映射到其值的字典。
此方法始终遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,属性值以“序列化”格式呈现,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损重构对象实例所需的信息。
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#
使用谓词查询
HasProps实例的属性值。
- select(selector: SelectorType) Iterable[Model]#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
- Returns:
序列[模型]
- select_one(selector: SelectorType) Model | None#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何内容,则返回None :param selector: :type selector: JSON-like
- Returns:
模型
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#
从JSON设置此对象的属性值。
- Parameters:
name (str) – 要设置的属性名称
value (JSON-value) – 要设置给属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对Bokeh应用程序的“回旋镖”更新。
在Bokeh服务器应用程序的上下文中,对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较,并抑制源自自身的任何更新。
- Returns:
无
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None#
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- Parameters:
selector (类似JSON的)
更新 (dict)
- Returns:
无
- themed_values() dict[str, Any] | None#
获取任何主题提供的覆盖。
结果以属性名称到值的字典形式返回,如果此实例没有主题覆盖任何值,则返回
None。- Returns:
字典或无
- to_serializable(serializer: Serializer) ObjectRefRep#
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None#