gmap#

gmap 函数类似于 figure(),但配置的绘图也具有 Google Maps 底图。

gmap#

gmap(google_api_key, map_options, **kwargs) GMap[source]#

创建一个新的 GMap 用于绘图。

参数:

所有其他关键字参数都传递给 GMap

返回值:

GMap

GMap#

class GMap(*args: Any, id: ID | None = None, **kwargs: Any)[source]#

基类: GMapPlot, GlyphAPI

一个 Plot 的子类,简化了带有默认坐标轴、网格、工具等的绘图创建。

参数:

除了下面文档中列出的所有 Bokeh 模型属性外,Figure 初始化器还接受以下选项,这些选项可以帮助简化配置

关键字参数:
above = []#
类型:

列表

一个渲染器列表,用于占据绘图上方的区域。

align = 'auto'#
类型:

Either(Auto, Enum(Align), Tuple(Enum(Align), Enum(Align)))

父容器内的对齐点。

仅当此组件是布局(例如,网格)的子元素时,此属性才有用。自对齐可以被父容器(例如,网格轨道对齐)覆盖。

api_key = Undefined#
类型:

Required(Bytes)

Google Maps API 需要 API 密钥。有关如何获取您自己的密钥的更多信息,请参阅 https://developers.google.com/maps/documentation/javascript/get-api-key

api_version = 'weekly'#
类型:

String

要使用的 Google Maps API 版本。有关更多信息,请参阅 https://developers.google.com/maps/documentation/javascript/versions

注意

更改此值可能会导致地图渲染中断。

aspect_ratio = None#
类型:

Either(Null, Auto, Float)

描述组件的宽度和高度之间的比例关系。

如果组件的任何尺寸可以灵活调整大小,则此功能有效。如果设置为数字,则将保持 width / height = aspect_ratio 关系。否则,如果设置为 "auto",则将使用组件的首选宽度和高度来确定宽高比(如果未设置,则不会保留宽高比)。

aspect_scale = 1#
类型:

Float

一个用于增强宽高比控制的值。此值以乘法方式添加到 match_aspect 所需的计算值。aspect_scale 定义为图形的宽度与高度之比。

例如,aspect_scale 值为 2 的绘图将导致在屏幕上绘制一个正方形(以数据单位为单位),该正方形将绘制为一个像素宽度是像素高度两倍的矩形。

注意

仅当 match_aspect 设置为 True 时,此设置才生效。

attribution = []#
类型:

列表

允许确认或感谢数据、瓦片等提供商。

这可以是 HTML 或纯文本形式。渲染器(如瓦片渲染器)可以提供额外的署名,这些署名将在此处提供的署名之后添加。

注意

此功能是实验性的,可能会在短期内发生变化。

background_fill_alpha = 0.0#
类型:

Alpha

绘图背景样式的填充 alpha 值。

background_fill_color = '#ffffff'#
类型:

Nullable(Color)

绘图背景样式的填充颜色。

background_hatch_alpha = 1.0#
类型:

Alpha

绘图背景样式的阴影线 alpha 值。

background_hatch_color = 'black'#
类型:

Nullable(Color)

绘图背景样式的阴影线颜色。

background_hatch_extra = {}#
类型:

Dict(String, Instance(Texture))

绘图背景样式的额外阴影线。

background_hatch_pattern = None#
类型:

Nullable(String)

绘图背景样式的阴影线图案。

background_hatch_scale = 12.0#
类型:

Size

绘图背景样式的阴影线比例。

background_hatch_weight = 1.0#
类型:

Size

绘图背景样式的阴影线粗细。

below = []#
类型:

列表

一个渲染器列表,用于占据绘图下方的区域。

border_fill_alpha = 1.0#
类型:

Alpha

绘图边框样式的填充 alpha 值。

border_fill_color = '#ffffff'#
类型:

Nullable(Color)

绘图边框样式的填充颜色。

border_hatch_alpha = 1.0#
类型:

Alpha

绘图边框样式的阴影线 alpha 值。

border_hatch_color = 'black'#
类型:

Nullable(Color)

绘图边框样式的阴影线颜色。

border_hatch_extra = {}#
类型:

Dict(String, Instance(Texture))

绘图边框样式的额外阴影线。

border_hatch_pattern = None#
类型:

Nullable(String)

绘图边框样式的阴影线图案。

border_hatch_scale = 12.0#
类型:

Size

绘图边框样式的阴影线比例。

border_hatch_weight = 1.0#
类型:

Size

绘图边框样式的阴影线粗细。

center = []#
类型:

列表

一个渲染器列表,用于占据绘图的中心区域(框架)。

context_menu = 'auto'#
类型:

Nullable(Either(Instance(Menu), Enum(Enumeration(auto))))

用户右键单击组件时显示的菜单。

如果设置为 "auto",则组件可以提供动态生成的菜单。例如,Plot 和相关模型提供了一个 ToolMenu 实例,以便轻松访问其工具。

注意

右键单击时使用 Shift 键以显示本机上下文菜单。

css_classes = []#
类型:

列表

要添加到基础 DOM 元素的其他 CSS 类列表。

css_variables = {}#
类型:

Dict(String, Either(String, Instance(Node)))

允许定义动态计算的 CSS 变量。

例如,这可以用于协调画布渲染器和/或视觉元素与基于 HTML 的 UI 元素之间的定位和样式。

此处定义的变量等效于在 CSS 样式表中的 :host { ... } 下设置相同的变量。

注意

此属性是实验性的,可能随时更改。

disabled = False#
类型:

Bool

小部件在渲染时是否将被禁用。

如果为 True,小部件将灰显且不响应 UI 事件。

elements = []#
类型:

列表

附加到此窗格的基于 DOM 的 UI 元素的集合。

这可以包括浮动元素(如工具提示),从而允许在此元素和其他 UI 元素之间建立父子关系。

extra_x_ranges = {}#
类型:

Dict(String, Instance(Range))

用于映射 x 坐标的其他命名范围。

这对于添加额外的轴很有用。

extra_x_scales = {}#
类型:

Dict(String, Instance(Scale))

用于映射 x 坐标的其他命名比例。

这对于添加额外的轴很有用。

注意

此功能是实验性的,可能会在短期内发生变化。

extra_y_ranges = {}#
类型:

Dict(String, Instance(Range))

用于映射 y 坐标的其他命名范围。

这对于添加额外的轴很有用。

extra_y_scales = {}#
类型:

Dict(String, Instance(Scale))

用于映射 y 坐标的其他命名比例。

这对于添加额外的轴很有用。

注意

此功能是实验性的,可能会在短期内发生变化。

flow_mode = 'block'#
类型:

Enum(FlowMode)

定义布局是在 block 还是 inline 维度中流动。

frame_align = True#
类型:

Either(Bool, Struct)

允许指定在多图布局中对齐哪些框架边缘。

默认是对齐所有边缘,但用户可以选择不从对齐每个单独的边缘或所有边缘。另请注意,其他属性可能会禁用某些边缘的对齐,尤其是在使用固定框架尺寸(frame_widthframe_height 属性)时。

frame_height = None#
类型:

Nullable(Int)

绘图框架的高度或绘图的内部高度,不包括任何轴、标题、边框填充等。

frame_width = None#
类型:

Nullable(Int)

绘图框架的宽度或绘图的内部宽度,不包括任何轴、标题、边框填充等。

height = 600#
类型:

Nullable(NonNegative)

组件的高度(以像素为单位)。

这可以是固定高度或首选高度,具体取决于高度调整策略。

height_policy = 'auto'#
类型:

Either(Auto, Enum(SizingPolicy))

描述组件应如何保持其高度。

"auto"

使用组件的首选尺寸调整策略。

"fixed"

精确使用 height 像素。如果组件无法适应可用的垂直空间,则会溢出。

"fit"

使用组件的首选高度(如果已设置)并允许适应最小和最大高度边界(如果已设置)内的可用垂直空间。组件的高度既不会被强制最小化,也不会被强制最大化。

"min"

尽可能少地使用垂直空间,但不小于最小高度(如果已设置)。起点是首选高度(如果已设置)。组件的高度可能会根据父布局、纵横比管理和其他因素而缩小或增大。

"max"

尽可能多地使用垂直空间,但不超过最大高度(如果已设置)。起点是首选高度(如果已设置)。组件的高度可能会根据父布局、纵横比管理和其他因素而缩小或增大。

注意

这是一个实验性功能,将来可能会更改。请自行决定是否使用。如果不需要这种程度的控制,请优先使用 sizing_mode

hidpi = True#
类型:

Bool

是否在可用时使用 HiDPI 模式。

hold_render = False#
类型:

Bool

设置为 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_attributes = {}#
类型:

Dict(String, String)

允许在底层 HTML 元素上配置 HTML 属性。

html_id = None#
类型:

Nullable(String)

设置底层 HTML 元素的 id 属性。

这是常用 HTML id 属性的简写形式。或者,可以在 html_attributes 字典中设置 idhtml_id 优先。

inner_height = Undefined#
类型:

只读

这是绘图画布的精确高度,即实际绘图的高度,不包括工具栏等。请注意,这是在 Web 浏览器中计算的,因此此属性仅在能够进行双向通信的后端(服务器、笔记本)中有效。

注意

这是一个实验性功能,API 在不久的将来可能会更改。

inner_width = Undefined#
类型:

只读

这是绘图画布的精确宽度,即实际绘图的宽度,不包括工具栏等。请注意,这是在 Web 浏览器中计算的,因此此属性仅在能够进行双向通信的后端(服务器、笔记本)中有效。

注意

这是一个实验性功能,API 在不久的将来可能会更改。

left = []#
类型:

列表

要占用绘图左侧区域的渲染器列表。

lod_factor = 10#
类型:

Int

应用细节级别模式时要使用的抽取因子。

lod_factor 为 N 表示在交互事件处于活动状态时,仅绘制数据源中每第 N 个点。例如,如果 lod_factor=200,则仅绘制每第 200 个点。

细节级别模式旨在在大量数据点存在时,保持 HTML 画布绘图上的交互响应时间。

请注意,细节级别模式的可能替代方案是使用 WebGL output_backend。WebGL 渲染可能允许非常大的数据集保持交互性,而无需任何细节级别的降采样。启用 WebGL 输出后,不使用细节级别模式。

lod_interval = 300#
类型:

Int

交互式工具事件将启用细节级别降采样的间隔(以毫秒为单位)。

如果在上次交互事件开始后的 lod_interval 毫秒内需要重新绘制绘图,则将激活细节级别模式。值越大,细节级别模式就越“容易”开启。

lod_threshold = 2000#
类型:

Nullable(Int)

数据点的数量,高于此数量时,字形渲染器可能会执行细节级别降采样。例如,如果 lod_threshold=10000,则如果数据源中的点少于 10000 个,则不会激活细节级别模式。

设置为 None 以完全禁用任何细节级别的降采样。

lod_timeout = 500#
类型:

Int

用于检查交互式工具事件是否仍在发生的超时时间(以毫秒为单位)。一旦启用细节级别模式,将每 lod_timeout 毫秒进行一次检查。如果未发生交互式工具事件,则禁用细节级别模式。值越大,细节级别模式就越“慢”关闭。

map_options = Undefined#
类型:

Instance(GMapOptions)

用于显示绘图的选项。

margin = None#
类型:

Nullable(Either(Int, Tuple(Int, Int), Tuple(Int, Int, Int, Int)))

允许在组件周围创建额外的空间。元组中的值按以下顺序排列 - 上边距、右边距、下边距和左边距,类似于 CSS 标准。负边距值可用于从任何方向缩小空间。

match_aspect = False#
类型:

Bool

指定绘图的纵横比行为。纵横比定义为宽度与高度的比率。此属性控制 Bokeh 是否应尝试使数据空间的(宽度/高度)与屏幕空间的(宽度/高度)相匹配。

默认为 False,表示数据纵横比和屏幕纵横比独立变化。True 表示轴的绘图纵横比将与轴的像素范围的纵横比相匹配。最终结果是数据空间中的 1x1 区域在像素中是正方形,反之亦然,1x1 像素在数据单位中是正方形。

注意

此设置仅在存在两个数据范围时生效。此设置仅设置初始绘图绘制和后续重置。工具(单轴缩放、无约束框缩放)可能会更改纵横比。

警告

此设置与跨多个绘图链接数据范围不兼容。这样做可能会导致未定义的行为。

max_height = None#
类型:

Nullable(NonNegative)

如果高度可调整,则为组件的最大高度(以像素为单位)。

max_width = None#
类型:

Nullable(NonNegative)

如果宽度可调整,则为组件的最大宽度(以像素为单位)。

min_border = 5#
类型:

Nullable(Int)

用于将所有 min_border_X 属性设置为相同值的便捷属性。如果显式设置了单个边框属性,它将覆盖 min_border

min_border_bottom = None#
类型:

Nullable(Int)

中央绘图区域底部下方填充区域的最小大小(以像素为单位)。

注意

这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。

min_border_left = None#
类型:

Nullable(Int)

中央绘图区域左侧填充区域的最小大小(以像素为单位)。

注意

这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。

min_border_right = None#
类型:

Nullable(Int)

中央绘图区域右侧填充区域的最小大小(以像素为单位)。

注意

这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。

min_border_top = None#
类型:

Nullable(Int)

中央绘图区域顶部上方填充区域的最小大小(以像素为单位)。

注意

这是一个最小值。填充区域可能会根据需要扩展以容纳标题或轴等。

min_height = None#
类型:

Nullable(NonNegative)

如果高度可调整,则为组件的最小高度(以像素为单位)。

min_width = None#
类型:

Nullable(NonNegative)

如果宽度可调整,则为组件的最小宽度(以像素为单位)。

name = None#
类型:

Nullable(String)

此模型的任意用户提供的名称。

在查询文档以检索特定的 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_alpha = 1.0#
类型:

Alpha

绘图边框轮廓的线条 alpha 值。

outline_line_cap = 'butt'#
类型:

Enum(LineCap)

绘图边框轮廓的线条端帽样式。

outline_line_color = '#e5e5e5'#
类型:

Nullable(Color)

绘图边框轮廓的线条颜色。

outline_line_dash = []#
类型:

DashPattern

绘图边框轮廓的线条虚线模式。

