gmap

gmap 函数类似于 figure()，但它配置了一个也包含 Google 地图底层的绘图。

gmap

gmap(google_api_key, map_options, **kwargs) → GMap

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

参数:

• google_api_key (str) –

  Google 要求提供 API 密钥才能使地图正常运行。参见

  https://developers.google.com/maps/documentation/javascript/get-api-key

  Google API 密钥将作为 Base64 编码的字符串存储在 Bokeh 文档 JSON 中。

• map_options – (GMapOptions) Google 地图的特定配置

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

返回值:

GMap

GMap

class GMap(*args: Any, id: ID | None = None, **kwargs: Any)

基类: GMapPlot, GlyphAPI

Plot 的子类，它简化了具有默认轴、网格、工具等的绘图创建。

参数:

• google_api_key (str) –

  Google 要求提供 API 密钥才能使地图正常运行。参见

  https://developers.google.com/maps/documentation/javascript/get-api-key

• map_options – (GMapOptions) Google 地图的特定配置

除了下面记录的所有 Bokeh 模型属性外，Figure 初始化器还接受以下选项，它们可以帮助简化配置。

关键字参数:

• active_drag (Nullable(Either(Auto, String, Instance(Drag))))

  最初应激活的拖动工具。 (默认值: 'auto')

• active_inspect (Nullable(Either(Auto, String, Instance(InspectTool), Seq(Instance(InspectTool)))))

  最初应激活的拖动工具。 (默认值: 'auto')

• active_multi (Nullable(Either(Auto, String, Instance(GestureTool))))

  指定一个活动的多个手势工具，例如编辑工具或范围工具。（默认值：‘auto’）

• active_scroll (Nullable(Either(Auto, String, Instance(Scroll))))

  哪个滚动工具应该最初处于活动状态。（默认值：‘auto’）

• active_tap (Nullable(Either(Auto, String, Instance(Tap))))

  哪个点击工具应该最初处于活动状态。（默认值：‘auto’）

• tools (Either(String, Seq(Either(String, Instance(Tool)))))

  绘图应从哪些工具开始。（默认值：‘pan,wheel_zoom,box_zoom,save,reset,help’）

• tooltips (Nullable(Either(Instance(Template), String, List)))

  一个可选参数，用于为 Figure 配置工具提示。此参数接受与 HoverTool.tooltips 属性相同的参数。如果在 tools 参数中指定了悬停工具，则此值将覆盖该悬停工具的 tooltips 值。如果在 tools 参数中未指定悬停工具，则在此处传递工具提示将导致创建并添加一个工具提示。（默认值：None）

• x_axis_label (Nullable(TextLike))

  x 轴的标签。（默认值：‘’）

• x_axis_location (Nullable(Enum(VerticalLocation)))

  x 轴应位于何处。（默认值：‘below’）

• x_minor_ticks (Either(Auto, Int))

  相邻 x 轴主刻度之间的小刻度数量。（默认值：‘auto’）

• y_axis_label (Nullable(TextLike))

  y 轴的标签。（默认值：‘’）

• y_axis_location (Nullable(Enum(HorizontalLocation)))

  y 轴应位于何处。（默认值：‘left’）

• y_minor_ticks (Either(Auto, Int))

  相邻 y 轴主刻度之间的小刻度数量。（默认值：‘auto’）

above = []

类型:

List

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

align = 'auto'

类型:

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

父容器内的对齐点。

此属性仅在该组件是布局的子元素（例如网格）时有用。自对齐可以被父容器（例如网格轨道对齐）覆盖。

api_key = Undefined

类型:

Required(Bytes)

Google Maps API 需要一个 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

类型:

浮点数

为增加纵横比控制而提供的值。此值将乘法加到match_aspect所需的计算值。 aspect_scale定义为图形宽度与高度的比率。

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

注意

此设置仅在match_aspect设置为True时生效。

attribution = []

类型:

List

允许确认或给予数据、瓦片等的提供者。

这可以是 HTML 或纯文本形式。渲染器（如瓦片渲染器）可以提供额外的归属，这些归属将在此处提供的归属之后添加。

注意

此功能处于实验阶段，可能会在短期内发生变化。

background_fill_alpha = 0.0

类型:

Alpha

绘图背景样式的填充 alpha。

background_fill_color = '#ffffff'

类型:

Nullable(Color)

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

below = []

类型:

List

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

border_fill_alpha = 1.0

类型:

Alpha

绘图边框样式的填充 alpha。

border_fill_color = '#ffffff'

类型:

Nullable(Color)

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

center = []

类型:

List

一个渲染器列表，占据绘图的中心区域（框架）。

context_menu = None

类型:

Nullable(Instance(Menu))

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

注意

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

css_classes = []

类型:

List

添加到底层 DOM 元素的额外 CSS 类列表。

css_variables = {}

类型:

Dict(String, Instance(Node))

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

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

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

注意

此属性处于实验阶段，可能会随时更改。

disabled = False

类型:

布尔值

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

如果True，小部件将被灰显并对 UI 事件无响应。

elements = []

类型:

List

附加到此窗格的基于 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_width 和 frame_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

类型:

布尔值

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

hold_render = False

类型:

布尔值

设置为 True 时，所有重新绘制绘图的请求将被推迟。

这在定期更新许多图形时很有用。例如，假设我们在绘图上有 10 条线，每条线都有自己的数据源。我们在 for 循环中每秒向所有这些线流式传输，如下所示

for line in lines:
    line.stream(new_points())

