matplotlib.legend#

Das Modul legend definiert die Klasse Legend, die für das Zeichnen von Legenden verantwortlich ist, die mit Achsen und/oder Figuren verknüpft sind.

Wichtig

Es ist unwahrscheinlich, dass Sie jemals manuell eine Legend-Instanz erstellen würden. Die meisten Benutzer erstellen eine Legende normalerweise über die Funktion legend. Weitere Details zu Legenden finden Sie auch in einem Leitfaden zur Legende.

Die Klasse Legend ist ein Container für Legendengriffe und Legendentexte.

Die Legendenhandler-Zuordnung gibt an, wie Legendengriffe aus Künstlern (Linien, Flächen usw.) in den Achsen oder Figuren erstellt werden. Standardmäßige Legendenhandler sind im Modul legend_handler definiert. Obwohl nicht alle Künstlertypen von den standardmäßigen Legendenhandlern abgedeckt werden, können benutzerdefinierte Legendenhandler definiert werden, um beliebige Objekte zu unterstützen.

Siehe :ref:`<legend_guide>` für weitere Informationen.

class matplotlib.legend.DraggableLegend(legend, use_blit=False, update='loc')[Quelle]#

Basen: DraggableOffsetBox

Wrapper um eine Legend, um Mausziehen zu ermöglichen.

Parameter:
legendLegend

Die zu wrappende Legend-Instanz.

use_blitbool, optional

Verwendet Blitting für schnellere Bildkomposition. Details finden Sie unter FuncAnimation.

update{'loc', 'bbox'}, optional

Wenn "loc", wird der Parameter loc der Legende beim Finalisieren aktualisiert. Wenn "bbox", wird der Parameter bbox_to_anchor aktualisiert.

finalize_offset()[Quelle]#
class matplotlib.legend.Legend(parent, handles, labels, *, loc=None, numpoints=None, markerscale=None, markerfirst=True, reverse=False, scatterpoints=None, scatteryoffsets=None, prop=None, fontsize=None, labelcolor=None, borderpad=None, labelspacing=None, handlelength=None, handleheight=None, handletextpad=None, borderaxespad=None, columnspacing=None, ncols=1, mode=None, fancybox=None, shadow=None, title=None, title_fontsize=None, framealpha=None, edgecolor=None, facecolor=None, bbox_to_anchor=None, bbox_transform=None, frameon=None, handler_map=None, title_fontproperties=None, alignment='center', ncol=1, draggable=False)[Quelle]#

Bases: Artist

Platziert eine Legende in der Figur/Achse.

Parameter:
parentAxes oder Figure

Der Künstler, der die Legende enthält.

handlesListe von (Artist oder Tupel von Artist)

Eine Liste von Künstlern (Linien, Flächen), die zur Legende hinzugefügt werden sollen.

labelslist of str

Eine Liste von Beschriftungen, die neben den Künstlern angezeigt werden sollen. Die Anzahl der Handles und Beschriftungen sollte gleich sein. Wenn sie nicht gleich sind, werden sie auf die Länge der kürzeren Liste gekürzt.

Attribute:
legend_handles

Liste von Artist-Objekten, die als Legendereinträge hinzugefügt wurden.

Hinzugefügt in Version 3.7.

Andere Parameter:
locstr oder Paar von Floats, Standard: rcParams["legend.loc"] (Standard: 'best') für Achsen, 'upper right' für Figur

Die Position der Legende.

Die Zeichenketten 'upper left', 'upper right', 'lower left', 'lower right' platzieren die Legende in der entsprechenden Ecke der Achse/Figur.

Die Zeichenketten 'upper center', 'lower center', 'center left', 'center right' platzieren die Legende in der Mitte des entsprechenden Randes der Achse/Figur.

Die Zeichenkette 'center' platziert die Legende in der Mitte der Achse/Figur.

Die Zeichenkette 'best' platziert die Legende an der Position, unter den neun bisher definierten Positionen, mit der geringsten Überlappung mit anderen gezeichneten Künstlern. Diese Option kann bei Plots mit großen Datenmengen sehr langsam sein; Ihre Plotgeschwindigkeit kann davon profitieren, wenn Sie eine spezifische Position angeben.