outline_line_dash_offset = 0#
类型:

Int

绘图边框轮廓的线条虚线偏移。

outline_line_join = 'bevel'#
类型:

Enum(LineJoin)

绘图边框轮廓的线条连接样式。

outline_line_width = 1#
类型:

Float

绘图边框轮廓的线条宽度。

output_backend = 'canvas'#
类型:

Enum(OutputBackend)

指定绘图区域的输出后端。默认为 HTML5 Canvas。

注意

设置为 webgl 时,没有 WebGL 渲染实现的字形将回退到在 2D 画布上渲染。

renderers = []#
类型:

列表

此绘图的所有字形渲染器的列表。

可以手动操作此属性,但建议使用 add_glyph 以帮助确保执行所有必要的设置。

reset_policy = 'standard'#
类型:

Enum(ResetPolicy)

关于绘图在重置时应如何响应。默认情况下,标准操作是清除任何工具状态历史记录,将绘图范围恢复为原始值,撤消所有选择,并发出一个 Reset 事件。如果需要自定义,则可以将此属性设置为 "event_only",这将抑制除 Reset 事件之外的所有操作。

resizable = False#
类型:

Either(Bool, Enum(Dimensions))

指示布局是否可交互调整大小,如果可以,则指示在哪些维度上调整。

right = []#
类型:

列表

要占据绘图右侧区域的渲染器列表。

sizing_mode = None#
类型:

Nullable(Enum(SizingMode))

组件应如何调整自身大小。

这是一个用于维护组件宽度和高度的高级设置。要获得对大小调整更精细的控制,请改用 width_policyheight_policyaspect_ratio (这些优先于 sizing_mode)。

可能的场景

“inherit”

大小调整模式从父布局继承。如果没有父布局(或父项不是布局),则此值被视为未提供 sizing_mode 的值。

"fixed"

组件不响应。无论后续浏览器窗口大小调整事件如何,它都将保留其原始宽度和高度。

“stretch_width”

组件将响应式调整大小以拉伸到可用宽度,而不保持任何纵横比。组件的高度取决于组件的类型,可能是固定的或适合组件的内容。

“stretch_height”

组件将响应式调整大小以拉伸到可用高度,而不保持任何纵横比。组件的宽度取决于组件的类型,可能是固定的或适合组件的内容。

“stretch_both”

组件是完全响应式的,在宽度和高度上都是独立的,并将占据所有可用的水平和垂直空间,即使这会改变组件的纵横比。

“scale_width”

组件将响应式调整大小以拉伸到可用宽度,同时保持原始或提供的纵横比。

“scale_height”

组件将响应式调整大小以拉伸到可用高度,同时保持原始或提供的纵横比。

“scale_both”

组件将响应式调整大小以同时拉伸到可用宽度和高度,同时保持原始或提供的纵横比。

styles = {}#
类型:

Either(Dict(String, Nullable(String)), Instance(Styles))

应用于底层 DOM 元素的内联 CSS 样式。

stylesheets = []#
类型:

列表

用于底层 DOM 元素的其他样式表。

请注意,所有 bokeh 组件都使用 shadow DOM,因此任何包含的样式表都必须反映这一点,例如,使用 :host CSS 伪选择器来访问根 DOM 元素。

syncable = True#
类型:

Bool

指示此模型在 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 也不会出于任何原因直接使用这些标签。

title = Title(id='p74969', ...)#
类型:

Either(Null, Instance(Title))

绘图的标题。可以是文本字符串或 Title 注释。

title_location = 'above'#
类型:

Nullable(Enum(Location))

标题将位于何处。左侧或右侧的标题将旋转。

toolbar = Toolbar(id='p75038', ...)#
类型:

Instance(Toolbar)

与此绘图关联的工具栏,其中包含所有工具。如果需要,它会自动与绘图一起创建。

toolbar_inner = False#
类型:

Bool

将工具栏放置在框架内。将此属性设置为 True 对于自动隐藏的工具栏最有意义。

toolbar_location = 'right'#
类型:

Nullable(Enum(Location))

工具栏将位于何处。如果设置为 None,则不会将工具栏附加到绘图。

toolbar_sticky = True#
类型:

Bool

将工具栏固定到绘图的边缘。默认值:True。如果为 False,则工具栏将位于轴、标题等外部。

visible = True#
类型:

Bool

组件是否应显示在屏幕上。

width = 600#
类型:

Nullable(NonNegative)

组件的宽度(以像素为单位)。

这可以是固定宽度或首选宽度,具体取决于宽度大小调整策略。

width_policy = 'auto'#
类型:

Either(Auto, Enum(SizingPolicy))

描述组件应如何保持其宽度。

"auto"

使用组件的首选尺寸调整策略。

"fixed"

精确使用 width 像素。如果组件无法适应可用的水平空间,则会溢出。

"fit"

使用组件的首选宽度(如果已设置),并允许其适应最小和最大宽度边界(如果已设置)内的可用水平空间。组件的宽度既不会被积极地最小化,也不会被最大化。

"min"

尽可能少地使用水平空间,不小于最小宽度(如果已设置)。起点是首选宽度(如果已设置)。组件的宽度可能会根据父布局、纵横比管理和其他因素而缩小或增长。

"max"

尽可能多地使用水平空间,不超过最大宽度(如果已设置)。起点是首选宽度(如果已设置)。组件的宽度可能会根据父布局、纵横比管理和其他因素而缩小或增长。

注意

这是一个实验性功能,将来可能会更改。请自行决定是否使用。如果不需要这种程度的控制,请优先使用 sizing_mode

window_axis = 'none'#
类型:

Enum(WindowAxis)

当绘图上存在数据范围时,用于窗口自动调整范围的轴。例如,如果 window_axis 设置为值 "x",则 y 维度中的任何数据范围都将仅使用当前视口中配置的 x 轴的范围边界内的数据来计算其自动调整范围的范围。

如果设置为“none”(默认值),则自动调整范围将使用所有可用数据,而与视口无关。

x_range = Range1d(id='p75311', ...)#
类型:

Instance(Range)

绘图水平维度的(默认)数据范围。

x_scale = LinearScale(id='p75346', ...)#
类型:

Instance(Scale)

用于将数据空间中的 x 坐标转换为屏幕空间中的 x 坐标的比例类型。

y_range = Range1d(id='p75381', ...)#
类型:

Instance(Range)

绘图垂直维度的(默认)数据范围。

y_scale = LinearScale(id='p75416', ...)#
类型:

Instance(Scale)

用于将数据空间中的 y 坐标转换为屏幕空间中的 y 坐标的比例类型。

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#

在指定位置向绘图添加对象。

参数:
  • obj (Renderer) – 要添加到绘图的对象

  • place (str, 可选) – 添加对象的位置(默认值:“center”)。有效位置为:“left”、“right”、“above”、“below”、“center”。

返回值:

None

add_tile(tile_source: TileSource | TileProvider | str, retina: bool = False, **kwargs: Any) TileRenderer#

将新的 TileRenderer 添加到 Plot.renderers

参数:
关键字参数:

renderer (传递给瓦片的其他关键字参数)

返回值:

TileRenderer

返回类型:

TileRenderer

add_tools(*tools: Tool | str) None#

