matplotlib.axes.Axes.legend#
- Axes.legend(*args, **kwargs)[源代码][源代码]#
在Axes上放置一个图例。
调用签名:
legend() legend(handles, labels) legend(handles=handles) legend(labels)
调用签名对应于以下不同的使用此方法的方式：
1. 自动检测需要在图例中显示的元素
当你不传入任何额外参数时，要添加到图例中的元素会自动确定。
在这种情况下，标签取自艺术家。您可以在创建艺术家时指定它们，或者通过调用艺术家的
set_label()方法来指定:ax.plot([1, 2, 3], label='Inline label') ax.legend()
或者:
line, = ax.plot([1, 2, 3]) line.set_label('Label via method') ax.legend()
备注
特定的艺术家可以通过使用以下划线“_”开头的标签来排除在自动图例元素选择之外。以下划线开头的字符串是所有艺术家的默认标签，因此在没有提供任何参数且未手动设置标签的情况下调用
Axes.legend将导致UserWarning并绘制一个空图例。2. 在图例中明确列出艺术家和标签
为了完全控制哪些艺术家有图例条目，可以分别传递一个图例艺术家可迭代对象和一个图例标签可迭代对象:
ax.legend([line1, line2, line3], ['label1', 'label2', 'label3'])
3. 在图例中显式列出艺术家
这与2类似，但标签取自艺术家的标签属性。例如:
line1, = ax.plot([1, 2, 3], label='label1') line2, = ax.plot([1, 2, 3], label='label2') ax.legend(handles=[line1, line2])
4. 标记现有绘图元素
不鼓励
不推荐使用此调用签名，因为绘图元素和标签之间的关系仅通过它们的顺序隐式表示，容易混淆。
要在 Axes 上为所有艺术家创建图例，请使用字符串的可迭代对象调用此函数，每个图例项对应一个字符串。例如:
ax.plot([1, 2, 3]) ax.plot([5, 6, 7]) ax.legend(['First line', 'Second line'])
- 参数:
- 返回:
- 其他参数:
- loc : str 或一对浮点数, 默认值:
rcParams["legend.loc"](default:'best')str 或一对浮点数，默认值： 图例的位置。
字符串
'upper left'、'upper right'、'lower left'、'lower right'将图例放置在坐标轴的相应角落。字符串
'upper center','lower center','center left','center right'将图例放置在轴的相应边缘的中心。字符串
'center'将图例放置在轴的中心。字符串
'best'将图例放置在九个定义位置中与其他绘制元素重叠最小的位置。对于包含大量数据的图表，此选项可能会相当慢；提供一个具体位置可能会提高绘图速度。位置也可以是一个2元组，给出图例左下角的坐标，以轴坐标表示（在这种情况下，*bbox_to_anchor*将被忽略）。
为了向后兼容，
'center right'``（但没有其他位置）也可以拼写为'right'``，并且每个“字符串”位置也可以用数值表示：位置字符串
位置代码
'最佳' (仅限轴)
0
'右上角'
toctree是一个 reStructuredText 指令 ，这是一个非常多功能的标记。指令可以有参数、选项和内容。'左上角'
2
'左下角'
3
'右下角'
4
'右'
5
'居中靠左'
6
'居中右'
7
'lower center'
8
'上中'
9
'center'
10
- bbox_to_anchor :
BboxBase, 2-tuple, 或 4-tuple 的浮点数BboxBase, 2-tuple, 或 4-tuple of floats 用于与 loc 一起定位图例的框。默认为
axes.bbox``（如果作为 `.Axes.legend` 的方法调用）或 ``figure.bbox``（如果 ``figure.legend）。此参数允许图例的任意放置。Bbox 坐标在由 bbox_transform 给出的坐标系中解释，默认转换为 Axes 或 Figure 坐标，具体取决于调用
legend的对象。如果给定一个 4 元组或
BboxBase，那么它指定图例放置的 bbox(x, y, width, height)。要将图例放置在 Axes（或图形）右下象限的最佳位置:loc='best', bbox_to_anchor=(0.5, 0., 0.5, 0.5)
一个 2 元组
(x, y)将由 loc 指定的图例角放置在 x, y 处。例如，要将图例的右上角放置在 Axes（或图形）的中心，可以使用以下关键字:loc='upper right', bbox_to_anchor=(0.5, 0.5)
- ncolsint, 默认值: 1
图例的列数。
为了向后兼容，拼写 ncol 也被支持，但不推荐使用。如果两者都给出，ncols 优先。
- prop : None 或
FontProperties或 dict无或 图例的字体属性。如果为 None（默认），将使用当前的
matplotlib.rcParams。- 字体大小int 或 {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
图例的字体大小。如果值是数字，则大小将是绝对字体大小（以点为单位）。字符串值相对于当前默认字体大小。仅当未指定 prop 时，此参数才被使用。
- labelcolor : str 或 list, 默认值:
rcParams["legend.labelcolor"](default:'None')str 或 list, 默认: 图例中文本的颜色。可以是有效的颜色字符串（例如，'red'），或颜色字符串的列表。labelcolor 也可以设置为与线条或标记的颜色相匹配，使用 'linecolor'、'markerfacecolor'（或 'mfc'），或 'markeredgecolor'（或 'mec'）。
标签颜色可以通过
rcParams["legend.labelcolor"](default:'None') 全局设置。如果为 None，则使用rcParams["text.color"](default:'black')。- numpoints : int, 默认值:
rcParams["legend.numpoints"](default:1)int, 默认值: 在为 `.Line2D`（线条）创建图例条目时，图例中的标记点数量。
- scatterpoints : int, 默认值:
rcParams["legend.scatterpoints"](default:1)int, 默认值: 为 `.PathCollection`（散点图）创建图例条目时图例中的标记点数量。
- scatteryoffsets : 浮点数可迭代对象, 默认值:
[0.375, 0.5, 0.3125]浮点数的可迭代对象，默认值： 散点图图例条目创建的标记的垂直偏移量（相对于字体大小）。0.0 在图例文本的底部，1.0 在顶部。要使所有标记在同一高度绘制，请设置为
[0.5]。- markerscale : float, 默认值:
rcParams["legend.markerscale"](default:1.0)浮点数，默认值： 图例标记相对于原始绘制标记的相对大小。
- markerfirstbool, 默认值: True
如果 True，图例标记放置在图例标签的左侧。如果 False，图例标记放置在图例标签的右侧。
- 反向bool, 默认值: False
如果 True，图例标签按输入的反序显示。如果 False，图例标签按输入的顺序显示。
Added in version 3.7.
- frameon : bool, 默认值:
rcParams["legend.frameon"](default:True)bool, 默认值: 图例是否应绘制在补丁（框架）上。
- fancybox : bool, 默认值:
rcParams["legend.fancybox"](default:True)bool, 默认值: 是否应在构成图例背景的
FancyBboxPatch周围启用圆角。- shadow : None, bool 或 dict, 默认值:
rcParams["legend.shadow"](default:False)None, bool 或 dict, 默认: 是否在图例后面绘制阴影。阴影可以使用
Patch关键字进行配置。目前不支持通过rcParams["legend.shadow"](default:False) 进行自定义。- framealpha : float, 默认值:
rcParams["legend.framealpha"](default:0.8)浮点数，默认值： 图例背景的透明度。如果 shadow 被激活且 framealpha 为
None，则默认值将被忽略。- facecolor : "inherit" 或颜色, 默认:
rcParams["legend.facecolor"](default:'inherit')“继承”或颜色，默认： 图例的背景颜色。如果为
"inherit"，则使用rcParams["axes.facecolor"](default:'white')。- edgecolor : "inherit" 或颜色, 默认值:
rcParams["legend.edgecolor"](default:'0.8')“继承”或颜色，默认： 图例背景补丁边缘颜色。如果为
"inherit"，则使用rcParams["axes.edgecolor"](default:'black')。- 模式
expand, None 如果 mode 设置为
"expand"，图例将会水平扩展以填充 Axes 区域（或者如果定义了 bbox_to_anchor ，则填充其定义的图例大小）。- bbox_transform : None 或
Transform无或 边界框的变换（bbox_to_anchor）。对于值 ``None``（默认），将使用 Axes 的
transAxes变换。- 标题str 或 None
图例的标题。默认无标题 (
None)。- title_fontproperties : None 或
FontProperties或 dict无或 图例标题的字体属性。如果为 None（默认），将使用 title_fontsize 参数（如果存在）；如果 title_fontsize 也为 None，将使用当前的
rcParams["legend.title_fontsize"](default:None)。- title_fontsize : int 或 {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}, 默认值:
rcParams["legend.title_fontsize"](default:None)int 或 {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}，默认值： 图例标题的字体大小。注意：这不能与 title_fontproperties 结合使用。如果你想在设置其他字体属性时设置字体大小，请在 title_fontproperties 中使用 size 参数。
- 对齐{'center', 'left', 'right'}, 默认: 'center'
图例标题和条目框的对齐方式。条目作为一个整体块对齐，因此标记总是对齐的。
- borderpad : float, 默认值:
rcParams["legend.borderpad"](default:0.4)浮点数，默认值： 图例边框内的分数空白，以字体大小为单位。
- labelspacing : float, 默认值:
rcParams["legend.labelspacing"](default:0.5)浮点数，默认值： 图例条目之间的垂直空间，以字体大小为单位。
- handlelength : float, 默认值:
rcParams["legend.handlelength"](default:2.0)浮点数，默认值： 图例句柄的长度，以字体大小单位表示。
- handleheight : float, 默认值:
rcParams["legend.handleheight"](default:0.7)浮点数，默认值： 图例句柄的高度，以字体大小单位表示。
- handletextpad : float, 默认值:
rcParams["legend.handletextpad"](default:0.8)浮点数，默认值： 图例句柄和文本之间的填充，以字体大小为单位。
- borderaxespad : 浮点数, 默认值:
rcParams["legend.borderaxespad"](default:0.5)浮点数，默认值： Axes 和图例边框之间的填充，以字体大小为单位。
- columnspacing : float, 默认值:
rcParams["legend.columnspacing"](default:2.0)浮点数，默认值： 列之间的间距，以字体大小为单位。
- handler_map字典 或 None
自定义字典，将实例或类型映射到图例处理器。这个 handler_map 更新了在
matplotlib.legend.Legend.get_legend_handler_map中找到的默认处理器映射。- 可拖动bool, 默认值: False
图例是否可以用鼠标拖动。
- loc : str 或一对浮点数, 默认值:
注释
此功能不支持某些艺术家。详情请参阅 图例指南。
示例
(
Source code,2x.png,png)
