Matplotlib 图例

图例指南

在Matplotlib中灵活地生成图例。

本图例指南是对可用文档的扩展 legend()-请在继续阅读本指南之前，确保您熟悉该文档的内容。

本指南使用了一些常用术语，为清楚起见，在此处进行了记录：

图例条目

图例由一个或多个图例条目组成。一项仅由一个键和一个标签组成。

图例键

每个图例标签左侧的彩色/图案标记。

图例标签

描述键代表的句柄的文本。

图例手柄

用于在图例中生成适当条目的原始对象。

控制图例条目

legend()不带参数的调用会自动获取图例句柄及其关联的标签。此功能等效于：

 

 为了完全控制向图例添加的内容，通常将适当的句柄直接传递给legend()：

 

 

创建专门用于添加图例的艺术家（aka代理艺术家）

并非所有句柄都可以自动转换为图例条目，因此通常有必要创建一个可以使用的艺术家。要使用图例或轴，图例手柄不必存在。

假设我们要创建一个图例，该图例具有一些用红色表示的数据条目：

 

 

 有许多受支持的图例句柄，我们可以创建带有标记的线来代替创建颜色补丁：

 

 

图例位置

图例的位置可以通过关键字loc来指定 。该bbox_to_anchor关键字给出了手动图例位置的控制有很大程度。

例如，如果您希望轴图例位于图形的右上角而不是轴的角，则只需指定角的位置以及该位置的坐标系即可：

 

 自定义图例放置的更多示例：

 

 

同一轴上的多个图例¶

有时，将图例条目拆分为多个图例更为清晰。尽管执行此操作的本能方法可能是legend()多次调用该函数，但您会发现轴上仅存在一个图例。

这样做是为了可以legend()重复调用以将图例更新为轴上的最新句柄，因此要保留旧的图例实例，我们必须将它们手动添加到轴上：

 

 

图例处理程序

下面的示例演示了将两个图例键彼此叠加的方法：