向绘图添加工具。

参数:

*tools (Tool) – 要添加到绘图的工具

返回值:

None

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)), optional) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:'rad')

  • 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)

  • inner_radius_units (NotSerialized(Enum(SpatialUnits)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • 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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • start_angle_units (NotSerialized(Enum(AngleUnits)), optional) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:'rad')

  • syncable (Bool, optional) –

    指示此模型在 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, optional) – 环形圈中心点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, optional) – 环形圈中心点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))

  • inner_radius (DistanceSpec, optional) – 环形圈的内半径。(默认值:Field(field='inner_radius', transform=Unspecified, units=Unspecified))

  • outer_radius (DistanceSpec, optional) – 环形圈的外半径。(默认值: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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 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)

  • inner_radius_units (NotSerialized(Enum(SpatialUnits)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • 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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • syncable (Bool, optional) –

    指示此模型在 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, optional) – 弧线中心点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, optional) – 弧线中心点的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))

  • radius (DistanceSpec, optional) – 弧线的半径。(默认值:Field(field='radius', transform=Unspecified, units=Unspecified))

  • start_angle (AngleSpec, optional) – 弧线的起始角度,从水平方向测量。(默认值:Field(field='start_angle', transform=Unspecified, units=Unspecified))

  • end_angle (AngleSpec, optional) – 弧线的终止角度,从水平方向测量。(默认值: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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)), optional) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:'rad')

  • 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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • start_angle_units (NotSerialized(Enum(AngleUnits)), optional) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:'rad')

  • syncable (Bool, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – Bezier 曲线的线条 Alpha 值。(默认值:1.0)

  • line_cap (LineCapSpec, 可选) – Bezier 曲线的线帽值。(默认值:‘butt’)

  • line_color (ColorSpec, 可选) – Bezier 曲线的线条颜色值。(默认值:‘black’)

  • line_dash (DashPatternSpec) – Bezier 曲线的线条虚线值。(默认值:[])

  • line_dash_offset (IntSpec) – Bezier 曲线的线条虚线偏移值。(默认值:0)

  • line_join (LineJoinSpec, 可选) – Bezier 曲线的线条连接值。(默认值:‘bevel’)

  • line_width (FloatSpec, 可选) – Bezier 曲线的线条宽度值。(默认值:1)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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, 可选) – 每个块的左下角的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, 可选) – 每个块的左下角的 y 坐标。(默认值:Field(field='y', transform=Unspecified, units=Unspecified))

  • width (DistanceSpec, 可选) – 块的宽度。(默认值:1)

  • height (DistanceSpec, 可选) – 块的高度。(默认值:1)

  • alpha (float, 可选) –

    用于一次设置所有 alpha 关键字参数的别名。(默认值:None)

    Alpha 值必须介于 0(完全透明)和 1(完全不透明)之间。

    任何显式设置的 line_alpha 等值都将覆盖此设置。

  • color (颜色, 可选) –

    用于一次设置所有颜色关键字参数的别名。(默认值:None)

    有关定义颜色的不同选项,请参阅用户指南中的 颜色属性

    任何显式设置的 line_color 等值都将覆盖此设置。

  • legend_field (str, 可选) –

    指定字形应通过 在浏览器中对其进行分组 来生成多个图例条目。此参数的值是数据源中应​​用于分组的列的名称。

    分组在 JavaScript 中执行,与在浏览器中渲染 Bokeh 内容同时进行。如果随后更新数据,图例将自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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 (strseq[float]) – 中心 x 坐标的值或字段名称

  • y (strseq[float]) – 中心 y 坐标的值或字段名称

  • radius (strlist[float]) – 以 数据单位 表示的半径值或字段名称

  • color (颜色值, 可选) – 设置填充和线条颜色的简写方式

  • source (ColumnDataSource) – 用户提供的数据源。 将尝试根据需要将对象转换为 ColumnDataSource。 如果未提供,则会自动为用户创建一个。

  • **kwargs线条属性填充属性

示例

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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#

清除当前定义的任何自定义扩展。

序列化调用将导致任何当前定义的自定义扩展包含在生成的文档中,无论是否使用它们。 此方法可用于清除所有现有的自定义扩展定义。

clone(**overrides: Any) Self#

复制一个 HasProps 对象。

这将创建原始模型的浅克隆,即任何可变容器或子模型都不会被复制。 允许在克隆时覆盖特定属性。

column(col, gridplot)#

返回此图是否在 GridPlot 的给定列中。

参数:
  • col (int) – 要测试的列的索引

  • gridplot (GridPlot) – 要检查的 GridPlot

返回值:

bool

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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 dataspecs() dict[str, DataSpec]#

收集此类上所有 DataSpec 属性的名称。

此方法始终遍历类层次结构,并包括在任何父类上定义的属性。

返回值:

DataSpec 属性的名称

返回类型:

set[str]

classmethod descriptors() list[PropertyDescriptor[Any]]#

属性描述符列表,按定义顺序排列。

destroy() None#

清理对文档和属性的引用

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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, optional) – 椭圆中心的 x 坐标。(默认值: Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, optional) – 椭圆中心的 y 坐标。(默认值: Field(field='y', transform=Unspecified, units=Unspecified))

  • width (DistanceSpec, optional) – 每个椭圆的宽度。(默认值: Field(field='width', transform=Unspecified, units=Unspecified))

  • height (DistanceSpec, optional) – 每个椭圆的高度。(默认值: Field(field='height', transform=Unspecified, units=Unspecified))

  • angle (AngleSpec) – 椭圆从水平方向旋转的角度。 [rad] (默认值: 0.0)

  • alpha (float, 可选) –

    用于一次设置所有 alpha 关键字参数的别名。(默认值:None)

    Alpha 值必须介于 0(完全透明)和 1(完全不透明)之间。

    任何显式设置的 line_alpha 等值都将覆盖此设置。

  • color (颜色, 可选) –

    用于一次设置所有颜色关键字参数的别名。(默认值:None)

    有关定义颜色的不同选项,请参阅用户指南中的 颜色属性

    任何显式设置的 line_color 等值都将覆盖此设置。

  • legend_field (str, 可选) –

    指定字形应通过 在浏览器中对其进行分组 来生成多个图例条目。此参数的值是数据源中应​​用于分组的列的名称。

    分组在 JavaScript 中执行,与在浏览器中渲染 Bokeh 内容同时进行。如果随后更新数据,图例将自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 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)

  • height_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位:screen 或 data(默认值:‘data’)

  • 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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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

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, optional) – 区域一侧点的 x 坐标。(默认值: Field(field='x1', transform=Unspecified, units=Unspecified))

  • x2 (NumberSpec, optional) – 区域另一侧点的 x 坐标。(默认值: Field(field='x2', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, optional) – 区域点的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 水平方向区域的阴影线颜色值。(默认值: ‘black’)

  • hatch_extra (Dict(String, Instance(‘bokeh.models.textures.Texture’))) – 水平方向区域的额外阴影线值。(默认值: {})

  • hatch_pattern (HatchPatternSpec) – 水平方向区域的阴影线图案值。

  • hatch_scale (FloatSpec, 可选) – 水平方向区域的阴影线比例值。(默认值: 12.0)

  • hatch_weight (FloatSpec, 可选) – 水平方向区域的阴影线粗细值。(默认值: 1.0)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_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, optional) – 区域一侧点的 x 坐标。(默认值: Field(field='x1', transform=Unspecified, units=Unspecified))

  • x2 (NumberSpec, optional) – 区域另一侧点的 x 坐标。(默认值: Field(field='x2', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, optional) – 区域点的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 水平方向区域的阴影线颜色值。(默认值: ‘black’)

  • hatch_extra (Dict(String, Instance(‘bokeh.models.textures.Texture’))) – 水平方向区域的额外阴影线值。(默认值: {})

  • hatch_pattern (HatchPatternSpec) – 水平方向区域的阴影线图案值。

  • hatch_scale (FloatSpec, 可选) – 水平方向区域的阴影线比例值。(默认值: 12.0)

  • hatch_weight (FloatSpec, 可选) – 水平方向区域的阴影线粗细值。(默认值: 1.0)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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)
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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, 可选) –

    六边形瓦片的半径(以 数据单位 为单位)。

    对于 “pointy_top” 朝向,半径始终沿笛卡尔 y 轴测量;对于 “flat_top” 朝向,半径始终沿笛卡尔 x 轴测量。如果底层笛卡尔坐标系统的纵横比不是 1:1,则瓦片可能会在一个方向上被“挤压”。为了确保瓦片始终是正六边形,请考虑将绘图的 match_aspect 属性设置为 True。(默认值:1.0)

  • syncable (Bool, optional) –

    指示此模型在 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)
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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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))), optional) – 图像的位置应锚定在 xy 坐标处。(默认值:‘bottom_left’)

  • color_mapper (Instance(ColorMapper), 可选) –

    用于将 image 中的标量数据映射到用于显示的 RGBA 值的 ColorMapper

    也可以设置 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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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’)

  • palette (strlist[颜色值])

  • from (用于为颜色映射器属性构建值的调色板)

  • syncable (Bool, optional) –

    指示此模型在 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

