图表

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

基础类：Plot, GlyphAPI

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

Plot的一个子类，通过默认的轴、网格、工具等简化了绘图创建。

图形对象有许多字形方法，可用于绘制矢量化的图形字形：

annular_wedge() annulus() arc() asterisk() bezier() circle() circle_cross() circle_dot() circle_x() circle_y() cross() dash() diamond() diamond_cross() diamond_dot() dot() ellipse() harea() harea_step() hbar()

hex() hex_tile() hstrip() hspan() image() image_rgba() image_url() inverted_triangle() line() multi_line() multi_polygons() ngon() patch() patches() plus() quad() quadratic() ray() rect() segment()

square() square_cross() square_dot() square_pin() square_x() star() star_dot() step() text() triangle() triangle_dot() triangle_pin() varea() varea_step() vbar() vstrip() vspan() wedge() x() y()

有一个散点函数可以通过标记类型进行参数化：

• scatter()

还有一些专门用于堆叠条形图的方法：

• 条形图: hbar_stack(), vbar_stack()

• 线条：hline_stack(), vline_stack()

• 区域: harea_stack(), varea_stack()

以及一个用于制作简单六边形图表的专用方法：

• hexbin()

除了所有的figure属性外，以下选项也被接受：

Keyword Arguments:

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

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

• x_axis_label (Nullable(TextLike)):

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

• x_axis_location (Nullable(Enum(VerticalLocation))):

  x轴应该位于哪里。（默认值：'below'）

• x_axis_type (Nullable(Either(Auto, Enum(Enumeration(linear, log, datetime, mercator))))):

  x轴的类型。（默认值：'auto'）

• x_minor_ticks (Either(Auto, Int)):

  相邻x轴主刻度之间的次要刻度数量。（默认值：'auto'）

• x_range (Either(Instance(Range), Either(Tuple(Float, Float), Tuple(Datetime, Datetime), Tuple(TimeDelta, TimeDelta)), Seq(String), Object, Object)):

  自定义图表的x轴范围。（默认值：DataRange1d(id=’p66522’, …)）

• y_axis_label (Nullable(TextLike)):

  y轴的标签。（默认：''）

• y_axis_location (Nullable(Enum(HorizontalLocation))):

  y轴应该位于的位置。（默认值：'left'）

• y_axis_type (Nullable(Either(Auto, Enum(Enumeration(linear, log, datetime, mercator))))):

  y轴的类型。（默认值：'auto'）

• y_minor_ticks (Either(Auto, Int)):

  相邻y轴主刻度之间的次要刻度数量。（默认值：'auto'）

• y_range (Either(Instance(Range), Either(Tuple(Float, Float), Tuple(Datetime, Datetime), Tuple(TimeDelta, TimeDelta)), Seq(String), Object, Object)):

  自定义图表的y轴范围。（默认值：DataRange1d(id=’p66523’, …)）

above = []

Type:

List

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

align = 'auto'

Type:

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

父容器内的对齐点。

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

aspect_ratio = None

Type:

Either(Null, Auto, Float)

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

如果组件的任何尺寸是灵活的，这将起作用。如果设置为一个数字，width / height = aspect_ratio 关系将保持不变。否则，如果设置为 "auto"，将使用组件的首选宽度和高度来确定宽高比（如果未设置，则不保留宽高比）。

aspect_scale = 1

Type:

Float

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

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

注意

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

attribution = []

Type:

List

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

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

注意

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

background_fill_alpha = 1.0

Type:

Alpha

图表背景样式的填充透明度。

background_fill_color = '#ffffff'

Type:

Nullable(Color)

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

below = []

Type:

List

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

border_fill_alpha = 1.0

Type:

Alpha

绘图边框样式的填充透明度。

border_fill_color = '#ffffff'

Type:

Nullable(Color)

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

center = []

Type:

List

用于占据绘图中心区域（框架）的渲染器列表。

context_menu = None

Type:

Nullable(Instance(Menu))

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

注意

右键点击时使用Shift键以显示原生上下文菜单。

css_classes = []

Type:

List

要添加到基础DOM元素的额外CSS类列表。

css_variables = {}

Type:

Dict(String, Instance(Node))

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

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

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

注意

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

disabled = False

Type:

Bool

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

如果 True，小部件将变为灰色且不响应UI事件。

elements = []

Type:

List

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

这可以包括像工具提示这样的浮动元素，允许在此和其他UI元素之间建立父子关系。

extra_x_ranges = {}

Type:

Dict(String, Instance(Range))

额外的命名范围，可用于映射x坐标。

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

extra_x_scales = {}

Type:

Dict(String, Instance(Scale))

额外的命名比例尺，可用于映射x坐标。

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

注意

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

extra_y_ranges = {}

Type:

Dict(String, Instance(Range))

额外的命名范围，可用于映射y坐标。

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

extra_y_scales = {}

Type:

Dict(String, Instance(Scale))

额外的命名比例尺，可用于映射y坐标。

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

注意

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

flow_mode = 'block'

Type:

Enum(FlowMode)

定义布局将在block或inline维度中流动。

frame_align = True

Type:

Either(Bool, Struct)

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

默认情况下是对齐所有边缘，但用户可以选择不对齐每个单独的边缘或所有边缘。还要注意，其他属性可能会禁用某些边缘的对齐，特别是在使用固定框架大小时（frame_width 和 frame_height 属性）。

frame_height = None

Type:

Nullable(Int)

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

frame_width = None

Type:

Nullable(Int)

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

height = 600

Type:

Nullable(NonNegative)

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

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

height_policy = 'auto'

Type:

Either(Auto, Enum(SizingPolicy))

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

"auto"

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

"fixed"

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

"fit"

使用组件的首选高度（如果已设置），并允许在最小和最大高度范围内适应可用的垂直空间（如果已设置）。组件的高度既不会被过度最小化，也不会被过度最大化。

"min"

尽可能使用最少的垂直空间，但不少于最小高度（如果已设置）。 起点是首选高度（如果已设置）。组件的高度可能会根据父布局、宽高比管理和其他因素缩小或增长。

"max"

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

注意

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

hidpi = True

Type:

Bool

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

hold_render = False

Type:

Bool

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

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

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

这段代码的问题在于每个流都会触发图表的重新渲染。即使只在最后一个流上重新绘制也会产生几乎相同的视觉效果。特别是对于具有许多点的线条，这在计算上变得非常昂贵，并可能导致浏览器冻结。使用便捷方法hold，我们可以控制何时启动渲染，如下所示：

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

在这种情况下，我们仅在最后一个流之后渲染新附加的点。

inner_height = Undefined

Type:

Readonly

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

注意

这是一个实验性功能，API 可能会在不久的将来发生变化。

inner_width = Undefined

Type:

Readonly

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

注意

这是一个实验性功能，API 可能会在不久的将来发生变化。

left = []

Type:

List

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

lod_factor = 10

Type:

Int

在应用细节层次抽稀时使用的抽稀因子。

lod_interval = 300

Type:

Int

交互工具事件启用细节层次下采样的时间间隔（以毫秒为单位）。

lod_threshold = 2000

Type:

Nullable(Int)

多个数据点，超过此数量时，字形渲染器可能会执行细节层次的下采样。设置为None以禁用任何细节层次的下采样。

lod_timeout = 500

Type:

Int

检查交互工具事件是否仍在发生的超时时间（以毫秒为单位）。一旦启用了细节层次模式，每 lod_timeout 毫秒进行一次检查。如果没有发生交互工具事件，则禁用细节层次模式。

margin = None

Type:

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

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

match_aspect = False

Type:

Bool

指定绘图的长宽比行为。长宽比定义为宽度与高度的比率。此属性控制Bokeh是否应尝试将数据空间的（宽度/高度）与屏幕空间的（宽度/高度）以像素为单位匹配。

默认是 False，表示数据的宽高比和屏幕的宽高比是独立变化的。True 表示坐标轴的绘图宽高比将与坐标轴的像素范围的宽高比匹配。最终结果是，数据空间中的1x1区域在像素中是正方形，反之，1x1像素在数据单位中也是正方形。

注意

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

警告

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

max_height = None

Type:

Nullable(NonNegative)

如果高度可调，组件的最大高度（以像素为单位）。

max_width = None

Type:

Nullable(NonNegative)

如果宽度可调，组件的最大宽度（以像素为单位）。

min_border = 5

Type:

Nullable(Int)

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

min_border_bottom = None

Type:

Nullable(Int)

中央绘图区域底部下方填充区域的最小像素大小。

注意

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

min_border_left = None

Type:

Nullable(Int)

中央绘图区域左侧填充区域的最小像素大小。

注意

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

min_border_right = None

Type:

Nullable(Int)

中央绘图区域右侧填充区域的最小像素大小。

注意

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

min_border_top = None

Type:

Nullable(Int)

中央绘图区域顶部上方填充区域的最小像素大小。

注意

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

min_height = None

Type:

Nullable(NonNegative)

如果高度可调，组件的最小高度（以像素为单位）。

min_width = None

Type:

Nullable(NonNegative)

如果宽度可调，组件的最小宽度（以像素为单位）。

name = None

Type:

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

Type:

Readonly

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

注意

这是一个实验性功能，API 可能会在不久的将来发生变化。

outer_width = Undefined

Type:

Readonly

这是布局的确切宽度，即实际绘图的高度，包括工具栏等。请注意，这是在网络浏览器中计算的，因此此属性仅适用于能够进行双向通信的后端（服务器、笔记本）。

注意

这是一个实验性功能，API 可能会在不久的将来发生变化。

outline_line_alpha = 1.0

Type:

Alpha

图表边框轮廓的线条透明度。

outline_line_cap = 'butt'

Type:

Enum(LineCap)

图表边框轮廓的线帽。

outline_line_color = '#e5e5e5'

Type:

Nullable(Color)

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

outline_line_dash = []

Type:

DashPattern

图表边框轮廓的虚线样式。

outline_line_dash_offset = 0

Type:

Int

图表边框轮廓的虚线偏移量。

outline_line_join = 'bevel'

Type:

Enum(LineJoin)

图表边框轮廓的线条连接方式。

outline_line_width = 1

Type:

Float

图表边框轮廓的线宽。

output_backend = 'canvas'

Type:

Enum(OutputBackend)

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

注意

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

renderers = []

Type:

List

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

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

reset_policy = 'standard'

Type:

Enum(ResetPolicy)

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

resizable = False

Type:

Either(Bool, Enum(Dimensions))

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

right = []

Type:

List

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

sizing_mode = None

Type:

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 = {}

Type:

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

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

stylesheets = []

Type:

List

用于底层DOM元素的附加样式表。

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

syncable = True

Type:

Bool

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

注意

将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍然会工作。

tags = []

Type:

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='p68802', ...)

Type:

Either(Null, Instance(Title))

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

title_location = 'above'

Type:

Nullable(Enum(Location))

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

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

Type:

Instance(Toolbar)

与此图相关联的工具栏，包含所有工具。如果必要，它会自动与图一起创建。

toolbar_inner = False

Type:

Bool

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

toolbar_location = 'right'

Type:

Nullable(Enum(Location))

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

toolbar_sticky = True

Type:

Bool

将工具栏固定在绘图边缘。默认值：True。如果为False，工具栏将位于轴、标题等之外。

visible = True

Type:

Bool

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

width = 600

Type:

Nullable(NonNegative)

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

这可以是固定宽度或首选宽度，取决于宽度调整策略。

width_policy = 'auto'

Type:

Either(Auto, Enum(SizingPolicy))

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

"auto"

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

"fixed"

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

"fit"

使用组件的首选宽度（如果已设置），并允许其在最小和最大宽度范围内（如果已设置）适应可用的水平空间。组件的宽度既不会被过度最小化，也不会被过度最大化。

"min"

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

"max"

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

注意

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

x_range = DataRange1d(id='p69110', ...)

Type:

Instance(Range)

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

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

Type:

Instance(Scale)

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

y_range = DataRange1d(id='p69180', ...)

Type:

Instance(Range)

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

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

Type:

Instance(Scale)

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

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

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

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

Parameters:

• source (DataSource) – 所有字形使用的数据源

• glyph (Glyph) – 要添加到绘图中的图形符号

Keyword Arguments:

• the (任何额外的关键字参数都会原封不动地传递给)

• 初始化器。 (Glyph)

Returns:

字形渲染器

add_layout(obj: Renderer, place: Literal['above', 'below', 'left', 'right', 'center'] = 'center') → None

在指定位置向图表添加一个对象。

Parameters:

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

• 位置 (str, 可选) – 添加对象的位置（默认：‘center’） 有效的位置有：‘left’, ‘right’, ‘above’, ‘below’, ‘center’。

Returns:

无

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

将新的TileRenderer添加到Plot.renderers中

Parameters:

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

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

Keyword Arguments:

renderer (额外的关键字参数会原样传递给 tile)

Returns:

TileRenderer

Return type:

TileRenderer

add_tools(*tools: 工具 | str) → None

向图表添加工具。

Parameters:

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

Returns:

无

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图形到这个图表中。

Parameters:

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

• 方向 (Enum(Direction), 可选) – 在起始角度和结束角度之间描边的方向。（默认值：'anticlock'）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个要使用的 Glyph 来实现，或者更简单地通过传递例如 muted_color 等参数到此字形函数中来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• end_angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈数（默认：'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)

• inner_radius_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也不会直接使用该名称。

• outer_radius_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认值：'data'）

• start_angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈数（默认：'弧度'）

