HOWTO · Matplotlib

Comment spécifier la position de la légende dans les coordonnées du graphique dans Matplotlib

Cet article vous montre comment spécifier la position de la légende dans un graphique dans Matplotlib.

Sur cette page

Pour positionner une légende Matplotlib, définissez son paramètre loc sur une position standard, comme "upper left" ou "lower right". Pour la placer à des coordonnées précises, combinez loc et bbox_to_anchor : bbox_to_anchor fournit les coordonnées d’ancrage, et loc choisit le point de la légende qui s’aligne sur cet ancrage. La valeur par défaut de borderaxespad ajoute un petit espace ; le point visible de la légende peut donc être légèrement décalé par rapport aux coordonnées. Définissez borderaxespad=0 pour obtenir un alignement exact.

Exemples : positionner une légende Matplotlib avec loc et bbox_to_anchor

L’exemple suivant crée deux axes et ajoute une légende à chacun. Il utilise best sur le premier axe et lower left sur le second. Vous pouvez modifier ces valeurs pour comparer différentes positions standard avec vos propres données. Les figures montrent les tracés obtenus ; le code indique quels paramètres adapter.

import matplotlib.pyplot as plt

x = [1, 2, 3]
y1 = [0.5 * i + 1 for i in x]
y2 = [2 * i + 1 for i in x]

fig, ax = plt.subplots(2, 1)

ax[0].plot(x, y1, "b-", label="0.5x+1")
ax[0].plot(x, y2, "g-", label="2x+1")
ax[0].legend(loc="best")

ax[1].plot(x, y1, "b-", label="0.5x+1")
ax[1].plot(x, y2, "g-", label="2x+1")
ax[1].legend(loc="lower left")

plt.tight_layout()
plt.show()

Specify Legend position in graph coordinates Matplotlib

Le paramètre loc accepte notamment les valeurs suivantes : best, upper right, upper left, lower left, lower right, right, center left, center right, lower center, upper center et center :

best
upper right
upper left
lower left
lower right
right
center left
center right
lower center
upper center
center

Pour une position standard, loc place la légende dans ses axes. Avec la valeur best, Matplotlib choisit une position en fonction du contenu du tracé ; les valeurs nommées, comme lower left, vous permettent de choisir directement l’emplacement. Si la légende recouvre une ligne ou un marqueur important, essayez une autre valeur de la liste. Ces positions situent la légende par rapport à ses axes, et non à l’ensemble de la figure.

Pour un placement par coordonnées, bbox_to_anchor fournit les coordonnées d’ancrage et loc détermine quel point de la légende s’aligne sur cet ancrage. Dans l’exemple suivant, chaque ancrage est défini par rapport à ses propres axes. Le marqueur rouge est dessiné aux mêmes coordonnées avec ax.transAxes, ce qui permet de repérer facilement l’ancrage. Les deux axes utilisent des valeurs loc différentes pour montrer comment le point d’alignement de la légende change. Avec la valeur par défaut de borderaxespad, la légende reste légèrement à l’écart de chaque marqueur ; celui-ci indique toujours les coordonnées de l’ancrage.

import matplotlib.pyplot as plt

x = [1, 2, 3]
y1 = [0.5 * i + 1 for i in x]
y2 = [2 * i + 1 for i in x]

fig, ax = plt.subplots(2, 1)

ax[0].plot(x, y1, "b-", label="Plot-1")
ax[0].plot(x, y2, "g-", label="Plot-2")
ax[0].legend(loc="upper left", bbox_to_anchor=(0.9, 0.75))
ax[0].scatter((0.9), (0.75), s=70, c="red", transform=ax[0].transAxes)

ax[1].plot(x, y1, "b-", label="Plot-1")
ax[1].plot(x, y2, "g-", label="Plot-2")
ax[1].legend(loc="center right", bbox_to_anchor=(0.6, 0.4))
ax[1].scatter((0.6), (0.4), s=70, c="red", transform=ax[1].transAxes)

plt.tight_layout()
plt.show()

Set bbox_to_anchor to specify Legend position in graph coordinates Matplotlib

Sur l’axe du haut, bbox_to_anchor=(0.9, 0.75) place l’ancrage au niveau du marqueur rouge. Comme loc="upper left", le coin supérieur gauche de la légende s’aligne sur cet ancrage, avec un léger espace visible dû à la valeur par défaut de borderaxespad. Sur l’axe du bas, l’ancrage se trouve en (0.6, 0.4) et loc="center right" : le point central droit de la légende s’aligne donc sur le marqueur rouge inférieur, avec le même effet d’espacement. Pour faire coïncider exactement le point choisi avec son marqueur, ajoutez borderaxespad=0 à l’appel legend de l’axe concerné.

Pour adapter l’un ou l’autre de ces placements, choisissez d’abord une coordonnée x et une coordonnée y par rapport à l’axe concerné, puis définissez le tuple bbox_to_anchor correspondant et marquez ce point pendant que vous ajustez le tracé. Choisissez une valeur loc pour le point de la légende que vous souhaitez aligner sur cet emplacement. Les deux paramètres fonctionnent ensemble : modifier uniquement l’ancrage déplace le point sélectionné, tandis que modifier loc change le point de la légende aligné sur l’ancrage. Associez la transformation de chaque marqueur aux mêmes axes que ceux de sa légende afin que le repère visuel utilise le même système de coordonnées. Conservez la valeur par défaut de borderaxespad pour garder un petit espace, ou définissez borderaxespad=0 dans l’appel legend pour aligner exactement la légende sur le marqueur. Aucun résultat dans la console n’est présenté ; les figures ci-dessus montrent les tracés obtenus.