Función Matplotlib legend()


Matplotlib 参考文档Documentación de referencia de Matplotlib

legend()Se utiliza para agregar una leyenda al gráfico, ayudando al lector a identificar el significado de cada curva o grupo de datos.

Definición de la función

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

Descripción de los parámetros comunes

ParámetroTipoDescripción
locstr o intPosición de la leyenda: 'best' (automático), 'upper right', 'upper left', 'lower left', 'lower right', 'right', 'center left', 'center right', 'lower center', 'upper center', 'center', 'outside' (exterior)
bbox_to_anchortupleCoordenadas del punto de anclaje de la leyenda, que se combinan con loc para una posición precisa. Por ejemplo, (1.05, 1) coloca la leyenda en la esquina superior derecha fuera de los Axes.
ncolintNúmero de columnas de la leyenda, el valor predeterminado es 1. Cuando hay varias entradas, se muestran en varias columnas.
fontsizeint o strTamaño de fuente de la leyenda, como 10, 'small', 'large'
frameonboolSi se muestra el borde de la leyenda, el valor predeterminado es True
shadowboolSi se agrega un efecto de sombra
titlestrEl título de la leyenda
facecolorcolorColor de fondo de la leyenda
edgecolorcolorColor del borde de la leyenda
fancyboxboolSi se usa un borde redondeado, el valor predeterminado es True
markerscalefloatEscala de los marcadores en la leyenda en relación con los marcadores originales
handlelengthfloatLongitud de las líneas en la leyenda

La leyenda solo muestra los Artist que tienen configurado el parámetrolabellabel. La práctica común es especificar directamente label en funciones de trazado como plot(), scatter(), bar(), y luego llamar a legend().


Ejemplos de uso

Ejemplo 1: Leyenda básica

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)

fig, ax = plt.subplots(layout='constrained')

# El label de cada curva se agrega automáticamente a la leyenda
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='damped sin(x)')

ax.legend(loc='upper right')  # Recopila automáticamente todos los labels
ax.set_title('Basic Legend')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 2: Leyenda fuera del gráfico + múltiples columnas

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

# Dibujar múltiples curvas
for i in range(6):
    ax.plot(x, np.sin(x + i * 0.5), label=f'sin(x + {i*0.5:.1f})')

# La leyenda se coloca fuera de los Axes, se muestra en dos columnas
ax.legend(loc='upper left',
          bbox_to_anchor=(1.02, 1),   # Esquina superior derecha exterior
          ncol=2,                      # En dos columnas
          title='Phase Shift',
          frameon=True,
          fancybox=True,
          shadow=True)

ax.set_title('Legend Outside the Plot (ncol=2)')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 3: Personalizar entradas de leyenda

Ejemplo

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)

# Especificar manualmente las entradas de la leyenda (no asociadas con el label del gráfico)
blue_line = mpatches.Patch(color='blue', label='Sine Wave')
red_line = mpatches.Patch(color='red', label='Cosine Wave')

ax.legend(handles=[blue_line, red_line],
          loc='upper right',
          fontsize=11)

ax.set_title('Custom Legend Handles')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 4: Referencia rápida de códigos de posición de leyenda

Ejemplo

import matplotlib.pyplot as plt

# Muestra las posiciones correspondientes a todos los códigos 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='Line A')
    ax.plot([0, 1], [1, 0], 'r--', label='Line B')
    ax.legend(loc=loc, fontsize=8, title=f'loc="{loc}"')
    ax.set_xticks([])
    ax.set_yticks([])

fig.suptitle('All legend() Locations', fontsize=14)
plt.show()

Preguntas frecuentes

¿La leyenda no se muestra?

Verifique si la función de trazado tiene configurado el parámetrolabellabel.

Confirme que se ha llamado a la funciónlegend()legend().

Si algunos Artist no necesitan aparecer en la leyenda, establezca label como una cadena vacía o '_nolegend_'.

¿Cómo modificar parcialmente el estilo de línea en la leyenda?

Mediantelegend.get_lines()la obtención de los objetos de línea de la leyenda y la modificación de sus propiedades, o el uso del parámetrohandler_maplabel.


Matplotlib 参考文档Documentación de referencia de Matplotlib

Otras extensiones