• syncable (Bool, 可选) –

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

  注意

  将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍将正常工作。（默认值：True）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图形到这个图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• inner_radius_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也不会直接使用该名称。

• outer_radius_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认值：'data'）

• syncable (Bool, 可选) –

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

  注意

  将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍将正常工作。（默认值：True）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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实例都不应修改它）。

Parameters:

property_values (dict) – 用于替换默认值的主题值

Returns:

无

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字形到此图中。

Parameters:

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

• 方向 (Enum(Direction), 可选) – 在起始角度和结束角度之间描边的方向。（默认值：'anticlock'）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• end_angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈数（默认：'rad'）

• 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)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈数（默认：'弧度'）

• syncable (Bool, 可选) –

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

  注意

  将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍将正常工作。（默认值：True）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展命中半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图形到这个图表中。

Parameters:

• 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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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的给定列中。

Parameters:

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

• gridplot (GridPlot) – 要检查的GridPlot

Returns:

布尔

contour(x: ArrayLike | None = None, y: ArrayLike | None = None, z: ArrayLike | np.ma.MaskedArray | None = None, levels: ArrayLike | None = None, **visuals) → ContourRenderer

创建填充多边形和/或等高线的等高线图。

如果设置了fill_color，则计算填充的等高线多边形；如果设置了line_color，则计算等高线。

Parameters:

• x (类似数组[float] 形状为 (ny, nx) 或 (nx,), 可选) – z 值的 x 坐标。可以是与 z.shape 相同形状的 2D 数组，或者是长度为 nx = z.shape[1] 的 1D 数组。如果未指定，则假定为 np.arange(nx)。必须单调有序。

• y (数组形式[float] 形状为 shape (ny, nx) 或 (ny,), 可选) – z 值的 y 坐标。可以是 2D 数组，形状与 z.shape 相同，或者是 1D 数组，长度为 ny = z.shape[0]。如果未指定，则假定为 np.arange(ny)。必须单调有序。

• z (数组形式[float] 的 形状 (ny, nx)) – 一个用于计算等高线的二维NumPy数组。它可能是一个掩码数组，任何无效值（np.inf 或 np.nan）也将被掩码掉。

• levels (数组形式[float]) – 用于计算等高线的z层级，必须递增。 在每个层级计算等高线，并在每对相邻层级之间计算填充等高线，因此等高线的组数为len(levels)，填充等高线多边形的组数为len(levels)-1。

• **视觉元素 –

  填充属性, 阴影属性 和 线条属性 填充和阴影属性用于填充轮廓，线条属性用于线条轮廓。如果使用向量化属性，则必须使用正确的数量，len(levels) 用于线条属性，len(levels)-1 用于填充和阴影属性。

  fill_color 和 line_color 更加灵活，因为它们会接受更长的序列，并使用 linear_palette() 将其插值到所需的数量，并且还接受调色板集合（从整数长度到颜色序列的映射字典），例如 bokeh.palettes.Cividis。

cross(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs)

配置并添加Scatter图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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属性的名称。

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

Returns:

DataSpec 属性的名称

Return type:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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, 可选) – 椭圆的hatch weight值。(默认: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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

模型的结构相等性。

Parameters:

其他 (HasProps) – 要比较的其他实例

Returns:

如果属性在结构上相等，则为True，否则为False

graph(node_source: ColumnDataSource, edge_source: ColumnDataSource, layout_provider: LayoutProvider, **kwargs)

使用给定的节点、边和布局提供者创建网络图。

Parameters:

• node_source (ColumnDataSource) – 用户提供的图形节点数据源。如果需要，将尝试将对象转换为ColumnDataSource。如果没有提供，则会自动为用户创建一个。

• edge_source (ColumnDataSource) – 用户提供的图边数据源。如果需要，将尝试将该对象转换为ColumnDataSource。如果没有提供，则会自动为用户创建一个。

• layout_provider (LayoutProvider) – 一个 LayoutProvider 实例，用于在笛卡尔空间中提供图形坐标。

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

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 glyphs到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• fill_alpha (Alpha, 可选) – 水平方向区域的填充透明度值。(默认值: 1.0)

• fill_color (Nullable(Color), 可选) – 水平定向区域的填充颜色值。（默认值：'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, 可选) – 水平方向区域的hatch scale值。(默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 水平方向区域的hatch权重值。(默认值: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.harea(x1=[0, 0, 0], x2=[1, 4, 2], y=[1, 2, 3],
           fill_color="#99D594")

show(plot)

harea_stack(stackers, **kw)

生成多个HArea渲染器，用于从左到右堆叠的层级。

Parameters:

stackers (seq[str]) –

一个数据源字段名称的列表，用于依次堆叠 x1 和 x2 的 harea 坐标。

此外，渲染器的 name 将被设置为每个连续的堆叠器的值（这对于特殊的悬停变量 $name 很有用）。

任何额外的关键字参数都会传递给每次调用harea。如果关键字值是列表或元组，则每次调用将从序列中获取一个值。

Returns:

列表[GlyphRenderer]

示例

假设有一个名为 source 的 ColumnDataSource，其中包含列 2016 和 2017，那么以下对 harea_stack 的调用 将创建两个堆叠的 HArea 渲染器：

p.harea_stack(['2016', '2017'], y='y', color=['blue', 'red'], source=source)

这相当于以下两个单独的调用：

p.harea(x1=stack(),       x2=stack('2016'),         y='y', color='blue', source=source, name='2016')
p.harea(x1=stack('2016'), x2=stack('2016', '2017'), y='y', color='red',  source=source, name='2017')