Die Position kann auch ein 2-Tupel sein, das die Koordinaten der unteren linken Ecke der Legende in Achsen-/Figurenkoordinaten angibt (in diesem Fall wird bbox_to_anchor ignoriert).

Zur Abwärtskompatibilität kann 'center right' (aber keine andere Position) auch als 'right' geschrieben werden, und jede "Zeichenketten"-Position kann auch als numerischer Wert angegeben werden.

Positionszeichenkette

Positions-Code

'best' (nur Achsen)

0

'oben rechts'

1

'oben links'

2

'unten links'

3

'unten rechts'

4

'rechts'

5

'links mitte'

6

'rechts mitte'

7

'unten mitte'

8

'oben mitte'

9

'mitte'

10

Wenn eine Figur den „constrained layout“-Manager verwendet, können die Zeichenkettencodes des Schlüsselwortarguments loc durch das Präfix 'outside' ein besseres Layout-Verhalten erzielen. An den Ecken gibt es Mehrdeutigkeiten, sodass 'outside upper right' Platz für die Legende oberhalb des restlichen Achsenbereichs im Layout schafft und 'outside right upper' Platz auf der rechten Seite des Layouts schafft. Zusätzlich zu den für loc aufgeführten Werten gibt es 'outside right upper', 'outside right lower', 'outside left upper' und 'outside left lower'. Weitere Details finden Sie im Leitfaden zur Legende.

bbox_to_anchorBboxBase, 2-Tupel oder 4-Tupel von Floats

Box, die zur Positionierung der Legende in Verbindung mit loc verwendet wird. Standardmäßig axes.bbox (wenn als Methode von Axes.legend aufgerufen) oder figure.bbox (wenn figure.legend). Dieses Argument ermöglicht eine beliebige Platzierung der Legende.

Bbox-Koordinaten werden im durch *bbox_transform* gegebenen Koordinatensystem interpretiert, wobei die Standardtransformation die Achsen- oder Figure-Koordinaten sind, je nachdem, welche legend aufgerufen wird.

Wenn ein 4-Tupel oder ein BboxBase angegeben wird, gibt es die Bbox (x, y, width, height) an, in der die Legende platziert wird. Um die Legende an der besten Position im unteren rechten Quadranten der Achse (oder Figur) zu platzieren.

loc='best', bbox_to_anchor=(0.5, 0., 0.5, 0.5)

Ein 2-Tupel (x, y) platziert die Ecke der Legende, die durch *loc* angegeben wird, bei x, y. Zum Beispiel, um die obere rechte Ecke der Legende in der Mitte der Achse (oder Figur) zu platzieren, können die folgenden Schlüsselwörter verwendet werden:

loc='upper right', bbox_to_anchor=(0.5, 0.5)
ncolsint, default: 1

Die Anzahl der Spalten, die die Legende hat.

Zur Abwärtskompatibilität wird auch die Schreibweise *ncol* unterstützt, diese wird jedoch nicht empfohlen. Wenn beide angegeben sind, hat *ncols* Vorrang.

propNone oder FontProperties oder dict

Die Font-Eigenschaften der Legende. Wenn None (Standard), werden die aktuellen matplotlib.rcParams verwendet.

