Fonction legend() de Matplotlib


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ètreTypeDescription
locstr ou intPosition 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_anchortupleCoordonné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.
ncolintNombre 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.
fontsizeint ou strTaille de police de la légende, par ex. 10, 'small', 'large'
frameonboolIndique si le cadre de la légende doit être affiché, True par défaut
shadowboolIndique s'il faut ajouter un effet d'ombre
titlestrLe titre de la légende
facecolorcolorCouleur d'arrière-plan de la légende
edgecolorcolorCouleur du cadre de la légende
fancyboxboolIndique s'il faut utiliser un cadre arrondi, True par défaut
markerscalefloatL'échelle des marqueurs dans la légende par rapport aux marqueurs d'origine
handlelengthfloatLa longueur des lignes dans la légende

La légende n'affiche que les Artists qui ont lelabelparamè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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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.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)

# 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

import matplotlib.pyplot as plt

# 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.


Matplotlib 参考文档Documentation de référence de Matplotlib

Autres extensions