注意

如果同时传递 palettecolor_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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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))), optional) – 图像的位置应锚定在 xy 坐标处。(默认值:‘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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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))), optional) – 图像的位置应锚定在 xy 坐标处。(默认值:‘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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)), 可选) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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)), 可选) – 用于关联属性的单位:screen 或 data(默认值:'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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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)

使用 JavaScript 链接两个 Bokeh 模型属性。

这是一个便捷方法,简化了添加 CustomJS 回调以在一个 Bokeh 模型属性的值更改时更新另一个属性。

参数:
  • attr (str) – 此模型上 Bokeh 属性的名称

  • other (Model) – 要链接到 self.attr 的 Bokeh 模型

  • other_attr (str) – other 上要链接在一起的属性

  • attr_selector (int | str) – 用于链接可下标 attr 中项目的索引

在版本 1.1 中添加

提出:

ValueError

示例

使用 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)
js_on_event(event: str | type[Event], *callbacks: JSEventCallback) None#
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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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_cap (Enum(LineCap), 可选) – 线条的线帽值。(默认值:'butt')

  • line_color (Nullable(Color), 可选) – 线条的线条颜色值。(默认值:'black')

  • line_dash (DashPattern) – 线条的线条虚线值。(默认值:[])

  • line_dash_offset (Int) – 线条的线条虚线偏移值。(默认值:0)

  • line_join (Enum(LineJoin), 可选) – 线条的线连接值。(默认值:'bevel')

  • line_width (Float, 可选) – 线条的线宽值。(默认值:1)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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 (str) – 要搜索的属性的名称

  • raises (bool) – 如果找不到属性,是引发异常还是返回 None

返回值:

名为 name 的属性的描述符

返回类型:

