Bokeh 在 Bokeh 中的自动图例放置

在本文中，我们将介绍 Bokeh 中的自动图例放置。Bokeh 是一个用于创建交互式可视化图表的 Python 库。它提供了多种图表类型和功能，使我们能够轻松地构建漂亮的可视化图形。

图例是可视化图表中很重要的一部分，它可以帮助观众理解图表中各部分的含义和对应关系。Bokeh 提供了自动图例放置功能，可以根据数据和图表的特点，自动将图例放置在合适的位置。

阅读更多：Bokeh 教程

使用例子

我们先来看一个简单的例子，假设我们有一个包含多个数据系列的线性图。每个数据系列代表了不同城市的温度变化。我们可以使用 Bokeh 来创建这个图表，并自动放置图例。

from bokeh.plotting import figure, show
from bokeh.models import Legend

# 创建一个包含多个数据系列的线性图
p = figure()

# 添加数据系列
p.line(x=[1, 2, 3, 4, 5], y=[10, 20, 15, 25, 30], legend_label="New York")
p.line(x=[1, 2, 3, 4, 5], y=[5, 10, 15, 20, 25], legend_label="San Francisco")
p.line(x=[1, 2, 3, 4, 5], y=[15, 25, 20, 10, 5], legend_label="London")

# 创建图例并自动放置
legend = Legend(items=[
    ("New York", [p.renderers[0]]),
    ("San Francisco", [p.renderers[1]]),
    ("London", [p.renderers[2]])
], location="top_right")

p.add_layout(legend, 'right')
show(p)

在上面的例子中，我们首先创建了一个空的图表，然后使用 line 方法添加了三个数据系列。每个数据系列都有一个 legend_label 参数，用于指定图例中的标签。

接下来，我们创建了一个 Legend 对象并将它与图表关联。我们将每个数据系列与对应的图例项进行了绑定，并指定了图例的位置为右上角。

最后，我们使用 show 函数展示了图表。

自动图例放置算法

Bokeh 的自动图例放置算法是基于一种启发式的方法，它会根据图表的内容和空间进行自适应的调整。

算法首先会根据图表中渲染器的个数和位置，计算出图例所需的空间大小和位置。然后，它会根据一些预定义的规则来决定最终的图例位置。

例如，在我们上面的例子中，如果我们将图例的位置从右上角改为左下角：

legend = Legend(items=[
    ("New York", [p.renderers[0]]),
    ("San Francisco", [p.renderers[1]]),
    ("London", [p.renderers[2]])
], location="bottom_left")

p.add_layout(legend, 'right')

这时，Bokeh 的自动图例放置算法会自动调整图例的位置，将其放置在左下角。

自定义图例放置

除了自动图例放置功能，Bokeh 还提供了一些方法来手动控制图例的位置。

在上面的例子中，我们使用了location 参数来指定图例的位置。除了location参数，还可以使用offset 参数来调整图例相对于给定位置的偏移。

例如，我们可以将图例的位置设置为顶部中间，并向下偏移20像素：

legend = Legend(items=[
    ("New York", [p.renderers[0]]),
    ("San Francisco", [p.renderers[1]]),
    ("London", [p.renderers[2]])
], location="top_center", offset=(0, 20))

p.add_layout(legend, 'right')

使用offset参数，可以根据实际需求对图例的位置进行微调。