此代码的问题是，每次流式传输都会触发绘图的重新渲染。即使只在最后一次流式传输时重新绘制，也会产生几乎相同的视觉效果。特别是对于具有许多点的线，这会变得计算量大，并可能冻结您的浏览器。使用便捷方法 hold，我们可以控制渲染的启动时间，如下所示

with plot.hold(render=True):
    for line in lines:
        line.stream(new_points())

在这种情况下，我们只在最后一次流式传输后渲染新追加的点。

inner_height = Undefined

类型:

只读

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

注意

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

inner_width = Undefined

类型:

只读

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

注意

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

left = []

类型:

List

渲染器列表，用于占据绘图左侧区域。

lod_factor = 10

类型:

Int

应用细节级别降采样时要使用的降采样因子。

lod_interval = 300

类型:

Int

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

lod_threshold = 2000

类型:

Nullable(Int)

数据点数量，超过此数量，图形渲染器可能会执行细节级别降采样。设置为 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

类型:

布尔值

指定绘图的纵横比行为。纵横比定义为宽度与高度的比率。此属性控制 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.circle([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

类型:

浮点数

绘图边框轮廓的线宽。

output_backend = 'canvas'

类型:

Enum(OutputBackend)

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

注意

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

renderers = []

类型:

List

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

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

reset_policy = 'standard'

类型:

Enum(ResetPolicy)

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

resizable = False

类型:

Either(Bool, Enum(Dimensions))

布局是否可交互调整大小，如果是，则在哪个维度。

right = []

类型:

List

一个渲染器列表，用于占据绘图右侧的区域。

sizing_mode = None

类型:

Nullable(Enum(SizingMode))

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

这是维护组件宽度和高度的高级设置。要获得对大小调整的更细粒度控制，请使用 width_policy、height_policy 和 aspect_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 = []

类型:

List

用于底层 DOM 元素的额外样式表。

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

syncable = True

类型:

布尔值

指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

注意

将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍将起作用。

tags = []

类型:

List

一个可选的任意用户提供值的列表，附加到此模型。

当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

>>> r = plot.circle([1,2,3], [4,5,6])
>>> r.tags = ["foo", 10]
>>> plot.select(tags=['foo', 10])
[GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]

或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

注意

不会对提供的任何标签强制实施唯一性保证或其他条件，Bokeh 也不会直接出于任何原因使用标签。

title = Title(id='p71637', ...)

类型:

Either(Null, Instance(Title))

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

title_location = 'above'

类型:

Nullable(Enum(Location))

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

toolbar = Toolbar(id='p71706', ...)

类型:

Instance(Toolbar)

与该图相关的工具栏，其中包含所有工具。如果需要，它将自动与图一起创建。

toolbar_inner = False

类型:

布尔值

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

toolbar_location = 'right'

类型:

Nullable(Enum(Location))

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

toolbar_sticky = True

类型:

布尔值

将工具栏粘贴到图的边缘。默认值：True。如果为 False，工具栏将位于轴、标题等之外。

visible = True

类型:

布尔值

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

width = 600

类型:

Nullable(NonNegative)

组件的宽度（以像素为单位）。

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

width_policy = 'auto'

类型:

Either(Auto, Enum(SizingPolicy))

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

"auto"

使用组件的首选大小策略。

"fixed"

使用完全 width 像素。如果组件无法容纳在可用的水平空间中，则组件将溢出。

"fit"

使用组件的首选宽度（如果设置）并允许它在最小和最大宽度边界（如果设置）内适合可用的水平空间。组件的宽度既不会被积极地最小化，也不会被积极地最大化。

"min"

使用尽可能少的水平空间，不小于最小宽度（如果设置）。起点是首选宽度（如果设置）。组件的宽度可能会缩小或增大，具体取决于父布局、纵横比管理和其他因素。

"max"

使用尽可能多的水平空间，不超过最大宽度（如果设置）。起点是首选宽度（如果设置）。组件的宽度可能会缩小或增大，具体取决于父布局、纵横比管理和其他因素。

注意

这是一个实验性功能，将来可能会发生变化。请自行决定使用它。如果不需要这种级别的控制，请优先使用 sizing_mode。

x_range = Range1d(id='p71945', ...)

类型:

Instance(Range)

图的水平维度的（默认）数据范围。

x_scale = LinearScale(id='p71980', ...)

类型:

Instance(Scale)

要使用哪种比例将数据空间中的 x 坐标转换为屏幕空间中的 x 坐标。

y_range = Range1d(id='p72015', ...)

类型:

Instance(Range)

图的垂直维度的（默认）数据范围。

y_scale = LinearScale(id='p72050', ...)

类型:

Instance(Scale)

要使用哪种比例将数据空间中的 y 坐标转换为屏幕空间中的 y 坐标。

add_glyph(source_or_glyph: Glyph | ColumnarDataSource, glyph: Glyph | None = None, **kwargs: Any) → GlyphRenderer

在图表中添加一个图形，并关联数据源和范围。

此函数将创建和配置一个图形对象，然后将其添加到图表的渲染器列表中。

参数:

• 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, optional) – 要添加对象的 位置（默认：‘center’） 有效的位置有：‘left’, ‘right’, ‘above’, ‘below’, ‘center’。

返回值:

None

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

将新的 TileRenderer 添加到 Plot.renderers

参数:

• tile_source (TileSource, xyzservices.TileProvider, str) – 包含瓦片集配置的瓦片源实例

• retina (bool) – 是否使用瓦片的视网膜版本（如果可用）

关键字参数:

renderer (将其他关键字参数直接传递给瓦片)

返回值:

TileRenderer

返回类型：:

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)

为该图形配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

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