PropertyDescriptor

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, 可选) – 用于定位文本锚点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, 可选) – 文本锚点的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))

  • text (StringSpec, 可选) – 要渲染的文本值。(默认值: 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) –

    此字形边界框内的位置,xy 坐标将锚定到该位置。可以是命名的锚点,如 top_leftcenter,也可以是从左到右和从上到下的百分比,或者这些的组合,在宽度和高度上独立设置。如果设置为 auto,则锚点将根据文本 alignbaseline 确定。

    注意

    此属性是实验性的,可能随时更改。(默认值: Value(value=’auto’, transform=Unspecified, units=Unspecified))

  • angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)

  • background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充 alpha 值。(默认值: 1.0)

  • background_fill_color (ColorSpec) – 文本边界框的填充颜色值。

  • background_hatch_alpha (AlphaSpec, 可选) – 文本边界框的阴影线 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, 可选) – 文本边界框的阴影线缩放值。(默认值: 12.0)

  • background_hatch_weight (FloatSpec, 可选) – 文本边界框的阴影线粗细值。(默认值: 1.0)

  • border_line_alpha (AlphaSpec, 可选) – 文本边界框的边框线 alpha 值。(默认值: 1.0)

  • border_line_cap (LineCapSpec, 可选) – 文本边界框的边框线端帽值。(默认值: ‘butt’)

  • border_line_color (ColorSpec) – 文本边界框的边框线颜色值。

  • border_line_dash (DashPatternSpec) – 文本边界框的边框线虚线模式值。(默认值: [])

  • border_line_dash_offset (IntSpec) – 文本边界框的边框线虚线偏移值。(默认值: 0)

  • border_line_join (LineJoinSpec, 可选) – 文本边界框的边框线连接方式值。(默认值: ‘bevel’)

  • border_line_width (FloatSpec, 可选) – 文本边界框的边框线宽度值。(默认值: 1)

  • border_radius (Either(NonNegative, Tuple(NonNegative, NonNegative, NonNegative, NonNegative), Struct)) –

    允许框具有圆角。为了获得最佳效果,应与 padding 结合使用。

    注意

    此属性是实验性的,可能会在任何时候更改。(默认值:0)

  • decorations (List) –

    字形装饰的集合,例如箭头。

    使用 GlyphRenderer.add_decoration() 可以轻松地为字形渲染器的所有字形进行设置。当需要更精细的控制时,请使用此属性。

    注意

    装饰仅用于辅助字形的视觉外观,但它们不参与命中测试等。(默认值:[])

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, 可选) –

    指定文本框轮廓的形状。

    文本框的默认轮廓是其边界框(或矩形)。可以将其更改为预定义的形状选择,如圆形、椭圆形、菱形、平行四边形等。这些形状外接在边界框上,以便框的内容适合这些形状内部。

    仅当设置了边框线、背景填充和/或背景阴影线属性时,此属性才生效。用户可以选择 "none" 以避免绘制任何形状,即使设置了边框或背景视觉效果。

    注意

    此属性是实验性的,可能随时更改。

    注意

    当前,点击测试仅使用字形文本内容的边界框,这等效于使用框/矩形形状。(默认值: ‘box’)

  • padding (Either(NonNegative, Tuple(NonNegative, NonNegative), Struct, Tuple(NonNegative, NonNegative, NonNegative, NonNegative), Struct)) –

    字形的文本与其边界框(边框)之间的额外空间。

    注意

    此属性是实验性的,可能会在任何时候更改。(默认值:0)

  • syncable (Bool, optional) –

    指示此模型在 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, 可选) – 文本的文本对齐值。(默认值: ‘left’)

  • text_alpha (AlphaSpec, 可选) – 文本的文本 alpha 值。(默认值: 1.0)

  • text_baseline (TextBaselineSpec, 可选) – 文本的文本基线值。(默认值: ‘bottom’)

  • text_color (ColorSpec, 可选) – 文本的文本颜色值。(默认值: ‘#444444’)

  • text_font (StringSpec, 可选) – 文本的文本字体值。(默认值: Value(value=’helvetica’, transform=Unspecified, units=Unspecified))

  • text_font_size (FontSizeSpec, 可选) – 文本的文本字体大小值。(默认值: Value(value=’16px’, transform=Unspecified, units=Unspecified))

  • text_font_style (FontStyleSpec, 可选) – 文本的文本字体样式值。(默认值: ‘normal’)

  • text_line_height (NumberSpec, 可选) – 文本的文本行高值。(默认值: 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, 可选) – 所有线的 x 坐标,以“列表的列表”形式给出。(默认值: Field(field=’xs’, transform=Unspecified, units=Unspecified))

  • ys (NumberSpec, 可选) – 所有线的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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, 可选) –

    所有面片的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, optional) – n 边形的填充 alpha 值。(默认值:1.0)

  • fill_color (ColorSpec, optional) – n 边形的填充颜色值。(默认值:‘gray’)

  • hatch_alpha (AlphaSpec, optional) – n 边形的阴影线 alpha 值。(默认值:1.0)

  • hatch_color (ColorSpec, optional) – n 边形的阴影线颜色值。(默认值:‘black’)

  • hatch_extra (Dict(String, Instance(‘bokeh.models.textures.Texture’))) – n 边形的额外阴影线值。(默认值:{})

  • hatch_pattern (HatchPatternSpec) – n 边形的阴影线图案值。

  • hatch_scale (FloatSpec, optional) – n 边形的阴影线缩放值。(默认值:12.0)

  • hatch_weight (FloatSpec, optional) – n 边形的阴影线粗细值。(默认值:1.0)

  • line_alpha (AlphaSpec, optional) – n 边形的线条 alpha 值。(默认值:1.0)

  • line_cap (LineCapSpec, optional) – n 边形的线条端帽值。(默认值:‘butt’)

  • line_color (ColorSpec, optional) – n 边形的线条颜色值。(默认值:‘black’)

  • line_dash (DashPatternSpec) – n 边形的线条虚线模式值。(默认值:[])

  • line_dash_offset (IntSpec) – n 边形的线条虚线偏移值。(默认值:0)

  • line_join (LineJoinSpec, optional) – n 边形的线条连接值。(默认值:‘bevel’)

  • line_width (FloatSpec, optional) – n 边形的线条宽度值。(默认值:1)

  • n (NumberSpec, optional) – n 边形的边数。小于 3 的值将不会绘制任何字形实例。(默认值:Field(field=’n’, transform=Unspecified, units=Unspecified))

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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), optional) –

    沿哪个维度测量 n 边形的半径。

    当数据空间纵横比不是 1:1 时,绘制的 n 边形的大小取决于用于测量半径“距离”的方向。此属性允许控制该方向。

    将此维度设置为 ‘max’ 将在 x 和 y 维度上计算半径,并使用两者中的最大值,‘min’ 选择最小值。(默认值:‘x’)

  • radius_units (NotSerialized(Enum(SpatialUnits)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • syncable (Bool, optional) –

    指示此模型在 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 中的特定事件。

classmethod parameters() list[Parameter]#

生成适用于从字形派生的函数的 Python Parameter 值。

返回值:

list(Parameter)

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, optional) –

    补丁点的 x 坐标。

    注意

    一个补丁可能包含多个多边形。在这种情况下,每个多边形的 x 坐标应在序列中用 NaN 值分隔。(默认值:Field(field=’x’, transform=Unspecified, units=Unspecified))

  • y (NumberSpec, optional) –

    补丁点的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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 (Alpha, optional) – 补丁的阴影线 alpha 值。(默认值:1.0)

  • hatch_color (Nullable(Color), optional) – 补丁的阴影线颜色值。(默认值:‘black’)

  • hatch_extra (Dict(String, Instance(‘bokeh.models.textures.Texture’))) – 补丁的额外阴影线值。(默认值:{})

  • hatch_pattern (Nullable(String)) – 补丁的阴影线图案值。

  • hatch_scale (Size, optional) – 补丁的阴影线缩放值。(默认值:12.0)

  • hatch_weight (Size, optional) – 补丁的阴影线粗细值。(默认值:1.0)

  • line_alpha (Alpha, optional) – 补丁的线条 alpha 值。(默认值:1.0)

  • line_cap (Enum(LineCap), optional) – 补丁的线条端帽值。(默认值:‘butt’)

  • line_color (Nullable(Color), optional) – 补丁的线条颜色值。(默认值:‘black’)

  • line_dash (DashPattern) – 补丁的线条虚线模式值。(默认值:[])

  • line_dash_offset (Int) – 补丁的线条虚线偏移值。(默认值:0)

  • line_join (Enum(LineJoin), optional) – 补丁的线条连接值。(默认值:‘bevel’)

  • line_width (Float, optional) – 补丁的线条宽度值。(默认值:1)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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, 可选) –

    所有补丁的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 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, optional) – 补丁的线条颜色值。(默认值:‘black’)

  • line_dash (DashPatternSpec) – 补丁的线条虚线模式值。(默认值:[])

  • line_dash_offset (IntSpec) – 补丁的线条虚线偏移值。(默认值:0)

  • line_join (LineJoinSpec, optional) – 补丁的线条连接值。(默认值:‘bevel’)

  • line_width (FloatSpec, optional) – 补丁的线条宽度值。(默认值:1)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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]]#

收集此类上所有也具有引用的属性的名称。

此方法始终遍历类层次结构,并包括在任何父类上定义的属性。

返回值:

具有引用的属性的名称

返回类型:

set[str]

properties_with_values(*, include_defaults: bool = True, include_undefined: bool = False) dict[str, Any]#

收集一个字典,将属性名称映射到它们的值。

此方法始终遍历类层次结构,并包括在任何父类上定义的属性。

不可序列化的属性将被跳过,并且属性值采用“序列化”格式,这可能与您通常从属性中读取的值略有不同;此方法的目的是返回无损地重建对象实例所需的信息。

参数:

include_defaults (bool, 可选) – 是否包括自对象创建以来尚未显式设置的属性。(默认值:True)

返回值:

从属性名称到其值的映射

返回类型:

字典

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 四边形的填充透明度值。(默认值: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)

  • 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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 抛物线的线条透明度值。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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 实例的属性值。

参数:
  • query (可调用对象) – 接受属性描述符并返回 True 或 False 的可调用对象

  • include_defaults (bool, 可选) – 是否包括用户尚未显式设置的属性(默认值:True)

返回值:

匹配属性的属性名称和值的映射

返回类型:

字典

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)), 可选) – 用于关联属性的单位:屏幕或数据(默认值:’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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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)

警告

Rect 字形在对数刻度上未明确定义。请改用 BlockQuad 字形。

references() set[Model]#

返回此对象引用的所有 Models