harea_step(x1=Field(field='x1', transform=Unspecified, units=Unspecified), x2=Field(field='x2', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, name=None, step_mode='before', syncable=True, tags=[], **kwargs)

配置并添加HAreaStep字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• fill_alpha (Alpha, 可选) – 水平方向区域的填充透明度值。(默认值: 1.0)

• fill_color (Nullable(Color), 可选) – 水平定向区域的填充颜色值。（默认值：'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, 可选) – 水平方向区域的hatch scale值。(默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 水平方向区域的hatch权重值。(默认: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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, 可选) – 水平条的hatch scale值。(默认: 12.0)

• hatch_weight (NumberSpec, 可选) – 水平条的hatch weight值。(默认: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.hbar(y=[1, 2, 3], height=0.5, left=0, right=[1,2,3], color="#CAB2D6")

show(plot)

hbar_stack(stackers, **kw)

生成多个从左到右堆叠的HBar渲染器。

Parameters:

stackers (seq[str]) –

一个数据源字段名称的列表，用于依次堆叠left和right条形坐标。

此外，渲染器的name将被设置为每个连续堆叠器的值（这对于特殊的悬停变量$name非常有用）

任何额外的关键字参数都会传递给每次对hbar的调用。 如果关键字值是列表或元组，则每次调用将从序列中获取一个值。

Returns:

列表[GlyphRenderer]

示例

假设一个名为 source 的 ColumnDataSource 包含列 2016 和 2017，那么以下对 hbar_stack 的调用 将创建两个堆叠的 HBar 渲染器：

p.hbar_stack(['2016', '2017'], y=10, width=0.9, color=['blue', 'red'], source=source)

这相当于以下两个单独的调用：

p.hbar(bottom=stack(),       top=stack('2016'),         y=10, width=0.9, color='blue', source=source, name='2016')
p.hbar(bottom=stack('2016'), top=stack('2016', '2017'), y=10, width=0.9, color='red',  source=source, name='2017')

hex(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs)

配置并添加Scatter图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图表。

Parameters:

• q (NumberSpec, 可选) – 瓦片中心的“列”轴向坐标。（默认值：Field(field=’q’, transform=Unspecified, units=Unspecified)）

• r (NumberSpec, 可选) – 瓦片中心的“行”轴向坐标。(默认: Field(field=’r’, transform=Unspecified, units=Unspecified))

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• aspect_scale (Float, 可选) –

  匹配绘图的长宽比缩放。

  使用此参数在使用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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300, match_aspect=True)
plot.hex_tile(r=[0, 0, 1], q=[1, 2, 2], fill_color="#74ADD1")

show(plot)

hexbin(x, y, size, orientation='pointytop', palette='Viridis256', line_color=None, fill_color=None, aspect_scale=1, **kwargs)

执行一个简单的等权重六边形分箱。

将添加一个HexTile字形来显示分箱。该字形的ColumnDataSource将包含列q、r和count，其中q和r是图块的轴向坐标，而count是相关的分箱计数。

在相关图表上设置match_aspect=True通常很有用，这样六边形瓦片在屏幕空间中都是规则的（即不会被“拉伸”）。

对于更复杂的用例，例如加权分箱或单独缩放六边形瓦片，直接使用hex_tile()，或考虑使用更高级的库，如HoloViews。

Parameters:

• x (数组[float]) – 一个NumPy数组，包含要分箱到六边形图块的x坐标。

• y (数组[float]) – 一个NumPy数组，包含要分箱到六边形瓦片中的y坐标。

• size (float) –

  使用的六边形平铺的大小。大小定义为从六边形中心到角落的距离。

  如果宽高比不是1-1，则具体来说，size是从中心到“顶部”角落的距离（在“pointytop”方向下），以及从中心到“侧面”角落的距离（在“flattop”方向下）。

• orientation ("pointytop" 或 "flattop", 可选) – 六边形瓦片是否应该以尖角朝上或平面朝上。(默认值: “pointytop”)

• 调色板 (str 或 seq[color], 可选) –

  用于根据计数对箱子进行颜色映射的调色板（或调色板名称）。(默认值: ‘Viridis256’)

  如果提供了 fill_color，它将覆盖此值。

• line_color (color, 可选) – 六边形图块的轮廓颜色，或为 None（默认值：None）

• fill_color (color, optional) – 六边形图块的填充颜色，可选。如果为None，则 使用palette根据计数对图块进行颜色映射。(默认值: None)

• aspect_scale (float) –

  匹配绘图的长宽比缩放。

  当处理一个aspect_scale != 1的绘图时，可以设置此参数以匹配绘图，以便绘制规则的六边形（而不是“拉伸”的六边形）。

  这大致相当于在“屏幕空间”中进行分箱，当绘图的长宽比缩放不为1时，使用轴对齐的矩形分箱可能更好。

任何额外的关键字参数都会传递给 hex_tile()。

Returns:

(Glyphrender, DataFrame)

一个包含生成的HexTile渲染器的元组，用于显示分箱，以及一个Pandas DataFrame，其列包括q、r和count，其中q和r是轴向坐标，count是相关的分箱计数。

Example

import numpy as np
from bokeh.models import HoverTool
from bokeh.plotting import figure, show

x = 2 + 2*np.random.standard_normal(500)
y = 2 + 2*np.random.standard_normal(500)

p = figure(match_aspect=True, tools="wheel_zoom,reset")
p.background_fill_color = '#440154'
p.grid.visible = False

p.hexbin(x, y, size=0.5, hover_color="pink", hover_alpha=0.8)

hover = HoverTool(tooltips=[("count", "@c"), ("(q,r)", "(@q, @r)")])
p.add_tools(hover)

show(p)

hline_stack(stackers, **kw)

生成多个水平堆叠的Line渲染器。

Parameters:

堆叠器 (序列[str]) – 一个数据源字段名称的列表，用于依次堆叠以生成 x 线坐标。

此外，渲染器的name将被设置为每个连续堆叠器的值（这对于特殊的悬停变量$name非常有用）

任何额外的关键字参数都会传递给每次对line的调用。 如果关键字值是列表或元组，则每次调用将从序列中获取一个值。

Returns:

列表[GlyphRenderer]

示例

假设有一个名为 source 的 ColumnDataSource，其中包含列 2016 和 2017，那么以下对 hline_stack 的调用，使用 x 坐标的堆叠器将创建两个堆叠的 Line 渲染器：

p.hline_stack(['2016', '2017'], y='y', color=['blue', 'red'], source=source)

这相当于以下两个单独的调用：

p.line(x=stack('2016'),         y='y', color='blue', source=source, name='2016')
p.line(x=stack('2016', '2017'), y='y', color='red',  source=source, name='2017')

hold(*, render: bool) → Generator[None, None, None]

负责在范围内打开和关闭属性。

Parameters:

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字形到此图表。

Parameters:

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

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• y0 (NumberSpec, 可选) – 条带一侧的y坐标。(默认值: Field(field=’y0’, transform=Unspecified, units=Unspecified))

• y1 (NumberSpec, 可选) – 条带另一侧坐标的y坐标。（默认值：Field(field=’y1’, transform=Unspecified, units=Unspecified)）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图表。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• anchor (Either(Enum(Anchor), Tuple(Either(Enum(Align), Enum(HAlign), Percent), Either(Enum(Align), Enum(VAlign), Percent))), 可选) – 图像的位置应锚定在 x, y 坐标处。（默认值：'bottom_left'）

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

  一个 ColorMapper 用于将 image 中的标量数据映射为用于显示的 RGBA 值。

  也可以设置 bokeh.palettes 中的调色板名称，在这种情况下，将使用配置了该调色板的 LinearColorMapper。

  注意

  颜色映射步骤发生在客户端。（默认值：）

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• dh_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'data'）

• dw_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'data'）

• global_alpha (AlphaSpec, 可选) – 图像的全局透明度值。(默认值: 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’)

• 调色板 (str 或 list[颜色值])

• from (从调色板中为颜色映射器属性构造一个值)

• syncable (Bool, 可选) –

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

  注意

  将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍将正常工作。（默认值：True）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图表。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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, 可选) – 图像的全局透明度值。(默认值: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• 图像 (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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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 值。

  注意

  颜色映射步骤发生在客户端。（默认值：未定义）

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• dh_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'data'）

• dw_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'data'）

• global_alpha (AlphaSpec, 可选) – 图像的全局透明度值。(默认值: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• url (StringSpec) –

  用于获取图像的URL。

  注意

  实际的图像获取和加载发生在客户端。

• x (NumberSpec) – 用于定位图像锚点的x坐标。

• y (NumberSpec) – 用于定位图像锚点的y坐标。

• w (NullDistanceSpec) –

  图像将在数据空间中占据的绘图区域的宽度。

  默认值为 None，在这种情况下，图像将以其实际图像大小显示（无论此处指定的单位如何）。

• h (NullDistanceSpec) –

  图像将在数据空间中占据的绘图区域的高度。

  默认值为 None，在这种情况下，图像将以其实际图像大小显示（无论此处指定的单位如何）。

• angle (AngleSpec) – 旋转图像的角度，从水平方向测量。（默认值：0）

• dilate (Bool) –

  是否始终以使图像变大的方式舍入分数像素位置。

  如果像素舍入错误导致图像之间出现间隙，而它们应该看起来是齐平的，此设置可能有用。（默认值：False）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• anchor (Either(Enum(Anchor), Tuple(Either(Enum(Align), Enum(HAlign), Percent), Either(Enum(Align), Enum(VAlign), Percent))), 可选) – 图像的位置应锚定在 x, y 坐标处。（默认值：'top_left'）

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• global_alpha (NumberSpec, 可选) – 每个图像渲染时的整体不透明度（除了图像本身固有的alpha值之外）。(默认值: 1.0)

• h_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'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）

• 标签 (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)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'data'）

也可以为选择、非选择、悬停或静音设置额外图标的颜色和alpha参数。为此，请在任何视觉参数前添加相关前缀。例如，传递nonselection_alpha来设置非选择时的线条和填充alpha，或传递hover_fill_alpha来设置悬停时的填充alpha。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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模型属性值发生变化时更新它。

Parameters:

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

• 其他 (Model) – 一个要链接到 self.attr 的 Bokeh 模型

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

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

在版本1.1中添加

Raises:

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字形到此图中。

Parameters:

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

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

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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，给定属性名称。

Parameters:

• name (str) – 要搜索的属性的名称

• raises (bool) – 如果缺失，是抛出异常还是返回None

Returns:

名为name的属性的描述符

Return type:

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字形到此图表。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• anchor (DataSpec, 可选) –

  在此字形边界框内的位置，x 和 y 坐标将锚定到该位置。这可以是一个命名的锚点，如 top_left 或 center，或者是从左到右和从上到下的百分比，或者这些的组合，分别在宽度和高度上独立。如果设置为 auto，则锚点将由文本的 align 和 baseline 决定。

  注意

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

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

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

• background_hatch_alpha (AlphaSpec, 可选) – 文本边界框的阴影透明度值。(默认: 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, 可选) – 文本边界框的线条透明度值。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• xs (NumberSpec, 可选) – 所有线条的x坐标，以“列表的列表”形式给出。(默认: Field(field=’xs’, transform=Unspecified, units=Unspecified))

• ys (NumberSpec, 可选) – 所有线条的y坐标，以“列表的列表”形式给出。(默认: Field(field=’ys’, transform=Unspecified, units=Unspecified))

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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 glyphs到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图形到这个图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle (AngleSpec) – 以弧度为单位旋转n边形的角度。当值为零时，顶点直接绘制在中心坐标的上方。（默认值：0）

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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-gons的额外hatch值。(默认值: {})

• 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-gons的线条虚线值。(默认: [])

• line_dash_offset (IntSpec) – n边形的虚线偏移值。（默认值：0）

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

• line_width (NumberSpec, 可选) – n边形的线宽值。（默认值：1）

• n (NumberSpec, 可选) – n边形的边数。小于三的值将导致不绘制任何图形实例。(默认: 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)), optional) –

  测量n边形半径的维度。

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

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

• radius_units (NotSerialized(Enum(SpatialUnits)), 可选) – 用于关联属性的单位：屏幕或数据（默认：'data'）

• syncable (Bool, 可选) –

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

  注意

  将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍将正常工作。（默认值：True）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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发生变化时触发。

Parameters:

• attr (str) – 此对象上的一个属性名称

• *callbacks (callable) – 要注册的回调函数

Returns:

无

示例

widget.on_change('value', callback1, callback2, ..., callback_n)

on_event(event: str | type[Event], *callbacks: Callable[[Event], None] | Callable[[], None]) → None

当此模型上发生指定事件时运行回调

并非所有模型都支持所有事件。 有关哪些模型能够触发特定事件的更多信息，请参见bokeh.events中的具体事件。

classmethod parameters() → list[Parameter]

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

Returns:

列表(参数)

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字形到此图表。

Parameters:

• x (NumberSpec, 可选) –

  补丁点的x坐标。

  注意

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

• y (NumberSpec, 可选) –

  补丁点的y坐标。

  注意

  一个补丁可能由多个多边形组成。在这种情况下，每个多边形的y坐标应在序列中用NaN值分隔。（默认值：Field(field=’y’, transform=Unspecified, units=Unspecified)）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

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

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• fill_alpha (Alpha, 可选) – 用于填充补丁的透明度值。(默认值: 1.0)

• fill_color (Nullable(Color), 可选) – 补丁的填充颜色值。（默认：'gray'）

• hatch_alpha (Alpha, 可选) – 用于补丁的阴影透明度值。(默认: 1.0)

• hatch_color (Nullable(Color), 可选) – 用于补丁的阴影颜色值。（默认值：'black'）

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

• hatch_pattern (Nullable(String)) – 用于补丁的填充图案值。

• hatch_scale (Size, 可选) – 用于补丁的hatch scale值。(默认值: 12.0)

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

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

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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, 可选) – 用于补丁的hatch scale值。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

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

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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中。

Returns:

属性名称

classmethod properties_with_refs() → dict[str, Property[Any]]

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

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

Returns:

具有引用的属性名称

Return type:

set[str]

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

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

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

不可序列化的属性将被跳过，属性值以“序列化”格式呈现，这可能与您通常从属性中读取的值略有不同；此方法的目的是返回无损重构对象实例所需的信息。

Parameters:

include_defaults (bool, optional) – 是否包含自对象创建以来未明确设置的属性。（默认值：True）

Returns:

从属性名称到其值的映射

Return type:

dict

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字形到此图中。

Parameters:

• left (NumberSpec, 可选) – 左边界的x坐标。(默认: Field(field=’left’, transform=Unspecified, units=Unspecified))

• right (NumberSpec, 可选) – 右边界的x坐标。(默认: Field(field=’right’, transform=Unspecified, units=Unspecified))

• 顶部 (NumberSpec, 可选) – 顶部边缘的y坐标。(默认: Field(field=’top’, transform=Unspecified, units=Unspecified))

• 底部 (NumberSpec, 可选) – 底部边缘的 y 坐标。（默认值：Field(field=’bottom’, transform=Unspecified, units=Unspecified)）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

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

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

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

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

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

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

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

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

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

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

• y_range_name (str, optional) –

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

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

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

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

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

