HOWTO · Matplotlib
Wie man eine einzige Legende für alle Teilflächen in Matplotlib erstellt
Mit `fig.legend()` fügen Sie eine Legende zur gesamten Matplotlib-Figure hinzu. `ax.legend()` erstellt dagegen eine Legende für eine einzelne Axes. Wenn alle Subplots dieselben beschrifteten Datenreihen zeigen, können Sie die Handles und Labels einer Axes für die gemeinsame Legende wiederverwenden. Bei unterschiedlichen Datenreihen sammeln Sie die Handles und Labels jeder Axes und übergeben beide Listen an die Figure-Legende.
Auf dieser Seite
Mit fig.legend() fügen Sie eine Legende zur gesamten Matplotlib-Figure hinzu. Wenn alle Subplots dieselben beschrifteten Datenreihen zeigen, können Sie die Handles und Labels einer Axes wiederverwenden. Zeigen die Subplots unterschiedliche Datenreihen, sammeln Sie die Handles und Labels jeder Axes und übergeben beide Listen an die Figure-Legende. ax.legend() unterscheidet sich davon: Damit erstellen Sie eine Legende für eine einzelne Axes.
Die folgenden Beispiele erstellen Figures mit Matplotlib. Das erste gibt außerdem die Labels aus, die für die gemeinsame Legende gesammelt wurden.
Eine gemeinsame Figure-Legende erstellen, wenn die Subplots dieselben Labels verwenden
Wenn jeder Subplot dieselbe Datenreihe mit demselben Label darstellt, liefert bereits ein Subplot alle Einträge für eine gemeinsame Legende. Das folgende Beispiel verwendet zwei Messwerte mit unterschiedlichen Skalierungen; beide tragen das Label measurement. Da Label und Bedeutung übereinstimmen, genügt es, die Handles der ersten Axes zu verwenden. Fügen Sie die Legende zu fig hinzu, statt legend() für jede Axes aufzurufen. So erscheint sie nur einmal für die gesamte Figure.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
import matplotlib
matplotlib.use("Agg")
import logging
# Ignore only Matplotlib's benign cold-start cache notice; other diagnostics
# remain visible on stderr.
class _FontCacheNoticeFilter(logging.Filter):
def filter(self, record):
return "Matplotlib is building the font cache; this may take a moment." not in record.getMessage()
logging.getLogger("matplotlib.font_manager").addFilter(_FontCacheNoticeFilter())
import matplotlib.pyplot as plt
fig, axes = plt.subplots(2, 1, figsize=(6, 4))
x = [0, 1, 2]
for ax, scale in zip(axes, [1, 2]):
ax.plot(x, [scale * value for value in x], label="measurement")
handles, labels = axes[0].get_legend_handles_labels()
fig.legend(handles, labels, loc="upper center")
fig.tight_layout(rect=(0, 0, 1, 0.9))
print("Legend entries:", labels)
plt.show()
Legend entries: ['measurement']
get_legend_handles_labels() gibt zwei zusammengehörige Listen mit den beschrifteten Artists dieser Axes zurück. Der Ansatz mit gemeinsamen Labels ist knapp, berücksichtigt aber nur die Datenreihen auf der ausgewählten Axes. Hat ein anderer Subplot ein abweichendes Label oder eine andere Datenreihe, verwenden Sie den Ansatz für alle Axes im nächsten Abschnitt.
Handles und Labels aller Axes sammeln, wenn sich die Inhalte der Subplots unterscheiden
Enthalten verschiedene Subplots unterschiedlich beschriftete Linien, sammeln Sie die Handles und Labels jeder Axes in derselben Schleife. Die Einträge der beiden Listen gehören jeweils anhand ihrer Position zusammen: Ein Handle am Index i entspricht dem Label am Index i. Der folgende Code erzeugt zwei Legendeneinträge, einen für jede Linie.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt
fig, axes = plt.subplots(1, 2, figsize=(7, 3))
axes[0].plot([0, 1, 2], [0, 1, 4], label="quadratic")
axes[1].plot([0, 1, 2], [0, 1, 2], label="linear")
handles, labels = [], []
for ax in axes:
ax_handles, ax_labels = ax.get_legend_handles_labels()
handles.extend(ax_handles)
labels.extend(ax_labels)
fig.legend(handles, labels, loc="upper center", ncol=2)
fig.tight_layout(rect=(0, 0, 1, 0.88))
plt.show()
Dabei werden beschriftete Artists aus jeder Axes gesammelt. Deshalb können gleiche Labels mehrfach vorkommen. Beziehen sich wiederholte Einträge auf dasselbe Konzept, wählen Sie vor dem Aufruf von fig.legend() für jedes gewünschte Label einen Handle aus. Sollen Leserinnen und Leser die Datenreihen unterscheiden können, behalten Sie unterschiedliche Labels bei. Für eine Auswahl übergeben Sie nur die zugehörigen Handles und Labels; die Legende muss nicht jede gezeichnete Linie enthalten.
Die Figure-Legende positionieren und formatieren
Das Argument loc legt fest, welcher Punkt der Legende an ihrem Anker ausgerichtet wird. Mit fig.legend(..., loc="upper center") zentrieren Sie die Legende beispielsweise am oberen Rand der Figure. Für eine genaue Position verwenden Sie bbox_to_anchor. Bei einer Figure-Legende beziehen sich die Koordinaten auf die Figure. Der Aufruf fig.legend(handles, labels, loc="upper center", bbox_to_anchor=(0.5, 1.02)) platziert die Legende zum Beispiel knapp oberhalb des oberen Rands. Passen Sie die Ankerwerte an, um sie zu verschieben, und reservieren Sie mit fig.tight_layout(rect=(0, 0, 1, 0.9)) oder fig.subplots_adjust(top=0.82) Platz, damit die Legende keine Subplot-Inhalte verdeckt.
Für die Gestaltung der Legende stehen dieselben vertrauten Optionen wie bei anderen Matplotlib-Legenden zur Verfügung. Übergeben Sie beispielsweise fontsize=9, frameon=False oder facecolor="white" an fig.legend(), um Schriftgröße, Rahmen oder Hintergrund anzupassen. Wenn Sie eine Figure mit einer Legende außerhalb ihres Bereichs speichern, kann fig.savefig("plot.png", bbox_inches="tight") die äußere Legende in das gespeicherte Bild aufnehmen.
Häufige Fragen zu einer Figure-Legende
Worin unterscheiden sich ax.legend() und fig.legend()? ax.legend() gehört zu einer bestimmten Axes. fig.legend() gehört zur Figure und kann Einträge aus einer oder mehreren Axes zusammenführen.
Wie erstelle ich eine gemeinsame Legende, wenn alle Subplots dieselben Labels verwenden? Rufen Sie die Handles und Labels einer repräsentativen Axes ab und übergeben Sie sie an fig.legend(). Das funktioniert, wenn diese Axes dieselben beschrifteten Datenreihen wie die anderen Subplots enthält.
Wie nehme ich nur ausgewählte Linien auf? Stellen Sie die gewünschten Handles und Labels in zusammengehörigen Listen zusammen und übergeben Sie beide Listen an fig.legend(). Prüfen Sie bei wiederholten Labels, ob die Einträge dieselbe Datenreihe bezeichnen, bevor Sie Duplikate entfernen.
Wie verhindere ich, dass die Legende die Diagramme verdeckt? Platzieren Sie sie mit loc und bbox_to_anchor in einem Randbereich der Figure und reservieren Sie anschließend Platz im Subplot-Layout. Liegt die Legende außerhalb der Figure-Fläche, verwenden Sie beim Speichern einen engen Begrenzungsrahmen, damit sie nicht abgeschnitten wird.