remove_on_change(attr: str, *callbacks: Callable[[str, Any, Any], None]) None#

从此对象中移除回调函数

remove_tools(*tools: Tool) None#

从绘图中移除工具。

参数:

*tools (Tool) – 要从绘图中移除的工具

返回值:

None

row(row, gridplot)#

返回此绘图是否在 GridPlot 的给定行中。

参数:
  • row (int) – 要测试的行索引

  • gridplot (GridPlot) – 要检查的 GridPlot

返回值:

bool

scatter(*args: Any, **kwargs: Any) GlyphRenderer#

创建给定 x 和 y 项的散点图。

参数:
  • x (strseq[float]) – 中心 x 坐标的值或字段名称

  • y (strseq[float]) – 中心 y 坐标的值或字段名称

  • size (strlist[float]) – 屏幕单位 的尺寸值或字段名称

  • marker (str, 或 list[str]) – 标记类型的名称或字段名称,请访问 MarkerType 查看有效值的完整列表。

  • color (颜色值, 可选) – 设置填充和线条颜色的简写方式

  • source (ColumnDataSource) – 用户提供的数据源。 将尝试根据需要将对象转换为 ColumnDataSource。 如果未提供,则会自动为用户创建一个。

  • **kwargs线条属性填充属性

示例

>>> p.scatter([1,2,3],[4,5,6], marker="square", fill_color="red")
>>> p.scatter("data1", "data2", marker="mtype", source=data_source, ...)

注意

当使用 WebGL 输出后端时,具有多种标记类型的 Scatter 标记可能以不同的顺序绘制。这是为了性能而做出的明确权衡。

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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

返回值:

Model

set_from_json(name: str, value: Any, *, setter: Setter | None = None) None#

从 JSON 设置此对象上的属性值。

参数:
  • name (str) – 要设置的属性的名称

  • value (JSON-value) – 要设置为属性的值

  • setter (ClientSessionServerSessionNone, 可选) –

    这用于防止对 Bokeh 应用程序的“回旋镖”式更新。

    在 Bokeh 服务器应用程序的上下文中,传入的属性更新将使用执行更新的会话进行注释。此值会通过更新触发的任何后续更改通知进行传播。会话可以将事件设置器与其自身进行比较,并抑制任何源自自身的更新。