query_properties_with_values(query: Callable[[PropertyDescriptor[Any]], bool], *, include_defaults: bool = True, include_undefined: bool = False) → dict[str, Any]

使用谓词查询HasProps实例的属性值。

Parameters:

• query (callable) – 一个可调用对象，接受属性描述符并返回 True 或 False

• include_defaults (bool, optional) – 是否包含用户未明确设置的属性（默认值：True）

Returns:

属性名称和值的映射，用于匹配属性

Return type:

dict

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字形到此图中。

Parameters:

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

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

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

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

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

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

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

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

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图形到这个图表中。

Parameters:

• x (NumberSpec, 可选) – 矩形中心的x坐标。(默认: Field(field=’x’, transform=Unspecified, units=Unspecified))

• y (NumberSpec, 可选) – 矩形中心的y坐标。（默认值：Field(field=’y’, transform=Unspecified, units=Unspecified)）

• width (DistanceSpec, 可选) – 矩形的整体宽度。(默认: Field(field=’width’, transform=Unspecified, units=Unspecified))

• height (DistanceSpec, 可选) – 矩形的整体高度。(默认: Field(field=’height’, transform=Unspecified, units=Unspecified))

• angle (AngleSpec) – 矩形旋转的角度，从水平方向测量。（默认值：0.0）

• dilate (Bool) –

  是否始终以使矩形更大的方式舍入分数像素位置。

  如果像素舍入错误导致矩形之间出现间隙，而它们应该显示为齐平时，此设置可能有用。（默认值：False）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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: 工具) → None

从图中移除工具。

Parameters:

*tools (Tool) – 要从绘图中移除的工具

Returns:

无

row(row, gridplot)

返回此图是否位于GridPlot的给定行中。

Parameters:

• row (int) – 要测试的行的索引

• gridplot (GridPlot) – 要检查的GridPlot

Returns:

布尔

scatter(*args: Any, **kwargs: Any) → GlyphRenderer

创建给定x和y项的散点图。

Parameters:

• x (str 或 seq[float]) – 中心x坐标的值或字段名称

• y (str 或 seq[float]) – 中心 y 坐标的值或字段名称

• size (str 或 list[float]) – 屏幕单位中的大小值或字段名称

• marker (str, 或 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, ...)

注意

Scatter 标记在使用 WebGL 输出后端时，可能会以不同的顺序绘制多种标记类型。这是为了性能而做出的明确权衡。

segment(x0=Field(field='x0', transform=Unspecified, units=Unspecified), y0=Field(field='y0', transform=Unspecified, units=Unspecified), x1=Field(field='x1', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs)

配置并添加Segment字形到此图表。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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的查询字典作为 单个参数或作为关键字参数：

Parameters:

selector (JSON-like) – 一些示例文本

Keyword Arguments:

kwargs – 查询字典键/值作为关键字参数

此外，为了与Model.select兼容，可以将选择器字典作为selector关键字参数传递，在这种情况下，kwargs['selector']的值将用于查询。

为了方便，可以通过提供name字符串作为单一参数来进行仅针对名称的查询：

Parameters:

name (str) – 要查询的名称

也可以通过仅提供Model子类作为单一参数来进行类型查询：

Parameters:

type (Model) – 要查询的类型

Returns:

序列[模型]

示例

# 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

Returns:

模型

set_from_json(name: str, value: Any, *, setter: Setter | None = None) → None

从JSON设置此对象的属性值。

Parameters:

• name (str) – 要设置的属性名称

• value (JSON-value) – 要设置给属性的值

• setter (ClientSession 或 ServerSession 或 None, 可选) –

  这用于防止对Bokeh应用程序的“回旋镖”更新。

  在Bokeh服务器应用程序的上下文中，对属性的传入更新将使用正在执行更新的会话进行注释。该值通过更新触发的任何后续更改通知传播。会话可以将事件设置器与自身进行比较，并抑制源自自身的任何更新。

Returns:

无

set_select(selector: type[Model] | SelectorType, updates: dict[str, Any]) → None

使用指定的属性/值更新来更新与给定选择器匹配的对象。

Parameters:

• selector (类似JSON的)

• 更新 (dict)

Returns:

无

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.square_cross(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25],
                  color="#7FC97F",fill_color=None, line_width=2)

show(plot)

square_dot(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs)

配置并添加Scatter图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.square_x(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25],
              color="#FDAE6B",fill_color=None, line_width=2)

show(plot)

star(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), size=4, angle=0.0, *, angle_units='rad', decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, hit_dilation=1.0, line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs)

配置并添加Scatter图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图表。

Parameters:

• x (NumberSpec, 可选) – 步骤的x坐标。(默认: Field(field=’x’, transform=Unspecified, units=Unspecified))

• y (NumberSpec, 可选) – 步骤的y坐标。(默认值: Field(field=’y’, transform=Unspecified, units=Unspecified))

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.step(x=[1, 2, 3, 4, 5], y=[1, 2, 3, 2, 5], color="#FB8072")

show(plot)

subplot(*, x_source: Range | None = None, y_source: Range | None = None, x_scale: Scale | None = None, y_scale: Scale | None = None, x_target: Range, y_target: Range) → GlyphAPI

创建一个新的子坐标系并公开一个绘图API。

tex(x=Field(field='x', transform=Unspecified, units=Unspecified), y=Field(field='y', transform=Unspecified, units=Unspecified), text=Field(field='text', transform=Unspecified, units=Unspecified), angle=0, x_offset=0, y_offset=0, *, anchor=Value(value='auto', transform=Unspecified, units=Unspecified), angle_units='rad', background_fill_alpha=1.0, background_fill_color=None, background_hatch_alpha=1.0, background_hatch_color=None, background_hatch_extra={}, background_hatch_pattern=None, background_hatch_scale=12.0, background_hatch_weight=1.0, border_line_alpha=1.0, border_line_cap='butt', border_line_color=None, border_line_dash=[], border_line_dash_offset=0, border_line_join='bevel', border_line_width=1, border_radius=0, decorations=[], display='auto', macros={}, name=None, outline_shape='box', padding=0, syncable=True, tags=[], text_align='left', text_alpha=1.0, text_baseline='bottom', text_color='#444444', text_font=Value(value='helvetica', transform=Unspecified, units=Unspecified), text_font_size=Value(value='16px', transform=Unspecified, units=Unspecified), text_font_style='normal', text_line_height=1.2, text_outline_color=None, **kwargs)

