Matplotlib.figure.Figure.legend()

matplotlib.figure.Figure.legend()是Matplotlib图形对象（Figure对象）的一个方法，用于在图形上创建图例。图例是显示不同数据系列对应的标签和图形样式的部分，帮助读者更好地理解图形内容。

使用方法

首先，需要导入Matplotlib库：

import matplotlib.pyplot as plt

然后，创建一个Figure对象：

fig = plt.figure()

接下来，创建一个子图（axes）：

ax = fig.add_subplot(111)

可以在子图上绘制需要展示的数据：

ax.plot(x1, y1, label='数据系列1')
ax.plot(x2, y2, label='数据系列2')
ax.plot(x3, y3, label='数据系列3')

最后，使用.legend()方法创建图例：

ax.legend()

参数

.legend()方法可以传入多个参数，用于自定义图例的外观和位置。以下是一些常用参数：

• loc：指定图例的位置，可以是字符串或整数。常用的字符串取值包括 'best'、'upper right'、'upper left'、'lower right'、'lower left'，详情请参考官方文档。
• title：指定图例标题。
• fontsize：指定图例中文本的字体大小。
• shadow：是否显示图例的阴影效果。
• frameon：是否显示图例的边框。
• ncol：指定图例的列数。

返回值

该方法没有明确的返回值，但会在当前Figure对象上创建一个图例，显示不同数据系列对应的标签和样式。

示例

下面是一个完整的示例，展示如何使用.legend()方法：

import numpy as np
import matplotlib.pyplot as plt

# 生成示例数据
x = np.linspace(0, 2*np.pi, 100)
y1 = np.sin(x)
y2 = np.cos(x)

# 创建Figure对象和子图
fig = plt.figure()
ax = fig.add_subplot(111)

# 绘制数据系列
ax.plot(x, y1, label='sin(x)')
ax.plot(x, y2, label='cos(x)')

# 创建图例
ax.legend(loc='upper right', fontsize=12, title='Legend')

# 显示图形
plt.show()

以上代码将绘制两条曲线，并在图形上方右上角创建一个图例，显示'sin(x)'和'cos(x)'。

通过自定义参数，你可以调整图例的位置、样式和外观，以适应不同的显示需求。

结论

.legend()方法是Matplotlib中用于创建图例的重要工具，可以帮助你更好地展示数据，并提升图形的可读性和解释性。熟练掌握该方法的使用，将为你的数据可视化工作提供更多的灵活性和创造力。