返回值:

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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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_cap (Enum(LineCap), 可选) – 步阶的线条端点样式值。(默认: ‘butt’)

  • line_color (Nullable(Color), 可选) – 步阶的线条颜色值。(默认: ‘black’)

  • line_dash (DashPattern) – 步阶的线条虚线模式值。(默认: [])

  • line_dash_offset (Int) – 步阶的线条虚线偏移值。(默认: 0)

  • line_join (Enum(LineJoin), 可选) – 步阶的线条连接样式值。(默认: ‘bevel’)

  • line_width (Float, 可选) – 步阶的线条宽度值。(默认: 1)

  • mode (Enum(StepMode), 可选) –

    步阶“水平”应相对于 x 和 y 坐标绘制的位置。此参数可以采用以下三个值之一

    • before: (默认) 在每个 x 坐标之前绘制步阶水平线 (第一个点之前没有步阶)

    • after: 在每个 x 坐标之后绘制步阶水平线 (最后一个点之后没有步阶)

    • center: 在每个 x 坐标中心绘制步阶水平线 (默认: ‘before’)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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)
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, 可选) – 用于定位文本锚点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, 可选) – 文本锚点的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))

  • text (StringSpec, 可选) – 要渲染的文本值。(默认值: 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) –

    此字形边界框内的位置,xy 坐标将锚定到该位置。可以是命名的锚点,如 top_leftcenter,也可以是从左到右和从上到下的百分比,或者这些的组合,在宽度和高度上独立设置。如果设置为 auto,则锚点将根据文本 alignbaseline 确定。

    注意

    此属性是实验性的,可能随时更改。(默认值: Value(value=’auto’, transform=Unspecified, units=Unspecified))

  • angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)

  • background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充 alpha 值。(默认值: 1.0)

  • background_fill_color (ColorSpec) – 文本边界框的填充颜色值。

  • background_hatch_alpha (AlphaSpec, 可选) – 文本边界框的阴影线 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, 可选) – 文本边界框的阴影线缩放值。(默认值: 12.0)

  • background_hatch_weight (FloatSpec, 可选) – 文本边界框的阴影线粗细值。(默认值: 1.0)

  • border_line_alpha (AlphaSpec, 可选) – 文本边界框的边框线 alpha 值。(默认值: 1.0)

  • border_line_cap (LineCapSpec, 可选) – 文本边界框的边框线端帽值。(默认值: ‘butt’)

  • border_line_color (ColorSpec) – 文本边界框的边框线颜色值。

  • border_line_dash (DashPatternSpec) – 文本边界框的边框线虚线模式值。(默认值: [])

  • border_line_dash_offset (IntSpec) – 文本边界框的边框线虚线偏移值。(默认值: 0)

  • border_line_join (LineJoinSpec, 可选) – 文本边界框的边框线连接方式值。(默认值: ‘bevel’)

  • border_line_width (FloatSpec, 可选) – 文本边界框的边框线宽度值。(默认值: 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: {})
    

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, 可选) –

    指定文本框轮廓的形状。

    文本框的默认轮廓是其边界框(或矩形)。可以将其更改为预定义的形状选择,如圆形、椭圆形、菱形、平行四边形等。这些形状外接在边界框上,以便框的内容适合这些形状内部。

    仅当设置了边框线、背景填充和/或背景阴影线属性时,此属性才生效。用户可以选择 "none" 以避免绘制任何形状,即使设置了边框或背景视觉效果。

    注意

    此属性是实验性的,可能随时更改。

    注意

    当前,点击测试仅使用字形文本内容的边界框,这等效于使用框/矩形形状。(默认值: ‘box’)

  • padding (Either(NonNegative, Tuple(NonNegative, NonNegative), Struct, Tuple(NonNegative, NonNegative, NonNegative, NonNegative), Struct)) –

    字形的文本与其边界框(边框)之间的额外空间。

    注意

    此属性是实验性的,可能会在任何时候更改。(默认值:0)

  • syncable (Bool, optional) –

    指示此模型在 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, 可选) – 文本的文本对齐值。(默认值: ‘left’)

  • text_alpha (AlphaSpec, 可选) – 文本的文本 alpha 值。(默认值: 1.0)

  • text_baseline (TextBaselineSpec, 可选) – 文本的文本基线值。(默认值: ‘bottom’)

  • text_color (ColorSpec, 可选) – 文本的文本颜色值。(默认值: ‘#444444’)

  • text_font (StringSpec, 可选) – 文本的文本字体值。(默认值: Value(value=’helvetica’, transform=Unspecified, units=Unspecified))

  • text_font_size (FontSizeSpec, 可选) – 文本的文本字体大小值。(默认值: Value(value=’16px’, transform=Unspecified, units=Unspecified))

  • text_font_style (FontStyleSpec, 可选) – 文本的文本字体样式值。(默认值: ‘normal’)

  • text_line_height (NumberSpec, 可选) – 文本的文本行高值。(默认值: 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, 可选) – 用于定位文本锚点的 x 坐标。(默认值:Field(field='x', transform=Unspecified, units=Unspecified))

  • y (NumberSpec, 可选) – 文本锚点的 y 坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))

  • text (StringSpec, 可选) – 要渲染的文本值。(默认值: 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) –

    此字形边界框内的位置,xy 坐标将锚定到该位置。可以是命名的锚点,如 top_leftcenter,也可以是从左到右和从上到下的百分比,或者这些的组合,在宽度和高度上独立设置。如果设置为 auto,则锚点将根据文本 alignbaseline 确定。

    注意

    此属性是实验性的,可能随时更改。(默认值: Value(value=’auto’, transform=Unspecified, units=Unspecified))

  • angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:‘rad’)

  • background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充 alpha 值。(默认值: 1.0)

  • background_fill_color (ColorSpec) – 文本边界框的填充颜色值。

  • background_hatch_alpha (AlphaSpec, 可选) – 文本边界框的阴影线 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, 可选) – 文本边界框的阴影线缩放值。(默认值: 12.0)

  • background_hatch_weight (FloatSpec, 可选) – 文本边界框的阴影线粗细值。(默认值: 1.0)

  • border_line_alpha (AlphaSpec, 可选) – 文本边界框的边框线 alpha 值。(默认值: 1.0)

  • border_line_cap (LineCapSpec, 可选) – 文本边界框的边框线端帽值。(默认值: ‘butt’)

  • border_line_color (ColorSpec) – 文本边界框的边框线颜色值。

  • border_line_dash (DashPatternSpec) – 文本边界框的边框线虚线模式值。(默认值: [])

  • border_line_dash_offset (IntSpec) – 文本边界框的边框线虚线偏移值。(默认值: 0)

  • border_line_join (LineJoinSpec, 可选) – 文本边界框的边框线连接方式值。(默认值: ‘bevel’)

  • border_line_width (FloatSpec, 可选) – 文本边界框的边框线宽度值。(默认值: 1)

  • border_radius (Either(NonNegative, Tuple(NonNegative, NonNegative, NonNegative, NonNegative), Struct)) –

    允许框具有圆角。为了获得最佳效果,应与 padding 结合使用。

    注意

    此属性是实验性的,可能会在任何时候更改。(默认值:0)

  • decorations (List) –

    字形装饰的集合,例如箭头。

    使用 GlyphRenderer.add_decoration() 可以轻松地为字形渲染器的所有字形进行设置。当需要更精细的控制时,请使用此属性。

    注意

    装饰仅用于辅助字形的视觉外观,但它们不参与命中测试等。(默认值:[])

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, 可选) –

    指定文本框轮廓的形状。

    文本框的默认轮廓是其边界框(或矩形)。可以将其更改为预定义的形状选择,如圆形、椭圆形、菱形、平行四边形等。这些形状外接在边界框上,以便框的内容适合这些形状内部。

    仅当设置了边框线、背景填充和/或背景阴影线属性时,此属性才生效。用户可以选择 "none" 以避免绘制任何形状,即使设置了边框或背景视觉效果。

    注意

    此属性是实验性的,可能随时更改。

    注意

    当前,点击测试仅使用字形文本内容的边界框,这等效于使用框/矩形形状。(默认值: ‘box’)

  • padding (Either(NonNegative, Tuple(NonNegative, NonNegative), Struct, Tuple(NonNegative, NonNegative, NonNegative, NonNegative), Struct)) –

    字形的文本与其边界框(边框)之间的额外空间。

    注意

    此属性是实验性的,可能会在任何时候更改。(默认值:0)

  • syncable (Bool, optional) –

    指示此模型在 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, 可选) – 文本的文本对齐值。(默认值: ‘left’)

  • text_alpha (AlphaSpec, 可选) – 文本的文本 alpha 值。(默认值: 1.0)

  • text_baseline (TextBaselineSpec, 可选) – 文本的文本基线值。(默认值: ‘bottom’)

  • text_color (ColorSpec, 可选) – 文本的文本颜色值。(默认值: ‘#444444’)

  • text_font (StringSpec, 可选) – 文本的文本字体值。(默认值: Value(value=’helvetica’, transform=Unspecified, units=Unspecified))

  • text_font_size (FontSizeSpec, 可选) – 文本的文本字体大小值。(默认值: Value(value=’16px’, transform=Unspecified, units=Unspecified))

  • text_font_style (FontStyleSpec, 可选) – 文本的文本字体样式值。(默认值: ‘normal’)

  • text_line_height (NumberSpec, 可选) – 文本的文本行高值。(默认值: 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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#
unapply_theme() 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, 可选) – 区域点的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))

  • y1 (NumberSpec, 可选) – 区域一侧点的 y 坐标。(默认值: Field(field=’y1’, transform=Unspecified, units=Unspecified))

  • y2 (NumberSpec, 可选) – 区域另一侧点的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_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, 可选) – 区域点的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))

  • y1 (NumberSpec, 可选) – 区域一侧点的 y 坐标。(默认值: Field(field=’y1’, transform=Unspecified, units=Unspecified))

  • y2 (NumberSpec, 可选) – 区域另一侧点的 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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, 可选) – 垂直条中心点的 x 坐标。(默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))

  • width (DistanceSpec, 可选) – 垂直条的宽度。(默认值: 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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)
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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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)), optional) – 用于关联属性的单位: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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)), optional) – 用于关联属性的单位:screen 或 data(默认值:'data')

  • start_angle_units (NotSerialized(Enum(AngleUnits)), optional) – 用于关联属性的单位:deg、rad、grad 或 turn(默认值:'rad')

  • syncable (Bool, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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_fieldlegend_grouplegend_label 中的一个

  • legend_group (str, 可选) –

    指定字形应生成多个图例条目,方法是在 Python 中对它们进行分组。此参数的值是数据源中应被用于分组的列的名称。

    分组在 Python 中执行,在 Bokeh 输出发送到浏览器之前。如果日期随后更新,图例将不会自动重新分组。

    注意

    应仅提供 legend_fieldlegend_grouplegend_label 中的一个

  • legend_label (str, 可选) –

    指定字形应在图例中生成单个基本图例标签。图例条目将使用此处提供的确切文本进行标记。

    注意

    应仅提供 legend_fieldlegend_grouplegend_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, 可选) – 扩张命中半径的因子,该半径负责定义标记响应与悬停和点击工具交互的范围。(默认值: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)

  • name (Nullable(String)) –

    此模型的任意用户提供的名称。

    在查询文档以检索特定的 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, optional) –

    指示此模型在 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 axis#

可展开的 Axis 对象列表。

property background#
property coordinates#
property document: Document | None#

此模型所连接的 Document (可以为 None

property grid#

可展开的 Grid 对象列表。

property hover#

可展开的 HoverTool 对象列表。

property id: ID#
property legend#

可展开的 Legend 对象列表。

property plot#
property ref: Ref#
property tools: list[Tool]#
property xaxis#

用于 x 维度的可展开 Axis 对象列表。

property xgrid#

用于 x 维度的可展开 Grid 对象列表。

property yaxis#

用于 y 维度的可展开 Axis 对象列表。

property ygrid#

用于 y 维度的可展开 Grid 对象列表。