Fonction legend() de Matplotlib
Documentation de référence de Matplotlib
legend()Utilisé pour ajouter une légende à un graphique, aidant les lecteurs à identifier la signification de chaque courbe ou groupe de données.
Définition de fonction
matplotlib.pyplot.legend(*args, **kwargs) Axes.legend(*args, **kwargs) Figure.legend(*args, **kwargs)
Descriptions des paramètres courants
| Paramètre | Type | Description |
|---|---|---|
| loc | str ou int | Position de la légende : 'best' (automatique), 'upper right', 'upper left', 'lower left', 'lower right', 'right', 'center left', 'center right', 'lower center', 'upper center', 'center', 'outside' |
| bbox_to_anchor | tuple | Coordonnées d'ancrage de la légende, utilisées avec loc pour un positionnement précis. Par exemple, (1.05, 1) place la légende dans le coin supérieur droit à l'extérieur des Axes. |
| ncol | int | Nombre de colonnes de la légende, la valeur par défaut est 1. Lorsqu'il y a plusieurs entrées, elles sont affichées sur plusieurs colonnes. |
| fontsize | int ou str | Taille de police de la légende, par ex. 10, 'small', 'large' |
| frameon | bool | Indique si le cadre de la légende doit être affiché, True par défaut |
| shadow | bool | Indique s'il faut ajouter un effet d'ombre |
| title | str | Le titre de la légende |
| facecolor | color | Couleur d'arrière-plan de la légende |
| edgecolor | color | Couleur du cadre de la légende |
| fancybox | bool | Indique s'il faut utiliser un cadre arrondi, True par défaut |
| markerscale | float | L'échelle des marqueurs dans la légende par rapport aux marqueurs d'origine |
| handlelength | float | La longueur des lignes dans la légende |
La légende n'affiche que les Artists qui ont le
labelparamètre défini. Une pratique courante consiste à spécifier label directement dans les fonctions de tracé telles que plot(), scatter(), bar(), puis à appeler legend().
Exemples d'utilisation
Exemple 1 : Légende de base
Exemple
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(layout='constrained')
# Le label de chaque courbe entre automatiquement dans la légende
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) amorti')
ax.legend(loc='upper right') # Récupérer automatiquement toutes les étiquettes
ax.set_title('Légende de base')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
Exemple 2 : Légende en dehors du graphique + plusieurs colonnes
Exemple
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Tracer plusieurs courbes
for i in range(6):
ax.plot(x, np.sin(x + i * 0.5), label=f'sin(x + {i*0.5:.1f})')
# Placer la légende en dehors des axes, affichée sur deux colonnes
ax.legend(loc='upper left',
bbox_to_anchor=(1.02, 1), # Coin supérieur droit à l'extérieur
ncol=2, # Diviser en deux colonnes
title='Déphasage',
frameon=True,
fancybox=True,
shadow=True)
ax.set_title('Légende en dehors du graphique (ncol=2)')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
Exemple 3 : Entrées de légende personnalisées
Exemple
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)
# Spécifier manuellement les entrées de légende (non associées aux étiquettes du graphique)
blue_line = mpatches.Patch(color='blue', label='Onde sinusoïdale')
red_line = mpatches.Patch(color='red', label='Onde cosinusoïdale')
ax.legend(handles=[blue_line, red_line],
loc='upper right',
fontsize=11)
ax.set_title('Poignées de légende personnalisées')
ax.set_xlabel('x')
ax.grid(True, alpha=0.3)
plt.show()
Exemple 4 : Référence rapide des codes d'emplacement de légende
Exemple
# Afficher les positions correspondant à tous les codes 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='Ligne A')
ax.plot([0, 1], [1, 0], 'r--', label='Ligne B')
ax.legend(loc=loc, fontsize=8, title=f'loc="{loc}"')
ax.set_xticks([])
ax.set_yticks([])
fig.suptitle('Tous les emplacements de legend()', fontsize=14)
plt.show()
Questions fréquentes
La légende ne s'affiche pas ?
Vérifiez si la fonction de tracé dispose dulabelparamètre défini.
Assurez-vous d'avoir appelé lelegend()fonction.
Si certains artistes n'ont pas besoin d'apparaître dans la légende, définissez label sur une chaîne vide ou '_nolegend_'.
Comment modifier partiellement les styles de ligne dans la légende ?
Utiliserlegend.get_lines()pour récupérer les objets de ligne dans la légende et modifier leurs propriétés, ou utiliser lehandler_mapparamètre.
Autres extensions