Python中的 Matplotlib.axes.Axes.get_legend_handles_labels()方法

Matplotlib是一个Python中非常流行的绘图库，可以用于绘制各种类型的图像，例如条形图、折线图、散点图等等。在绘制这些图像时，经常需要添加图例来帮助读者理解图像的含义。在Matplotlib中，我们可以使用Axes.get_legend_handles_labels()方法来获取图例的标签和句柄。

方法的简介

Axes.get_legend_handles_labels()方法是Matplotlib.axes.Axes类中的一个方法，用于获取当前轴（Axes对象）上的所有艺术品的句柄和标签。在这里，艺术品指的是绘制的所有元素，例如线条、点、条形图、散点图等等，都可以被称作艺术品。

方法的参数

Axes.get_legend_handles_labels()方法没有任何参数，在执行这个方法时，会返回一个长度为2的元组，其中第一个元素是一个包含所有艺术品句柄的列表，第二个元素是一个包含与句柄对应的标签的列表。

方法的返回值

Axes.get_legend_handles_labels()方法的返回值是一个元组，其中第一个元素是所有艺术品句柄的列表，第二个元素是与每个句柄对应的标签的列表。

用以下代码片段可以获取句柄和标签列表：

handles, labels = ax.get_legend_handles_labels()

示例

以下是一个绘制折线图的Matplotlib代码示例，其中展示了如何使用Axes.get_legend_handles_labels()方法获取句柄和标签列表，然后将它们传递给legend()方法来绘制图例。

import matplotlib.pyplot as plt

# 随机生成一些数据
x = [1, 2, 3, 4, 5]
y1 = [1, 3, 5, 4, 2]
y2 = [2, 4, 5, 2, 1]

# 绘制两条折线
fig, ax = plt.subplots()
ax.plot(x, y1, 'r', label='Line 1')
ax.plot(x, y2, 'b', label='Line 2')

# 获取句柄和标签列表
handles, labels = ax.get_legend_handles_labels()

# 绘制图例
ax.legend(handles, labels, loc='upper right')

# 显示图像
plt.show()

输出的结果如下：

在上面的例子中，我们先使用plot()方法绘制了两条折线，然后使用Axes.get_legend_handles_labels()方法获得了每个艺术品对应的句柄和标签列表。最后，我们调用legend()方法来绘制图例，并指定handles参数和labels参数。

总结

Axes.get_legend_handles_labels()方法是Matplotlib库中非常实用的一个方法，能够返回当前轴（Axes对象）上所有艺术品的句柄和标签。通过了解该方法的返回值和使用方式，我们可以更好地绘制图像，并添加适当的图例以帮助读者理解我们所呈现的数据。