Функция legend() в Matplotlib


Matplotlib 参考文档Справочная документация Matplotlib

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

Определение функции

matplotlib.pyplot.legend(*args, **kwargs)
Axes.legend(*args, **kwargs)
Figure.legend(*args, **kwargs)

Описание общих параметров

ПараметрTypeОписание
locstr или intПозиция легенды: 'best' (автоматически), 'upper right', 'upper left', 'lower left', 'lower right', 'right', 'center left', 'center right', 'lower center', 'upper center', 'center', 'outside'
bbox_to_anchortupleКоординаты привязки легенды, используются вместе с loc для точного позиционирования. Например, (1.05, 1) размещает легенду в правом верхнем углу за пределами Axes.
ncolintКоличество столбцов легенды, по умолчанию 1. Если записей несколько, они отображаются в нескольких столбцах.
fontsizeint или strРазмер шрифта легенды, например, 10, 'small', 'large'
frameonboolОтображать ли рамку легенды, по умолчанию True
shadowboolДобавлять ли эффект тени
titlestrЗаголовок легенды
facecolorcolorЦвет фона легенды
edgecolorcolorЦвет рамки легенды
fancyboxboolИспользовать ли скругленную рамку, по умолчанию True
markerscalefloatМасштаб маркеров в легенде относительно исходных маркеров
handlelengthfloatДлина линий в легенде

Легенда отображает только 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()

Пример 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()

Пример 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()

Пример 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()

Часто задаваемые вопросы

Легенда не отображается?

Проверьте, задан ли у функции построения графикаlabelпараметр.

Убедитесь, что вы вызвалиlegend()функцию.

Если некоторые Artists не должны появляться в легенде, задайте для label пустую строку или '_nolegend_'.

Как частично изменить стили линий в легенде?

Используйтеlegend.get_lines()чтобы получить объекты линий в легенде и изменить их свойства, или используйтеhandler_mapпараметра.


Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения