Función Matplotlib legend()
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ámetro | Tipo | Descripción |
|---|---|---|
| loc | str o int | Posició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_anchor | tuple | Coordenadas 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. |
| ncol | int | Número de columnas de la leyenda, el valor predeterminado es 1. Cuando hay varias entradas, se muestran en varias columnas. |
| fontsize | int o str | Tamaño de fuente de la leyenda, como 10, 'small', 'large' |
| frameon | bool | Si se muestra el borde de la leyenda, el valor predeterminado es True |
| shadow | bool | Si se agrega un efecto de sombra |
| title | str | El título de la leyenda |
| facecolor | color | Color de fondo de la leyenda |
| edgecolor | color | Color del borde de la leyenda |
| fancybox | bool | Si se usa un borde redondeado, el valor predeterminado es True |
| markerscale | float | Escala de los marcadores en la leyenda en relación con los marcadores originales |
| handlelength | float | Longitud de las líneas en la leyenda |
La leyenda solo muestra los Artist que tienen configurado el parámetro
labellabel. 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 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 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.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
# 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.
Otras extensiones