matplotlib.pyplot.figlegend

matplotlib.pyplot.figlegend(*args, **kwargs)[source]

Размещение легенды на рисунке.

Возможные подписи:

figlegend()
figlegend(handles, labels)
figlegend(handles=handles)
figlegend(labels)

Эти подписи соответствуют различным способам использования этого метода:

1. Автоматическое определение элементов, отображаемых в легенде

Элементы, которые нужно добавить в легенду, автоматически определяются, если не передаются дополнительные аргументы.

В этом случае подписи берутся из объекта графика. Вы можете указать их при создании объекта или вызвав метод set_label() для объекта:

ax.plot([1, 2, 3], label='Inline label')
fig.figlegend()

или:

line, = ax.plot([1, 2, 3])
line.set_label('Label via method')
fig.figlegend()

Конкретные линии могут быть исключены из автоматического выбора элементов легенды, если подпись начинается с символа подчеркивания. Это значение по умолчанию для всех объектов графика, поэтому вызов Figure.legend без аргументов и без ручного задания меток не приведет к отрисовке легенды.

2. Явное указание объектов и меток в легенде

Для полного контроля над тем, какие объекты графика имеют запись в легенде, можно передать итерируемый объект объектов графика, за которым следует итерируемый объект меток легенды:

fig.figlegend([line1, line2, line3], ['label1', 'label2', 'label3'])

3. Явное указание объектов в легенде

Это аналогично пункту 2, но метки берутся из свойств меток объектов графика. Пример:

line1, = ax1.plot([1, 2, 3], label='label1')
line2, = ax2.plot([1, 2, 3], label='label2')
fig.figlegend(handles=[line1, line2])

4. Подпись существующих элементов графика

Не рекомендуется

Этот способ вызова не рекомендуется, так как связь между элементами графика и метками задается только по порядку и может легко быть ошибочно интерпретирована.

Чтобы создать легенду для всех объектов на всех осях, вызовите эту функцию с итерируемым объектом строк, по одной строке для каждого элемента легенды. Например:

fig, (ax1, ax2)  = plt.subplots(1, 2)
ax1.plot([1, 3, 5], color='blue')
ax2.plot([2, 4, 6], color='red')
fig.figlegend(['the blues', 'the reds'])

Параметры

handlesсписок Artist, необязательно

Список объектов графика (линии, области) для добавления в легенду. Используйте его вместе с labels, если вам нужен полный контроль над отображаемыми элементами в легенде и автоматический механизм, описанный выше, недостаточен.

Длина списков handles и labels должна быть одинаковой. В противном случае они усекаются до меньшей длины.

labelsсписок str, необязательно

Список меток, которые нужно отобразить рядом с объектами. Используйте его вместе с handles, если вам нужен полный контроль над отображаемыми элементами в легенде и автоматический механизм, описанный выше, недостаточен.

Возвращает

Legend

Другие параметры

locstr or pair of floats, default: rcParams["legend.loc"] (default: 'best') ('best' for axes, 'upper right' for figures)

Расположение легенды.

Строки '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', и каждое позиционное "строковое" значение также может быть задано как числовое значение:

Строковое значение позиции	Код позиции
'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

bbox_to_anchorBboxBase, 2-tuple, or 4-tuple of floats

Прямоугольник, используемый для позиционирования легенды в сочетании с loc. По умолчанию axes.bbox (если вызывается как метод для Axes.legend) или figure.bbox (если Figure.legend). Этот аргумент позволяет произвольное размещение легенды.

Координаты прямоугольника интерпретируются в системе координат, заданной bbox_transform, по умолчанию в координатах осей или рисунка, в зависимости от того, какой legend вызывается.

Если задан 4-кортеж или BboxBase, он задает прямоугольник (x, y, width, height) внутри которого размещается легенда. Чтобы поместить легенду в наилучшее положение в правом нижнем квадранте осей (или рисунка):

loc='best', bbox_to_anchor=(0.5, 0., 0.5, 0.5)

2-кортеж (x, y) помещает угол легенды, указанный loc в x, y. Например, чтобы поместить верхний правый угол легенды в центр осей (или рисунка) можно использовать следующие ключевые слова:

loc='upper right', bbox_to_anchor=(0.5, 0.5)

ncolint, default: 1

Количество столбцов в легенде.

propNone or matplotlib.font_manager.FontProperties or dict

Свойства шрифта легенды. Если None (по умолчанию), будут использоваться текущие matplotlib.rcParams.

fontsizeint or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

Размер шрифта легенды. Если значение числовое, размер будет абсолютным значением размера шрифта в пунктах. Строковые значения относительны к текущему размеру шрифта по умолчанию. Этот аргумент используется только если prop не указан.

labelcolorstr or list, default: rcParams["legend.labelcolor"] (default: 'None')

Цвет текста в легенде. Может быть строкой, обозначающей цвет (например, 'red'), или списком строк, обозначающих цвет. Цвет метки также может быть настроен для совпадения с цветом линии или маркера с помощью 'linecolor', 'markerfacecolor' (или 'mfc'), или 'markeredgecolor' (или 'mec').

Цвет метки может быть установлен глобально с помощью rcParams["legend.labelcolor"] (по умолчанию 'None'). Если None, используется rcParams["text.color"] (по умолчанию 'black').

numpointsint, default: rcParams["legend.numpoints"] (default: 1)

Количество точек маркера в легенде при создании записи легенды для Line2D (линии).

scatterpointsint, default: rcParams["legend.scatterpoints"] (default: 1)

Количество точек маркера в легенде при создании записи легенды для PathCollection (диаграммы рассеяния).

scatteryoffsetsiterable of floats, default: [0.375, 0.5, 0.3125]

Вертикальное смещение (относительно размера шрифта) для маркеров, созданных для записи легенды диаграммы рассеяния. 0.0 соответствует основанию текста легенды, а 1.0 - верху. Чтобы нарисовать все маркеры на одной высоте, установите значение в [0.5].

markerscalefloat, default: rcParams["legend.markerscale"] (default: 1.0)

Относительный размер маркеров легенды по сравнению с первоначально нарисованными.

markerfirstbool, default: True

Если True, маркер легенды помещается слева от метки легенды. Если False, маркер легенды помещается справа от метки легенды.

frameonbool, default: rcParams["legend.frameon"] (default: True)

Определяет, должна ли легенда быть нарисована на области (рамке).

fancyboxbool, default: rcParams["legend.fancybox"] (default: True)

Определяет, следует ли включить закругленные углы вокруг FancyBboxPatch, что формирует фон легенды.

shadowbool, default: rcParams["legend.shadow"] (default: False)

Определяет, должна ли быть отрисована тень за легендой.

framealphafloat, default: rcParams["legend.framealpha"] (default: 0.8)

Альфа-прозрачность фона легенды. Если shadow включен и framealpha равно None, значение по умолчанию игнорируется.

facecolor"inherit" or color, default: rcParams["legend.facecolor"] (default: 'inherit')

Цвет фона легенды. Если "inherit", используется rcParams["axes.facecolor"] (по умолчанию 'white').

edgecolor"inherit" or color, default: rcParams["legend.edgecolor"] (default: '0.8')

Цвет границы фона легенды. Если "inherit", используется rcParams["axes.edgecolor"] (по умолчанию 'black').

mode{"expand", None}

Если mode задано "expand", легенда будет горизонтально расширена, чтобы заполнить область осей (или bbox_to_anchor, если он определяет размер легенды).

bbox_transformNone or matplotlib.transforms.Transform

Преобразование для прямоугольной области (bbox_to_anchor). Для значения None (по умолчанию) используется преобразование осей transAxes.

titlestr or None

Заголовок легенды. По умолчанию заголовок отсутствует (None).

title_fontpropertiesNone or matplotlib.font_manager.FontProperties or dict

Свойства шрифта заголовка легенды. Если None (по умолчанию), используется аргумент title_fontsize, если он задан; если title_fontsize также None, используется текущий rcParams["legend.title_fontsize"] (по умолчанию None).

title_fontsizeint or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}, default: rcParams["legend.title_fontsize"] (default: None)

Размер шрифта заголовка легенды. Примечание: Этот аргумент нельзя использовать совместно с title_fontproperties. Если вы хотите задать размер шрифта вместе с другими свойствами шрифта, используйте параметр size в title_fontproperties.

borderpadfloat, default: rcParams["legend.borderpad"] (default: 0.4)

Доля отступа внутри рамки легенды, в единицах размера шрифта.

labelspacingfloat, default: rcParams["legend.labelspacing"] (default: 0.5)

Вертикальное расстояние между записями легенды, в единицах размера шрифта.

handlelengthfloat, default: rcParams["legend.handlelength"] (default: 2.0)

Длина элементов управления легенды, в единицах размера шрифта.

handleheightfloat, default: rcParams["legend.handleheight"] (default: 0.7)

Высота элементов управления легенды, в единицах размера шрифта.

handletextpadfloat, default: rcParams["legend.handletextpad"] (default: 0.8)

Отступ между маркерной меткой и текстом, в единицах размера шрифта.

borderaxespadfloat, default: rcParams["legend.borderaxespad"] (default: 0.5)

Отступ между осью и границей легенды, в единицах размера шрифта.

columnspacingfloat, default: rcParams["legend.columnspacing"] (default: 2.0)

Интервал между столбцами, в единицах размера шрифта.

handler_mapdict or None

Пользовательский словарь, сопоставляющий экземпляры или типы с обработчиком легенды. Этот handler_map обновляет стандартный словарь обработчиков по адресу matplotlib.legend.Legend.get_legend_handler_map.

См. также

Axes.legend

Примечания

Некоторые элементы управления не поддерживаются этой функцией. Подробнее см. Руководство по легендам.