配置并添加TeXGlyph字形到此图中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• anchor (DataSpec, 可选) –

  在此字形边界框内的位置，x 和 y 坐标将锚定到该位置。这可以是一个命名的锚点，如 top_left 或 center，或者是从左到右和从上到下的百分比，或者这些的组合，分别在宽度和高度上独立设置。如果设置为 auto，则锚点将由文本的 align 和 baseline 决定。

  注意

  此属性是实验性的，可能会随时更改。（默认值：Value(value=’auto’, transform=Unspecified, units=Unspecified)）

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充透明度值。(默认值: 1.0)

• background_fill_color (ColorSpec) – 文本边界框的填充颜色值。

• background_hatch_alpha (AlphaSpec, 可选) – 文本边界框的阴影透明度值。(默认: 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, 可选) – 文本边界框的线条透明度值。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• anchor (DataSpec, 可选) –

  在此字形边界框内的位置，x 和 y 坐标将锚定到该位置。这可以是一个命名的锚点，如 top_left 或 center，或者是从左到右和从上到下的百分比，或者这些的组合，分别在宽度和高度上独立设置。如果设置为 auto，则锚点将由文本的 align 和 baseline 决定。

  注意

  此属性是实验性的，可能会随时更改。（默认值：Value(value=’auto’, transform=Unspecified, units=Unspecified)）

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• background_fill_alpha (AlphaSpec, 可选) – 文本边界框的填充透明度值。(默认值: 1.0)

• background_fill_color (ColorSpec) – 文本边界框的填充颜色值。

• background_hatch_alpha (AlphaSpec, 可选) – 文本边界框的阴影透明度值。(默认: 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, 可选) – 文本边界框的线条透明度值。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

注意

文本相对于x、y坐标的位置和角度由对齐和基线文本属性指示。

themed_values() → dict[str, Any] | None

获取任何主题提供的覆盖。

结果以属性名称到值的字典形式返回，如果此实例没有主题覆盖任何值，则返回None。

Returns:

字典或无

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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

移除任何主题值并恢复默认设置。

Returns:

无

update(**kwargs: Any) → None

从给定的关键字参数更新对象的属性。

Returns:

无

示例

以下是等价的：

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字形到此图表。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置字形渲染器的所有字形。当需要更精细的控制时，请使用此属性。

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• fill_alpha (Alpha, 可选) – 垂直方向区域的填充透明度值。(默认: 1.0)