• fill_alpha (AlphaSpec, 可选) – 环形楔形的填充 alpha 值。 (默认值：1.0)

• fill_color (ColorSpec, 可选) – 环形楔形的填充颜色值。 (默认值：‘gray’)

• hatch_alpha (AlphaSpec, 可选) – 环形楔形的阴影 alpha 值。 (默认值：1.0)

• hatch_color (ColorSpec, 可选) – 环形楔形的阴影颜色值。 (默认值：‘black’)

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

• hatch_pattern (HatchPatternSpec) – 环形楔形的阴影图案值。

• hatch_scale (NumberSpec, 可选) – 环形楔形的阴影比例值。 (默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 环形楔形的阴影粗细值。 (默认值：1.0)

• inner_radius_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认值：‘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 (NumberSpec, 可选) – 环形楔形的线粗细值。 (默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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)), 可选) – 用于关联属性的单位：屏幕或数据 (默认值：‘data’)

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

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在此图形中配置并添加 Annulus 字形。

参数:

• x (NumberSpec, 可选) – 环形中心的 x 坐标。 (默认: Field(field=’x’, transform=Unspecified, units=Unspecified))

• y (NumberSpec, 可选) – 环形中心的 y 坐标。 (默认: Field(field=’y’, transform=Unspecified, units=Unspecified))

• inner_radius (DistanceSpec, 可选) – 环形的内半径。 (默认: Field(field=’inner_radius’, transform=Unspecified, units=Unspecified))

• outer_radius (DistanceSpec, 可选) – 环形的外半径。 (默认: Field(field=’outer_radius’, transform=Unspecified, units=Unspecified))

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 环形的阴影比例值。 (默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 环形的阴影权重值。 (默认: 1.0)

• inner_radius_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认值：‘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 (NumberSpec, 可选) – 环形的线条宽度值。 (默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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)), 可选) – 用于关联属性的单位：屏幕或数据 (默认值：‘data’)

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 Arc 图形。

参数:

• x (NumberSpec, 可选) – 弧的中心点的 x 坐标。（默认值：Field(field=’x’, transform=Unspecified, units=Unspecified)）

• y (NumberSpec, 可选) – 弧的中心点的 y 坐标。（默认值：Field(field=’y’, transform=Unspecified, units=Unspecified)）

• radius (DistanceSpec, 可选) – 弧的半径。（默认值：Field(field=’radius’, transform=Unspecified, units=Unspecified)）

• start_angle (AngleSpec, 可选) – 从水平方向测量的弧的起始角度。（默认值：Field(field=’start_angle’, transform=Unspecified, units=Unspecified)）

• end_angle (AngleSpec, 可选) – 从水平方向测量的弧的结束角度。（默认值：Field(field=’end_angle’, transform=Unspecified, units=Unspecified)）

• direction (Enum(Direction), 可选) – 从起始角度到结束角度的描边方向。 (默认值: 'anticlock')

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

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

• line_alpha (AlphaSpec, 可选) – 弧的线条 alpha 值。（默认值：1.0）

• line_cap (LineCapSpec, 可选) – 弧的线条端点样式。（默认值：‘butt’）

• line_color (ColorSpec, 可选) – 弧的线条颜色。（默认值：‘black’）

• line_dash (DashPatternSpec) – 弧的线条虚线样式。（默认值：[]）

• line_dash_offset (IntSpec) – 弧的线条虚线偏移值。（默认值：0）

• line_join (LineJoinSpec, 可选) – 弧的线条连接样式。（默认值：‘bevel’）

