sources#
- class AjaxDataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基类:
WebDataSource
一个可以通过 Ajax 调用 REST 端点来填充列的数据源。
如果您想创建一个独立的文档(即,没有 Bokeh 服务器支持),但仍然可以使用现有的 REST API 动态更新,则
AjaxDataSource
特别有用。来自 REST API 的响应应与标准
ColumnDataSource
的.data
属性匹配,即一个 JSON 字典,将名称映射到值数组{ 'x' : [1, 2, 3, ...], 'y' : [9, 3, 2, ...] }
或者,如果 REST API 返回不同的格式,则可以提供
CustomJS
回调,通过此数据源的adapter
属性将 REST 响应转换为 Bokeh 格式。可以通过直接指定
data
属性来设置初始数据。当与FactorRange
结合使用时,即使 data` 中的列为空,这也是必要的。一个完整的示例可以在 examples/basic/data/ajax_source.py 中查看
JSON 原型
{ "adapter": null, "content_type": "application/json", "data": { "type": "map" }, "data_url": { "name": "unset", "type": "symbol" }, "default_values": { "type": "map" }, "http_headers": { "type": "map" }, "id": "p64800", "if_modified": false, "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "max_size": null, "method": "POST", "mode": "replace", "name": null, "polling_interval": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64801", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p64802", "name": "UnionRenderers", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- adapter = None#
-
一个 JavaScript 回调,用于将原始 JSON 响应适配为 Bokeh
ColumnDataSource
格式。如果提供,则此回调将在收到 JSON 数据后立即执行,但在附加或替换数据源中的数据之前执行。
CustomJS
回调将接收AjaxDataSource
作为cb_obj
,并将接收原始 JSON 响应作为cb_data.response
。回调代码应返回适合 BokehColumnDataSource
的data
对象(即,字符串列名到数据数组的映射)。
- data = {}#
- 类型:
列名到数据序列的映射。列可以是,例如,Python 列表或元组、NumPy 数组等。
.data 属性也可以从 Pandas DataFrames 或 GroupBy 对象设置。在这些情况下,行为与将对象传递给
ColumnDataSource
初始化程序相同。
- default_values = {}#
-
定义每列的默认值。
当将行插入数据源时(例如通过编辑工具),如果未显式提供给定列的值,则会使用此值。如果缺少默认值,则工具将参考其自身的配置,或者尝试让数据源推断出合理的默认值。
- http_headers = {}#
-
指定为 Ajax 请求设置的 HTTP 标头。
示例
ajax_source.headers = { 'x-my-custom-header': 'some value' }
- if_modified = False#
- 类型:
是否在发送到服务器的 Ajax 请求中包含
If-Modified-Since
标头。如果服务器支持此标头,则只会返回自上次请求以来的新数据。
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p64842', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- selection_policy = UnionRenderers(id='p64846', ...)#
- 类型:
SelectionPolicy
的实例,确定如何设置选择。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- classmethod from_df(data: pd.DataFrame) DataDict #
从 Pandas
DataFrame
创建列的dict
,适用于创建ColumnDataSource
。- 参数:
data (DataFrame) – 要转换的数据
- 返回值:
dict[str, np.array]
- classmethod from_groupby(data: pd.core.groupby.GroupBy) DataDict #
从 Pandas
GroupBy
创建列的dict
,适用于创建ColumnDataSource
。生成的数据是对组运行
describe
的结果。- 参数:
data (Groupby) – 要转换的数据
- 返回值:
dict[str, np.array]
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- patch(patches: Patches, setter: Setter | None = None) None #
在特定位置高效地更新数据源列。
如果只需要更新
ColumnDataSource
中的一小部分数据,则可以使用此方法高效地仅更新子集,而无需发送整个数据集。此方法应传递一个字典,该字典将列名称映射到描述要应用的补丁更改的元组列表。要完全替换列中的单个项目,元组应采用以下形式
(index, new_value) # replace a single column value # or (slice, new_values) # replace several column values
索引或切片处的值将被替换为相应的的新值。
对于其值是其他数组或列表的列(例如,图像或 patches glyphs),也可以修补“子区域”。在这种情况下,元组的第一项应该是一个,其第一个元素是 CDS 补丁中数组项的索引,其后续元素是数组项的整数索引或切片
# replace the entire 10th column of the 2nd array: +----------------- index of item in column data source | | +--------- row subindex into array item | | | | +- column subindex into array item V V V ([2, slice(None), 10], new_values)
想象一下 2d NumPy 数组的列表,上面的补丁大致等效于
data = [arr1, arr2, ...] # list of 2d arrays data[2][:, 10] = new_data
可以接受的切片和数据类型有一些限制。
切片的负
start
、stop
或step
值将导致ValueError
。在切片中,
start > stop
将导致ValueError
当修补 1d 或 2d 子项时,子项必须是 NumPy 数组。
新值必须作为适当大小的**展平的一维数组**提供。
- 参数:
- 返回值:
None
- Raises:
示例
以下示例演示如何修补整个列元素。在这种情况下,
source = ColumnDataSource(data=dict(foo=[10, 20, 30], bar=[100, 200, 300])) patches = { 'foo' : [ (slice(2), [11, 12]) ], 'bar' : [ (0, 101), (2, 301) ], } source.patch(patches)
在此操作之后,
source.data
的值将是dict(foo=[11, 12, 30], bar=[101, 200, 301])
有关更全面的示例,请参阅 examples/server/app/patch_app.py。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- stream(new_data: DataDict, rollover: int | None = None) None #
使用新的仅追加数据高效地更新数据源列。
在需要更新数据列的情况下,此方法可以高效地仅发送新数据,而无需重新发送整个数据集。
- 参数:
- 返回值:
None
- Raises:
示例
source = ColumnDataSource(data=dict(foo=[], bar=[])) # has new, identical-length updates for all columns in source new_data = { 'foo' : [10, 20], 'bar' : [100, 200], } source.stream(new_data)
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_df() pd.DataFrame #
将此数据源转换为 pandas
DataFrame
。- 返回值:
DataFrame
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class CDSView(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基类:
Model
一个
ColumnDataSource
的视图,表示按行划分的子集。JSON 原型
{ "filter": { "id": "p64854", "name": "AllIndices", "type": "object" }, "id": "p64853", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- filter = AllIndices(id='p64857', ...)#
-
定义要从此视图应用到的数据源中使用的索引子集。
默认情况下,使用所有索引 (
AllIndices
过滤器)。 这可以通过使用专门的过滤器(如IndexFilter
、BooleanFilter
等)来更改。 过滤器可以使用集合运算进行组合,以创建非平凡的数据掩码。 这可以通过直接使用诸如InversionFilter
、UnionFilter
等模型来完成,或者通过对过滤器使用集合运算符来完成,例如:# filters everything but indexes 10 and 11 cds_view.filter &= ~IndexFilter(indices=[10, 11])
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, **callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], **callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class ColumnDataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
Bases:
ColumnarDataSource
将列名映射到序列或数组。
ColumnDataSource
是 Bokeh 的基础数据结构。大多数绘图、数据表格等都将由ColumnDataSource
驱动。如果使用单个参数调用
ColumnDataSource
初始化器,则该参数可以是以下任何一种一个 Python
dict
,它将字符串名称映射到值序列,例如列表、数组等。data = {'x': [1,2,3,4], 'y': np.array([10.0, 20.0, 30.0, 40.0])} source = ColumnDataSource(data)
注意
ColumnDataSource
仅创建data
的浅拷贝。如果从另一个ColumnDataSource.data
对象初始化,并且您希望保持独立性,请使用例如ColumnDataSource(copy.deepcopy(data))
。一个 Pandas
DataFrame
对象source = ColumnDataSource(df)
在这种情况下,CDS 将具有与
DataFrame
的列相对应的列。如果DataFrame
列具有多个级别,则将使用下划线将其展平(例如 level_0_col_level_1_col)。如果DataFrame
的索引是MultiIndex
,则会将其展平为元组的Index
,然后使用reset_index
重置。如果索引已命名,则结果将是具有相同名称的列;如果索引是已命名的MultiIndex
,则结果将是 level_0_name_level_1_name。如果Index
没有名称,或者MultiIndex
名称无法展平/确定,则reset_index
函数会将索引列命名为index
,如果名称index
不可用,则命名为level_0
。一个 Pandas
GroupBy
对象group = df.groupby(('colA', 'ColB'))
在这种情况下,CDS 将具有与调用
group.describe()
的结果相对应的列。describe
方法为所有未分组的原始列生成统计度量列,例如mean
和count
。CDS 列通过将原始列名与计算的度量连接而成。例如,如果DataFrame
具有列'year'
和'mpg'
。然后将df.groupby('year')
传递给 CDS 将生成诸如'mpg_mean'
之类的列如果
GroupBy.describe
结果具有命名的索引列,则 CDS 也将具有具有此名称的列。但是,如果索引名称(或MultiIndex
的任何子名称)为None
,则 CDS 将具有一个通用名称为index
的索引列。请注意,这种调整
GroupBy
对象的功能可能仅适用于 Pandas>=0.20.0
。
注意
存在一个隐含的假设,即给定
ColumnDataSource
中的所有列在任何时候都具有相同的长度。因此,通常最好“一次性”更新数据源的.data
属性。JSON 原型
{ "data": { "type": "map" }, "default_values": { "type": "map" }, "id": "p64864", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64865", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p64866", "name": "UnionRenderers", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- data = {}#
- 类型:
列名到数据序列的映射。列可以是,例如,Python 列表或元组、NumPy 数组等。
.data 属性也可以从 Pandas DataFrames 或 GroupBy 对象设置。在这些情况下,行为与将对象传递给
ColumnDataSource
初始化程序相同。
- default_values = {}#
-
定义每列的默认值。
当将行插入数据源时(例如通过编辑工具),如果未显式提供给定列的值,则会使用此值。如果缺少默认值,则工具将参考其自身的配置,或者尝试让数据源推断出合理的默认值。
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p64879', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- selection_policy = UnionRenderers(id='p64883', ...)#
- 类型:
SelectionPolicy
的实例,确定如何设置选择。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([1,2,3], [4,5,6]) >>> r.tags = ["foo", 10] >>> plot.select(tags=['foo', 10]) [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
或者,仅仅是将任何必要的元数据附加到可以通过
CustomJS
回调等访问的模型的便捷方法。注意
对于提供的任何标签,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用这些标签。
- __init__(data: DataDict | pd.DataFrame | pd.core.groupby.GroupBy, **kwargs: Any) None [source]#
- __init__(**kwargs: Any) None
如果使用单个参数(为 dict 或
pandas.DataFrame
)调用,则隐式地将其视为 “data” 属性。
- apply_theme(property_values: dict[str, Any]) None #
应用一组主题值,这些值将代替默认值使用,但不会覆盖应用程序设置的值。
传入的字典可能会保持原样并与其他实例共享,以节省内存(因此调用者和
HasProps
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- classmethod from_df(data: pd.DataFrame) DataDict [source]#
从 Pandas
DataFrame
创建列的dict
,适用于创建ColumnDataSource
。- 参数:
data (DataFrame) – 要转换的数据
- 返回值:
dict[str, np.array]
- classmethod from_groupby(data: pd.core.groupby.GroupBy) DataDict [source]#
从 Pandas
GroupBy
创建列的dict
,适用于创建ColumnDataSource
。生成的数据是对组运行
describe
的结果。- 参数:
data (Groupby) – 要转换的数据
- 返回值:
dict[str, np.array]
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- patch(patches: Patches, setter: Setter | None = None) None [source]#
在特定位置高效地更新数据源列。
如果只需要更新
ColumnDataSource
中的一小部分数据,则可以使用此方法高效地仅更新子集,而无需发送整个数据集。此方法应传递一个字典,该字典将列名称映射到描述要应用的补丁更改的元组列表。要完全替换列中的单个项目,元组应采用以下形式
(index, new_value) # replace a single column value # or (slice, new_values) # replace several column values
索引或切片处的值将被替换为相应的的新值。
对于其值是其他数组或列表的列(例如,图像或 patches glyphs),也可以修补“子区域”。在这种情况下,元组的第一项应该是一个,其第一个元素是 CDS 补丁中数组项的索引,其后续元素是数组项的整数索引或切片
# replace the entire 10th column of the 2nd array: +----------------- index of item in column data source | | +--------- row subindex into array item | | | | +- column subindex into array item V V V ([2, slice(None), 10], new_values)
想象一下 2d NumPy 数组的列表,上面的补丁大致等效于
data = [arr1, arr2, ...] # list of 2d arrays data[2][:, 10] = new_data
可以接受的切片和数据类型有一些限制。
切片的负
start
、stop
或step
值将导致ValueError
。在切片中,
start > stop
将导致ValueError
当修补 1d 或 2d 子项时,子项必须是 NumPy 数组。
新值必须作为适当大小的**展平的一维数组**提供。
- 参数:
- 返回值:
None
- Raises:
示例
以下示例演示如何修补整个列元素。在这种情况下,
source = ColumnDataSource(data=dict(foo=[10, 20, 30], bar=[100, 200, 300])) patches = { 'foo' : [ (slice(2), [11, 12]) ], 'bar' : [ (0, 101), (2, 301) ], } source.patch(patches)
在此操作之后,
source.data
的值将是dict(foo=[11, 12, 30], bar=[101, 200, 301])
有关更全面的示例,请参阅 examples/server/app/patch_app.py。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- stream(new_data: DataDict, rollover: int | None = None) None [source]#
使用新的仅追加数据高效地更新数据源列。
在需要更新数据列的情况下,此方法可以高效地仅发送新数据,而无需重新发送整个数据集。
- 参数:
- 返回值:
None
- Raises:
示例
source = ColumnDataSource(data=dict(foo=[], bar=[])) # has new, identical-length updates for all columns in source new_data = { 'foo' : [10, 20], 'bar' : [100, 200], } source.stream(new_data)
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class ColumnarDataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基簎:
DataSource
数据源类型的基簎类,可以映射到列式格式。
注意
这是一个抽象基簎类,用于帮助组织 Bokeh 模型类型的层次结构。 它本身不适合实例化。
JSON 原型
{ "default_values": { "type": "map" }, "id": "p64890", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64891", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p64892", "name": "UnionRenderers", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- default_values = {}#
-
定义每列的默认值。
当将行插入数据源时(例如通过编辑工具),如果未显式提供给定列的值,则会使用此值。如果缺少默认值,则工具将参考其自身的配置,或者尝试让数据源推断出合理的默认值。
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p64902', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- selection_policy = UnionRenderers(id='p64906', ...)#
- 类型:
SelectionPolicy
的实例,确定如何设置选择。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
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
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class DataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基类:
Model
数据源类型的基类。
注意
这是一个抽象基簎类,用于帮助组织 Bokeh 模型类型的层次结构。 它本身不适合实例化。
JSON 原型
{ "id": "p64913", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64914", "name": "Selection", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p64919', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class GeoJSONDataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
Bases:
ColumnarDataSource
JSON 原型
{ "default_values": { "type": "map" }, "geojson": { "name": "unset", "type": "symbol" }, "id": "p64924", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "name": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64925", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p64926", "name": "UnionRenderers", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- default_values = {}#
-
定义每列的默认值。
当将行插入数据源时(例如通过编辑工具),如果未显式提供给定列的值,则会使用此值。如果缺少默认值,则工具将参考其自身的配置,或者尝试让数据源推断出合理的默认值。
- geojson = Undefined#
-
包含用于绘图的要素的 GeoJSON。目前,
GeoJSONDataSource
只能处理FeatureCollection
或GeometryCollection
。
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p64939', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- selection_policy = UnionRenderers(id='p64943', ...)#
- 类型:
SelectionPolicy
的实例,确定如何设置选择。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class ServerSentDataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基类:
WebDataSource
一个可以通过接收服务器发送事件端点来填充列的数据源。
JSON 原型
{ "adapter": null, "data": { "type": "map" }, "data_url": { "name": "unset", "type": "symbol" }, "default_values": { "type": "map" }, "id": "p64950", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "max_size": null, "mode": "replace", "name": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64951", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p64952", "name": "UnionRenderers", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- adapter = None#
-
一个 JavaScript 回调,用于将原始 JSON 响应适配为 Bokeh
ColumnDataSource
格式。如果提供,则此回调将在收到 JSON 数据后立即执行,但在附加或替换数据源中的数据之前执行。
CustomJS
回调将接收AjaxDataSource
作为cb_obj
,并将接收原始 JSON 响应作为cb_data.response
。回调代码应返回适合 BokehColumnDataSource
的data
对象(即,字符串列名到数据数组的映射)。
- data = {}#
- 类型:
列名到数据序列的映射。列可以是,例如,Python 列表或元组、NumPy 数组等。
.data 属性也可以从 Pandas DataFrames 或 GroupBy 对象设置。在这些情况下,行为与将对象传递给
ColumnDataSource
初始化程序相同。
- default_values = {}#
-
定义每列的默认值。
当将行插入数据源时(例如通过编辑工具),如果未显式提供给定列的值,则会使用此值。如果缺少默认值,则工具将参考其自身的配置,或者尝试让数据源推断出合理的默认值。
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p64977', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- selection_policy = UnionRenderers(id='p64981', ...)#
- 类型:
SelectionPolicy
的实例,确定如何设置选择。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- classmethod from_df(data: pd.DataFrame) DataDict #
从 Pandas
DataFrame
创建列的dict
,适用于创建ColumnDataSource
。- 参数:
data (DataFrame) – 要转换的数据
- 返回值:
dict[str, np.array]
- classmethod from_groupby(data: pd.core.groupby.GroupBy) DataDict #
从 Pandas
GroupBy
创建列的dict
,适用于创建ColumnDataSource
。生成的数据是对组运行
describe
的结果。- 参数:
data (Groupby) – 要转换的数据
- 返回值:
dict[str, np.array]
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- patch(patches: Patches, setter: Setter | None = None) None #
在特定位置高效地更新数据源列。
如果只需要更新
ColumnDataSource
中的一小部分数据,则可以使用此方法高效地仅更新子集,而无需发送整个数据集。此方法应传递一个字典,该字典将列名称映射到描述要应用的补丁更改的元组列表。要完全替换列中的单个项目,元组应采用以下形式
(index, new_value) # replace a single column value # or (slice, new_values) # replace several column values
索引或切片处的值将被替换为相应的的新值。
对于其值是其他数组或列表的列(例如,图像或 patches glyphs),也可以修补“子区域”。在这种情况下,元组的第一项应该是一个,其第一个元素是 CDS 补丁中数组项的索引,其后续元素是数组项的整数索引或切片
# replace the entire 10th column of the 2nd array: +----------------- index of item in column data source | | +--------- row subindex into array item | | | | +- column subindex into array item V V V ([2, slice(None), 10], new_values)
想象一下 2d NumPy 数组的列表,上面的补丁大致等效于
data = [arr1, arr2, ...] # list of 2d arrays data[2][:, 10] = new_data
可以接受的切片和数据类型有一些限制。
切片的负
start
、stop
或step
值将导致ValueError
。在切片中,
start > stop
将导致ValueError
当修补 1d 或 2d 子项时,子项必须是 NumPy 数组。
新值必须作为适当大小的**展平的一维数组**提供。
- 参数:
- 返回值:
None
- Raises:
示例
以下示例演示如何修补整个列元素。在这种情况下,
source = ColumnDataSource(data=dict(foo=[10, 20, 30], bar=[100, 200, 300])) patches = { 'foo' : [ (slice(2), [11, 12]) ], 'bar' : [ (0, 101), (2, 301) ], } source.patch(patches)
在此操作之后,
source.data
的值将是dict(foo=[11, 12, 30], bar=[101, 200, 301])
有关更全面的示例,请参阅 examples/server/app/patch_app.py。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- stream(new_data: DataDict, rollover: int | None = None) None #
使用新的仅追加数据高效地更新数据源列。
在需要更新数据列的情况下,此方法可以高效地仅发送新数据,而无需重新发送整个数据集。
- 参数:
- 返回值:
None
- Raises:
示例
source = ColumnDataSource(data=dict(foo=[], bar=[])) # has new, identical-length updates for all columns in source new_data = { 'foo' : [10, 20], 'bar' : [100, 200], } source.stream(new_data)
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_df() pd.DataFrame #
将此数据源转换为 pandas
DataFrame
。- 返回值:
DataFrame
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- class WebDataSource(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基类:
ColumnDataSource
用于可以从数据 URL 更新的 Web 列数据源的基类。
注意
这个基类通常不适合自行实例化。
注意
这是一个抽象基簎类,用于帮助组织 Bokeh 模型类型的层次结构。 它本身不适合实例化。
JSON 原型
{ "adapter": null, "data": { "type": "map" }, "data_url": { "name": "unset", "type": "symbol" }, "default_values": { "type": "map" }, "id": "p64988", "js_event_callbacks": { "type": "map" }, "js_property_callbacks": { "type": "map" }, "max_size": null, "mode": "replace", "name": null, "selected": { "attributes": { "indices": [], "line_indices": [] }, "id": "p64989", "name": "Selection", "type": "object" }, "selection_policy": { "id": "p64990", "name": "UnionRenderers", "type": "object" }, "subscribed_events": { "type": "set" }, "syncable": true, "tags": [] }
- adapter = None#
-
一个 JavaScript 回调,用于将原始 JSON 响应适配为 Bokeh
ColumnDataSource
格式。如果提供,则此回调将在收到 JSON 数据后立即执行,但在附加或替换数据源中的数据之前执行。
CustomJS
回调将接收AjaxDataSource
作为cb_obj
,并将接收原始 JSON 响应作为cb_data.response
。回调代码应返回适合 BokehColumnDataSource
的data
对象(即,字符串列名到数据数组的映射)。
- data = {}#
- 类型:
列名到数据序列的映射。列可以是,例如,Python 列表或元组、NumPy 数组等。
.data 属性也可以从 Pandas DataFrames 或 GroupBy 对象设置。在这些情况下,行为与将对象传递给
ColumnDataSource
初始化程序相同。
- default_values = {}#
-
定义每列的默认值。
当将行插入数据源时(例如通过编辑工具),如果未显式提供给定列的值,则会使用此值。如果缺少默认值,则工具将参考其自身的配置,或者尝试让数据源推断出合理的默认值。
- name = None#
-
此模型的任意用户提供的名称。
当查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
- selected = Selection(id='p65015', ...)#
- 类型:
只读
Selection
的实例,指示此DataSource
上的选定索引。这是一个只读属性。您只能更改此对象的属性来更改选择(例如,selected.indices
)。
- selection_policy = UnionRenderers(id='p65019', ...)#
- 类型:
SelectionPolicy
的实例,确定如何设置选择。
- syncable = True#
- 类型:
指示当在 Web 浏览器中更新此模型时,是否应将其同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要这些对象的更新值)时,将其设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调触发。但是,任何 JS 端回调仍然有效。
- tags = []#
- 类型:
要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 Bokeh 模型时,此数据可能很有用
>>> r = plot.scatter([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
实例都不应修改它)。- 参数:
property_values (dict) – 要代替默认值使用的主题值
- 返回值:
None
- classmethod clear_extensions() None #
清除任何当前定义的自定义扩展。
序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- classmethod descriptors() list[PropertyDescriptor[Any]] #
属性描述符列表,按定义顺序排列。
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要与之比较的其他实例
- 返回值:
如果属性在结构上相等,则为 True,否则为 False
- classmethod from_df(data: pd.DataFrame) DataDict #
从 Pandas
DataFrame
创建列的dict
,适用于创建ColumnDataSource
。- 参数:
data (DataFrame) – 要转换的数据
- 返回值:
dict[str, np.array]
- classmethod from_groupby(data: pd.core.groupby.GroupBy) DataDict #
从 Pandas
GroupBy
创建列的dict
,适用于创建ColumnDataSource
。生成的数据是对组运行
describe
的结果。- 参数:
data (Groupby) – 要转换的数据
- 返回值:
dict[str, np.array]
- js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) None #
使用 JavaScript 链接两个 Bokeh 模型属性。
这是一种便捷方法,可简化添加
CustomJS
回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。- 参数:
在版本 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
。- 参数:
- 返回值:
名为
name
的属性的描述符- 返回类型:
- on_change(attr: str, *callbacks: PropertyCallback) None #
在此对象上添加一个回调,以便在
attr
更改时触发。- 参数:
attr (str) – 此对象上的属性名称
*callbacks (callable) – 要注册的回调函数
- 返回值:
None
示例
widget.on_change('value', callback1, callback2, ..., callback_n)
- on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) None #
当指定事件在此模型上发生时运行回调。
并非所有模型都支持所有事件。有关哪些模型能够触发事件的更多信息,请参阅 bokeh.events 中的特定事件。
- classmethod parameters() list[Parameter] #
生成适用于从 glyph 派生的函数的 Python
Parameter
值。- 返回值:
list(Parameter)
- patch(patches: Patches, setter: Setter | None = None) None #
在特定位置高效地更新数据源列。
如果只需要更新
ColumnDataSource
中的一小部分数据,则可以使用此方法高效地仅更新子集,而无需发送整个数据集。此方法应传递一个字典,该字典将列名称映射到描述要应用的补丁更改的元组列表。要完全替换列中的单个项目,元组应采用以下形式
(index, new_value) # replace a single column value # or (slice, new_values) # replace several column values
索引或切片处的值将被替换为相应的的新值。
对于其值是其他数组或列表的列(例如,图像或 patches glyphs),也可以修补“子区域”。在这种情况下,元组的第一项应该是一个,其第一个元素是 CDS 补丁中数组项的索引,其后续元素是数组项的整数索引或切片
# replace the entire 10th column of the 2nd array: +----------------- index of item in column data source | | +--------- row subindex into array item | | | | +- column subindex into array item V V V ([2, slice(None), 10], new_values)
想象一下 2d NumPy 数组的列表,上面的补丁大致等效于
data = [arr1, arr2, ...] # list of 2d arrays data[2][:, 10] = new_data
可以接受的切片和数据类型有一些限制。
切片的负
start
、stop
或step
值将导致ValueError
。在切片中,
start > stop
将导致ValueError
当修补 1d 或 2d 子项时,子项必须是 NumPy 数组。
新值必须作为适当大小的**展平的一维数组**提供。
- 参数:
- 返回值:
None
- Raises:
示例
以下示例演示如何修补整个列元素。在这种情况下,
source = ColumnDataSource(data=dict(foo=[10, 20, 30], bar=[100, 200, 300])) patches = { 'foo' : [ (slice(2), [11, 12]) ], 'bar' : [ (0, 101), (2, 301) ], } source.patch(patches)
在此操作之后,
source.data
的值将是dict(foo=[11, 12, 30], bar=[101, 200, 301])
有关更全面的示例,请参阅 examples/server/app/patch_app.py。
- classmethod properties(*, _with_props: bool = False) set[str] | dict[str, Property[`Any]] #
收集此类上的属性名称。
警告
在 Bokeh 的未来版本中,此方法将返回一个字典,该字典将属性名称映射到属性对象。为了使此方法的当前用法在未来保持兼容,请将返回值包装在
list
中。- 返回值:
属性名称
- 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] #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
- 返回值:
seq[Model]
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回值:
模型 (Model)
- set_from_json(name: str, value: Any, *, setter: Setter | None = None) None #
从 JSON 在此对象上设置属性值。
- 参数:
name (str) – 要设置的属性的名称
value (JSON-value) – 要设置为属性的值
setter (ClientSession 或 ServerSession 或 None, 可选) –
这用于防止对 Bokeh 应用程序的“回旋镖”更新。
在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用正在执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件 setter 与自身进行比较,并抑制任何源自自身的更新。
- 返回值:
None
- set_select(selector: type[`Model] | SelectorType, updates: dict[`str, Any]) None #
使用指定的属性/值更新来更新与给定选择器匹配的对象。
- 参数:
selector (JSON-like)
updates (dict)
- 返回值:
None
- stream(new_data: DataDict, rollover: int | None = None) None #
使用新的仅追加数据高效地更新数据源列。
在需要更新数据列的情况下,此方法可以高效地仅发送新数据,而无需重新发送整个数据集。
- 参数:
- 返回值:
None
- Raises:
示例
source = ColumnDataSource(data=dict(foo=[], bar=[])) # has new, identical-length updates for all columns in source new_data = { 'foo' : [10, 20], 'bar' : [100, 200], } source.stream(new_data)
- themed_values() dict[`str, Any] | None #
获取任何主题提供的覆盖。
结果作为从属性名称到值的字典返回,如果主题未覆盖此实例的任何值,则返回
None
。- 返回值:
dict 或 None
- to_df() pd.DataFrame #
将此数据源转换为 pandas
DataFrame
。- 返回值:
DataFrame
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #