matplotlib之pyplot模块之图例（legend）基础（legend()的调用方式，图例外观设置）

matplotlib可以为可见对象（Artist，比如线条、形状）添加图例（legend）。官方建议使用pyplot模块的legend函数简便的创建图例，而不是使用底层的matplotlib.legend类构造图例。

函数签名为matplotlib.pyplot.legend(*args, **kwargs)

legend()基本应用演示

使用图例的基础有两个：

• handles：可见对象（Artist，比如线条、形状）序列，与labels配合使用。
• labels：类型为字符串列表，即图例中显示的文本集合。

两者的长度最好一致，否则按照长度最小的进行截断。

调用方式有三种：

• legend()：根据可见对象和标签自动构造图例。
• legend(labels)：自动匹配可见对象和labels，官方不建议使用这种方式，因为可见对象和标签的对应关系并不明确！
• legend(handles, labels)：指定可见对象和标签的对应关系。

案例

演示legend函数的三种调用方式。

import matplotlib.pyplot as plt

plt.figure(figsize=(13,4))
plt.subplot(131)
# legend()调用方式
plt.plot([1, 1],label='1')
plt.plot([2, 2],label='2')
plt.legend()
plt.subplot(132)
# legend(labels)调用方式
plt.plot([1, 1])
plt.plot([2, 2])
plt.legend(['1','2'])
plt.subplot(133)
# legend(handles, labels)调用方式
# 注意plot函数返回的为Line2D对象列表
line1, = plt.plot([1, 1])
line2, = plt.plot([2, 2])
print(type(line1))
plt.legend((line1,line2),['1st','2nd'])
plt.show()

legend()其他参数

• loc：图例显示的位置，类型为浮点数或字符串，默认值为rcParams["legend.loc"] ( 'best')。浮点数和字符串之间具有以下对应关系：

  位置字符串	位置编码
  ‘best’	0
  ‘upper right’	1
  ‘upper left’	2
  ‘lower left’	3
  ‘lower right’	4
  ‘right’	5
  ‘center left’	6
  ‘center right’	7
  ‘lower center’	8
  ‘upper center’	9
  ‘center’	10

• ncol：图例显示的列数。类型为整数，默认值为1。
• prop：字体属性。None或matplotlib.font_manager.FontProperties或字典。默认为None,使用rcParmas中字体相关设置。
• fontsize：标签字体大小。整数或{'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}。只有设置了prop参数，fontsize属性才生效。
• labelcolor：标签颜色。字符串或字符串列表，可以为颜色格式或'linecolor'， 'markerfacecolor' ('mfc')，'markeredgecolor' ( 'mec')。
• numpoints：图例中标记点的个数。类型为整数，默认值为rcParams["legend.numpoints"] (1)。适用于折线图Line2D对象。
• scatterpoints：图例中标记点的个数。类型为整数，默认值为rcParams["legend.scatterpoints"] (1)。适用于散点图。
• markerfirst：图表标记是否在左侧。类型为布尔值，默认值为True。
• markerscale：图例标记的缩放比例。类型为浮点数，默认值为rcParams["legend.markerscale"] (1.0)。
• frameon：图例区域是否有边框。类型为布尔值。默认值为：rcParams["legend.frameon"] (True)。
• fancybox：图例区域矩形是否为圆角。类型为布尔值。默认值为：rcParams["legend.fancybox"] ( True)。
• shadow：图例区域是否有阴影。类型为布尔值。默认值为：rcParams["legend.shadow"] ( False)。
• title：图例标题。类型为字符串或None，默认值为None，即没有图例标题。
• title_fontsize：标题字体大小。整数或{'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}。默认值为rcParams["legend.title_fontsize"] (None)。
• facecolor：图例区域背景色。"inherit"或 色彩值，默认值为rcParams["legend.facecolor"] ('inherit')。如果使用"inherit"，使用rcParams["axes.facecolor"] ( 'white')。
• edgecolor：图例区域边缘颜色。"inherit"或 色彩值，默认值为rcParams["legend.edgecolor"] ('0.8')。如果使用"inherit"，使用rcParams["axes.edgecolor"] ('black')。
• borderpad：图例边框填充距离。浮点值，单位为字体大小单位。默认值为rcParams["legend.borderpad"] (0.4)。
• labelspacing：图例条目之间的垂直距离。浮点值，单位为字体大小单位。默认值为rcParams["legend.labelspacing"] ( 0.5)。
• handlelength：图例标记的长度。浮点值，单位为字体大小单位。默认值为rcParams["legend.handlelength"] (2.0)。
• handletextpad：图例标记和标签的距离。浮点值，单位为字体大小单位。默认值为rcParams["legend.handletextpad"] ( 0.8)。
• borderaxespad：图例与子图边缘之间的填充距离。浮点值，单位为字体大小单位。默认值为rcParams["legend.borderaxespad"] (0.5)。
• columnspacing：图例列间距。浮点值，单位为字体大小单位。默认值为 rcParams["legend.columnspacing"] (2.0)。

图例相关rcParams参数：

#legend.loc:           best
#legend.frameon:       True     # if True, draw the legend on a background patch
#legend.framealpha:    0.8      # legend patch transparency
#legend.facecolor:     inherit  # inherit from axes.facecolor; or color spec
#legend.edgecolor:     0.8      # background patch boundary color
#legend.fancybox:      True     # if True, use a rounded box for the
                                # legend background, else a rectangle
#legend.shadow:        False    # if True, give background a shadow effect
#legend.numpoints:     1        # the number of marker points in the legend line
#legend.scatterpoints: 1        # number of scatter points
#legend.markerscale:   1.0      # the relative size of legend markers vs. original
#legend.fontsize:      medium
#legend.title_fontsize: None    # None sets to the same as the default axes.

## Dimensions as fraction of fontsize:
#legend.borderpad:     0.4  # border whitespace
#legend.labelspacing:  0.5  # the vertical space between the legend entries
#legend.handlelength:  2.0  # the length of the legend lines
#legend.handleheight:  0.7  # the height of the legend handle
#legend.handletextpad: 0.8  # the space between the legend line and legend text
#legend.borderaxespad: 0.5  # the border between the axes and legend edge
#legend.columnspacing: 2.0  # column separation

案例：图例外观设置

对比自定义图例外观与默认图例外观。
左图设置了以下图例外观：标题为’legends’（默认为空），图例显示为2列（默认为1列），标签显示在左边（默认为左侧），图例标记点显示为2个（默认为1个），图例区域矩形为直角（默认为圆角），图例背景色为灰色，图例边缘为红色，图例显示阴影（默认无）。

import matplotlib.pyplot as plt

line1, = plt.plot([1, 1], marker='o')
line2, = plt.plot([2, 2])
plt.legend((line1, line2), ['1st', '2nd'], loc=0,
           title='legends', ncol=2, markerfirst=False,
           numpoints=2, frameon=True, fancybox=True,
           facecolor='gray', edgecolor='r', shadow=True)
plt.show()