• line_width (NumberSpec, 可选) – 弧的线条宽度。（默认值：1）

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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)), 可选) – 用于相关属性的单位：屏幕或数据。（默认值：‘data’）

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

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 贝塞尔曲线的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在此图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 块的填充比例值。 (默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 块的填充宽度值。 (默认值: 1.0)

• height_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 (NumberSpec, 可选) – 块的线宽度值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• width_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位: 屏幕或数据 (默认值: ‘data’)

也可以设置额外字形的颜色和 Alpha 参数，以用于选择、未选择、悬停或静音。为此，请在任何视觉参数前添加相关前缀。例如，传递 nonselection_alpha 来设置非选择状态的线条和填充 Alpha，或传递 hover_fill_alpha 来设置悬停状态的填充 Alpha。有关完整详情，请参见用户指南中的 字形样式 部分。

返回值:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.block(x=[1, 2, 3], y=[1,2,3], width=0.5, height=1, , color="#CAB2D6")

show(plot)

circle(*args: Any, **kwargs: Any) → GlyphRenderer

将 Circle 图形配置并添加到此图形中。

参数:

• x (str 或 seq[float]) – 中心 x 坐标的值或字段名

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

• radius (str 或 list[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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

配置并在此图表中添加 Ellipse 图形。

参数:

• x (NumberSpec, 可选) – 椭圆中心的 x 坐标。 (默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))

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

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

• height (DistanceSpec, 可选) – 每个椭圆的高度。 (默认值：Field(field=’height’, transform=Unspecified, units=Unspecified))

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

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 椭圆的阴影缩放值。 (默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 椭圆的阴影粗细值。 (默认值：1.0)

• height_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位: 屏幕或数据 (默认值: ‘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 (NumberSpec, 可选) – 椭圆的线条粗细值。 (默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• width_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位: 屏幕或数据 (默认值: ‘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)

配置并在此图形中添加 HArea 图形。

参数:

• x1 (NumberSpec, 可选) – 区域一侧点的 x 坐标。 (默认值：Field(field=’x1’, transform=Unspecified, units=Unspecified))

• x2 (NumberSpec, 可选) – 区域另一侧点的 x 坐标。 (默认值：Field(field=’x2’, transform=Unspecified, units=Unspecified))

• y (NumberSpec, 可选) – 区域点的 y 坐标。 (默认值：Field(field=’y’, transform=Unspecified, units=Unspecified))

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 水平定向区域的阴影缩放值。 (默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 水平定向区域的阴影粗细值。 (默认值：1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图上配置并添加 HAreaStep 图形。

参数:

• x1 (NumberSpec, 可选) – 区域一侧点的 x 坐标。 (默认值：Field(field=’x1’, transform=Unspecified, units=Unspecified))

• x2 (NumberSpec, 可选) – 区域另一侧点的 x 坐标。 (默认值：Field(field=’x2’, transform=Unspecified, units=Unspecified))

• y (NumberSpec, 可选) – 区域点的 y 坐标。 (默认值：Field(field=’y’, transform=Unspecified, units=Unspecified))

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 水平定向区域的阴影缩放值。 (默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 水平定向区域的阴影粗细值。 (默认值：1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图上配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 水平条形的填充比例值。 (默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 水平条形的填充权重值。 (默认值：1.0)

• height_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位: 屏幕或数据 (默认值: ‘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 (NumberSpec, 可选) – 水平条的线宽值。(默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在这个图形中配置并添加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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• aspect_scale (Float, 可选) –

  匹配绘图的纵横比缩放。

  使用此参数在使用aspect_scale 时匹配绘图的纵横比缩放，aspect_scale 的值不为 1.0。 (默认值: 1.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 (NumberSpec, 可选) – 六边形平铺的阴影缩放值。 (默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 六边形平铺的阴影权重值。 (默认值: 1.0)

• line_alpha (AlphaSpec, 可选) – 六边形平铺的线条透明度值。 (默认值: 1.0)

• line_cap (LineCapSpec, 可选) – 六边形平铺的线条端点值。 (默认值: ‘butt’)

• line_color (ColorSpec) – 六边形平铺的线条颜色值。

• line_dash (DashPatternSpec) – 六边形平铺的线条虚线值。 (默认值: [])

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

• line_join (LineJoinSpec, 可选) – 六边形平铺的线条连接值。 (默认值: ‘bevel’)

• line_width (NumberSpec, 可选) – 六边形平铺的线条宽度值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• orientation (String, 可选) –

  六边形平铺的方向。

  使用 "pointytop" 将平铺方向设置为尖角朝上。 使用 "flattop" 将平铺方向设置为平边朝上。 (默认值: ‘pointytop’)

• scale (NumberSpec, 可选) – 每个平铺的缩放因子。 (默认值: 1.0)

• size (Float, 可选) –

  六边形平铺的半径（以数据单位 为单位）。

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

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

为当前图形配置并添加 HSpan 图形。

参数:

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

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 横跨的线宽度值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

为当前图形配置并添加 HStrip 图形。

参数:

• y0 (NumberSpec, 可选) – 构成带状图一边的坐标。 (默认值: Field(field=’y0’, transform=Unspecified, units=Unspecified))

• y1 (NumberSpec, 可选) – 构成带状图另一边的坐标。 (默认值: Field(field=’y1’, transform=Unspecified, units=Unspecified))

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• fill_alpha (AlphaSpec, 可选) – 带状图的填充透明度值。 (默认值: 1.0)

• fill_color (ColorSpec, 可选) – 带状图的填充颜色值。 (默认值: ‘gray’)

• hatch_alpha (AlphaSpec, 可选) – 带状图的阴影透明度值。 (默认值: 1.0)

• hatch_color (ColorSpec, 可选) – 带状图的阴影颜色值。 (默认值: ‘black’)

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

• hatch_pattern (HatchPatternSpec) – 带状图的阴影图案值。

• hatch_scale (NumberSpec, 可选) – 带状图的阴影比例值。 (默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 带状图的阴影宽度值。 (默认值: 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 (NumberSpec, 可选) – 带状图的线宽度值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在此图中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (Either(Enum(Anchor), Tuple(Either(Enum(Align), Enum(HAlign), Percent), Either(Enum(Align), Enum(VAlign), Percent))), 可选) – 图像的定位应锚定在 x、y 坐标处。(默认: ‘bottom_left’)

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

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

  还可以设置 bokeh.palettes 中调色板的名称，在这种情况下，将使用使用命名调色板配置的 LinearColorMapper。

  注意

  颜色映射步骤在客户端进行。(默认: <Instance: LinearColorMapper(palette=Greys9)>)

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• dh_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认: ‘data’)

• dw_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认: ‘data’)

• global_alpha (AlphaSpec, 可选) – 图像的全局 alpha 值。(默认: 1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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 (str 或 list[color value])

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

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 Alpha 参数，以用于选择、未选择、悬停或静音。为此，请在任何视觉参数前添加相关前缀。例如，传递 nonselection_alpha 来设置非选择状态的线条和填充 Alpha，或传递 hover_fill_alpha 来设置悬停状态的填充 Alpha。有关完整详情，请参见用户指南中的 字形样式 部分。

返回值:

GlyphRenderer

注意

如果同时传递 palette 和 color_mapper，则会引发 ValueError 异常。如果两者都没有传递，则将使用 Greys9 调色板作为默认值。

image_rgba(image=Field(field='image', transform=Unspecified, units=Unspecified), x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), dw=Field(field='dw', transform=Unspecified, units=Unspecified), dh=Field(field='dh', transform=Unspecified, units=Unspecified), dilate=False, *, anchor='bottom_left', decorations=[], dh_units='data', dw_units='data', global_alpha=1.0, name=None, origin='bottom_left', syncable=True, tags=[], **kwargs)

在该图形上配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (Either(Enum(Anchor), Tuple(Either(Enum(Align), Enum(HAlign), Percent), Either(Enum(Align), Enum(VAlign), Percent))), 可选) – 图像的定位应锚定在 x、y 坐标处。(默认: ‘bottom_left’)

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• dh_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认: ‘data’)

• dw_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认: ‘data’)

• global_alpha (AlphaSpec, 可选) – 图像的全局 alpha 值。(默认: 1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形上配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (Either(Enum(Anchor), Tuple(Either(Enum(Align), Enum(HAlign), Percent), Either(Enum(Align), Enum(VAlign), Percent))), 可选) – 图像的定位应锚定在 x、y 坐标处。(默认: ‘bottom_left’)

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

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

  注意

  颜色映射步骤在客户端执行。 (默认值: Undefined)

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• dh_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认: ‘data’)

• dw_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据 (默认: ‘data’)

• global_alpha (AlphaSpec, 可选) – 图像的全局 alpha 值。(默认: 1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形上配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (Either(Enum(Anchor), Tuple(Either(Enum(Align), Enum(HAlign), Percent), Either(Enum(Align), Enum(VAlign), Percent))), optional) – 图像应在 x、y 坐标处锚定。 (默认: ‘top_left’)

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

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• global_alpha (NumberSpec, optional) – 每张图像渲染时的整体不透明度（除了图像本身的任何固有 alpha 值）。 (默认: 1.0)

• h_units (NotSerialized(Enum(SpatialUnits)), optional) – 用于关联属性的单位：屏幕或数据（默认: ‘data’）

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• w_units (NotSerialized(Enum(SpatialUnits)), optional) – 用于关联属性的单位：屏幕或数据（默认: ‘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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 Alpha 参数，以用于选择、未选择、悬停或静音。为此，请在任何视觉参数前添加相关前缀。例如，传递 nonselection_alpha 来设置非选择状态的线条和填充 Alpha，或传递 hover_fill_alpha 来设置悬停状态的填充 Alpha。有关完整详情，请参见用户指南中的 字形样式 部分。

返回值:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.inverted_triangle(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DE2D26")

show(plot)

js_link(attr: str, other: Model, other_attr: str, attr_selector: int | str | None = None) → None

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

这是一个简便方法，它简化了添加 CustomJS 回调，以便在另一个 Bokeh 模型属性更改值时更新一个 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)

配置并将 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在图中配置并添加 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 (NumberSpec) –

  以像素为单位的偏移值，应用于 x 坐标。

  这很有用，例如，如果希望将文本在 屏幕单位 中从给定的数据位置浮动一个固定距离。 (默认值: 0)

• y_offset (NumberSpec) –

  以像素为单位的偏移值，应用于 y 坐标。

  这很有用，例如，如果希望将文本在 屏幕单位 中从给定的数据位置浮动一个固定距离。 (默认值: 0)

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (DataSpec, 可选) –

  此图形边界框内 x 和 y 坐标锚定的位置。 这可以是一个命名的锚点，例如 top_left 或 center，或从左到右和从上到下的百分比，或两者的组合，在宽度和高度上独立。 如果设置为 auto，则锚点将从文本 align 和 baseline 确定。

  注意

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

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

• background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充 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 (NumberSpec, 可选) – 文本边界框的阴影比例值。 (默认值: 12.0)

• background_hatch_weight (NumberSpec, 可选) – 文本边界框的阴影权重值。 (默认值: 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 (NumberSpec, 可选) – 文本边界框的线宽值。 (默认值：1)

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

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

  注意

  此属性是实验性的，可能会随时更改。 (默认值: 0)

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• text_align (TextAlignSpec, 可选) – 文本的文本对齐值。 (默认值：‘left’)

• text_alpha (AlphaSpec, 可选) – 文本的文本透明度值。 (默认值：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)

在此图中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 线的线宽值。 (默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在图表中配置和添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 多边形填充的缩放比例值。（默认值：12.0）

• hatch_weight (NumberSpec, 可选) – 多边形填充的权重值。（默认值：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 (NumberSpec, 可选) – 多边形线条的宽度值。（默认值：1）

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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=Field(field='radius', transform=Unspecified, units=Unspecified), *, 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)

在这个图形中配置并添加 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 边的顶点。（默认: Field(field=’radius’, transform=Unspecified, units=Unspecified))

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• angle (AngleSpec) – 以弧度表示的旋转 N 边的角度。当值为 0 时，一个顶点将直接绘制在中心坐标上方。（默认: 0)

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

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• fill_alpha (AlphaSpec, 可选) – N 边的填充透明度值。（默认: 1.0)

• fill_color (ColorSpec, 可选) – N 边的填充颜色值。（默认: ‘gray’)

• hatch_alpha (AlphaSpec, 可选) – N 边的填充透明度值。（默认: 1.0)

• hatch_color (ColorSpec, 可选) – N 边的填充颜色值。（默认: ‘black’)

• hatch_extra (Dict(String, Instance(‘bokeh.models.textures.Texture’))) – N 边的填充透明度值。（默认: {})

• hatch_pattern (HatchPatternSpec) – N 边的填充颜色值。

• hatch_scale (NumberSpec, 可选) – N 边的填充透明度值。（默认: 12.0)

• hatch_weight (NumberSpec, 可选) – N 边的填充颜色值。（默认: 1.0)

• line_alpha (AlphaSpec, 可选) – N 边的线条透明度值。（默认: 1.0)

• line_cap (LineCapSpec, 可选) – N 边的线条端点样式值。（默认: ‘butt’)

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

• line_dash (DashPatternSpec) – N 边的线条虚线样式值。（默认: [])

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

• line_join (LineJoinSpec, 可选) – N 边的线条连接样式值。（默认: ‘bevel’)

• line_width (NumberSpec, 可选) – N 边的线条宽度值。（默认: 1)

