Функция legend() в Matplotlib
Справочная документация Matplotlib
legend()Используется для добавления легенды на график, помогая читателям понять значение каждой кривой или группы данных.
Определение функции
matplotlib.pyplot.legend(*args, **kwargs) Axes.legend(*args, **kwargs) Figure.legend(*args, **kwargs)
Описание общих параметров
| Параметр | Type | Описание |
|---|---|---|
| loc | str или int | Позиция легенды: 'best' (автоматически), 'upper right', 'upper left', 'lower left', 'lower right', 'right', 'center left', 'center right', 'lower center', 'upper center', 'center', 'outside' |
| bbox_to_anchor | tuple | Координаты привязки легенды, используются вместе с loc для точного позиционирования. Например, (1.05, 1) размещает легенду в правом верхнем углу за пределами Axes. |
| ncol | int | Количество столбцов легенды, по умолчанию 1. Если записей несколько, они отображаются в нескольких столбцах. |
| fontsize | int или str | Размер шрифта легенды, например, 10, 'small', 'large' |
| frameon | bool | Отображать ли рамку легенды, по умолчанию True |
| shadow | bool | Добавлять ли эффект тени |
| title | str | Заголовок легенды |
| facecolor | color | Цвет фона легенды |
| edgecolor | color | Цвет рамки легенды |
| fancybox | bool | Использовать ли скругленную рамку, по умолчанию True |
| markerscale | float | Масштаб маркеров в легенде относительно исходных маркеров |
| handlelength | float | Длина линий в легенде |
Легенда отображает только Artists, у которых задан
labelпараметр. Обычно label указывают непосредственно в функциях построения графиков, таких как plot(), scatter(), bar(), а затем вызывают legend().
Примеры использования
Пример 1: Базовая легенда
Пример
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(layout='constrained')
# Метка каждой кривой автоматически попадает в легенду
ax.plot(x, np.sin(x), label='sin(x)')
ax.plot(x, np.cos(x), label='cos(x)')
ax.plot(x, np.sin(x) * np.exp(-x/3), label='затухающий sin(x)')
ax.legend(loc='upper right') # Автоматически собрать все метки
ax.set_title('Базовая легенда')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(layout='constrained')
# Метка каждой кривой автоматически попадает в легенду
ax.plot(x, np.sin(x), label='sin(x)')
ax.plot(x, np.cos(x), label='cos(x)')
ax.plot(x, np.sin(x) * np.exp(-x/3), label='затухающий sin(x)')
ax.legend(loc='upper right') # Автоматически собрать все метки
ax.set_title('Базовая легенда')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
Пример 2: легенда вне графика + несколько столбцов
Пример
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Нарисовать несколько кривых
for i in range(6):
ax.plot(x, np.sin(x + i * 0.5), label=f'sin(x + {i*0.5:.1f})')
# Разместить легенду вне осей, отображаемую в два столбца
ax.legend(loc='upper left',
bbox_to_anchor=(1.02, 1), # Верхний правый угол снаружи
ncol=2, # Разделить на два столбца
title='Фазовый сдвиг',
frameon=True,
fancybox=True,
shadow=True)
ax.set_title('Легенда вне графика (ncol=2)')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Нарисовать несколько кривых
for i in range(6):
ax.plot(x, np.sin(x + i * 0.5), label=f'sin(x + {i*0.5:.1f})')
# Разместить легенду вне осей, отображаемую в два столбца
ax.legend(loc='upper left',
bbox_to_anchor=(1.02, 1), # Верхний правый угол снаружи
ncol=2, # Разделить на два столбца
title='Фазовый сдвиг',
frameon=True,
fancybox=True,
shadow=True)
ax.set_title('Легенда вне графика (ncol=2)')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
Пример 3: Пользовательские элементы легенды
Пример
import matplotlib.pyplot as plt
import matplotlib.patches as mpatches
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(layout='constrained')
ax.plot(x, np.sin(x), 'b-', linewidth=2)
ax.plot(x, np.cos(x), 'r--', linewidth=2)
# Вручную задать элементы легенды (не связанные с метками графика)
blue_line = mpatches.Patch(color='blue', label='Синусоидальная волна')
red_line = mpatches.Patch(color='red', label='Косинусоидальная волна')
ax.legend(handles=[blue_line, red_line],
loc='upper right',
fontsize=11)
ax.set_title('Пользовательские элементы легенды')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
import matplotlib.patches as mpatches
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(layout='constrained')
ax.plot(x, np.sin(x), 'b-', linewidth=2)
ax.plot(x, np.cos(x), 'r--', linewidth=2)
# Вручную задать элементы легенды (не связанные с метками графика)
blue_line = mpatches.Patch(color='blue', label='Синусоидальная волна')
red_line = mpatches.Patch(color='red', label='Косинусоидальная волна')
ax.legend(handles=[blue_line, red_line],
loc='upper right',
fontsize=11)
ax.set_title('Пользовательские элементы легенды')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
Пример 4: Краткий справочник по кодам расположения легенды
Пример
import matplotlib.pyplot as plt
# Отобразить позиции, соответствующие всем кодам loc
locations = [
'upper left', 'upper right', 'lower left', 'lower right',
'center left', 'center right', 'lower center', 'upper center',
'center'
]
fig, axes = plt.subplots(3, 3, figsize=(10, 8),
layout='constrained')
axes = axes.flatten()
for ax, loc in zip(axes, locations):
ax.plot([0, 1], [0, 1], 'b-', label='Линия A')
ax.plot([0, 1], [1, 0], 'r--', label='Линия B')
ax.legend(loc=loc, fontsize=8, title=f'loc="{loc}"')
ax.set_xticks([])
ax.set_yticks([])
fig.suptitle('Все расположения legend()', fontsize=14)
plt.show()
# Отобразить позиции, соответствующие всем кодам loc
locations = [
'upper left', 'upper right', 'lower left', 'lower right',
'center left', 'center right', 'lower center', 'upper center',
'center'
]
fig, axes = plt.subplots(3, 3, figsize=(10, 8),
layout='constrained')
axes = axes.flatten()
for ax, loc in zip(axes, locations):
ax.plot([0, 1], [0, 1], 'b-', label='Линия A')
ax.plot([0, 1], [1, 0], 'r--', label='Линия B')
ax.legend(loc=loc, fontsize=8, title=f'loc="{loc}"')
ax.set_xticks([])
ax.set_yticks([])
fig.suptitle('Все расположения legend()', fontsize=14)
plt.show()
Часто задаваемые вопросы
Легенда не отображается?
Проверьте, задан ли у функции построения графикаlabelпараметр.
Убедитесь, что вы вызвалиlegend()функцию.
Если некоторые Artists не должны появляться в легенде, задайте для label пустую строку или '_nolegend_'.
Как частично изменить стили линий в легенде?
Используйтеlegend.get_lines()чтобы получить объекты линий в легенде и изменить их свойства, или используйтеhandler_mapпараметра.
Другие расширения