• fill_color (Nullable(Color), 可选) – 垂直方向区域的填充颜色值。(默认: ‘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, 可选) – 垂直方向区域的hatch scale值。(默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 垂直方向区域的hatch权重值。(默认值: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.varea(x=[1, 2, 3], y1=[0, 0, 0], y2=[1, 4, 2],
           fill_color="#99D594")

show(plot)

varea_stack(stackers, **kw)

生成多个VArea渲染器，用于从底部到顶部堆叠的层级。

Parameters:

stackers (seq[str]) –

一个数据源字段名称的列表，用于依次堆叠 y1 和 y1 varea 坐标。

此外，渲染器的 name 将被设置为每个连续的堆叠器的值（这对于特殊的悬停变量 $name 很有用）。

任何额外的关键字参数都会传递给每次对varea的调用。 如果关键字值是列表或元组，则每次调用将从序列中获取一个值。

Returns:

列表[GlyphRenderer]

示例

假设有一个名为 source 的 ColumnDataSource，其中包含列 2016 和 2017，那么以下对 varea_stack 的调用 将创建两个堆叠的 VArea 渲染器：

p.varea_stack(['2016', '2017'], x='x', color=['blue', 'red'], source=source)

这相当于以下两个单独的调用：

p.varea(y1=stack(),       y2=stack('2016'),         x='x', color='blue', source=source, name='2016')
p.varea(y1=stack('2016'), y2=stack('2016', '2017'), x='x', color='red',  source=source, name='2017')

varea_step(x=Field(field='x', transform=Unspecified, units=Unspecified), y1=Field(field='y1', transform=Unspecified, units=Unspecified), y2=Field(field='y2', transform=Unspecified, units=Unspecified), *, decorations=[], fill_alpha=1.0, fill_color='gray', hatch_alpha=1.0, hatch_color='black', hatch_extra={}, hatch_pattern=None, hatch_scale=12.0, hatch_weight=1.0, name=None, step_mode='before', syncable=True, tags=[], **kwargs)

配置并添加VAreaStep字形到此图中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置字形渲染器的所有字形。当需要更精细的控制时，请使用此属性。

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• fill_alpha (Alpha, 可选) – 垂直方向区域的填充透明度值。(默认: 1.0)

• fill_color (Nullable(Color), 可选) – 垂直方向区域的填充颜色值。(默认: ‘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, 可选) – 垂直方向区域的hatch scale值。(默认值: 12.0)

• hatch_weight (NumberSpec, 可选) – 垂直方向区域的hatch权重值。(默认值: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图表。

Parameters:

• x (NumberSpec, 可选) – 垂直条中心的x坐标。（默认值：Field(field=’x’, transform=Unspecified, units=Unspecified)）

• width (DistanceSpec, 可选) – 垂直条的宽度。（默认值：1）

• 顶部 (NumberSpec, 可选) – 顶部边缘的y坐标。(默认: Field(field=’top’, transform=Unspecified, units=Unspecified))

• 底部 (NumberSpec) – 底部边缘的 y 坐标。（默认值：0）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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, 可选) – 垂直条的hatch scale值。(默认: 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.vbar(x=[1, 2, 3], width=0.5, bottom=0, top=[1,2,3], color="#CAB2D6")

show(plot)

vbar_stack(stackers, **kw)

生成多个VBar渲染器，用于从底部到顶部堆叠的层级。

Parameters:

stackers (seq[str]) –

一个数据源字段名称的列表，用于依次堆叠left和right条形坐标。

此外，渲染器的name将被设置为每个连续堆叠器的值（这对于特殊的悬停变量$name非常有用）

任何额外的关键字参数都会传递给每次调用vbar。 如果关键字值是列表或元组，则每次调用将从序列中获取一个值。

Returns:

列表[GlyphRenderer]

示例

假设有一个名为 source 的 ColumnDataSource，其中包含列 2016 和 2017，那么以下对 vbar_stack 的调用 将创建两个堆叠的 VBar 渲染器：

p.vbar_stack(['2016', '2017'], x=10, width=0.9, color=['blue', 'red'], source=source)

这相当于以下两个单独的调用：

p.vbar(bottom=stack(),       top=stack('2016'),         x=10, width=0.9, color='blue', source=source, name='2016')
p.vbar(bottom=stack('2016'), top=stack('2016', '2017'), x=10, width=0.9, color='red',  source=source, name='2017')

vline_stack(stackers, **kw)

生成多个Line渲染器，用于垂直堆叠的线条。

Parameters:

stackers (seq[str]) – 一个数据源字段名称的列表，用于依次堆叠以生成 y 线坐标。

此外，渲染器的name将被设置为每个连续堆叠器的值（这对于特殊的悬停变量$name非常有用）

任何额外的关键字参数都会传递给每次对line的调用。 如果关键字值是列表或元组，则每次调用将从序列中获取一个值。

Returns:

列表[GlyphRenderer]

示例

假设有一个名为 source 的 ColumnDataSource，其中包含列 2016 和 2017，那么以下对 vline_stack 的调用，使用 y 坐标的堆叠器将创建两个堆叠的 Line 渲染器：

p.vline_stack(['2016', '2017'], x='x', color=['blue', 'red'], source=source)

这相当于以下两个单独的调用：

p.line(y=stack('2016'),         x='x', color='blue', source=source, name='2016')
p.line(y=stack('2016', '2017'), x='x', color='red',  source=source, name='2017')

vspan(x=Field(field='x', transform=Unspecified, units=Unspecified), *, decorations=[], line_alpha=1.0, line_cap='butt', line_color='black', line_dash=[], line_dash_offset=0, line_join='bevel', line_width=1, name=None, syncable=True, tags=[], **kwargs)

配置并添加VSpan字形到此图中。

Parameters:

• x (NumberSpec, 可选) – 跨度的x坐标。(默认: Field(field=’x’, transform=Unspecified, units=Unspecified))

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• x0 (NumberSpec, 可选) – 条带一侧的x坐标。(默认值: Field(field=’x0’, transform=Unspecified, units=Unspecified))

• x1 (NumberSpec, 可选) – 条带另一侧坐标的x坐标。(默认值: Field(field=’x1’, transform=Unspecified, units=Unspecified))

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• 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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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字形到此图中。

Parameters:

• 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)）

• 方向 (Enum(Direction), 可选) – 在起始角度和结束角度之间描边的方向。（默认值：'anticlock'）

• alpha (float, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• decorations (List) –

  一组字形装饰，例如箭头。

  使用 GlyphRenderer.add_decoration() 可以轻松设置字形渲染器的所有字形。当需要更精细的控制时，请使用此属性。

  注意

  装饰仅用于辅助字形的视觉外观，但它们不参与点击测试等。（默认值：[]）

• end_angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈数（默认：'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)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈数（默认：'弧度'）

• syncable (Bool, 可选) –

  指示当在网页浏览器中更新时，此模型是否应同步回Bokeh服务器。设置为False可能有助于减少网络流量，特别是在处理频繁更新的对象时，而我们不需要这些更新值。

  注意

  将此属性设置为False将阻止此对象上的任何on_change()回调触发。然而，任何JS端的回调仍将正常工作。（默认值：True）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

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图元到此图表中。

Parameters:

• 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, optional) –

  用于一次性设置所有alpha关键字参数的别名。（默认值：None）

  Alpha值必须在0（完全透明）和1（完全不透明）之间。

  任何明确设置的line_alpha等值将覆盖此设置。

• color (color, optional) –

  一次性设置所有颜色关键字参数的别名。（默认值：无）

  请参阅用户指南中的颜色属性以了解定义颜色的不同选项。

  任何明确设置的line_color等值将覆盖此设置。

• legend_field (str, optional) –

  指定该图形应通过在浏览器中分组生成多个图例条目。 此参数的值是数据源中用于分组的列的名称。

  分组是在JavaScript中执行的，同时Bokeh内容在浏览器中呈现。如果数据随后更新，图例将自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_group (str, optional) –

  指定通过在Python中分组，图例应生成多个条目。 此参数的值是数据源中应用于分组的列的名称。

  分组在Python中执行，在Bokeh输出发送到浏览器之前。如果数据随后更新，图例将不会自动重新分组。

  注意

  只能提供legend_field、legend_group或legend_label中的一个

• legend_label (str, optional) –

  指定该字形应在图例中生成一个单一的 基本图例标签。 图例条目将使用此处提供的确切文本进行标注。

  注意

  只能提供 legend_field、legend_group 或 legend_label 中的一个。

• muted (bool, optionall) –

  是否应将字形渲染为静音状态（默认值：False）

  为了使此功能有用，必须在返回的 GlyphRender 上配置一个 muted_glyph。这可以通过显式创建一个 Glyph 来使用，或者更简单地通过传递例如 muted_color 等参数到此字形函数来实现。

• name (str, optional) –

  一个可选的用户提供的名称，附加到渲染器上（默认值：None）

  Bokeh 不会以任何方式使用这个值，但它可能有助于在 Bokeh 文档中搜索以找到特定的模型。

• source (ColumnDataSource, optional) –

  用户提供的数据源。（默认值：None）

  如果未提供，Bokeh 将自动从坐标和其他作为字面列表或数组值传递的参数中构造一个内部的 ColumnDataSource，并使用默认的列名。

  如果提供了数据源，Bokeh 将使用该数据源来派生图形。在这种情况下，坐标或其他参数不能使用字面列表或数组。只允许使用单一固定值（例如 x=10）或数据源中的列名（例如 x="time"）。

• 视图 (CDSView, 可选) – 用于过滤数据源的视图。(默认值: None)

• visible (bool, optional) – 是否应渲染该字形。（默认值：True）

• x_range_name (str, optional) –

  用于映射x坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• y_range_name (str, optional) –

  用于映射y坐标的额外范围的名称。 (默认值: None)

  如果未提供，则将使用绘图的默认y_range进行坐标映射。

• level (RenderLevel, optional) – 指定此图标的渲染级别顺序。

Keyword Arguments:

• angle_units (NotSerialized(Enum(AngleUnits)), 可选) – 用于关联属性的单位：度、弧度、梯度或圈（默认：'弧度'）

• 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)

• hit_dilation (Size, 可选) – 用于扩展点击半径的因子，该半径定义了标记响应Hover和Tap工具交互的范围。（默认值：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）

• 标签 (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。有关详细信息，请参阅用户指南中的样式化图标部分。

Returns:

GlyphRenderer

示例

from bokeh.plotting import figure, show

plot = figure(width=300, height=300)
plot.y(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DE2D26")

show(plot)

property axis

可拆分的Axis对象列表。

property background

property coordinates

property document: Document | None

该模型附加到的Document（可以为None）

property grid

可拆分的Grid对象列表。

property hover

可展开的HoverTool对象列表。

property id: ID

property legend

可拆分的Legend对象列表。

property plot

property ref: Ref

property tools: list[工具]

property xaxis

用于x维度的Axis对象的可拆分列表。

property xgrid

用于x维度的Grid对象的可拆分列表。

property yaxis

用于y维度的Axis对象的可拆分列表。

property ygrid

用于y维度的Grid对象的可拆分列表。