fontsizeint oder {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

Die Schriftgröße der Legende. Wenn der Wert numerisch ist, ist die Größe die absolute Schriftgröße in Punkten. Zeichenkettenwerte sind relativ zur aktuellen Standard-Schriftgröße. Dieses Argument wird nur verwendet, wenn *prop* nicht angegeben ist.

labelcolorstr oder list, Standard: rcParams["legend.labelcolor"] (Standard: 'None')

Die Farbe des Textes in der Legende. Entweder eine gültige Farbsymbolkette (z. B. 'red') oder eine Liste von Farbsymbolketten. Die *labelcolor* kann auch so eingestellt werden, dass sie mit der Farbe der Linie oder des Markers übereinstimmt, indem 'linecolor', 'markerfacecolor' (oder 'mfc') oder 'markeredgecolor' (oder 'mec') verwendet wird.

Labelcolor kann global über rcParams["legend.labelcolor"] (Standard: 'None') gesetzt werden. Wenn None, wird rcParams["text.color"] (Standard: 'black') verwendet.

numpointsint, Standard: rcParams["legend.numpoints"] (Standard: 1)

Die Anzahl der Markierungspunkte in der Legende beim Erstellen eines Legendereintrags für ein Line2D (Linie).

scatterpointsint, Standard: rcParams["legend.scatterpoints"] (Standard: 1)

Die Anzahl der Markierungspunkte in der Legende beim Erstellen eines Legendereintrags für eine PathCollection (Streudiagramm).

scatteryoffsetsiterierbares Objekt von Floats, Standard: [0.375, 0.5, 0.3125]

Der vertikale Versatz (relativ zur Schriftgröße) für die Marker, die für einen Legenden-Eintrag eines Streudiagramms erstellt werden. 0.0 ist an der Basis des Legendentextes, und 1.0 ist an der Oberseite. Um alle Marker auf derselben Höhe zu zeichnen, setzen Sie dies auf [0.5].

markerscalefloat, Standard: rcParams["legend.markerscale"] (Standard: 1.0)

Die relative Größe von Legenden-Markern im Vergleich zu den ursprünglich gezeichneten.

markerfirstbool, Standard: True

Wenn *True*, wird der Legenden-Marker links vom Legenden-Bezeichner platziert. Wenn *False*, wird der Legenden-Marker rechts vom Legenden-Bezeichner platziert.

reversebool, Standard: False

Wenn *True*, werden die Legenden-Bezeichner in umgekehrter Reihenfolge zur Eingabe angezeigt. Wenn *False*, werden die Legenden-Bezeichner in derselben Reihenfolge wie die Eingabe angezeigt.

Hinzugefügt in Version 3.7.

frameonbool, Standard: rcParams["legend.frameon"] (Standard: True)

Gibt an, ob die Legende auf einem Patch (Rahmen) gezeichnet werden soll.

fancyboxbool, Standard: rcParams["legend.fancybox"] (Standard: True)

Ob abgerundete Ecken um den FancyBboxPatch, der den Hintergrund der Legende bildet, aktiviert werden sollen.

shadowNone, bool oder dict, Standard: rcParams["legend.shadow"] (Standard: False)

Ob ein Schatten hinter der Legende gezeichnet werden soll. Der Schatten kann mit Patch-Schlüsselwörtern konfiguriert werden. Benutzerdefinierte Einstellungen über rcParams["legend.shadow"] (Standard: False) werden derzeit nicht unterstützt.

framealphafloat, Standard: rcParams["legend.framealpha"] (Standard: 0.8)

Die Alpha-Transparenz des Legenden-Hintergrunds. Wenn *shadow* aktiviert ist und *framealpha* None ist, wird der Standardwert ignoriert.

facecolor"inherit" oder Farbe, Standard: rcParams["legend.facecolor"] (Standard: 'inherit')

Die Hintergrundfarbe der Legende. Wenn "inherit", wird rcParams["axes.facecolor"] (Standard: 'white') verwendet.

edgecolor"inherit" oder Farbe, Standard: rcParams["legend.edgecolor"] (Standard: '0.8')

Die Randfarbe der Hintergrundfläche der Legende. Wenn "inherit", wird rcParams["axes.edgecolor"] (Standard: 'black') verwendet.

mode{"expand", None}

Wenn *mode* auf "expand" gesetzt ist, wird die Legende horizontal erweitert, um den Achsenbereich (oder *bbox_to_anchor*, falls dieser die Größe der Legende bestimmt) auszufüllen.

bbox_transformNone oder Transform

Die Transformation für die Bounding Box (*bbox_to_anchor*). Für einen Wert von None (Standard) wird die transAxes-Transformation der Achse verwendet.

titlestr oder None

Der Titel der Legende. Standard ist kein Titel (None).

title_fontpropertiesNone oder FontProperties oder dict

Die Font-Eigenschaften des Legendentitels. Wenn None (Standard), wird das Argument title_fontsize verwendet, wenn es vorhanden ist; wenn auch title_fontsize None ist, wird die aktuelle rcParams["legend.title_fontsize"] (Standard: None) verwendet.

title_fontsizeint oder {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}, Standard: rcParams["legend.title_fontsize"] (Standard: None)

Die Schriftgröße des Legendentitels. Hinweis: Dies kann nicht mit *title_fontproperties* kombiniert werden. Wenn Sie die Schriftgröße zusammen mit anderen Schrifteigenschaften festlegen möchten, verwenden Sie den Parameter *size* in *title_fontproperties*.

alignment{'center', 'left', 'right'}, Standard: 'center'

Die Ausrichtung des Legendentitels und der Box der Einträge. Die Einträge werden als einzelner Block ausgerichtet, sodass die Marker immer aufgereiht sind.

borderpadfloat, Standard: rcParams["legend.borderpad"] (Standard: 0.4)

Der Bruchteil des Leerraums innerhalb des Legendenrahmens, in Schriftgrößen-Einheiten.

labelspacingfloat, Standard: rcParams["legend.labelspacing"] (Standard: 0.5)

Der vertikale Abstand zwischen den Legenden-Einträgen, in Schriftgrößen-Einheiten.

handlelengthfloat, Standard: rcParams["legend.handlelength"] (Standard: 2.0)

Die Länge der Legenden-Handles, in Schriftgrößen-Einheiten.

handleheightfloat, Standard: rcParams["legend.handleheight"] (Standard: 0.7)

Die Höhe der Legenden-Handles, in Schriftgrößen-Einheiten.

handletextpadfloat, Standard: rcParams["legend.handletextpad"] (Standard: 0.8)

Der Abstand zwischen dem Legenden-Handle und dem Text, in Schriftgrößen-Einheiten.

borderaxespadfloat, Standard: rcParams["legend.borderaxespad"] (Standard: 0.5)

Der Abstand zwischen der Achse und dem Legenden-Rahmen, in Schriftgrößen-Einheiten.

columnspacingfloat, Standard: rcParams["legend.columnspacing"] (Standard: 2.0)

Der Abstand zwischen Spalten, in Schriftgrößen-Einheiten.

handler_mapdict oder None

Das benutzerdefinierte Wörterbuch, das Instanzen oder Typen einer Legendenhandler zuordnet. Diese handler_map aktualisiert die globale Handler-Zuordnung, die unter matplotlib.legend.Legend.get_legend_handler_map gefunden wird.

draggablebool, Standard: False

Gibt an, ob die Legende per Maus verschoben werden kann.

codes = {'best': 0, 'center': 10, 'center left': 6, 'center right': 7, 'lower center': 8, 'lower left': 3, 'lower right': 4, 'right': 5, 'upper center': 9, 'upper left': 2, 'upper right': 1}#
contains(mouseevent)[Quelle]#

Testet, ob der Künstler das Mausereignis enthält.

Parameter:
mouseeventMouseEvent
Gibt zurück:
containsbool

Gibt an, ob Werte innerhalb des Radius liegen.

detailsdict

Ein Künstler-spezifisches Wörterbuch mit Details zum Ereigniskontext, wie z. B. welche Punkte sich im Auswahlradius befinden. Details finden Sie in den einzelnen Künstler-Unterklassen.

draw(renderer)[Quelle]#

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:
rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

draw_frame(b)[Quelle]#

Legt fest, ob die Hintergrundfläche der Legende gezeichnet wird.

Parameter:
bbool
get_alignment()[Quelle]#

Ruft den Ausrichtungswert der Legendenbox ab.

get_bbox_to_anchor()[Quelle]#

Gibt die Bbox zurück, an der die Legende verankert wird.

get_children()[Quelle]#

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

classmethod get_default_handler_map()[Quelle]#

Gibt die globale Standard-Handler-Zuordnung zurück, die von allen Legenden gemeinsam genutzt wird.

get_draggable()[Quelle]#

Gibt True zurück, wenn die Legende ziehbar ist, andernfalls False.

get_frame()[Quelle]#

Gibt das Rectangle zurück, das zum Einrahmen der Legende verwendet wird.

get_frame_on()[Quelle]#

Ruft ab, ob die Hintergrundfläche der Legende gezeichnet wird.

static get_legend_handler(legend_handler_map, orig_handle)[Quelle]#

Gibt einen Legendenhandler aus legend_handler_map zurück, der orig_handler entspricht.

legend_handler_map sollte ein Wörterbuchobjekt sein (das von der Methode get_legend_handler_map zurückgegeben wird).

Es wird zuerst geprüft, ob orig_handle selbst ein Schlüssel in der legend_handler_map ist und gibt den zugehörigen Wert zurück. Andernfalls wird jeder Klasse in ihrer Method Resolution Order geprüft. Wenn kein passender Schlüssel gefunden wird, gibt es None zurück.

get_legend_handler_map()[Quelle]#

Gibt die Handler-Zuordnung dieser Legendeninstanz zurück.

get_lines()[Quelle]#

Gibt die Liste der Line2Ds in der Legende zurück.

get_patches()[Quelle]#

Gibt die Liste der Patchs in der Legende zurück.

get_texts()[Quelle]#

Gibt die Liste der Texts in der Legende zurück.

get_tightbbox(renderer=None)[Quelle]#

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:
rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:
Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_title()[Quelle]#

Gibt die Text-Instanz für den Legendentitel zurück.

get_window_extent(renderer=None)[Quelle]#

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

set(*, agg_filter=<UNSET>, alignment=<UNSET>, alpha=<UNSET>, animated=<UNSET>, bbox_to_anchor=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, draggable=<UNSET>, frame_on=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, loc=<UNSET>, mouseover=<UNSET>, ncols=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, title=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[Quelle]#

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft

Beschreibung

agg_filter

eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt

alignment

{'center', 'left', 'right'}.

alpha

float oder None

animated

bool

bbox_to_anchor

BboxBase oder Tupel

clip_box

BboxBase oder None

clip_on

bool

clip_path

Patch oder (Path, Transform) oder None

draggable

bool

figure

Figure oder SubFigure

frame_on

bool

gid

str

in_layout

bool

label

object

loc

str oder Paar von Floats, Standard: rcParams["legend.loc"] (Standard: 'best') für Achsen, 'upper right' für Figur

mouseover

bool

ncols

unknown

path_effects

liste von AbstractPathEffect

picker

None oder bool oder float oder callable

rasterized

bool

sketch_params

(scale: float, length: float, randomness: float)

snap

bool oder None

title

str

transform

Transform

url

str

visible

bool

zorder

float

set_alignment(alignment)[Quelle]#

Setzt die Ausrichtung des Legendentitels und des Feldes von Einträgen.

Die Einträge werden als einzelner Block ausgerichtet, so dass Marker immer aufgereiht sind.

Parameter:
alignment{'center', 'left', 'right'}.
set_bbox_to_anchor(bbox, transform=None)[Quelle]#

Legt die Bbox fest, an der die Legende verankert wird.

Parameter:
bboxBboxBase oder Tupel

Die Begrenzungsbox kann auf folgende Arten spezifiziert werden:

  • Eine BboxBase-Instanz

  • Ein Tupel von (left, bottom, width, height) in der gegebenen Transformation (normalisierte Achsenkoordinate, wenn None)

  • Ein Tupel von (left, bottom), bei dem Breite und Höhe als null angenommen werden.

  • None, um die Bbox-Verankerung zu entfernen und die Eltern-Bbox zu verwenden.

transformTransform, optional

Eine Transformation, die auf die Begrenzungsbox angewendet werden soll. Wenn nicht angegeben, wird eine Transformation auf die Begrenzungsbox des Elternteils verwendet.

classmethod set_default_handler_map(handler_map)[Quelle]#

Legt die globale Standard-Handler-Map fest, die von allen Legenden gemeinsam genutzt wird.

set_draggable(state, use_blit=False, update='loc')[Quelle]#

Aktiviert oder deaktiviert die Maus-Drag-Unterstützung der Legende.

Parameter:
statebool

Ob das Ziehen mit der Maus aktiviert ist.

use_blitbool, optional

Verwendet Blitting für schnellere Bildkomposition. Details finden Sie unter FuncAnimation.

update{'loc', 'bbox'}, optional

Der Legendenparameter, der beim Ziehen geändert wird

  • 'loc': aktualisiert den loc-Parameter der Legende

  • 'bbox': aktualisiert den bbox_to_anchor-Parameter der Legende

Gibt zurück:
DraggableLegend oder None

Wenn state True ist, gibt dies die DraggableLegend-Hilfsinstanz zurück. Andernfalls gibt dies None zurück.

set_frame_on(b)[Quelle]#

Legt fest, ob die Hintergrundfläche der Legende gezeichnet wird.

Parameter:
bbool
set_loc(loc=None)[Quelle]#

Legt die Position der Legende fest.

Hinzugefügt in Version 3.8.

Parameter:
locstr oder Paar von Floats, Standard: rcParams["legend.loc"] (Standard: 'best') für Achsen, 'upper right' für Figur

Die Position der Legende.

Die Zeichenketten 'upper left', 'upper right', 'lower left', 'lower right' platzieren die Legende in der entsprechenden Ecke der Achse/Figur.

Die Zeichenketten 'upper center', 'lower center', 'center left', 'center right' platzieren die Legende in der Mitte des entsprechenden Randes der Achse/Figur.

Die Zeichenkette 'center' platziert die Legende in der Mitte der Achse/Figur.

Die Zeichenkette 'best' platziert die Legende an der Position, unter den neun bisher definierten Positionen, mit der geringsten Überlappung mit anderen gezeichneten Künstlern. Diese Option kann bei Plots mit großen Datenmengen sehr langsam sein; Ihre Plotgeschwindigkeit kann davon profitieren, wenn Sie eine spezifische Position angeben.

Die Position kann auch ein 2-Tupel sein, das die Koordinaten der unteren linken Ecke der Legende in Achsen-/Figurenkoordinaten angibt (in diesem Fall wird bbox_to_anchor ignoriert).

Zur Abwärtskompatibilität kann 'center right' (aber keine andere Position) auch als 'right' geschrieben werden, und jede "Zeichenketten"-Position kann auch als numerischer Wert angegeben werden.

Positionszeichenkette

Positions-Code

'best' (nur Achsen)

0

'oben rechts'

1

'oben links'

2

'unten links'

3

'unten rechts'

4

'rechts'

5

'links mitte'

6

'rechts mitte'

7

'unten mitte'

8

'oben mitte'

9

'mitte'

10

Wenn eine Figur den „constrained layout“-Manager verwendet, können die Zeichenkettencodes des Schlüsselwortarguments loc durch das Präfix 'outside' ein besseres Layout-Verhalten erzielen. An den Ecken gibt es Mehrdeutigkeiten, sodass 'outside upper right' Platz für die Legende oberhalb des restlichen Achsenbereichs im Layout schafft und 'outside right upper' Platz auf der rechten Seite des Layouts schafft. Zusätzlich zu den für loc aufgeführten Werten gibt es 'outside right upper', 'outside right lower', 'outside left upper' und 'outside left lower'. Weitere Details finden Sie im Leitfaden zur Legende.

set_ncols(ncols)[Quelle]#

Legt die Anzahl der Spalten fest.

set_title(title, prop=None)[Quelle]#

Legendentitel und Titelstil festlegen.

Parameter:
titlestr

Der Legendentitel.

propfont_manager.FontProperties oder str oder pathlib.Path

Die Font-Eigenschaften des Legendentitels. Wenn ein str, wird er als Fontconfig-Muster interpretiert, das von FontProperties geparst wird. Wenn ein pathlib.Path, wird er als absoluter Pfad zu einer Schriftdatei interpretiert.

classmethod update_default_handler_map(handler_map)[Quelle]#

Aktualisiert die globale Standard-Handler-Map, die von allen Legenden gemeinsam genutzt wird.

zorder = 5#