figure#
- class figure(*args: Any, id: ID | None = None, **kwargs: Any)[source]#
基类:
Plot
,GlyphAPI
创建一个新的绘图图形。
是
Plot
的子类,简化了包含默认坐标轴、网格、工具等的绘图创建。Figure 对象有许多字形方法,可用于绘制矢量图形字形
有一个散点函数可以通过标记类型进行参数化
还有用于堆叠条形的专门方法
bars:
hbar_stack()
,vbar_stack()
lines:
hline_stack()
,vline_stack()
areas:
harea_stack()
,varea_stack()
以及一个用于制作简单六边形格网图的专门方法
除了所有
figure
属性属性之外,还接受以下选项- 关键词参数:
- active_inspect (
Nullable
(Either
(Auto
,String
,Instance
(InspectTool
),Seq
(Instance
(InspectTool
))))) 应初始激活哪个拖拽工具。(默认值:‘auto’)
- active_inspect (
- x_axis_label (
Nullable
(TextLike
)) x 轴的标签。(默认值:‘’)
- x_axis_label (
- x_axis_location (
Nullable
(Enum
(VerticalLocation
))) x 轴应位于何处。(默认值:‘below’)
- x_axis_location (
- y_axis_label (
Nullable
(TextLike
)) y 轴的标签。(默认值:‘’)
- y_axis_label (
- y_axis_location (
Nullable
(Enum
(HorizontalLocation
))) y 轴应位于何处。(默认值:‘left’)
- y_axis_location (
- align = 'auto'#
-
父容器内的对齐点。
仅当此组件是布局(例如网格)的子元素时,此属性才有用。自对齐可以被父容器覆盖(例如,网格轨道对齐)。
- aspect_ratio = None#
-
描述组件的宽度和高度之间的比例关系。
如果组件的任何尺寸大小可变,则此功能有效。如果设置为数字,则将保持
width / height = aspect_ratio
关系。 否则,如果设置为"auto"
,组件的首选宽度和高度将用于确定纵横比(如果未设置,则不会保留纵横比)。
- aspect_scale = 1#
- 类型:
为增加纵横比控制而给出的值。此值以乘法方式添加到
match_aspect
所需的计算值中。aspect_scale
定义为图形的宽度与高度之比。例如,
aspect_scale
值为 2 的绘图将导致在屏幕上绘制一个正方形,该正方形在数据单位中是一个像素宽度是其像素高度两倍的长方形。注意
仅当
match_aspect
设置为True
时,此设置才生效。
- attribution = []#
- 类型:
允许致谢或感谢数据、瓦片等提供商。
这可以是 HTML 或纯文本形式。 渲染器(如瓦片渲染器)可以提供额外的署名,这些署名将在此处提供的署名之后添加。
注意
此功能是实验性的,可能会在短期内发生变化。
-
当用户右键单击组件时显示的菜单。
如果设置为
"auto"
,组件可能会提供动态生成的菜单。例如,Plot
和相关模型提供ToolMenu
实例,以便轻松访问其工具。注意
右键单击时使用 Shift 键可显示原生上下文菜单。
- css_variables = {}#
-
允许定义动态计算的 CSS 变量。
例如,这可以用于协调画布渲染器和/或视觉元素与基于 HTML 的 UI 元素之间的定位和样式。
此处定义的变量等效于在 CSS 样式表中的
:host { ... }
下设置相同的变量。注意
此属性为实验性属性,可能会随时更改。
- extra_x_scales = {}#
-
用于映射 x 坐标的其他命名比例。
这对于添加其他轴很有用。
注意
此功能是实验性的,可能会在短期内发生变化。
- extra_y_scales = {}#
-
用于映射 y 坐标的其他命名比例。
这对于添加其他轴很有用。
注意
此功能是实验性的,可能会在短期内发生变化。
- frame_align = True#
-
允许指定在多绘图布局中要对齐的框架边缘。
默认情况下,对齐所有边缘,但用户可以选择不进行每个单独边缘或所有边缘的对齐。另请注意,其他属性可能会禁用某些边缘的对齐,尤其是在使用固定框架大小(
frame_width
和frame_height
属性)时。
- height = 600#
- 类型:
组件的高度(以像素为单位)。
这可以是固定高度或首选高度,具体取决于高度尺寸调整策略。
- height_policy = 'auto'#
- 类型:
描述组件应如何保持其高度。
"auto"
使用组件的首选尺寸调整策略。
"fixed"
精确使用
height
像素。如果组件无法容纳在可用的垂直空间中,则会溢出。"fit"
使用组件的首选高度(如果已设置),并允许在最小和最大高度边界(如果已设置)内适应可用的垂直空间。组件的高度既不会被过度最小化,也不会被过度最大化。
"min"
尽可能少地使用垂直空间,不小于最小高度(如果已设置)。起点是首选高度(如果已设置)。组件的高度可能会根据父布局、纵横比管理和其他因素而缩小或增长。
"max"
尽可能多地使用垂直空间,不超过最大高度(如果已设置)。起点是首选高度(如果已设置)。组件的高度可能会根据父布局、纵横比管理和其他因素而缩小或增长。
注意
这是一个实验性功能,将来可能会发生变化。请自行决定是否使用。如果不需要这种程度的控制,请优先使用
sizing_mode
。
- hold_render = False#
- 类型:
设置为 True 时,所有重绘绘图的请求都将被搁置。
当定期更新许多字形时,这很有用。例如,假设我们在绘图上有 10 条线,每条线都有自己的数据源。我们每秒在一个 for 循环中流式传输到所有这些线,如下所示
for line in lines: line.stream(new_points())
此代码的问题在于,每个流都会触发绘图的重新渲染。即使仅在最后一个流上重绘也会产生几乎相同的视觉效果。特别是对于具有许多点的线,这在计算上会变得非常昂贵,并可能冻结您的浏览器。使用便捷方法 hold,我们可以控制何时启动渲染,如下所示
with plot.hold(render=True): for line in lines: line.stream(new_points())
在这种情况下,我们仅在最后一个流之后渲染新追加的点。
- html_id = None#
-
设置底层 HTML 元素的
id
属性。这是常见 HTML
id
属性的简写形式。或者,可以在html_attributes
字典中设置id
。html_id
优先。
- inner_height = Undefined#
- 类型:
只读
这是绘图画布的确切高度,即实际绘图的高度,不包括工具栏等。请注意,这是在 Web 浏览器中计算的,因此此属性仅在能够进行双向通信的后端(服务器、笔记本)中有效。
注意
这是一个实验性功能,API 在不久的将来可能会发生变化。
- inner_width = Undefined#
- 类型:
只读
这是绘图画布的确切宽度,即实际绘图的宽度,不包括工具栏等。请注意,这是在 Web 浏览器中计算的,因此此属性仅在能够进行双向通信的后端(服务器、笔记本)中有效。
注意
这是一个实验性功能,API 在不久的将来可能会发生变化。
- lod_factor = 10#
- 类型:
应用细节级别模式时要使用的抽取因子。
lod_factor
为 N 表示在交互事件处于活动状态时,仅绘制数据源中每 N 个点中的一个点。例如,如果lod_factor=200
,则仅绘制每 200 个点中的一个点。细节级别模式旨在在大量数据点存在时,保持 HTML 画布绘图上的交互响应时间。
请注意,细节级别模式的一种可能的替代方案是使用 WebGL
output_backend
。WebGL 渲染可能允许非常大的数据集在没有任何细节级别降采样的情况下保持交互性。启用 WebGL 输出后,不使用细节级别模式。
- lod_interval = 300#
- 类型:
交互式工具事件将启用细节级别降采样的间隔(以毫秒为单位)。
如果在上次交互事件开始后的
lod_interval
毫秒内需要重新绘制绘图,则将激活细节级别模式。值越大,细节级别模式就“越容易”开启。
- lod_threshold = 2000#
-
数据点的数量,超过此数量后,字形渲染器可能会执行细节级别降采样。例如,如果
lod_threshold=10000
,则如果数据源中的点少于 10000 个,则不会激活细节级别模式。设置为
None
以完全禁用任何细节级别降采样。
- lod_timeout = 500#
- 类型:
用于检查交互式工具事件是否仍在发生的超时时间(以毫秒为单位)。一旦启用细节级别模式,则每
lod_timeout
毫秒进行一次检查。如果没有发生交互式工具事件,则禁用细节级别模式。值越大,细节级别模式就“越慢”关闭。
- margin = None#
-
允许在组件周围创建额外的空间。元组中的值按以下顺序排列 - 上边距、右边距、下边距和左边距,类似于 CSS 标准。可以使用负边距值来缩小任何方向的空间。
- match_aspect = False#
- 类型:
指定绘图的纵横比行为。纵横比定义为宽度与高度之比。此属性控制 Bokeh 是否应尝试将数据空间的(宽度/高度)与屏幕空间的像素(宽度/高度)相匹配。
默认值为
False
,表示数据纵横比和屏幕纵横比独立变化。True
表示轴的绘图纵横比将与轴的像素范围的纵横比相匹配。最终结果是数据空间中的 1x1 区域在像素中是一个正方形,反之亦然,1x1 像素在数据单元中是一个正方形。注意
此设置仅在有两个数据范围时生效。此设置仅设置初始绘图绘制和后续重置。工具(单轴缩放、无约束框缩放)可能会更改纵横比。
警告
此设置与跨多个绘图链接数据范围不兼容。这样做可能会导致未定义的行为。
- max_height = None#
- 类型:
组件的最大高度(以像素为单位),如果高度可调整。
- max_width = None#
- 类型:
组件的最大宽度(以像素为单位),如果宽度可调整。
- min_border = 5#
-
一个方便的属性,用于将所有
min_border_X
属性设置为相同的值。如果显式设置了单个边框属性,它将覆盖min_border
。
- min_border_bottom = None#
-
中央绘图区域底部下方填充区域的最小尺寸(以像素为单位)。
注意
这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。
- min_border_left = None#
-
中央绘图区域左侧填充区域的最小尺寸(以像素为单位)。
注意
这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。
- min_border_right = None#
-
中央绘图区域右侧填充区域的最小尺寸(以像素为单位)。
注意
这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。
- min_border_top = None#
-
中央绘图区域顶部上方填充区域的最小尺寸(以像素为单位)。
注意
这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。
- min_height = None#
- 类型:
组件的最小高度(以像素为单位),如果高度可调整。
- min_width = None#
- 类型:
组件的最小宽度(以像素为单位),如果宽度可调整。
- 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 也不会出于任何原因直接使用该名称。
- outer_height = Undefined#
- 类型:
只读
这是布局的精确高度,即实际绘图的高度,包括工具栏等。请注意,这是在 Web 浏览器中计算的,因此此属性仅在能够进行双向通信的后端(服务器、笔记本)中有效。
注意
这是一个实验性功能,API 在不久的将来可能会发生变化。
- outer_width = Undefined#
- 类型:
只读
这是布局的精确宽度,即实际绘图的高度,包括工具栏等。请注意,这是在 Web 浏览器中计算的,因此此属性仅在能够进行双向通信的后端(服务器、笔记本)中有效。
注意
这是一个实验性功能,API 在不久的将来可能会发生变化。
- outline_line_dash = []#
- 类型:
绘图边框轮廓的线条虚线模式。
- output_backend = 'canvas'#
- 类型:
指定绘图区域的输出后端。默认为 HTML5 Canvas。
注意
当设置为
webgl
时,没有 WebGL 渲染实现的字形将回退到在 2D 画布上渲染。
- reset_policy = 'standard'#
- 类型:
绘图应如何响应重置。默认情况下,标准操作是清除任何工具状态历史记录,将绘图范围返回到其原始值,撤消所有选择,并发出
Reset
事件。如果需要自定义,可以将此属性设置为"event_only"
,这将抑制除 Reset 事件之外的所有操作。
- resizable = False#
- 类型:
Either
(Bool
,Enum
(Dimensions
))
布局是否可交互调整大小,如果是,则在哪些维度上。
- sizing_mode = None#
- 类型:
组件应如何调整自身大小。
这是用于保持组件宽度和高度的高级设置。要获得对大小调整的更精细控制,请改用
width_policy
、height_policy
和aspect_ratio
(这些优先于sizing_mode
)。可能的场景
"inherit"
大小调整模式是从父布局继承的。如果没有父布局(或父布局不是布局),则此值将被视为未提供
sizing_mode
的值。"fixed"
组件不响应。它将保留其原始宽度和高度,而与任何后续浏览器窗口大小调整事件无关。
"stretch_width"
组件将响应式调整大小以拉伸到可用宽度,而不保持任何纵横比。组件的高度取决于组件的类型,并且可以是固定的或适合组件的内容。
"stretch_height"
组件将响应式调整大小以拉伸到可用高度,而不保持任何纵横比。组件的宽度取决于组件的类型,并且可以是固定的或适合组件的内容。
"stretch_both"
组件是完全响应式的,宽度和高度独立,并将占据所有可用的水平和垂直空间,即使这会改变组件的纵横比。
"scale_width"
组件将响应式调整大小以拉伸到可用宽度,同时保持原始或提供的纵横比。
"scale_height"
组件将响应式调整大小以拉伸到可用高度,同时保持原始或提供的纵横比。
"scale_both"
组件将响应式调整大小以同时拉伸到可用宽度和高度,同时保持原始或提供的纵横比。
- stylesheets = []#
- 类型:
用于底层 DOM 元素的其他样式表。
请注意,所有 bokeh 的组件都使用 shadow DOM,因此任何包含的样式表都必须反映这一点,例如,使用
:host
CSS 伪选择器来访问根 DOM 元素。
- 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 也不会出于任何原因直接使用这些标签。
- width = 600#
- 类型:
组件的宽度(以像素为单位)。
这可以是固定的宽度,也可以是首选宽度,具体取决于宽度调整策略。
- width_policy = 'auto'#
- 类型:
描述组件应如何保持其宽度。
"auto"
使用组件的首选尺寸调整策略。
"fixed"
完全使用
width
像素。如果组件无法适应可用的水平空间,则会溢出。"fit"
使用组件的首选宽度(如果已设置),并允许其适应最小和最大宽度边界(如果已设置)内的可用水平空间。组件的宽度既不会被积极地最小化,也不会被最大化。
"min"
使用尽可能少的水平空间,不小于最小宽度(如果已设置)。起点是首选宽度(如果已设置)。组件的宽度可能会根据父布局、纵横比管理和其他因素而缩小或增大。
"max"
使用尽可能多的水平空间,不超过最大宽度(如果已设置)。起点是首选宽度(如果已设置)。组件的宽度可能会根据父布局、纵横比管理和其他因素而缩小或增大。
注意
这是一个实验性功能,将来可能会发生变化。请自行决定是否使用。如果不需要这种程度的控制,请优先使用
sizing_mode
。
- window_axis = 'none'#
- 类型:
当绘图上存在数据范围时,用于窗口自动调整范围的轴。例如,如果
window_axis
设置为值"x"
,则 y 维度中的任何数据范围都将仅使用 x 轴的范围边界内的数据(如当前视口中配置的那样)来计算其自动调整范围的范围。如果设置为“none”(默认值),则自动调整范围将使用所有可用数据,而与视口无关。
- add_glyph(source_or_glyph: Glyph | ColumnarDataSource, glyph: Glyph | None = None, **kwargs: Any) GlyphRenderer #
向绘图添加字形,其中包含关联的数据源和范围。
此函数将负责创建和配置 Glyph 对象,然后将其添加到绘图的渲染器列表中。
- 参数:
source (DataSource) – 字形要使用的所有数据的数据源
glyph (Glyph) – 要添加到绘图的字形
- 关键词参数:
the (传递给)
initializer. (Glyph) 的任何其他关键字参数按原样传递
- 返回:
GlyphRenderer
- add_layout(obj: Renderer, place: Literal['above', 'below', 'left', 'right', 'center'] = 'center') None #
在指定位置向绘图添加对象。
- add_tile(tile_source: TileSource | TileProvider | str, retina: bool = False, **kwargs: Any) TileRenderer #
将新的
TileRenderer
添加到Plot.renderers
中。- 参数:
tile_source (TileSource, xyzservices.TileProvider, str) – 包含瓦片集配置的瓦片源实例
retina (bool) – 是否使用视网膜版本的瓦片(如果可用)
- 关键词参数:
renderer (附加关键字参数将按原样传递给瓦片)
- 返回:
TileRenderer
- 返回类型:
- annular_wedge(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), inner_radius=Field(field='inner_radius', transform=Unspecified, units=Unspecified), outer_radius=Field(field='outer_radius', transform=Unspecified, units=Unspecified), start_angle=Field(field='start_angle', transform=Unspecified, units=Unspecified), end_angle=Field(field='end_angle', transform=Unspecified, units=Unspecified), direction='anticlock', *, decorations=[], end_angle_units='rad', fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, inner_radius_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, outer_radius_units='data', start_angle_units='rad', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
AnnularWedge
字形 (图形)。- 参数:
x (
NumberSpec
, 可选) – 环形扇形中心点的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 环形扇形中心点的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))inner_radius (
DistanceSpec
, 可选) – 环形扇形的内半径。(默认值: Field(field=’inner_radius’, transform=Unspecified, units=Unspecified))outer_radius (
DistanceSpec
, 可选) – 环形扇形的外半径。(默认值: Field(field=’outer_radius’, transform=Unspecified, units=Unspecified))start_angle (
AngleSpec
, 可选) – 环形扇形的起始角度,从水平方向测量。(默认值: Field(field=’start_angle’, transform=Unspecified, units=Unspecified))end_angle (
AngleSpec
, 可选) – 环形扇形的终止角度,从水平方向测量。(默认值: Field(field=’end_angle’, transform=Unspecified, units=Unspecified))direction (
Enum
(Direction
), 可选) – 起始角度和终止角度之间描边的方向。(默认值: ‘anticlock’)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
end_angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位: deg, rad, grad 或 turn (默认值: ‘rad’)fill_alpha (
AlphaSpec
, 可选) – 环形扇形的填充透明度值。(默认值: 1.0)fill_color (
ColorSpec
, 可选) – 环形扇形的填充颜色值。(默认值: ‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 环形扇形的阴影线透明度值。(默认值: 1.0)hatch_color (
ColorSpec
, 可选) – 环形扇形的阴影线颜色值。(默认值: ‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 环形扇形的额外阴影线值。(默认值: {})hatch_pattern (
HatchPatternSpec
) – 环形扇形的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 环形扇形的阴影线比例值。(默认值: 12.0)hatch_weight (
FloatSpec
, 可选) – 环形扇形的阴影线粗细值。(默认值: 1.0)inner_radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位: screen 或 data (默认值: ‘data’)line_alpha (
AlphaSpec
, 可选) – 环形扇形的线条透明度值。(默认值: 1.0)line_cap (
LineCapSpec
, 可选) – 环形扇形的线条端点样式值。(默认值: ‘butt’)line_color (
ColorSpec
, 可选) – 环形扇形的线条颜色值。(默认值: ‘black’)line_dash (
DashPatternSpec
) – 环形扇形的线条虚线样式值。(默认值: [])line_dash_offset (
IntSpec
) – 环形扇形的线条虚线偏移值。(默认值: 0)line_join (
LineJoinSpec
, 可选) – 环形扇形的线条连接样式值。(默认值: ‘bevel’)line_width (
FloatSpec
, 可选) – 环形扇形的线条宽度值。(默认值: 1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
outer_radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位: screen 或 data (默认值: ‘data’)start_angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位: deg, rad, grad 或 turn (默认值: ‘rad’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
- annulus(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), inner_radius=Field(field='inner_radius', transform=Unspecified, units=Unspecified), outer_radius=Field(field='outer_radius', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, inner_radius_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, outer_radius_units='data', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Annulus
字形 (图形)。- 参数:
x (
NumberSpec
, 可选) – 环形中心的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 环形中心的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))inner_radius (
DistanceSpec
, 可选) – 环形的内半径。(默认值: Field(field=’inner_radius’, transform=Unspecified, units=Unspecified))outer_radius (
DistanceSpec
, 可选) – 环形的外半径。(默认值: Field(field=’outer_radius’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 环形的填充透明度值。(默认值: 1.0)fill_color (
ColorSpec
, 可选) – 环形的填充颜色值。(默认值: ‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 环形的阴影线透明度值。(默认值: 1.0)hatch_color (
ColorSpec
, 可选) – 环形的阴影线颜色值。(默认值: ‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 环形的额外阴影线值。(默认值: {})hatch_pattern (
HatchPatternSpec
) – 环形的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – annuli 的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – annuli 的阴影线粗细值。(默认值:1.0)inner_radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位: screen 或 data (默认值: ‘data’)line_alpha (
AlphaSpec
, 可选) – annuli 的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – annuli 的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – annuli 的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – annuli 的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – annuli 的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – annuli 的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – annuli 的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
outer_radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位: screen 或 data (默认值: ‘data’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.annulus(x=[1, 2, 3], y=[1, 2, 3], color="#7FC97F", inner_radius=0.2, outer_radius=0.5) show(plot)
- apply_theme(property_values: dict[str, Any]) None #
应用一组主题值,这些值将代替默认值使用,但不会覆盖应用程序设置的值。
传入的字典可以保持原样并与其他实例共享,以节省内存(因此调用者和
HasProps
实例都不应修改它)。- 参数:
property_values (dict) – 用于代替默认值的主题值
- 返回:
None
- arc(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), radius=Field(field='radius', transform=Unspecified, units=Unspecified), start_angle=Field(field='start_angle', transform=Unspecified, units=Unspecified), end_angle=Field(field='end_angle', transform=Unspecified, units=Unspecified), direction='anticlock', *, decorations=[], end_angle_units='rad', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, radius_units='data', start_angle_units='rad', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Arc
字形。- 参数:
x (
NumberSpec
, 可选) – 圆弧中心的 x 坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 圆弧中心的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))radius (
DistanceSpec
, 可选) – 圆弧的半径。(默认值:Field(field=’radius’, transform=Unspecified, units=Unspecified))start_angle (
AngleSpec
, 可选) – 圆弧的起始角度,从水平方向测量。(默认值:Field(field=’start_angle’, transform=Unspecified, units=Unspecified))end_angle (
AngleSpec
, 可选) – 圆弧的结束角度,从水平方向测量。(默认值:Field(field=’end_angle’, transform=Unspecified, units=Unspecified))direction (
Enum
(Direction
), 可选) – 起始角度和终止角度之间描边的方向。(默认值: ‘anticlock’)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
end_angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位: deg, rad, grad 或 turn (默认值: ‘rad’)line_alpha (
AlphaSpec
, 可选) – 圆弧的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 圆弧的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 圆弧的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 圆弧的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 圆弧的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 圆弧的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 圆弧的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)start_angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位: deg, rad, grad 或 turn (默认值: ‘rad’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
- asterisk(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.asterisk(x=[1,2,3], y=[1,2,3], size=20, color="#F0027F") show(plot)
- bezier(x0=Field(field='x0', transform=Unspecified, units=Unspecified), y0=Field(field='y0', transform=Unspecified, units=Unspecified), x1=Field(field='x1', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), cx0=Field(field='cx0', transform=Unspecified, units=Unspecified), cy0=Field(field='cy0', transform=Unspecified, units=Unspecified), cx1=Field(field='cx1', transform=Unspecified, units=Unspecified), cy1=Field(field='cy1', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Bezier
字形。- 参数:
x0 (
NumberSpec
, 可选) – 起始点的 x 坐标。(默认值:Field(field=’x0’, transform=Unspecified, units=Unspecified))y0 (
NumberSpec
, 可选) – 起始点的 y 坐标。(默认值:Field(field=’y0’, transform=Unspecified, units=Unspecified))x1 (
NumberSpec
, 可选) – 结束点的 x 坐标。(默认值:Field(field=’x1’, transform=Unspecified, units=Unspecified))y1 (
NumberSpec
, 可选) – 结束点的 y 坐标。(默认值:Field(field=’y1’, transform=Unspecified, units=Unspecified))cx0 (
NumberSpec
, 可选) – 第一个控制点的 x 坐标。(默认值:Field(field=’cx0’, transform=Unspecified, units=Unspecified))cy0 (
NumberSpec
, 可选) – 第一个控制点的 y 坐标。(默认值:Field(field=’cy0’, transform=Unspecified, units=Unspecified))cx1 (
NumberSpec
, 可选) – 第二个控制点的 x 坐标。(默认值:Field(field=’cx1’, transform=Unspecified, units=Unspecified))cy1 (
NumberSpec
, 可选) – 第二个控制点的 y 坐标。(默认值:Field(field=’cy1’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
AlphaSpec
, 可选) – 贝塞尔曲线的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 贝塞尔曲线的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 贝塞尔曲线的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 贝塞尔曲线的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 贝塞尔曲线的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 贝塞尔曲线的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 贝塞尔曲线的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
- block(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), width=1, height=1, *, border_radius=0, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, height_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], width_units='data', **kwargs) GlyphRenderer #
配置并添加
Block
字形到此图形。- 参数:
x (
NumberSpec
, 可选) – 每个block左下角的x坐标。(默认: Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 每个block左下角的y坐标。(默认: Field(field='y', transform=Unspecified, units=Unspecified))width (
DistanceSpec
, 可选) – block的宽度。(默认: 1)height (
DistanceSpec
, 可选) – block的高度。(默认: 1)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许方框具有圆角。
注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – block的填充透明度值。(默认: 1.0)fill_color (
ColorSpec
, 可选) – block的填充颜色值。(默认: ‘gray’)hatch_alpha (
AlphaSpec
, 可选) – block的阴影线透明度值。(默认: 1.0)hatch_color (
ColorSpec
, 可选) – block的阴影线颜色值。(默认: ‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – block的阴影线额外值。(默认: {})hatch_pattern (
HatchPatternSpec
>) – block的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – block的阴影线缩放值。(默认: 12.0)hatch_weight (
FloatSpec
, 可选) – block的阴影线粗细值。(默认: 1.0)height_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)line_alpha (
AlphaSpec
, 可选) – block的线条透明度值。(默认: 1.0)line_cap (
LineCapSpec
, 可选) – block的线帽值。(默认: ‘butt’)line_color (
ColorSpec
, 可选) – block的线条颜色值。(默认: ‘black’)line_dash (
DashPatternSpec
) – block的虚线值。(默认: [])line_dash_offset (
IntSpec
) – block的虚线偏移值。(默认: 0)line_join (
LineJoinSpec
, 可选) – block的线连接值。(默认: ‘bevel’)line_width (
FloatSpec
, 可选) – block的线条宽度值。(默认: 1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
width_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.block(x=[1, 2, 3], y=[1,2,3], width=0.5, height=1, color="#CAB2D6") show(plot)
- circle(*args: Any, **kwargs: Any) GlyphRenderer #
配置并添加
Circle
字形到此图形。- 参数:
x (str 或 seq[float]) – 中心 x 坐标的值或字段名
y (str 或 seq[float]) – 中心 y 坐标的值或字段名
color (颜色值, 可选) – 设置填充颜色和线条颜色的简写形式
source (
ColumnDataSource
) – 用户提供的数据源。如果需要,将尝试将对象转换为ColumnDataSource
。如果未提供,则会自动为用户创建一个。
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.circle(x=[1, 2, 3], y=[1, 2, 3], radius=0.2) show(plot)
- circle_cross(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.circle_cross(x=[1,2,3], y=[4,5,6], size=20, color="#FB8072", fill_alpha=0.2, line_width=2) show(plot)
- circle_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.circle_dot(x=[1,2,3], y=[4,5,6], size=20, color="#FB8072", fill_color=None) show(plot)
- circle_x(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.circle_x(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DD1C77", fill_alpha=0.2) show(plot)
- circle_y(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.circle_y(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DD1C77", fill_alpha=0.2) show(plot)
- classmethod clear_extensions() None #
清除当前定义的任何自定义扩展。
序列化调用将导致任何当前定义的自定义扩展被包含在生成的文档中,无论它们是否被使用。此方法可用于清除所有现有的自定义扩展定义。
- column(col, gridplot)#
返回此绘图是否在
GridPlot
的给定列中。
- contour(x: ArrayLike | None = None, y: ArrayLike | None = None, z: ArrayLike | np.ma.MaskedArray | None = None, levels: ArrayLike | None = None, **visuals) ContourRenderer [source]#
创建填充多边形和/或轮廓线的轮廓图。
如果设置了
fill_color
,则计算填充轮廓多边形;如果设置了line_color
,则计算轮廓线。- 参数:
x (array-like[float] of shape (ny, nx) or (nx,), optional) –
z
值的 x 坐标。可以是与z.shape
相同形状的 2D 数组,也可以是长度为nx = z.shape[1]
的 1D 数组。如果未指定,则假定为np.arange(nx)
。必须单调递增。y (array-like[float] of shape (ny, nx) or (ny,), optional) –
z
值的 y 坐标。可以是与z.shape
相同形状的 2D 数组,也可以是长度为ny = z.shape[0]
的 1D 数组。如果未指定,则假定为np.arange(ny)
。必须单调递增。z (array-like[float] of shape (ny, nx)) – 用于计算轮廓的网格值 2D NumPy 数组。它可以是掩码数组,任何无效值(
np.inf
或np.nan
)也将被掩盖。levels (array-like[float]) – 计算轮廓的 z 水平,必须递增。轮廓线在每个水平计算,填充轮廓在每对相邻水平之间计算,因此轮廓线的数量为
len(levels)
,填充轮廓多边形的数量为len(levels)-1
。**visuals –
填充属性、 阴影线属性 和 线条属性。填充和阴影线属性用于填充轮廓,线条属性用于线条轮廓。如果使用向量化属性,则必须使用正确的数量,线条属性为
len(levels)
,填充和阴影线属性为len(levels)-1
。fill_color
和line_color
更加灵活,因为它们将接受更长的序列,并使用linear_palette()
将它们插值到所需的数量,并且还接受调色板集合(从整数长度到颜色序列的字典映射),例如 bokeh.palettes.Cividis。
- cross(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.cross(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#E6550D", line_width=2) show(plot)
- dash(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.dash(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#99D594", line_width=2) show(plot)
- classmethod descriptors() list[PropertyDescriptor[Any]] #
按定义顺序列出的属性描述符列表。
- diamond(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.diamond(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#1C9099", line_width=2) show(plot)
- diamond_cross(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.diamond_cross(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#386CB0", fill_color=None, line_width=2) show(plot)
- diamond_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y>=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.diamond_dot(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#386CB0", fill_color=None) show(plot)
- dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.dot(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#386CB0") show(plot)
- ellipse(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), width=Field(field='width', transform=Unspecified, units=Unspecified), height=Field(field='height', transform=Unspecified, units=Unspecified), angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, height_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], width_units='data', **kwargs) GlyphRenderer #
配置并向该图形添加
Ellipse
字形。- 参数:
x (
NumberSpec
, 可选) – 椭圆中心的 x 坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 椭圆中心的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))width (
DistanceSpec
, 可选) – 每个椭圆的宽度。(默认值:Field(field=’width’, transform=Unspecified, units=Unspecified))height (
DistanceSpec
, 可选) – 每个椭圆的高度。(默认值:Field(field=’height’, transform=Unspecified, units=Unspecified))angle (
AngleSpec
) – 椭圆从水平方向旋转的角度。[弧度] (默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 椭圆的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 椭圆的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 椭圆的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 椭圆的阴影颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 椭圆的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 椭圆的阴影图案值。hatch_scale (
FloatSpec
, 可选) – 椭圆的阴影缩放值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 椭圆的阴影粗细值。(默认值:1.0)height_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)line_alpha (
AlphaSpec
, 可选) – 椭圆的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 椭圆的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 椭圆的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 椭圆的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 椭圆的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 椭圆的线连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 椭圆的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
width_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.ellipse(x=[1, 2, 3], y=[1, 2, 3], width=30, height=20, color="#386CB0", fill_color=None, line_width=2) show(plot)
- equals(other: HasProps) bool #
模型的结构相等性。
- 参数:
other (HasProps) – 要比较的另一个实例
- 返回:
如果属性在结构上相等,则为 True,否则为 False
- graph(node_source: ColumnDataSource, edge_source: ColumnDataSource, layout_provider: LayoutProvider, **kwargs)[source]#
使用给定的节点、边和布局提供器创建网络图。
- 参数:
node_source (
ColumnDataSource
) – 用户提供的图形节点数据源。将尝试将对象转换为ColumnDataSource
(如果需要)。如果未提供,则会自动为用户创建一个。edge_source (
ColumnDataSource
) – 用户提供的图形边数据源。将尝试将对象转换为ColumnDataSource
(如果需要)。如果未提供,则会自动为用户创建一个。layout_provider (
LayoutProvider
) – 一个LayoutProvider
实例,用于在笛卡尔空间中提供图形坐标。
- harea(x1=Field(field='x1', transform=Unspecified, units=Unspecified), x2=Field(field='x2', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图形添加
HArea
字形。- 参数:
x1 (
NumberSpec
, 可选) – 区域一侧点的 x 坐标。(默认值:Field(field=’x1’, transform=Unspecified, units=Unspecified))x2 (
NumberSpec
, 可选) – 区域另一侧点的 x 坐标。(默认值:Field(field=’x2’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 区域点的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
Alpha
, 可选) – 水平定向区域的填充 alpha 值。(默认值:1.0)fill_color (
Nullable
(Color
), 可选) – 水平定向区域的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 水平定向区域的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 水平定向区域的阴影颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 水平定向区域的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 水平定向区域的阴影图案值。hatch_scale (
FloatSpec
, 可选) – 水平定向区域的阴影缩放值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 水平定向区域的阴影粗细值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.harea(x1=[0, 0, 0], x2=[1, 4, 2], y=[1, 2, 3], fill_color="#99D594") show(plot)
- harea_stack(stackers, **kw)[source]#
为从左到右堆叠的层生成多个
HArea
渲染器。- 参数:
stackers (seq[str]) –
要为
x1
和x2
harea 坐标连续堆叠的数据源字段名称列表。此外,渲染器的
name
将设置为每个连续堆叠器的值(这对于特殊的悬停变量$name
非常有用)
任何其他关键字参数都将传递给每次
harea
调用。如果关键字值是列表或元组,则每次调用都将从序列中获取一个值。- 返回:
list[GlyphRenderer]
示例
假设一个名为
source
的ColumnDataSource
,其中包含列 2016 和 2017,则以下对harea_stack
的调用将创建两个堆叠的HArea
渲染器p.harea_stack(['2016', '2017'], y='y', color=['blue', 'red'], source=source)
这等效于以下两个单独的调用
p.harea(x1=stack(), x2=stack('2016'), y='y', color='blue', source=source, name='2016') p.harea(x1=stack('2016'), x2=stack('2016', '2017'), y='y', color='red', source=source, name='2017')
- harea_step(x1=Field(field='x1', transform=Unspecified, units=Unspecified), x2=Field(field='x2', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, name=None, step_mode='before', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图形添加
HAreaStep
字形。- 参数:
x1 (
NumberSpec
, 可选) – 区域一侧点的 x 坐标。(默认值:Field(field=’x1’, transform=Unspecified, units=Unspecified))x2 (
NumberSpec
, 可选) – 区域另一侧点的 x 坐标。(默认值:Field(field=’x2’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 区域点的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
Alpha
, 可选) – 水平定向区域的填充 alpha 值。(默认值:1.0)fill_color (
Nullable
(Color
), 可选) – 水平定向区域的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 水平定向区域的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 水平定向区域的阴影颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 水平定向区域的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 水平定向区域的阴影图案值。hatch_scale (
FloatSpec
, 可选) – 水平定向区域的阴影缩放值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 水平定向区域的阴影粗细值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
step_mode (
Enum
(StepMode
), 可选) –步阶“级别”应相对于 x 和 y 坐标绘制的位置。参数可以采用以下三个值之一
before
: (默认) 在每个 y 坐标之前绘制步阶级别(第一个点之前没有步阶)after
: 在每个 y 坐标之后绘制步阶级别(最后一个点之后没有步阶)center
: 在每个 y 坐标上居中绘制步阶级别 (默认值: ‘before’)
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.harea_step(x1=[1, 2, 3], x2=[0, 0, 0], y=[1, 4, 2], step_mode="after", fill_color="#99D594") show(plot)
- hbar(y=Field(field='y', transform=Unspecified, units=Unspecified), height=1, right=Field(field='right', transform=Unspecified, units=Unspecified), left=0, *, border_radius=0, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, height_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并添加
HBar
字形到此图中。- 参数:
y (
NumberSpec
, 可选) – 水平条形图中心的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))height (
DistanceSpec
, 可选) – 垂直条形图的高度。(默认值: 1)right (
NumberSpec
, 可选) – 右边缘的 x 坐标。(默认值: Field(field=’right’, transform=Unspecified, units=Unspecified))left (
NumberSpec
) – 左边缘的 x 坐标。(默认值: 0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许方框具有圆角。
注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 水平条形图的填充 alpha 值。(默认值: 1.0)fill_color (
ColorSpec
, 可选) – 水平条形图的填充颜色值。(默认值: ‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 水平条形图的阴影线 alpha 值。(默认值: 1.0)hatch_color (
ColorSpec
, 可选) – 水平条形图的阴影线颜色值。(默认值: ‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 水平条形图的额外阴影线值。(默认值: {})hatch_pattern (
HatchPatternSpec
) – 水平条形图的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 水平条形图的阴影线比例值。(默认值: 12.0)hatch_weight (
FloatSpec
, 可选) – 水平条形图的阴影线粗细值。(默认值: 1.0)height_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)line_alpha (
AlphaSpec
, 可选) – 水平条形图的线条 alpha 值。(默认值: 1.0)line_cap (
LineCapSpec
, 可选) – 水平条形图的线帽值。(默认值: ‘butt’)line_color (
ColorSpec
, 可选) – 水平条形图的线条颜色值。(默认值: ‘black’)line_dash (
DashPatternSpec
) – 水平条形图的线条虚线值。(默认值: [])line_dash_offset (
IntSpec
) – 水平条形图的线条虚线偏移值。(默认值: 0)line_join (
LineJoinSpec
, 可选) – 水平条形图的线条连接值。(默认值: ‘bevel’)line_width (
FloatSpec
, 可选) – 水平条形图的线条宽度值。(默认值: 1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.hbar(y=[1, 2, 3], height=0.5, left=0, right=[1,2,3], color="#CAB2D6") show(plot)
- hbar_stack(stackers, **kw)[source]#
为从左到右堆叠的层生成多个
HBar
渲染器。- 参数:
stackers (seq[str]) –
要连续堆叠的
left
和right
条形坐标的数据源字段名称列表。此外,渲染器的
name
将设置为每个连续堆叠器的值(这对于特殊的悬停变量$name
非常有用)
任何额外的关键字参数都将传递给每次
hbar
调用。如果关键字值是列表或元组,则每次调用将从序列中获取一个值。- 返回:
list[GlyphRenderer]
示例
假设一个名为
source
的ColumnDataSource
,其中包含 2016 和 2017 列,则以下对hbar_stack
的调用将创建两个堆叠的HBar
渲染器p.hbar_stack(['2016', '2017'], y=10, width=0.9, color=['blue', 'red'], source=source)
这等效于以下两个单独的调用
p.hbar(bottom=stack(), top=stack('2016'), y=10, width=0.9, color='blue', source=source, name='2016') p.hbar(bottom=stack('2016'), top=stack('2016', '2017'), y=10, width=0.9, color='red', source=source, name='2017')
- hex(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.hex(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,30], color="#74ADD1") show(plot)
- hex_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.hex_dot(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,30], color="#74ADD1", fill_color=None) show(plot)
- hex_tile(q=Field(field='q', transform=Unspecified, units=Unspecified), r=Field(field='r', transform=Unspecified, units=Unspecified), *, aspect_scale=1.0, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color=None, line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, orientation='pointytop', scale=1.0, size=1.0, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并添加
HexTile
字形到此图中。- 参数:
q (
NumberSpec
, 可选) – 图块中心 “列” 轴向坐标。(默认值: Field(field=’q’, transform=Unspecified, units=Unspecified))r (
NumberSpec
, 可选) – 图块中心 “行” 轴向坐标。(默认值: Field(field=’r’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
aspect_scale (
Float
, 可选) –匹配绘图的纵横比缩放。
当使用
aspect_scale
且值不为1.0
时,使用此参数来匹配绘图的纵横比缩放。(默认值: 1.0)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 六边形图块的填充 alpha 值。(默认值: 1.0)fill_color (
ColorSpec
, 可选) – 六边形图块的填充颜色值。(默认值: ‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 六边形图块的阴影线 alpha 值。(默认值: 1.0)hatch_color (
ColorSpec
, 可选) – 六边形图块的阴影线颜色值。(默认值: ‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 六边形图块的额外阴影线值。(默认值: {})hatch_pattern (
HatchPatternSpec
) – 六边形图块的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 六边形图块的阴影线比例值。(默认值: 12.0)hatch_weight (
FloatSpec
, 可选) – 六边形图块的阴影线粗细值。(默认值: 1.0)line_alpha (
AlphaSpec
, 可选) – 六边形图块的线条 alpha 值。(默认值: 1.0)line_cap (
LineCapSpec
, 可选) – 六边形图块的线帽值。(默认值: ‘butt’)line_color (
ColorSpec
) – 六边形图块的线条颜色值。line_dash (
DashPatternSpec
) – 六边形图块的线条虚线值。(默认值: [])line_dash_offset (
IntSpec
) – 六边形图块的线条虚线偏移值。(默认值: 0)line_join (
LineJoinSpec
, 可选) – 六边形图块的线条连接值。(默认值: ‘bevel’)line_width (
FloatSpec
, 可选) – 六边形图块的线条宽度值。(默认值: 1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
orientation (
Enum
(HexTileOrientation
), 可选) –六边形图块的方向。
使用
"pointytop"
定向图块,使尖角位于顶部。使用"flattop"
定向图块,使平边位于顶部。(默认值: ‘pointytop’)scale (
NumberSpec
, 可选) – 单个图块的比例因子。(默认值: 1.0)size (
Float
, 可选) –六边形图块的半径(以数据单位为单位)。
半径始终沿 “尖顶” 方向的笛卡尔 y 轴测量,以及沿 “平顶” 方向的笛卡尔 x 轴测量。如果底层笛卡尔系统的纵横比不是 1:1,则图块可能在一个方向上被 “挤压”。为确保图块始终是正六边形,请考虑将绘图的
match_aspect
属性设置为 True。(默认值: 1.0)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300, match_aspect=True) plot.hex_tile(r=[0, 0, 1], q=[1, 2, 2], fill_color="#74ADD1") show(plot)
- hexbin(x, y, size, orientation='pointytop', palette='Viridis256', line_color=None, fill_color=None, aspect_scale=1, **kwargs)[source]#
执行简单的等权重六边形分箱。
将添加
HexTile
字形以显示分箱。ColumnDataSource
字形的将具有列q
、r
和count
,其中q
和r
是图块的 轴向坐标,而count
是关联的箱计数。经常需要在关联的绘图上设置
match_aspect=True
,以便六边形瓦片在屏幕空间中都是规则的(即,不会被“拉伸”)。对于更复杂的使用场景,例如加权分箱或单独缩放六边形瓦片,请直接使用
hex_tile()
,或者考虑使用更高级别的库,例如 HoloViews。- 参数:
x (array[float]) – 一个 NumPy 数组,包含要分箱到六边形瓦片中的 x 坐标。
y (array[float]) – 一个 NumPy 数组,包含要分箱到六边形瓦片中的 y 坐标。
size (float) –
要使用的六边形瓦片的大小。大小定义为从六边形中心到角顶点的距离。
如果纵横比缩放不是 1:1,那么具体来说,size 是指在 *“pointytop”* 方向下从中心到“顶部”角顶点的距离,以及在 “flattop” 方向下从中心到“侧面”角顶点的距离。
orientation ("pointytop" 或 "flattop", 可选) – 六边形瓦片应该是尖角朝上还是平边朝上。(默认值:“pointytop”)
palette (str 或 seq[color], 可选) –
用于根据计数对箱体进行颜色映射的调色板(或调色板名称)。(默认值:‘Viridis256’)
如果提供了
fill_color
,它将覆盖此值。line_color (color, 可选) – 六边形瓦片的轮廓颜色,或 None(默认值:None)
fill_color (color, 可选) – 六边形瓦片的填充颜色(可选),或 None。如果为 None,则将使用
palette
根据计数对瓦片进行颜色映射。(默认值:None)aspect_scale (float) –
匹配绘图的纵横比缩放。
当处理
aspect_scale != 1
的绘图时,可以设置此参数以匹配绘图,从而绘制规则的六边形(而不是“拉伸”的六边形)。这大致等同于在“屏幕空间”中进行分箱,并且当绘图纵横比不为 1 时,最好使用轴对齐的矩形箱体。
任何额外的关键字参数都会传递给
hex_tile()
。- 返回:
- (Glyphrenderer, DataFrame)
一个元组,包含用于显示分箱的
HexTile
渲染器,以及一个 PandasDataFrame
,其中包含列q
、r
和count
,其中q
和r
是瓦片的 轴坐标,而count
是关联的箱体计数。
示例
import numpy as np from bokeh.models import HoverTool from bokeh.plotting import figure, show x = 2 + 2*np.random.standard_normal(500) y = 2 + 2*np.random.standard_normal(500) p = figure(match_aspect=True, tools="wheel_zoom,reset") p.background_fill_color = '#440154' p.grid.visible = False p.hexbin(x, y, size=0.5, hover_color="pink", hover_alpha=0.8) hover = HoverTool(tooltips=[("count", "@c"), ("(q,r)", "(@q, @r)")]) p.add_tools(hover) show(p)
- hline_stack(stackers, **kw)[source]#
为水平堆叠的线条生成多个
Line
渲染器。- 参数:
stackers (seq[str]) – 数据源字段名称的列表,用于为
x
线条坐标连续堆叠。
此外,渲染器的
name
将设置为每个连续堆叠器的值(这对于特殊的悬停变量$name
非常有用)任何额外的关键字参数都会传递给对
line
的每次调用。如果关键字值是列表或元组,则每次调用都将从序列中获取一个值。- 返回:
list[GlyphRenderer]
示例
假设一个名为
source
的ColumnDataSource
,其中包含列 *2016* 和 *2017*,那么以下使用 x 坐标堆叠器的hline_stack
调用将创建两个堆叠的Line
渲染器p.hline_stack(['2016', '2017'], y='y', color=['blue', 'red'], source=source)
这等效于以下两个单独的调用
p.line(x=stack('2016'), y='y', color='blue', source=source, name='2016') p.line(x=stack('2016', '2017'), y='y', color='red', source=source, name='2017')
- hold(*, render: bool) Generator[None, None, None] #
负责在一个范围内打开和关闭属性。
- 参数:
render (bool) – 打开和关闭属性 hold_render。
- hspan(y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
HSpan
字形。- 参数:
y (
NumberSpec
, 可选) – span 的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
AlphaSpec
, 可选) – span 的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – span 的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – span 的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – span 的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – span 的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – span 的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – span 的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300, x_range=(0, 1)) plot.hspan(y=[1, 2, 3], color="#CAB2D6") show(plot)
- hstrip(y0=Field(field='y0', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
HStrip
字形。- 参数:
y0 (
NumberSpec
, 可选) – 条带一侧的 y 坐标。(默认值:Field(field=’y0’, transform=Unspecified, units=Unspecified))y1 (
NumberSpec
, 可选) – 条带另一侧的 y 坐标。(默认值:Field(field=’y1’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 条带的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 条带的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 条带的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 条带的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 条带的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 条带的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 条带的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 条带的阴影线粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 条带的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 条带的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 条带的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 条带的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 条带的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 条带的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 条带的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300, x_range=(0, 1)) plot.hstrip(y0=[1, 2, 5], y1=[3, 4, 8], color="#CAB2D6") show(plot)
- image(image=Field(field='image', transform=Unspecified, units=Unspecified), x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), dw=Field(field='dw', transform=Unspecified, units=Unspecified), dh=Field(field='dh', transform=Unspecified, units=Unspecified), dilate=False, *, anchor='bottom_left', color_mapper=<Instance: LinearColorMapper(palette=Greys9)>, decorations=[], dh_units='data', dw_units='data', global_alpha=1.0, name=None, origin='bottom_left', palette, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Image
字形。- 参数:
image (
NumberSpec
, 可选) – 要进行颜色映射的图像的标量数据数组。(默认值:Field(field=’image’, transform=Unspecified, units=Unspecified))x (
NumberSpec
, 可选) – 用于定位图像锚点的 x 坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 用于定位图像锚点的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))dw (
DistanceSpec
, 可选) –图像将占据的绘图区域的宽度。
注意
这不是图像的像素宽度。该数字由图像本身固定。(默认值:Field(field=’dw’, transform=Unspecified, units=Unspecified))
dh (
DistanceSpec
, 可选) –图像将占据的绘图区域的高度。
注意
这不是图像的像素高度。该数字由图像本身固定。(默认值:Field(field=’dh’, transform=Unspecified, units=Unspecified))
dilate (
Bool
) –是否始终以使图像更大的方式舍入小数像素位置。
如果像素舍入误差导致图像之间出现间隙(当它们本应齐平时),则此设置可能很有用。(默认值:False)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
Either
(Enum
(Anchor
),Tuple
(Either
(Enum
(Align
),Enum
(HAlign
),Percent
),Either
(Enum
(Align
),Enum
(VAlign
),Percent
))), 可选) – 图像的位置应锚定在 x、y 坐标处。(默认值:‘bottom_left’)color_mapper (
Instance
(ColorMapper
), 可选) –一个
ColorMapper
,用于将来自image
的标量数据映射到用于显示的 RGBA 值。也可以设置
bokeh.palettes
中的调色板名称,在这种情况下,将使用配置了命名调色板的LinearColorMapper
。注意
颜色映射步骤在客户端进行。(默认值:<Instance: LinearColorMapper(palette=Greys9)>)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
dh_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)dw_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)global_alpha (
AlphaSpec
, 可选) – 图像的全局 alpha 值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
origin (
Enum
(ImageOrigin
), 可选) – 定义图像的坐标空间。(默认值:‘bottom_left’)from (用于构造颜色映射器属性值的调色板)
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
注意
如果同时传递了
palette
和color_mapper
,将引发ValueError
异常。如果两者都未传递,则默认使用Greys9
调色板。
- image_rgba(image=Field(field='image', transform=Unspecified, units=Unspecified), x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), dw=Field(field='dw', transform=Unspecified, units=Unspecified), dh=Field(field='dh', transform=Unspecified, units=Unspecified), dilate=False, *, anchor='bottom_left', decorations=[], dh_units='data', dw_units='data', global_alpha=1.0, name=None, origin='bottom_left', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
ImageRGBA
字形。- 参数:
image (
NumberSpec
, 可选) – 图像的 RGBA 数据数组。(默认值:Field(field='image', transform=Unspecified, units=Unspecified))x (
NumberSpec
, 可选) – 用于定位图像锚点的 x 坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 用于定位图像锚点的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))dw (
DistanceSpec
, 可选) –图像将占据的绘图区域的宽度。
注意
这不是图像的像素宽度。该数字由图像本身固定。(默认值:Field(field=’dw’, transform=Unspecified, units=Unspecified))
dh (
DistanceSpec
, 可选) –图像将占据的绘图区域的高度。
注意
这不是图像的像素高度。该数字由图像本身固定。(默认值:Field(field=’dh’, transform=Unspecified, units=Unspecified))
dilate (
Bool
) –是否始终以使图像更大的方式舍入小数像素位置。
如果像素舍入误差导致图像之间出现间隙(当它们本应齐平时),则此设置可能很有用。(默认值:False)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
Either
(Enum
(Anchor
),Tuple
(Either
(Enum
(Align
),Enum
(HAlign
),Percent
),Either
(Enum
(Align
),Enum
(VAlign
),Percent
))), 可选) – 图像的位置应锚定在 x、y 坐标处。(默认值:‘bottom_left’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
dh_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)dw_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)global_alpha (
AlphaSpec
, 可选) – 图像的全局 alpha 值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
origin (
Enum
(ImageOrigin
), 可选) – 定义图像的坐标空间。(默认值:‘bottom_left’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
注意
image_rgba
方法接受图像作为 RGBA 值的二维数组(编码为 32 位整数)。
- image_stack(image=Field(field='image', transform=Unspecified, units=Unspecified), x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), dw=Field(field='dw', transform=Unspecified, units=Unspecified), dh=Field(field='dh', transform=Unspecified, units=Unspecified), dilate=False, *, anchor='bottom_left', color_mapper=Undefined, decorations=[], dh_units='data', dw_units='data', global_alpha=1.0, name=None, origin='bottom_left', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
ImageStack
字形。- 参数:
image (
NumberSpec
, 可选) – 图像的 3D 数据数组。(默认值:Field(field='image', transform=Unspecified, units=Unspecified))x (
NumberSpec
, 可选) – 用于定位图像锚点的 x 坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 用于定位图像锚点的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))dw (
DistanceSpec
, 可选) –图像将占据的绘图区域的宽度。
注意
这不是图像的像素宽度。该数字由图像本身固定。(默认值:Field(field=’dw’, transform=Unspecified, units=Unspecified))
dh (
DistanceSpec
, 可选) –图像将占据的绘图区域的高度。
注意
这不是图像的像素高度。该数字由图像本身固定。(默认值:Field(field=’dh’, transform=Unspecified, units=Unspecified))
dilate (
Bool
) –是否始终以使图像更大的方式舍入小数像素位置。
如果像素舍入误差导致图像之间出现间隙(当它们本应齐平时),则此设置可能很有用。(默认值:False)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
Either
(Enum
(Anchor
),Tuple
(Either
(Enum
(Align
),Enum
(HAlign
),Percent
),Either
(Enum
(Align
),Enum
(VAlign
),Percent
))), 可选) – 图像的位置应锚定在 x、y 坐标处。(默认值:‘bottom_left’)color_mapper (
Instance
(StackColorMapper
), 可选) –用于将来自
image
的标量数据映射到 RGBA 值以进行显示的ScalarColorMapper
。注意
颜色映射步骤发生在客户端。(默认值:Undefined)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
dh_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)dw_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)global_alpha (
AlphaSpec
, 可选) – 图像的全局 alpha 值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
origin (
Enum
(ImageOrigin
), 可选) – 定义图像的坐标空间。(默认值:‘bottom_left’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
- image_url(url, x, y, w, h, angle=0, dilate=False, *, anchor='top_left', angle_units='rad', decorations=[], global_alpha=1.0, h_units='data', name=None, retry_attempts=0, retry_timeout=0, syncable=True, tags=[], w_units='data', **kwargs) GlyphRenderer #
配置并向此图形添加
ImageURL
字形。- 参数:
url (
StringSpec
) –用于检索图像的 URL。
注意
图像的实际检索和加载发生在客户端。
x (
NumberSpec
) – 用于定位图像锚点的 x 坐标。y (
NumberSpec
) – 用于定位图像锚点的 y 坐标。w (
NullDistanceSpec
) –图像将在数据空间中占据的绘图区域的宽度。
默认值为
None
,在这种情况下,图像将以其实际图像大小显示(无论此处指定的单位如何)。h (
NullDistanceSpec
) –图像将在数据空间中占据的绘图区域的高度。
默认值为
None
,在这种情况下,图像将以其实际图像大小显示(无论此处指定的单位如何)。angle (
AngleSpec
) – 用于旋转图像的角度,从水平方向测量。(默认值:0)dilate (
Bool
) –是否始终以使图像更大的方式舍入小数像素位置。
如果像素舍入误差导致图像之间出现间隙(当它们本应齐平时),则此设置可能很有用。(默认值:False)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
Either
(Enum
(Anchor
),Tuple
(Either
(Enum
(Align
),Enum
(HAlign
),Percent
),Either
(Enum
(Align
),Enum
(VAlign
),Percent
))), 可选) – 图像的位置应锚定在 x, y 坐标处。(默认值:'top_left')angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
global_alpha (
NumberSpec
, 可选) – 每个图像渲染时的整体不透明度(除了图像本身固有的任何 alpha 值之外)。(默认值:1.0)h_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:屏幕或数据(默认值:'data')此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
retry_attempts (
Int
) – 从指定的 URL 重试加载图像的尝试次数。默认为零。(默认值:0)retry_timeout (
Int
) – 从指定的 URL 加载图像的重试尝试之间的超时时间(毫秒)。默认为零毫秒。(默认值:0)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
w_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:屏幕或数据(默认值:'data')
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
- inverted_triangle(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.inverted_triangle(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DE2D26") show(plot)
- 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)
- line(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Line
字形。- 参数:
x (
NumberSpec
, 可选) – 线条点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 线条点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
Alpha
, 可选) – 线条的线条 alpha 值。(默认值:1.0)line_dash (
DashPattern
) – 线条的线条虚线值。(默认值:[])line_dash_offset (
Int
) – 线条的线条虚线偏移值。(默认值:0)line_width (
Float
, 可选) – 线条的线宽值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show p = figure(title="line", width=300, height=300) p.line(x=[1, 2, 3, 4, 5], y=[6, 7, 2, 4, 5]) show(p)
- classmethod lookup(name: str, *, raises: bool = True) PropertyDescriptor[Any] | None #
查找给定属性名称的类上 Bokeh 属性的
PropertyDescriptor
。- 参数:
- 返回:
名为
name
的属性的描述符- 返回类型:
- mathml(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), text=Field(field='text', transform=Unspecified, units=Unspecified), angle=0, x_offset=0, y_offset=0, *, anchor=Value(value='auto', transform=Unspecified, units=Unspecified), angle_units='rad', background_fill_alpha=1.0, background_fill_color=None, background_hatch_alpha=1.0, background_hatch_color=None, background_hatch_extra={}, background_hatch_pattern=None, background_hatch_scale=12.0, background_hatch_weight=1.0, border_line_alpha=1.0, border_line_cap='butt', border_line_color=None, border_line_dash=[], border_line_dash_offset=0, border_line_join='bevel', border_line_width=1, border_radius=0, decorations=[], name=None, outline_shape='box', padding=0, syncable=True, tags=[], text_align='left', text_alpha=1.0, text_baseline='bottom', text_color='#444444', text_font=Value(value='helvetica', transform=Unspecified, units=Unspecified), text_font_size=Value(value='16px', transform=Unspecified, units=Unspecified), text_font_style='normal', text_line_height=1.2, text_outline_color=None, **kwargs) GlyphRenderer #
配置并向此图表添加
MathMLGlyph
字形。- 参数:
x (
NumberSpec
, optional) – 用于定位文本锚点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, optional) – 用于定位文本锚点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))text (
StringSpec
, optional) – 要渲染的文本值。(默认值:Field(field='text', transform=Unspecified, units=Unspecified))angle (
AngleSpec
) – 旋转文本的角度,从水平方向测量。(默认值:0)x_offset (
FloatSpec
) –应用于 x 坐标的像素偏移值。
例如,如果希望将文本从给定的数据位置“浮动”固定距离(以 屏幕单位 为单位),这将非常有用。(默认值:0)
y_offset (
FloatSpec
) –应用于 y 坐标的像素偏移值。
例如,如果希望将文本从给定的数据位置“浮动”固定距离(以 屏幕单位 为单位),这将非常有用。(默认值:0)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
DataSpec
, optional) –此字形边框内的位置,
x
和y
坐标将锚定到该位置。这可以是命名的锚点,例如top_left
或center
,也可以是从左到右和从上到下的百分比,或者这些的组合,在宽度和高度上独立设置。如果设置为auto
,则锚点将根据文本align
和baseline
确定。注意
此属性是实验性的,可能会在任何时候更改。(默认值:Value(value='auto', transform=Unspecified, units=Unspecified))
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)background_fill_alpha (
AlphaSpec
, optional) – 文本边框的填充 alpha 值。(默认值:1.0)background_fill_color (
ColorSpec
) – 文本边框的填充颜色值。background_hatch_alpha (
AlphaSpec
, optional) – 文本边框的阴影线 alpha 值。(默认值:1.0)background_hatch_color (
ColorSpec
) – 文本边框的阴影线颜色值。background_hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 文本边框的额外阴影线值。(默认值:{})background_hatch_pattern (
HatchPatternSpec
) – 文本边框的阴影线图案值。background_hatch_scale (
FloatSpec
, optional) – 文本边框的阴影线比例值。(默认值:12.0)background_hatch_weight (
FloatSpec
, optional) – 文本边框的阴影线粗细值。(默认值:1.0)border_line_alpha (
AlphaSpec
, optional) – 文本边框的线条 alpha 值。(默认值:1.0)border_line_cap (
LineCapSpec
, optional) – 文本边框的线帽值。(默认值:'butt')border_line_color (
ColorSpec
) – 文本边框的线条颜色值。border_line_dash (
DashPatternSpec
) – 文本边框的线条虚线值。(默认值:[])border_line_dash_offset (
IntSpec
) – 文本边框的线条虚线偏移值。(默认值:0)border_line_join (
LineJoinSpec
, optional) – 文本边框的线条连接值。(默认值:'bevel')border_line_width (
FloatSpec
, optional) – 文本边框的线条宽度值。(默认值:1)border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许框具有圆角。为了获得最佳效果,应与
padding
结合使用。注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
outline_shape (
DataSpec
, optional) –指定文本框轮廓的形状。
文本框的默认轮廓是其边界框(或矩形)。可以将其更改为预定义形状的选择,例如圆形、椭圆形、菱形、平行四边形等。这些形状外接在边界框上,以便框的内容适合这些形状内部。
仅当设置了边框线、背景填充和/或背景阴影线属性时,此属性才生效。用户可以选择
"none"
以避免绘制任何形状,即使设置了边框或背景视觉效果。注意
此属性为实验性属性,可能会随时更改。
注意
当前,命中测试仅使用字形文本内容的边界框,这等效于使用框/矩形形状。(默认值:'box')
padding (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
),Struct
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –字形文本与其边框(边框)之间的额外空间。
注意
此属性是实验性的,随时可能更改。(默认: 0)
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
text_align (
TextAlignSpec
, optional) – 文本的文本对齐值。(默认值:'left')text_alpha (
AlphaSpec
, optional) – 文本的文本 alpha 值。(默认值:1.0)text_baseline (
TextBaselineSpec
, optional) – 文本的文本基线值。(默认值:'bottom')text_color (
ColorSpec
, optional) – 文本的文本颜色值。(默认值:'#444444')text_font (
StringSpec
, optional) – 文本的文本字体值。(默认值:Value(value='helvetica', transform=Unspecified, units=Unspecified))text_font_size (
FontSizeSpec
, optional) – 文本的文本字体大小值。(默认值:Value(value='16px', transform=Unspecified, units=Unspecified))text_font_style (
FontStyleSpec
, optional) – 文本的文本字体样式值。(默认值:'normal')text_line_height (
NumberSpec
, optional) – 文本的文本行高值。(默认值:1.2)text_outline_color (
ColorSpec
) – 文本的文本轮廓颜色值。
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.mathml(x=[0], y=[0], text=[''' <math display="block"> <mrow> <msup> <mi>x</mi> <mn>2</mn> </msup> <msup> <mi>y</mi> <mn>2</mn> </msup> </mrow> </math> ''']) show(p)
- multi_line(xs=Field(field='xs', transform=Unspecified, units=Unspecified), ys=Field(field='ys', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图表添加
MultiLine
字形。- 参数:
xs (
NumberSpec
, optional) – 所有线的 x 坐标,以“列表的列表”形式给出。(默认值:Field(field='xs', transform=Unspecified, units=Unspecified))ys (
NumberSpec
, optional) – 所有线的 y 坐标,以“列表的列表”形式给出。(默认值:Field(field='ys', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
AlphaSpec
, optional) – 线的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, optional) – 线的线帽值。(默认值:'butt')line_color (
ColorSpec
, optional) – 线的线条颜色值。(默认值:'black')line_dash (
DashPatternSpec
) – 线的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 线的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, optional) – 线的线条连接值。(默认值:'bevel')line_width (
FloatSpec
, optional) – 线的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
注意
对于此字形,数据不仅仅是标量数组,它还是“数组的数组”。
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.multi_line(xs=[[1, 2, 3], [2, 3, 4]], ys=[[6, 7, 2], [4, 5, 7]], color=['red','green']) show(p)
- multi_polygons(xs=Field(field='xs', transform=Unspecified, units=Unspecified), ys=Field(field='ys', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图表添加
MultiPolygons
字形。- 参数:
xs (
NumberSpec
, optional) –所有面片的 x 坐标,以嵌套列表形式给出。
注意
MultiPolygons
中的每个项目代表一个 MultiPolygon,每个 MultiPolygon 由n
个 Polygon 组成。每个 Polygon 由一个外环组成,可以选择后跟m
个内环(孔洞)。(默认值:Field(field='xs', transform=Unspecified, units=Unspecified))ys (
NumberSpec
, 可选) –所有面片的 y 坐标,以“列表的列表”形式给出。
注意
MultiPolygons
中的每个项目代表一个 MultiPolygon,而每个 MultiPolygon 由n
个 Polygon 组成。每个 Polygon 由一个外部环组成,可以选择后跟m
个内部环(孔洞)。(默认值:Field(field=’ys’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 多边形的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 多边形的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 多边形的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 多边形的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 多边形的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 多边形的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 多边形的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 多边形的阴影线粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 多边形的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 多边形的线条端帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 多边形的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 多边形的线条虚线图案值。(默认值:[])line_dash_offset (
IntSpec
) – 多边形的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 多边形的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 多边形的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
注意
对于此字形,数据不仅仅是标量数组,它是一个嵌套数组。
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.multi_polygons(xs=[[[[1, 1, 2, 2]]], [[[1, 1, 3], [1.5, 1.5, 2]]]], ys=[[[[4, 3, 3, 4]]], [[[1, 3, 1], [1.5, 2, 1.5]]]], color=['red', 'green']) show(p)
- ngon(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), radius=Undefined, *, angle=0, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, n=Field(field='n', transform=Unspecified, units=Unspecified), name=None, radius_dimension='x', radius_units='data', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Ngon
字形。- 参数:
x (
NumberSpec
, 可选) – n 边形中心的 x 坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – n 边形中心的 y 坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))radius (
DistanceSpec
, 可选) – n 边形的半径值(默认情况下,单位为数据单位)。半径是从中心到 n 边形顶点的距离。(默认值:Undefined)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle (
AngleSpec
) – 旋转 n 边形的角度,以弧度为单位。当值为零时,一个顶点将直接绘制在中心坐标上方。(默认值:0)angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – n 边形的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – n 边形的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – n 边形的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – n 边形的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – n 边形的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – n 边形的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – n 边形的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – n 边形的阴影线粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – n 边形的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – n 边形的线条端帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – n 边形的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – n 边形的线条虚线图案值。(默认值:[])line_dash_offset (
IntSpec
) – n 边形的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – n 边形的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – n 边形的线条宽度值。(默认值:1)n (
NumberSpec
, 可选) – n 边形的边数。小于 3 的值将导致不绘制任何字形实例。(默认值:Field(field=’n’, transform=Unspecified, units=Unspecified))此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
radius_dimension (
Enum
(RadiusDimension
), 可选) –用于测量 n 边形半径的维度。
当数据空间纵横比不是 1:1 时,绘制的 n 边形的大小取决于用于测量半径“距离”的方向。此属性允许控制该方向。
将此维度设置为 ‘max’ 将计算 x 和 y 维度上的半径,并使用两者中的最大值,‘min’ 选择最小值。(默认值:‘x’)
radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.ngon(x=[1, 2, 3, 2], y=[6, 7, 2, 2], radius=1, n=[3, 4, 9, 20], color="#99d8c9") show(p)
- 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 中的特定事件。
- patch(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Patch
字形。- 参数:
x (
NumberSpec
, 可选) –面片点的 x 坐标。
注意
一个面片可以包含多个多边形。在这种情况下,每个多边形的 x 坐标应在序列中用 NaN 值分隔。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))
y (
NumberSpec
, 可选) –面片点的 y 坐标。
注意
一个面片可以包含多个多边形。在这种情况下,每个多边形的 y 坐标应在序列中用 NaN 值分隔。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
Alpha
, 可选) – 面片的填充 alpha 值。(默认值:1.0)hatch_alpha (
Alpha
, 可选) – 面片的阴影线 alpha 值。(默认值:1.0)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 面片的额外阴影线值。(默认值:{})hatch_scale (
Size
, 可选) – 面片的阴影线比例值。(默认值:12.0)hatch_weight (
Size
, 可选) – 面片的阴影线粗细值。(默认值:1.0)line_alpha (
Alpha
, 可选) – 面片的线条 alpha 值。(默认值:1.0)line_dash (
DashPattern
) – 面片的线条虚线图案值。(默认值:[])line_dash_offset (
Int
) – 面片的线条虚线偏移值。(默认值:0)line_width (
Float
, 可选) – 面片的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.patch(x=[1, 2, 3, 2], y=[6, 7, 2, 2], color="#99d8c9") show(p)
- patches(xs=Field(field='xs', transform=Unspecified, units=Unspecified), ys=Field(field='ys', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图形添加
Patches
字形。- 参数:
xs (
NumberSpec
, optional) –所有面片的 x 坐标,以“列表的列表”形式给出。
注意
单个面片可以包含多个多边形。在这种情况下,每个多边形的 x 坐标应在子列表中用 NaN 值分隔。(默认值:Field(field='xs', transform=Unspecified, units=Unspecified))
ys (
NumberSpec
, 可选) –所有面片的 y 坐标,以“列表的列表”形式给出。
注意
单个面片可以包含多个多边形。在这种情况下,每个多边形的 y 坐标应在子列表中用 NaN 值分隔。(默认值:Field(field='ys', transform=Unspecified, units=Unspecified))
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 面片的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 面片的填充颜色值。(默认值:'gray')hatch_alpha (
AlphaSpec
, 可选) – 面片的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 面片的阴影颜色值。(默认值:'black')hatch_extra (
Dict
(String
,Instance
('bokeh.models.textures.Texture'))) – 面片的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 面片的阴影图案值。hatch_scale (
FloatSpec
, 可选) – 面片的阴影比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 面片的阴影粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 面片的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 面片的线帽值。(默认值:'butt')line_color (
ColorSpec
, 可选) – 面片的线条颜色值。(默认值:'black')line_dash (
DashPatternSpec
) – 面片的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 面片的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 面条的线连接值。(默认值:'bevel')line_width (
FloatSpec
, 可选) – 面片的线宽值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
注意
对于此字形,数据不仅仅是标量数组,它还是“数组的数组”。
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.patches(xs=[[1,2,3],[4,5,6,5]], ys=[[1,2,1],[4,5,5,4]], color=["#43a2ca", "#a8ddb5"]) show(p)
- plus(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.plus(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DE2D26") show(plot)
- 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] #
收集将属性名称映射到其值的字典。
此方法总是遍历类层次结构,并包括在任何父类上定义的属性。
不可序列化的属性将被跳过,并且属性值采用“序列化”格式,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损地重建对象实例所需的信息。
- quad(left=Field(field='left', transform=Unspecified, units=Unspecified), right=Field(field='right', transform=Unspecified, units=Unspecified), top=Field(field='top', transform=Unspecified, units=Unspecified), bottom=Field(field='bottom', transform=Unspecified, units=Unspecified), *, border_radius=0, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图形添加
Quad
字形。- 参数:
left (
NumberSpec
, 可选) – 左边缘的 x 坐标。(默认值:Field(field='left', transform=Unspecified, units=Unspecified))right (
NumberSpec
, 可选) – 右边缘的 x 坐标。(默认值: Field(field=’right’, transform=Unspecified, units=Unspecified))top (
NumberSpec
, 可选) – 顶边缘的 y 坐标。(默认值:Field(field='top', transform=Unspecified, units=Unspecified))bottom (
NumberSpec
, 可选) – 底边缘的 y 坐标。(默认值:Field(field='bottom', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许方框具有圆角。
注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 四边形的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 四边形的填充颜色值。(默认值:'gray')hatch_alpha (
AlphaSpec
, 可选) – 四边形的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 四边形的阴影颜色值。(默认值:'black')hatch_extra (
Dict
(String
,Instance
('bokeh.models.textures.Texture'))) – 四边形的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 四边形的阴影图案值。hatch_scale (
FloatSpec
, 可选) – 四边形的阴影比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 四边形的阴影粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 四边形的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 四边形的线帽值。(默认值:'butt')line_color (
ColorSpec
, 可选) – 四边形的线条颜色值。(默认值:'black')line_dash (
DashPatternSpec
) – 四边形的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 四边形的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 四边形的线连接值。(默认值:'bevel')line_width (
FloatSpec
, 可选) – 四边形的线宽值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.quad(top=[2, 3, 4], bottom=[1, 2, 3], left=[1, 2, 3], right=[1.2, 2.5, 3.7], color="#B3DE69") show(plot)
- quadratic(x0=Field(field='x0', transform=Unspecified, units=Unspecified), y0=Field(field='y0', transform=Unspecified, units=Unspecified), x1=Field(field='x1', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), cx=Field(field='cx', transform=Unspecified, units=Unspecified), cy=Field(field='cy', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图形添加
Quadratic
字形。- 参数:
x0 (
NumberSpec
, 可选) – 起始点的 x 坐标。(默认值:Field(field=’x0’, transform=Unspecified, units=Unspecified))y0 (
NumberSpec
, 可选) – 起始点的 y 坐标。(默认值:Field(field=’y0’, transform=Unspecified, units=Unspecified))x1 (
NumberSpec
, 可选) – 结束点的 x 坐标。(默认值:Field(field=’x1’, transform=Unspecified, units=Unspecified))y1 (
NumberSpec
, 可选) – 结束点的 y 坐标。(默认值:Field(field=’y1’, transform=Unspecified, units=Unspecified))cx (
NumberSpec
, 可选) – 控制点的 x 坐标。(默认值:Field(field='cx', transform=Unspecified, units=Unspecified))cy (
NumberSpec
, 可选) – 控制点的 y 坐标。(默认值:Field(field='cy', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
AlphaSpec
, 可选) – 抛物线的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 抛物线的线帽值。(默认值:'butt')line_color (
ColorSpec
, 可选) – 抛物线的线条颜色值。(默认值:'black')line_dash (
DashPatternSpec
) – 抛物线的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 抛物线的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 抛物线的线条连接值。(默认值:'bevel')line_width (
FloatSpec
, 可选) – 抛物线的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
- query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any] #
使用谓词查询
HasProps
实例的属性值。
- ray(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), length=0, angle=0, *, angle_units='rad', decorations=[], length_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图形添加
Ray
字形。- 参数:
x (
NumberSpec
, 可选) – 射线起点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 射线起点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))length (
DistanceSpec
) – 射线延伸的长度。请注意,此length
默认使用 数据单位 (在 x 方向上测量)。(默认值:0)angle (
AngleSpec
) – 射线延伸的角度,以弧度为单位,从水平方向测量。(默认值:0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
length_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:'data')line_alpha (
AlphaSpec
, 可选) – 射线的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 射线的线帽值。(默认值:'butt')line_color (
ColorSpec
, 可选) – 射线的线条颜色值。(默认值:'black')line_dash (
DashPatternSpec
) – 射线的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 射线的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 射线的线条连接值。(默认值:'bevel')line_width (
FloatSpec
, 可选) – 射线的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.ray(x=[1, 2, 3], y=[1, 2, 3], length=45, angle=-0.7, color="#FB8072", line_width=2) show(plot)
- rect(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), width=Field(field='width', transform=Unspecified, units=Unspecified), height=Field(field='height', transform=Unspecified, units=Unspecified), angle=0.0, dilate=False, *, angle_units='rad', border_radius=0, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, height_units='data', line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], width_units='data', **kwargs) GlyphRenderer #
配置并向该图形添加
Rect
字形。- 参数:
x (
NumberSpec
, 可选) – 矩形中心点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 矩形中心点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))width (
DistanceSpec
, 可选) – 矩形的整体宽度。(默认值:Field(field='width', transform=Unspecified, units=Unspecified))height (
DistanceSpec
, 可选) – 矩形的整体高度。(默认值:Field(field='height', transform=Unspecified, units=Unspecified))angle (
AngleSpec
) – 矩形旋转的角度,以弧度为单位,从水平方向测量。(默认值:0.0)dilate (
Bool
) –是否始终对分数像素位置进行四舍五入,以使矩形更大。
当像素舍入误差导致矩形之间出现间隙(当它们本应齐平时),此设置可能很有用。(默认值:False)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许方框具有圆角。
注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 矩形的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 矩形的填充颜色值。(默认值:'gray')hatch_alpha (
AlphaSpec
, 可选) – 矩形的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 矩形的阴影线颜色值。(默认值:'black')hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 矩形的阴影线额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 矩形的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 矩形的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 矩形的阴影线粗细值。(默认值:1.0)height_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)line_alpha (
AlphaSpec
, 可选) – 矩形的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 矩形的线帽值。(默认值:'butt')line_color (
ColorSpec
, 可选) – 矩形的线条颜色值。(默认值:'black')line_dash (
DashPatternSpec
) – 矩形的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 矩形的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 矩形的线条连接值。(默认值:'bevel')line_width (
FloatSpec
, 可选) – 矩形的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
width_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.rect(x=[1, 2, 3], y=[1, 2, 3], width=10, height=20, color="#CAB2D6", width_units="screen", height_units="screen") show(plot)
- row(row, gridplot)#
返回此绘图是否在 GridPlot 的给定行中。
- scatter(*args: Any, **kwargs: Any) GlyphRenderer #
创建给定 x 和 y 项的散点图。
- 参数:
x (str 或 seq[float]) – 中心 x 坐标的值或字段名
y (str 或 seq[float]) – 中心 y 坐标的值或字段名
marker (str, 或 list[str]) – 标记类型的数值或字段名称,请访问
MarkerType
获取有效值的完整列表。color (颜色值, 可选) – 设置填充颜色和线条颜色的简写形式
source (
ColumnDataSource
) – 用户提供的数据源。如果需要,将尝试将对象转换为ColumnDataSource
。如果未提供,则会自动为用户创建一个。
示例
>>> p.scatter([1,2,3],[4,5,6], marker="square", fill_color="red") >>> p.scatter("data1", "data2", marker="mtype", source=data_source, ...)
注意
Scatter
具有多种标记类型的标记在使用 WebGL 输出后端时可能会以不同的顺序绘制。这是为了性能而做出的明确权衡。
- segment(x0=Field(field='x0', transform=Unspecified, units=Unspecified), y0=Field(field='y0', transform=Unspecified, units=Unspecified), x1=Field(field='x1', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Segment
字形。- 参数:
x0 (
NumberSpec
, 可选) – 起始点的 x 坐标。(默认值:Field(field=’x0’, transform=Unspecified, units=Unspecified))y0 (
NumberSpec
, 可选) – 起始点的 y 坐标。(默认值:Field(field=’y0’, transform=Unspecified, units=Unspecified))x1 (
NumberSpec
, 可选) – 结束点的 x 坐标。(默认值:Field(field=’x1’, transform=Unspecified, units=Unspecified))y1 (
NumberSpec
, 可选) – 结束点的 y 坐标。(默认值:Field(field=’y1’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
AlphaSpec
, 可选) – 线段的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 线段的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 线段的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 线段的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 线段的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 线段的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 线段的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.segment(x0=[1, 2, 3], y0=[1, 2, 3], x1=[1, 2, 3], y1=[1.2, 2.5, 3.7], color="#F4A582", line_width=3) show(plot)
- select(*args, **kwargs)#
查询此对象及其所有引用,以查找与给定选择器匹配的对象。
有几种不同的方法可以调用
select
方法。最常见的方法是提供一个 JSON 样式的查询字典作为单个参数或作为关键字参数- 参数:
selector (JSON-like) – 一些示例文本
- 关键词参数:
kwargs – 查询字典键/值作为关键字参数
此外,为了与
Model.select
兼容,选择器字典可以作为selector
关键字参数传递,在这种情况下,kwargs['selector']
的值将用于查询。为了方便起见,可以通过提供
name
字符串作为单个参数来对名称进行查询- 参数:
name (str) – 要查询的名称
同样,也可以通过简单地提供
Model
子类作为单个参数来对类型进行查询- 参数:
type (Model) – 要查询的类型
- 返回:
seq[Model]
示例
# These three are equivalent p.select(selector={"type": HoverTool}) p.select({"type": HoverTool}) p.select(HoverTool) # These two are also equivalent p.select({"name": "mycircle"}) p.select("mycircle") # Keyword arguments can be supplied in place of selector dict p.select({"name": "foo", "type": HoverTool}) p.select(name="foo", type=HoverTool)
- select_one(selector: SelectorType) Model | None #
查询此对象及其所有引用,以查找与给定选择器匹配的对象。如果找到多个对象,则引发错误。返回单个匹配对象,如果未找到任何对象,则返回 None :param selector: :type selector: JSON-like
- 返回:
模型
- 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
- square(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.square(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,30], color="#74ADD1") show(plot)
- square_cross(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.square_cross(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#7FC97F",fill_color=None, line_width=2) show(plot)
- square_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.square_dot(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#7FC97F", fill_color=None) show(plot)
- square_pin(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.square_pin(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#7FC97F",fill_color=None, line_width=2) show(plot)
- square_x(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.square_x(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#FDAE6B",fill_color=None, line_width=2) show(plot)
- star(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.star(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#1C9099", line_width=2) show(plot)
- star_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.star_dot(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#386CB0", fill_color=None, line_width=2) show(plot)
- step(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, mode='before', name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Step
字形。- 参数:
x (
NumberSpec
, 可选) – 步阶的 x 坐标。(默认值: Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 步阶的 y 坐标。(默认值: Field(field='y', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
Alpha
, 可选) – 步阶的线条 alpha 值。(默认值: 1.0)line_dash (
DashPattern
) – 步阶的线条虚线值。(默认值: [])line_dash_offset (
Int
) – 步阶的线条虚线偏移值。(默认值: 0)line_width (
Float
, 可选) – 步阶的线条宽度值。(默认值: 1)步阶“级别”应相对于 x 和 y 坐标绘制的位置。参数可以采用以下三个值之一
before
: (默认) 在每个 x 坐标之前绘制步阶水平线 (第一个点之前没有步阶)after
: 在每个 x 坐标之后绘制步阶水平线 (最后一个点之后没有步阶)center
: 在每个 x 坐标中心绘制步阶水平线 (默认值: ‘before’)
此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.step(x=[1, 2, 3, 4, 5], y=[1, 2, 3, 2, 5], color="#FB8072") show(plot)
- subplot(*, x_source: Range | None = None, y_source: Range | None = None, x_scale: Scale | None = None, y_scale: Scale | None = None, x_target: Range, y_target: Range) GlyphAPI [source]#
创建一个新的子坐标系并公开绘图 API。
- tex(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), text=Field(field='text', transform=Unspecified, units=Unspecified), angle=0, x_offset=0, y_offset=0, *, anchor=Value(value='auto', transform=Unspecified, units=Unspecified), angle_units='rad', background_fill_alpha=1.0, background_fill_color=None, background_hatch_alpha=1.0, background_hatch_color=None, background_hatch_extra={}, background_hatch_pattern=None, background_hatch_scale=12.0, background_hatch_weight=1.0, border_line_alpha=1.0, border_line_cap='butt', border_line_color=None, border_line_dash=[], border_line_dash_offset=0, border_line_join='bevel', border_line_width=1, border_radius=0, decorations=[], display='auto', macros={}, name=None, outline_shape='box', padding=0, syncable=True, tags=[], text_align='left', text_alpha=1.0, text_baseline='bottom', text_color='#444444', text_font=Value(value='helvetica', transform=Unspecified, units=Unspecified), text_font_size=Value(value='16px', transform=Unspecified, units=Unspecified), text_font_style='normal', text_line_height=1.2, text_outline_color=None, **kwargs) GlyphRenderer #
配置并向此图形添加
TeXGlyph
字形。- 参数:
x (
NumberSpec
, optional) – 用于定位文本锚点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, optional) – 用于定位文本锚点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))text (
StringSpec
, optional) – 要渲染的文本值。(默认值:Field(field='text', transform=Unspecified, units=Unspecified))angle (
AngleSpec
) – 旋转文本的角度,从水平方向测量。(默认值:0)x_offset (
FloatSpec
) –应用于 x 坐标的像素偏移值。
例如,如果希望将文本从给定的数据位置“浮动”固定距离(以 屏幕单位 为单位),这将非常有用。(默认值:0)
y_offset (
FloatSpec
) –应用于 y 坐标的像素偏移值。
例如,如果希望将文本从给定的数据位置“浮动”固定距离(以 屏幕单位 为单位),这将非常有用。(默认值:0)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
DataSpec
, optional) –此字形边框内的位置,
x
和y
坐标将锚定到该位置。这可以是命名的锚点,例如top_left
或center
,也可以是从左到右和从上到下的百分比,或者这些的组合,在宽度和高度上独立设置。如果设置为auto
,则锚点将根据文本align
和baseline
确定。注意
此属性是实验性的,可能会在任何时候更改。(默认值:Value(value='auto', transform=Unspecified, units=Unspecified))
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)background_fill_alpha (
AlphaSpec
, optional) – 文本边框的填充 alpha 值。(默认值:1.0)background_fill_color (
ColorSpec
) – 文本边框的填充颜色值。background_hatch_alpha (
AlphaSpec
, optional) – 文本边框的阴影线 alpha 值。(默认值:1.0)background_hatch_color (
ColorSpec
) – 文本边框的阴影线颜色值。background_hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 文本边框的额外阴影线值。(默认值:{})background_hatch_pattern (
HatchPatternSpec
) – 文本边框的阴影线图案值。background_hatch_scale (
FloatSpec
, optional) – 文本边框的阴影线比例值。(默认值:12.0)background_hatch_weight (
FloatSpec
, optional) – 文本边框的阴影线粗细值。(默认值:1.0)border_line_alpha (
AlphaSpec
, optional) – 文本边框的线条 alpha 值。(默认值:1.0)border_line_cap (
LineCapSpec
, optional) – 文本边框的线帽值。(默认值:'butt')border_line_color (
ColorSpec
) – 文本边框的线条颜色值。border_line_dash (
DashPatternSpec
) – 文本边框的线条虚线值。(默认值:[])border_line_dash_offset (
IntSpec
) – 文本边框的线条虚线偏移值。(默认值:0)border_line_join (
LineJoinSpec
, optional) – 文本边框的线条连接值。(默认值:'bevel')border_line_width (
FloatSpec
, optional) – 文本边框的线条宽度值。(默认值:1)border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许框具有圆角。为了获得最佳效果,应与
padding
结合使用。注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
display (
Enum
(Enumeration(inline, block, auto)), 可选) –定义如何解释文本以及使用什么 TeX 显示模式。
允许以下值
"auto"
(默认) 解析文本,需要 TeX 分隔符来括起数学内容,例如"$$x^2$$"
或r"\[\frac{x}{y}\]"
。这允许混合数学文本和常规文本内容。TeX 显示模式由解析器推断。"block"
文本被逐字采用,并使用 TeX 的块模式。"inline"
文本被逐字采用,并使用 TeX 的内联模式。(默认值: ‘auto’)
macros (
Dict
(String
,Either
(String
,Tuple
(String
,Int
)))) –用户定义的 TeX 宏。
这是从控制序列名称(不带前导反斜杠)到替换字符串或替换字符串和参数数量的元组的映射。
示例
TeX(text=r"\R \rightarrow \R^2", macros={"RR": r"{\bf R}"}) (default: {})
此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
outline_shape (
DataSpec
, optional) –指定文本框轮廓的形状。
文本框的默认轮廓是其边界框(或矩形)。可以将其更改为预定义形状的选择,例如圆形、椭圆形、菱形、平行四边形等。这些形状外接在边界框上,以便框的内容适合这些形状内部。
仅当设置了边框线、背景填充和/或背景阴影线属性时,此属性才生效。用户可以选择
"none"
以避免绘制任何形状,即使设置了边框或背景视觉效果。注意
此属性为实验性属性,可能会随时更改。
注意
当前,命中测试仅使用字形文本内容的边界框,这等效于使用框/矩形形状。(默认值:'box')
padding (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
),Struct
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –字形文本与其边框(边框)之间的额外空间。
注意
此属性是实验性的,随时可能更改。(默认: 0)
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
text_align (
TextAlignSpec
, optional) – 文本的文本对齐值。(默认值:'left')text_alpha (
AlphaSpec
, optional) – 文本的文本 alpha 值。(默认值:1.0)text_baseline (
TextBaselineSpec
, optional) – 文本的文本基线值。(默认值:'bottom')text_color (
ColorSpec
, optional) – 文本的文本颜色值。(默认值:'#444444')text_font (
StringSpec
, optional) – 文本的文本字体值。(默认值:Value(value='helvetica', transform=Unspecified, units=Unspecified))text_font_size (
FontSizeSpec
, optional) – 文本的文本字体大小值。(默认值:Value(value='16px', transform=Unspecified, units=Unspecified))text_font_style (
FontStyleSpec
, optional) – 文本的文本字体样式值。(默认值:'normal')text_line_height (
NumberSpec
, optional) – 文本的文本行高值。(默认值:1.2)text_outline_color (
ColorSpec
) – 文本的文本轮廓颜色值。
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show p = figure(width=300, height=300) p.tex(x=[0], y=[0], text=["x^2 y^2]) show(p)
- text(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), text=Field(field='text', transform=Unspecified, units=Unspecified), angle=0, x_offset=0, y_offset=0, *, anchor=Value(value='auto', transform=Unspecified, units=Unspecified), angle_units='rad', background_fill_alpha=1.0, background_fill_color=None, background_hatch_alpha=1.0, background_hatch_color=None, background_hatch_extra={}, background_hatch_pattern=None, background_hatch_scale=12.0, background_hatch_weight=1.0, border_line_alpha=1.0, border_line_cap='butt', border_line_color=None, border_line_dash=[], border_line_dash_offset=0, border_line_join='bevel', border_line_width=1, border_radius=0, decorations=[], name=None, outline_shape='box', padding=0, syncable=True, tags=[], text_align='left', text_alpha=1.0, text_baseline='bottom', text_color='#444444', text_font=Value(value='helvetica', transform=Unspecified, units=Unspecified), text_font_size=Value(value='16px', transform=Unspecified, units=Unspecified), text_font_style='normal', text_line_height=1.2, text_outline_color=None, **kwargs) GlyphRenderer #
配置并向此图形添加
Text
字形。- 参数:
x (
NumberSpec
, optional) – 用于定位文本锚点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y (
NumberSpec
, optional) – 用于定位文本锚点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))text (
StringSpec
, optional) – 要渲染的文本值。(默认值:Field(field='text', transform=Unspecified, units=Unspecified))angle (
AngleSpec
) – 旋转文本的角度,从水平方向测量。(默认值:0)x_offset (
FloatSpec
) –应用于 x 坐标的像素偏移值。
例如,如果希望将文本从给定的数据位置“浮动”固定距离(以 屏幕单位 为单位),这将非常有用。(默认值:0)
y_offset (
FloatSpec
) –应用于 y 坐标的像素偏移值。
例如,如果希望将文本从给定的数据位置“浮动”固定距离(以 屏幕单位 为单位),这将非常有用。(默认值:0)
alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
anchor (
DataSpec
, optional) –此字形边框内的位置,
x
和y
坐标将锚定到该位置。这可以是命名的锚点,例如top_left
或center
,也可以是从左到右和从上到下的百分比,或者这些的组合,在宽度和高度上独立设置。如果设置为auto
,则锚点将根据文本align
和baseline
确定。注意
此属性是实验性的,可能会在任何时候更改。(默认值:Value(value='auto', transform=Unspecified, units=Unspecified))
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)background_fill_alpha (
AlphaSpec
, optional) – 文本边框的填充 alpha 值。(默认值:1.0)background_fill_color (
ColorSpec
) – 文本边框的填充颜色值。background_hatch_alpha (
AlphaSpec
, optional) – 文本边框的阴影线 alpha 值。(默认值:1.0)background_hatch_color (
ColorSpec
) – 文本边框的阴影线颜色值。background_hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 文本边框的额外阴影线值。(默认值:{})background_hatch_pattern (
HatchPatternSpec
) – 文本边框的阴影线图案值。background_hatch_scale (
FloatSpec
, optional) – 文本边框的阴影线比例值。(默认值:12.0)background_hatch_weight (
FloatSpec
, optional) – 文本边框的阴影线粗细值。(默认值:1.0)border_line_alpha (
AlphaSpec
, optional) – 文本边框的线条 alpha 值。(默认值:1.0)border_line_cap (
LineCapSpec
, optional) – 文本边框的线帽值。(默认值:'butt')border_line_color (
ColorSpec
) – 文本边框的线条颜色值。border_line_dash (
DashPatternSpec
) – 文本边框的线条虚线值。(默认值:[])border_line_dash_offset (
IntSpec
) – 文本边框的线条虚线偏移值。(默认值:0)border_line_join (
LineJoinSpec
, optional) – 文本边框的线条连接值。(默认值:'bevel')border_line_width (
FloatSpec
, optional) – 文本边框的线条宽度值。(默认值:1)border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许框具有圆角。为了获得最佳效果,应与
padding
结合使用。注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
outline_shape (
DataSpec
, optional) –指定文本框轮廓的形状。
文本框的默认轮廓是其边界框(或矩形)。可以将其更改为预定义形状的选择,例如圆形、椭圆形、菱形、平行四边形等。这些形状外接在边界框上,以便框的内容适合这些形状内部。
仅当设置了边框线、背景填充和/或背景阴影线属性时,此属性才生效。用户可以选择
"none"
以避免绘制任何形状,即使设置了边框或背景视觉效果。注意
此属性为实验性属性,可能会随时更改。
注意
当前,命中测试仅使用字形文本内容的边界框,这等效于使用框/矩形形状。(默认值:'box')
padding (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
),Struct
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –字形文本与其边框(边框)之间的额外空间。
注意
此属性是实验性的,随时可能更改。(默认: 0)
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
text_align (
TextAlignSpec
, optional) – 文本的文本对齐值。(默认值:'left')text_alpha (
AlphaSpec
, optional) – 文本的文本 alpha 值。(默认值:1.0)text_baseline (
TextBaselineSpec
, optional) – 文本的文本基线值。(默认值:'bottom')text_color (
ColorSpec
, optional) – 文本的文本颜色值。(默认值:'#444444')text_font (
StringSpec
, optional) – 文本的文本字体值。(默认值:Value(value='helvetica', transform=Unspecified, units=Unspecified))text_font_size (
FontSizeSpec
, optional) – 文本的文本字体大小值。(默认值:Value(value='16px', transform=Unspecified, units=Unspecified))text_font_style (
FontStyleSpec
, optional) – 文本的文本字体样式值。(默认值:'normal')text_line_height (
NumberSpec
, optional) – 文本的文本行高值。(默认值:1.2)text_outline_color (
ColorSpec
) – 文本的文本轮廓颜色值。
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
注意
文本相对于
x
,y
坐标的位置和角度由对齐和基线文本属性指示。
- themed_values() dict[str, Any] | None #
获取任何主题提供的覆盖。
结果以从属性名称到值的字典形式返回,如果主题没有覆盖此实例的任何值,则返回
None
。- 返回:
dict 或 None
- to_serializable(serializer: Serializer) ObjectRefRep #
将此对象转换为可序列化的表示形式。
- triangle(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.triangle(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#99D594", line_width=2) show(plot)
- triangle_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.triangle_dot(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#99D594", fill_color=None) show(plot)
- triangle_pin(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.triangle_pin(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#99D594", line_width=2) show(plot)
- trigger(attr: str, old: Any, new: Any, hint: DocumentPatchedEvent | None = None, setter: Setter | None = None) None #
- update(**kwargs: Any) None #
使用给定的关键字参数更新对象的属性。
- 返回:
None
示例
以下是等效的
from bokeh.models import Range1d r = Range1d # set properties individually: r.start = 10 r.end = 20 # update properties together: r.update(start=10, end=20)
- varea(x=Field(field='x', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), y2=Field(field='y2', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并添加
VArea
字形到此图形。- 参数:
x (
NumberSpec
, optional) – 区域点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y1 (
NumberSpec
, optional) – 区域一侧点的 y 坐标。(默认值:Field(field='y1', transform=Unspecified, units=Unspecified))y2 (
NumberSpec
, optional) – 区域另一侧点的 y 坐标。(默认值:Field(field='y2', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
Alpha
, optional) – 垂直方向区域的填充 alpha 值。(默认值:1.0)fill_color (
Nullable
(Color
), optional) – 垂直方向区域的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, optional) – 垂直方向区域的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, optional) – 垂直方向区域的阴影颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 垂直方向区域的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 垂直方向区域的阴影图案值。hatch_scale (
FloatSpec
, optional) – 垂直方向区域的阴影缩放值。(默认值:12.0)hatch_weight (
FloatSpec
, optional) – 垂直方向区域的阴影粗细值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.varea(x=[1, 2, 3], y1=[0, 0, 0], y2=[1, 4, 2], fill_color="#99D594") show(plot)
- varea_stack(stackers, **kw)[source]#
为从底部到顶部堆叠的层生成多个
VArea
渲染器。- 参数:
stackers (seq[str]) –
要为
y1
和y1
varea 坐标连续堆叠的数据源字段名称列表。此外,渲染器的
name
将设置为每个连续堆叠器的值(这对于特殊的悬停变量$name
非常有用)
任何额外的关键字参数都将传递给每次
varea
调用。如果关键字值是列表或元组,则每次调用都将从序列中获取一个值。- 返回:
list[GlyphRenderer]
示例
假设一个名为
source
的ColumnDataSource
带有 2016 和 2017 列,则以下对varea_stack
的调用将创建两个堆叠的VArea
渲染器p.varea_stack(['2016', '2017'], x='x', color=['blue', 'red'], source=source)
这等效于以下两个单独的调用
p.varea(y1=stack(), y2=stack('2016'), x='x', color='blue', source=source, name='2016') p.varea(y1=stack('2016'), y2=stack('2016', '2017'), x='x', color='red', source=source, name='2017')
- varea_step(x=Field(field='x', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), y2=Field(field='y2', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, name=None, step_mode='before', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并添加
VAreaStep
字形到此图形。- 参数:
x (
NumberSpec
, optional) – 区域点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))y1 (
NumberSpec
, optional) – 区域一侧点的 y 坐标。(默认值:Field(field='y1', transform=Unspecified, units=Unspecified))y2 (
NumberSpec
, optional) – 区域另一侧点的 y 坐标。(默认值:Field(field='y2', transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
Alpha
, optional) – 垂直方向区域的填充 alpha 值。(默认值:1.0)fill_color (
Nullable
(Color
), optional) – 垂直方向区域的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, optional) – 垂直方向区域的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, optional) – 垂直方向区域的阴影颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 垂直方向区域的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 垂直方向区域的阴影图案值。hatch_scale (
FloatSpec
, optional) – 垂直方向区域的阴影缩放值。(默认值:12.0)hatch_weight (
FloatSpec
, optional) – 垂直方向区域的阴影粗细值。(默认值:1.0)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
step_mode (
Enum
(StepMode
), 可选) –步阶“级别”应相对于 x 和 y 坐标绘制的位置。参数可以采用以下三个值之一
before
: (默认) 在每个 x 坐标之前绘制步阶水平线 (第一个点之前没有步阶)after
: 在每个 x 坐标之后绘制步阶水平线 (最后一个点之后没有步阶)center
: 在每个 x 坐标中心绘制步阶水平线 (默认值: ‘before’)
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.varea_step(x=[1, 2, 3], y1=[0, 0, 0], y2=[1, 4, 2], step_mode="after", fill_color="#99D594") show(plot)
- vbar(x=Field(field='x', transform=Unspecified, units=Unspecified), width=1, top=Field(field='top', transform=Unspecified, units=Unspecified), bottom=0, *, border_radius=0, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], width_units='data', **kwargs) GlyphRenderer #
配置并添加
VBar
字形到此图形。- 参数:
x (
NumberSpec
, optional) – 垂直条中心点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))width (
DistanceSpec
, optional) – 垂直条的宽度。(默认值:1)top (
NumberSpec
, 可选) – 顶边缘的 y 坐标。(默认值:Field(field='top', transform=Unspecified, units=Unspecified))bottom (
NumberSpec
) – 底部边缘的 y 坐标。(默认值:0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
border_radius (
Either
(NonNegative
,Tuple
(NonNegative
,NonNegative
,NonNegative
,NonNegative
),Struct
)) –允许方框具有圆角。
注意
此属性是实验性的,随时可能更改。(默认: 0)
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, optional) – 垂直条的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, optional) – 垂直条的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, optional) – 垂直条的阴影 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, optional) – 垂直条的阴影颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 垂直条的阴影额外值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 垂直条的阴影图案值。hatch_scale (
FloatSpec
, optional) – 垂直条的阴影缩放值。(默认值:12.0)hatch_weight (
FloatSpec
, optional) – 垂直条的阴影粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, optional) – 垂直条的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, optional) – 垂直条的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 垂直条的线条颜色值。(默认值: ‘black’)line_dash (
DashPatternSpec
) – 垂直条的线条虚线值。(默认值: [])line_dash_offset (
IntSpec
) – 垂直条的线条虚线偏移值。(默认值: 0)line_join (
LineJoinSpec
, 可选) – 垂直条的线条连接值。(默认值: ‘bevel’)line_width (
FloatSpec
, 可选) – 垂直条的线条宽度值。(默认值: 1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
width_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data (默认: ‘data’)
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.vbar(x=[1, 2, 3], width=0.5, bottom=0, top=[1,2,3], color="#CAB2D6") show(plot)
- vbar_stack(stackers, **kw)[source]#
为从底部到顶部堆叠的层级生成多个
VBar
渲染器。- 参数:
stackers (seq[str]) –
要连续堆叠的
left
和right
条形坐标的数据源字段名称列表。此外,渲染器的
name
将设置为每个连续堆叠器的值(这对于特殊的悬停变量$name
非常有用)
任何额外的关键字参数都将传递给每次调用
vbar
。如果关键字值是列表或元组,则每次调用将从序列中获取一个值。- 返回:
list[GlyphRenderer]
示例
假设一个名为
source
的ColumnDataSource
,其中包含列 2016 和 2017,则以下对vbar_stack
的调用将创建两个堆叠的VBar
渲染器p.vbar_stack(['2016', '2017'], x=10, width=0.9, color=['blue', 'red'], source=source)
这等效于以下两个单独的调用
p.vbar(bottom=stack(), top=stack('2016'), x=10, width=0.9, color='blue', source=source, name='2016') p.vbar(bottom=stack('2016'), top=stack('2016', '2017'), x=10, width=0.9, color='red', source=source, name='2017')
- vline_stack(stackers, **kw)[source]#
为垂直堆叠的线条生成多个
Line
渲染器。- 参数:
stackers (seq[str]) – 要为
y
线条坐标连续堆叠的数据源字段名称列表。
此外,渲染器的
name
将设置为每个连续堆叠器的值(这对于特殊的悬停变量$name
非常有用)任何额外的关键字参数都会传递给对
line
的每次调用。如果关键字值是列表或元组,则每次调用都将从序列中获取一个值。- 返回:
list[GlyphRenderer]
示例
假设一个名为
source
的ColumnDataSource
,其中包含列 2016 和 2017,则以下对vline_stack
的调用,其堆叠器用于 y 坐标,将创建两个堆叠的Line
渲染器p.vline_stack(['2016', '2017'], x='x', color=['blue', 'red'], source=source)
这等效于以下两个单独的调用
p.line(y=stack('2016'), x='x', color='blue', source=source, name='2016') p.line(y=stack('2016', '2017'), x='x', color='red', source=source, name='2017')
- vspan(x=Field(field='x', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
VSpan
字形。- 参数:
x (
NumberSpec
, 可选) – span 的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
line_alpha (
AlphaSpec
, 可选) – span 的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – span 的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – span 的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – span 的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – span 的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – span 的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – span 的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300, y_range=(0, 1)) plot.vspan(x=[1, 2, 3], color="#CAB2D6") show(plot)
- vstrip(x0=Field(field='x0', transform=Unspecified, units=Unspecified), x1=Field(field='x1', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
VStrip
字形。- 参数:
x0 (
NumberSpec
, 可选) – 条带一侧坐标的 x 坐标。(默认值: Field(field=’x0’, transform=Unspecified, units=Unspecified))x1 (
NumberSpec
, 可选) – 条带另一侧坐标的 x 坐标。(默认值: Field(field=’x1’, transform=Unspecified, units=Unspecified))alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 条带的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 条带的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 条带的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 条带的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 条带的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 条带的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 条带的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 条带的阴影线粗细值。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 条带的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 条带的线帽值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 条带的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 条带的线条虚线值。(默认值:[])line_dash_offset (
IntSpec
) – 条带的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 条带的线条连接值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 条带的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300, y_range=(0, 1)) plot.vstrip(x0=[1, 2, 5], x1=[3, 4, 8], color="#CAB2D6") show(plot)
- wedge(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), radius=Field(field='radius', transform=Unspecified, units=Unspecified), start_angle=Field(field='start_angle', transform=Unspecified, units=Unspecified), end_angle=Field(field='end_angle', transform=Unspecified, units=Unspecified), direction='anticlock', *, decorations=[], end_angle_units='rad', fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, radius_units='data', start_angle_units='rad', syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向此图形添加
Wedge
字形。- 参数:
x (
NumberSpec
, 可选) – 楔形点的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 楔形点的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))radius (
DistanceSpec
, 可选) – 楔形的半径。(默认值: Field(field=’radius’, transform=Unspecified, units=Unspecified))start_angle (
AngleSpec
, 可选) – 楔形开始的角度,从水平方向测量。(默认值: Field(field=’start_angle’, transform=Unspecified, units=Unspecified))end_angle (
AngleSpec
, 可选) – 楔形结束的角度,从水平方向测量。(默认值: Field(field=’end_angle’, transform=Unspecified, units=Unspecified))direction (
Enum
(Direction
), 可选) – 起始角度和终止角度之间描边的方向。(默认值: ‘anticlock’)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
end_angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位: deg, rad, grad 或 turn (默认值: ‘rad’)fill_alpha (
AlphaSpec
, 可选) – 楔形的填充 alpha 值。(默认值: 1.0)fill_color (
ColorSpec
, 可选) – 楔形的填充颜色值。(默认值: ‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 楔形的阴影线 alpha 值。(默认值: 1.0)hatch_color (
ColorSpec
, 可选) – 楔形的阴影线颜色值。(默认值: ‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 楔形的额外阴影线值。(默认值: {})hatch_pattern (
HatchPatternSpec
) – 楔形的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 楔形的阴影线比例值。(默认值: 12.0)hatch_weight (
FloatSpec
, 可选) – 楔形的阴影线粗细值。(默认值: 1.0)line_alpha (
AlphaSpec
, 可选) – 楔形的线条 alpha 值。(默认值: 1.0)line_cap (
LineCapSpec
, 可选) – 楔形的线帽值。(默认值: ‘butt’)line_color (
ColorSpec
, 可选) – 楔形的线条颜色值。(默认值: ‘black’)line_dash (
DashPatternSpec
) – 楔形的线条虚线值。(默认值: [])line_dash_offset (
IntSpec
) – 楔形的线条虚线偏移值。(默认值: 0)line_join (
LineJoinSpec
, 可选) – 楔形的线条连接值。(默认值: ‘bevel’)line_width (
FloatSpec
, 可选) – 楔形的线条宽度值。(默认值: 1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
radius_units (
NotSerialized
(Enum
(SpatialUnits
)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)start_angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位: deg, rad, grad 或 turn (默认值: ‘rad’)syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.wedge(x=[1, 2, 3], y=[1, 2, 3], radius=15, start_angle=0.6, end_angle=4.1, radius_units="screen", color="#2b8cbe") show(plot)
- x(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.x(x=[1, 2, 3], y=[1, 2, 3], size=[10, 20, 25], color="#fa9fb5") show(plot)
- y(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs) GlyphRenderer #
配置并向该图表添加
Scatter
字形。- 参数:
x (
NumberSpec
, 可选) – 标记中心点的 x 轴坐标。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))y (
NumberSpec
, 可选) – 标记中心点的 y 轴坐标。(默认值:Field(field=’y’, transform=Unspecified, units=Unspecified))size (
SizeSpec
, 可选) – 标记在屏幕空间单位中的大小(直径)值。(默认值:4)angle (
AngleSpec
) – 旋转标记的角度。(默认值:0.0)alpha (float, 可选) –
用于一次性设置所有 alpha 关键字参数的别名。(默认值: None)
Alpha 值必须介于 0 (完全透明) 和 1 (完全不透明) 之间。
任何显式设置的
line_alpha
等值都将覆盖此设置。color (颜色, 可选) –
用于一次性设置所有颜色关键字参数的别名。(默认值: None)
有关定义颜色的不同选项,请参阅用户指南中的 颜色属性。
任何显式设置的
line_color
等值都将覆盖此设置。legend_field (str, 可选) –
指定字形 (图形) 应通过 在浏览器中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 JavaScript 中执行,与 Bokeh 内容在浏览器中渲染同时进行。如果数据随后更新,图例将自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_group (str, 可选) –
指定字形 (图形) 应通过 在 Python 中分组 来生成多个图例条目。此参数的值是数据源中应该用于分组的列的名称。
分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果数据随后更新,图例将不会自动重新分组。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个legend_label (str, 可选) –
指定字形 (图形) 应在图例中生成单个 基本图例标签。图例条目将使用此处提供的确切文本进行标记。
注意
legend_field
,legend_group
, 或legend_label
中只能提供一个。muted (bool, 可选) –
字形 (图形) 是否应渲染为静音 (默认值: False)
为了使此功能有用,必须在返回的
GlyphRender
上配置muted_glyph
。这可以通过显式创建要使用的Glyph
来完成,或者更简单地通过将例如muted_color
等传递给此字形 (图形) 函数。name (str, 可选) –
要附加到渲染器的可选用户提供的名称 (默认值: None)
Bokeh 不以任何方式使用此值,但它可能有助于搜索 Bokeh 文档以查找特定模型。
source (ColumnDataSource, 可选) –
用户提供的数据源。(默认值: None)
如果未提供,Bokeh 将自动构建一个内部
ColumnDataSource
,其默认列名称来自坐标和作为字面列表或数组值传入的其他参数。如果提供,Bokeh 将使用提供的数据源来派生字形 (图形)。在这种情况下,字面列表或数组不能用于坐标或其他参数。只允许使用单个固定值 (例如
x=10
) 或数据源中的列名称 (例如x="time"
)。view (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)
visible (bool, 可选) – 字形 (图形) 是否应该被渲染。(默认值: True)
x_range_name (str, 可选) –
用于映射 x 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。y_range_name (str, 可选) –
用于映射 y 坐标的额外范围的名称。(默认值: None)
如果未提供,则绘图的默认
y_range
将用于坐标映射。level (RenderLevel, 可选) – 指定此字形 (图形) 的渲染层级顺序。
- 关键词参数:
angle_units (
NotSerialized
(Enum
(AngleUnits
)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)decorations (
List
) –字形 (图形) 装饰的集合,例如箭头头部。
使用
GlyphRenderer.add_decoration()
可以轻松为字形 (图形) 渲染器的所有字形 (图形) 进行设置。当需要更精细的控制时,请使用此属性。注意
装饰仅用于辅助字形 (图形) 的视觉外观,但不参与点击测试等。(默认值: [])
fill_alpha (
AlphaSpec
, 可选) – 标记的填充 alpha 值。(默认值:1.0)fill_color (
ColorSpec
, 可选) – 标记的填充颜色值。(默认值:‘gray’)hatch_alpha (
AlphaSpec
, 可选) – 标记的阴影线 alpha 值。(默认值:1.0)hatch_color (
ColorSpec
, 可选) – 标记的阴影线颜色值。(默认值:‘black’)hatch_extra (
Dict
(String
,Instance
(‘bokeh.models.textures.Texture’))) – 标记的额外阴影线值。(默认值:{})hatch_pattern (
HatchPatternSpec
) – 标记的阴影线图案值。hatch_scale (
FloatSpec
, 可选) – 标记的阴影线比例值。(默认值:12.0)hatch_weight (
FloatSpec
, 可选) – 标记的阴影线粗细值。(默认值:1.0)hit_dilation (
Size
, 可选) – 用于扩大命中半径的因子,命中半径负责定义标记响应与 Hover 和 Tap 工具交互的范围。(默认值:1.0)line_alpha (
AlphaSpec
, 可选) – 标记的线条 alpha 值。(默认值:1.0)line_cap (
LineCapSpec
, 可选) – 标记的线条端帽样式值。(默认值:‘butt’)line_color (
ColorSpec
, 可选) – 标记的线条颜色值。(默认值:‘black’)line_dash (
DashPatternSpec
) – 标记的线条虚线模式值。(默认值:[])line_dash_offset (
IntSpec
) – 标记的线条虚线偏移值。(默认值:0)line_join (
LineJoinSpec
, 可选) – 标记的线条连接样式值。(默认值:‘bevel’)line_width (
FloatSpec
, 可选) – 标记的线条宽度值。(默认值:1)此模型的任意用户提供的名称。
在查询文档以检索特定的 Bokeh 模型时,此名称可能很有用。
>>> plot.scatter([1,2,3], [4,5,6], name="temp") >>> plot.select(name="temp") [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
注意
对于提供的任何名称,不强制执行唯一性保证或其他条件,Bokeh 也不会出于任何原因直接使用该名称。
syncable (
Bool
, 可选) –指示此模型在 Web 浏览器中更新时是否应同步回 Bokeh 服务器。在处理频繁更新的对象(我们不需要其更新的值)时,设置为
False
可能有助于减少网络流量。注意
将此属性设置为
False
将阻止此对象上的任何on_change()
回调函数触发。但是,任何 JS 端的回调函数仍然有效。(默认值: True)tags (
List
) –要附加到此模型的可选的任意用户提供的值列表。
当查询文档以检索特定的 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 也不会出于任何原因直接使用这些标签。(默认值: [])
也可以为选择、非选择、悬停或静音的额外字形 (图形) 设置颜色和 alpha 参数。为此,请将相关前缀添加到任何视觉参数。例如,传递
nonselection_alpha
以设置非选择的线条和填充 alpha,或传递hover_fill_alpha
以设置悬停的填充 alpha。有关完整详细信息,请参阅用户指南的 字形 (图形) 样式设置 部分。- 返回:
GlyphRenderer
示例
from bokeh.plotting import figure, show plot = figure(width=300, height=300) plot.y(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DE2D26") show(plot)
- property background#
- property coordinates#
- property id: ID#
- property legend#
Legend
对象的 Splattable 列表。
- property plot#
- property ref: Ref#