1. Description de plt.legend() matplotlib
La fonction plt.legend() est une méthode de la bibliothèque Matplotlib en Python, et elle est utilisée pour ajouter une légende à un graphique créé avec Matplotlib. La légende est un élément essentiel d'un graphique lorsque vous avez plusieurs séries de données ou des éléments différents dans le graphique, car elle permet de distinguer ces éléments en leur attribuant des labels explicites.
2. Syntaxe de la méthode legend() matplotlib
Voici la syntaxe générale de la fonction plt.legend() et de ses principaux paramètres :
plt.legend(handles, labels, loc='best', title=None, ...other parameters...)
- handles : C'est une liste d'objets représentant les éléments que vous souhaitez inclure dans la légende. Il peut s'agir de lignes, de marqueurs, de barres d'erreur, etc. Vous spécifiez généralement ces objets lorsque vous créez le graphique. Par exemple, si vous tracez une ligne avec plt.plot(), l'objet renvoyé peut être utilisé comme handle pour cette ligne.
- labels : C'est une liste de chaînes de caractères correspondant aux labels que vous souhaitez attribuer à chaque élément dans la légende. L'ordre des labels doit correspondre à l'ordre des handles. Si vous ne spécifiez pas cette option, Matplotlib essaiera d'utiliser les labels définis pour les éléments lors de leur création.
- loc (optionnel) : Cette option spécifie l'emplacement de la légende dans le graphique. Vous pouvez la définir avec des chaînes de caractères ou des codes numériques. Par exemple, "best" (par défaut) permet à Matplotlib de choisir automatiquement la meilleure position pour la légende, mais vous pouvez également utiliser des valeurs comme "upper right", "lower left", "center" ou des codes numériques (par exemple, 1 pour le coin supérieur droit).
- title (optionnel) : Vous pouvez spécifier un titre pour la légende en utilisant cette option. Le titre apparaîtra en haut de la légende.
D'autres paramètres sont également disponibles pour personnaliser la légende, tels que la taille de police (fontsize), la couleur de fond (facecolor), la transparence (alpha), etc.
3. Exemples d'usages de la méthode plt.legend()
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
import matplotlib.pyplot as plt # Création d'un graphique avec deux séries de données et des labels x = [1, 2, 3, 4] y1 = [5, 4, 7, 3] y2 = [6, 3, 4, 2] plt.plot(x, y1, label='Série 1') plt.plot(x, y2, label='Série 2') # Ajout de la légende plt.legend() # Affichage du graphique plt.show() """ plt.legend() ajoute une légende au graphique pour les deux séries de données avec les labels spécifiés. La légende est placée au meilleur emplacement automatiquement, mais vous pouvez personnaliser son emplacement en utilisant l'option loc. """ |
Younes Derfoufi
CRMEF OUJDA