• n (NumberSpec, 可选) – N 边的边数。小于 3 的值将导致不绘制任何图形实例。（默认: Field(field=’n’, transform=Unspecified, units=Unspecified))

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• radius_dimension (Enum(Enumeration(x, y, max, min)), 可选) –

  测量 N 边的半径的维度。

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

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

• radius_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于相关属性的单位：屏幕或数据。（默认值：‘data’）

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在此图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

将 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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’))) – 补丁的填充 extra 值。(默认: {})

• hatch_pattern (HatchPatternSpec) – 补丁的填充 pattern 值。

• hatch_scale (NumberSpec, 可选) – 补丁的填充 scale 值。(默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 补丁的填充 weight 值。(默认: 1.0)

• line_alpha (AlphaSpec, 可选) – 补丁的线 alpha 值。(默认: 1.0)

• line_cap (LineCapSpec, 可选) – 补丁的线 cap 值。(默认: ‘butt’)

• line_color (ColorSpec, 可选) – 补丁的线 color 值。(默认: ‘black’)

• line_dash (DashPatternSpec) – 补丁的线 dash 值。(默认: [])

• line_dash_offset (IntSpec) – 补丁的线 dash offset 值。(默认: 0)

• line_join (LineJoinSpec, 可选) – 补丁的线 join 值。(默认: ‘bevel’)

• line_width (NumberSpec, 可选) – 补丁的线 width 值。(默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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, optional) – 是否包括自对象创建以来未明确设置的属性。(默认值: 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)

在该图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 四边形的阴影比例值。 (默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 四边形的阴影粗细值。 (默认: 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 (NumberSpec, 可选) – 四边形的线条粗细值。 (默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 抛物线的线宽值。 (默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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 (callable) – 一个可调用对象，它接受属性描述符并返回 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)

配置并将 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 射线的线宽值。 (默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形上配置并添加 Rect 图形。

参数:

• x (NumberSpec, 可选) – 矩形的中心点横坐标。 (默认值: Field(field=’x’, transform=Unspecified, units=Unspecified))

• y (NumberSpec, 可选) – 矩形的中心点纵坐标。 (默认值: 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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, 可选) – 矩形的填充透明度值。 (默认值: 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 (NumberSpec, 可选) – 矩形的填充图案缩放值。 (默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 矩形的填充图案粗细值。 (默认值: 1.0)

• height_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 (NumberSpec, 可选) – 矩形的线条粗细值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• width_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位: 屏幕或数据 (默认值: ‘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 图形在对数刻度上没有明确定义。请改用 Block 或 Quad 图形。

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 (str 或 seq[float]) – 中心 x 坐标的值或字段名

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

• size (str or list[float]) – 大小值或字段名称，以 屏幕单位 为单位

• marker (str, or list[str]) – 标记类型的值或字段名称

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

配置并将 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• line_alpha (AlphaSpec, optional) – 线段的线透明度值。 (默认: 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 (NumberSpec, optional) – 线段的线宽值。 (默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 Alpha 参数，以用于选择、未选择、悬停或静音。为此，请在任何视觉参数前添加相关前缀。例如，传递 nonselection_alpha 来设置非选择状态的线条和填充 Alpha，或传递 hover_fill_alpha 来设置悬停状态的填充 Alpha。有关完整详情，请参见用户指南中的 字形样式 部分。

返回值:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.segment(x0=[1, 2, 3], y0=[1, 2, 3],
             x1=[1, 2, 3], y1=[1.2, 2.5, 3.7],
             color="#F4A582", line_width=3)

show(plot)

select(*args, **kwargs)

查询此对象及其所有引用，查找与给定选择器匹配的对象。

调用 select 方法有几种不同的方式。最普遍的方式是将类似 JSON 的查询字典作为单个参数提供，或者作为关键字参数提供

参数:

selector (JSON-like) – 一些示例文本

关键字参数:

kwargs – 查询字典键值对作为关键字参数

此外，为了与 Model.select 兼容，可以选择字典作为 selector 关键字参数传递，在这种情况下，kwargs['selector'] 的值将用于查询。

为了方便起见，只需将 name 字符串作为单个参数提供，就可以对名称进行查询

参数:

name (str) – 要查询的名称

只需将 Model 子类作为单个参数提供，就可以对类型进行查询

参数:

type (Model) – 要查询的类型

返回值:

seq[Model]

示例

# These three are equivalent
p.select(selector={"type": HoverTool})
p.select({"type": HoverTool})
p.select(HoverTool)

# These two are also equivalent
p.select({"name": "mycircle"})
p.select("mycircle")

# Keyword arguments can be supplied in place of selector dict
p.select({"name": "foo", "type": HoverTool})
p.select(name="foo", type=HoverTool)

select_one(selector: SelectorType) → Model | None

查询此对象及其所有引用以查找与给定选择器匹配的对象。如果找到多个对象，则会引发错误。返回单个匹配对象，如果未找到任何对象，则返回 None :param selector: :type selector: JSON-like

返回值:

模型

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

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

参数:

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

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

• setter (ClientSession or ServerSession or None, optional) –

  这用于防止 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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=

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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=

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• line_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.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

将 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 (NumberSpec) –

  以像素为单位的偏移值，应用于 x 坐标。

  这很有用，例如，如果希望将文本在 屏幕单位 中从给定的数据位置浮动一个固定距离。 (默认值: 0)

• y_offset (NumberSpec) –

  以像素为单位的偏移值，应用于 y 坐标。

  这很有用，例如，如果希望将文本在 屏幕单位 中从给定的数据位置浮动一个固定距离。 (默认值: 0)

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (DataSpec, 可选) –

  此图形边界框内 x 和 y 坐标锚定的位置。 这可以是一个命名的锚点，例如 top_left 或 center，或从左到右和从上到下的百分比，或两者的组合，在宽度和高度上独立。 如果设置为 auto，则锚点将从文本 align 和 baseline 确定。

  注意

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

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

• background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充 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 (NumberSpec, 可选) – 文本边界框的阴影比例值。 (默认值: 12.0)

• background_hatch_weight (NumberSpec, 可选) – 文本边界框的阴影权重值。 (默认值: 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 (NumberSpec, 可选) – 文本边界框的线宽值。 (默认值：1)

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

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

  注意

  此属性是实验性的，可能会随时更改。 (默认值: 0)

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• display (Either(Enum(Enumeration(inline, block, auto))), optional) –

  定义如何解释文本以及要使用的 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.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• text_align (TextAlignSpec, 可选) – 文本的文本对齐值。 (默认值：‘left’)

• text_alpha (AlphaSpec, 可选) – 文本的文本透明度值。 (默认值：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)

在此图形中配置并添加 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 (NumberSpec) –

  以像素为单位的偏移值，应用于 x 坐标。

  这很有用，例如，如果希望将文本在 屏幕单位 中从给定的数据位置浮动一个固定距离。 (默认值: 0)

• y_offset (NumberSpec) –

  以像素为单位的偏移值，应用于 y 坐标。

  这很有用，例如，如果希望将文本在 屏幕单位 中从给定的数据位置浮动一个固定距离。 (默认值: 0)

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• anchor (DataSpec, 可选) –

  此图形边界框内 x 和 y 坐标锚定的位置。 这可以是一个命名的锚点，例如 top_left 或 center，或从左到右和从上到下的百分比，或两者的组合，在宽度和高度上独立。 如果设置为 auto，则锚点将从文本 align 和 baseline 确定。

  注意

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

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

• background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充 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 (NumberSpec, 可选) – 文本边界框的阴影比例值。 (默认值: 12.0)

• background_hatch_weight (NumberSpec, 可选) – 文本边界框的阴影权重值。 (默认值: 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 (NumberSpec, 可选) – 文本边界框的线宽值。 (默认值：1)

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

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

  注意

  此属性是实验性的，可能会随时更改。 (默认值: 0)

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• text_align (TextAlignSpec, 可选) – 文本的文本对齐值。 (默认值：‘left’)

• text_alpha (AlphaSpec, 可选) – 文本的文本透明度值。 (默认值：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。

返回值:

字典或 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 垂直方向区域的阴影比例值。 (默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 垂直方向区域的阴影宽度值。 (默认: 1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 垂直方向区域的阴影比例值。 (默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 垂直方向区域的阴影宽度值。 (默认: 1.0)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 垂直条形的阴影比例值。 (默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 垂直条形的阴影粗细值。 (默认: 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 (NumberSpec, 可选) – 垂直条形的线宽值。 (默认: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

• width_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位: 屏幕或数据 (默认值: ‘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)

在该图形中配置并添加VSpan 图形。

参数:

• x (NumberSpec, 可选) – 跨度的 x 坐标。 (默认: Field(field=’x’, transform=Unspecified, units=Unspecified))

• alpha (float, 可选) –

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

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

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

• color (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 横跨的线宽度值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形中配置并添加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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

• fill_alpha (AlphaSpec, 可选) – 带状图的填充透明度值。 (默认值: 1.0)

• fill_color (ColorSpec, 可选) – 带状图的填充颜色值。 (默认值: ‘gray’)

• hatch_alpha (AlphaSpec, 可选) – 带状图的阴影透明度值。 (默认值: 1.0)

• hatch_color (ColorSpec, 可选) – 带状图的阴影颜色值。 (默认值: ‘black’)

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

• hatch_pattern (HatchPatternSpec) – 带状图的阴影图案值。

• hatch_scale (NumberSpec, 可选) – 带状图的阴影比例值。 (默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 带状图的阴影宽度值。 (默认值: 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 (NumberSpec, 可选) – 带状图的线宽度值。 (默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图形中配置并添加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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• level (RenderLevel, 可选) – 指定此图形的渲染级别顺序。

关键字参数:

• decorations (List) –

  图形装饰的集合，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置图形渲染器的所有图形。当需要更精细的控制时，使用此属性。

  注意

  装饰仅用于帮助图形的视觉外观，但它们不参与命中测试等。 (默认值：[])

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

• fill_alpha (AlphaSpec, 可选) – 楔形的填充透明度值。 (默认: 1.0)

• fill_color (ColorSpec, 可选) – 楔形的填充颜色值。 (默认: ‘gray’)

• hatch_alpha (AlphaSpec, 可选) – 楔形的填充透明度值。 (默认: 1.0)

• hatch_color (ColorSpec, 可选) – 楔形的填充颜色值。 (默认: ‘black’)

• hatch_extra (Dict(String, Instance(‘bokeh.models.textures.Texture’))) – 楔形的填充透明度值。 (默认: {})

• hatch_pattern (HatchPatternSpec) – 楔形的图案填充值。

• hatch_scale (NumberSpec, 可选) – 楔形的图案填充比例值。(默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 楔形的图案填充权重值。(默认值: 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 (NumberSpec, 可选) – 楔形的线条宽度值。(默认值: 1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([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)), 可选) – 用于相关属性的单位：屏幕或数据。（默认值：‘data’）

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

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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)

在该图表中配置并添加 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 (color, 可选) –

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

  请参阅用户指南中的 颜色属性，了解定义颜色的不同选项。

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

• legend_field (str, 可选) –

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

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_group (str, 可选) –

  指定图形应通过 在 Python 中进行分组 生成多个图例条目。 此参数的值是数据源中应用于分组的列的名称。

  分组是在发送 Bokeh 输出到浏览器之前在 Python 中执行的。 如果数据随后更新，图例不会自动重新分组。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一

• legend_label (str, 可选) –

  指定图形应在图例中生成一个简单的 基本图例标签。 图例条目用此处提供的精确文本标记。

  注意

  只能提供 legend_field、legend_group 或 legend_label 之一。

• muted (bool, optionall) –

  图形是否应呈现为静音（默认值: False）

  要使这有用，必须在返回的 GlyphRender 上配置 muted_glyph。 这可以通过显式创建要使用的 Glyph 来完成，或者更简单地通过将例如 muted_color 等传递到此图形函数来完成。

• name (str, 可选) –

  一个可选的用户提供的名称，附加到渲染器（默认值: None）

  Bokeh 不使用此值，但它可能对搜索 Bokeh 文档以查找特定模型有用。

• source (ColumnDataSource, 可选) –

  用户提供的数据源。 (默认值：无)

  如果未提供，Bokeh 将自动构造一个内部 ColumnDataSource，使用从坐标和作为字面列表或数组值传递的其他参数中获得的默认列名。

  如果提供，Bokeh 将使用提供的数据源来推导出图形。在这种情况下，字面列表或数组不能用于坐标或其他参数。仅允许数据源中的单个固定值（例如 x=10）或列名（例如 x="time"）。

• view (CDSView, 可选) – 用于过滤数据源的视图。 (默认值：无)

• visible (bool, 可选) – 图形是否应渲染。 (默认值：True)

• x_range_name (str, 可选) –

  用于映射 x 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 y_range 进行坐标映射。

• y_range_name (str, 可选) –

  用于映射 y 坐标的额外范围的名称。 (默认值：无)

  如果没有提供，则将使用图表的默认 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 (NumberSpec, 可选) – 标记的填充比例值。(默认值：12.0)

• hatch_weight (NumberSpec, 可选) – 标记的填充宽度值。(默认值：1.0)

• hit_dilation (Size, 可选) – 用于膨胀命中半径的因子，该半径负责定义标记对 Hover 和 Tap 工具交互做出响应的范围。(默认值：1.0)

• line_alpha (AlphaSpec, 可选) – 标记的线 alpha 值。(默认值：1.0)

• line_cap (LineCapSpec, 可选) – 标记的线端点样式值。(默认值：‘butt’)

• line_color (ColorSpec, 可选) – 标记的线颜色值。(默认值：‘black’)

• line_dash (DashPatternSpec) – 标记的线虚线样式值。(默认值：[])

• line_dash_offset (IntSpec) – 标记的线虚线偏移值。(默认值：0)

• line_join (LineJoinSpec, 可选) – 标记的线连接样式值。(默认值：‘bevel’)

• line_width (NumberSpec, 可选) – 标记的线宽度值。(默认值：1)

• name (Nullable(String)) –

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

  当查询文档以检索特定 Bokeh 模型时，此名称很有用。

  >>> plot.circle([1,2,3], [4,5,6], name="temp")
  >>> plot.select(name="temp")
  [GlyphRenderer(id='399d53f5-73e9-44d9-9527-544b761c7705', ...)]
  

  注意

  不对提供的任何名称强制执行唯一性保证或其他条件，Bokeh 也不出于任何原因直接使用名称。

• syncable (Bool, 可选) –

  指示此模型是否应在网页浏览器中更新时同步回 Bokeh 服务器。将设置更改为 False 可能有助于在处理经常更新的对象时减少网络流量，而我们不需要更新的值。

  注意

  将此属性设置为 False 将阻止此对象上的任何 on_change() 回调触发。但是，任何 JS 侧回调仍然可以工作。 (默认值：True)

• tags (List) –

  一个可选的任意用户提供值的列表，附加到此模型。

  当查询文档以检索特定 Bokeh 模型时，此数据可能很有用

  >>> r = plot.circle([1,2,3], [4,5,6])
  >>> r.tags = ["foo", 10]
  >>> plot.select(tags=['foo', 10])
  [GlyphRenderer(id='1de4c3df-a83d-480a-899b-fb263d3d5dd9', ...)]
  

  或者，只是将任何必要的元数据附加到模型的便捷方法，可以通过 CustomJS 回调等访问。

  注意

  不会对提供的任何标签实施唯一性保证或其他条件，Bokeh 也不会出于任何原因直接使用这些标签。 (默认值：[])

也可以设置额外字形的颜色和 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 对象的可扩展列表。

属性 plot

属性 ref: Ref

属性 tools: list[Tool]

属性 xaxis

可扩展的 Axis 对象列表，用于 x 轴。

属性 xgrid

可扩展的 Grid 对象列表，用于 x 轴。

属性 yaxis

可扩展的 Axis 对象列表，用于 y 轴。

属性 ygrid

可扩展的 Grid 对象列表，用于 y 轴。