matplotlib.pyplot.figure#

matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, *, facecolor=None, edgecolor=None, frameon=True, FigureClass=<class 'matplotlib.figure.Figure'>, clear=False, **kwargs)[Quelle]#

Erstellt eine neue Abbildung oder aktiviert eine vorhandene Abbildung.

Parameter:

numint oder str oder Figure oder SubFigure, optional

Eine eindeutige Kennung für die Abbildung.

Wenn eine Abbildung mit dieser Kennung bereits existiert, wird diese Abbildung aktiviert und zurückgegeben. Eine Ganzzahl bezieht sich auf das Attribut Figure.number, ein String bezieht sich auf das Abbildungs-Label.

Wenn keine Abbildung mit der Kennung existiert oder num nicht angegeben ist, wird eine neue Abbildung erstellt, aktiviert und zurückgegeben. Wenn num eine Ganzzahl ist, wird sie für das Attribut Figure.number verwendet, andernfalls wird ein automatisch generierter Ganzzahlwert verwendet (beginnend bei 1 und inkrementiert für jede neue Abbildung). Wenn num ein String ist, werden das Abbildungs-Label und der Fenstertitel auf diesen Wert gesetzt. Wenn num eine SubFigure ist, wird deren übergeordnete Figure aktiviert.

figsize(float, float), Standard: rcParams["figure.figsize"] (Standard: [6.4, 4.8])

Breite, Höhe in Zoll.

dpifloat, Standard: rcParams["figure.dpi"] (Standard: 100.0)

Die Auflösung der Abbildung in Punkten pro Zoll.

facecolorcolor, Standard: rcParams["figure.facecolor"] (Standard: 'white')

Die Hintergrundfarbe.

edgecolorcolor, Standard: rcParams["figure.edgecolor"] (Standard: 'white')

Die Rahmenfarbe.

frameonbool, Standard: True

Wenn False, wird der Abbildungsrahmen unterdrückt.

FigureClassUnterklasse von Figure

Wenn gesetzt, wird eine Instanz dieser Unterklasse erstellt, anstatt einer einfachen Figure.

clearbool, Standard: False

Wenn True und die Abbildung bereits existiert, wird sie gelöscht.

layout{'constrained', 'compressed', 'tight', 'none', LayoutEngine, None}, Standard: None

Der Layout-Mechanismus zur Positionierung von Plot-Elementen, um überlappende Achsen-Dekorationen (Beschriftungen, Ticks etc.) zu vermeiden. Beachten Sie, dass Layout-Manager die Anzeige von Abbildungen merklich verlangsamen können.

'constrained': Der Constrained-Layout-Solver passt die Achsengrößen an, um überlappende Achsen-Dekorationen zu vermeiden. Kann komplexe Plot-Layouts und Farbleisten verarbeiten und wird daher empfohlen.

Siehe Constrained layout guide für Beispiele.
'compressed': Verwendet denselben Algorithmus wie 'constrained', entfernt aber zusätzlichen Platz zwischen Achsen mit festem Seitenverhältnis. Am besten für einfache Raster von Achsen geeignet.
'tight': Verwendet den Tight-Layout-Mechanismus. Dies ist ein relativ einfacher Algorithmus, der die Subplot-Parameter anpasst, damit Dekorationen nicht überlappen. Siehe Figure.set_tight_layout für weitere Details.
'none': Verwendet keine Layout-Engine.
Eine LayoutEngine-Instanz. Eingebaute Layout-Klassen sind ConstrainedLayoutEngine und TightLayoutEngine, die einfacher über 'constrained' und 'tight' zugänglich sind. Das Übergeben einer Instanz ermöglicht es Drittanbietern, ihre eigenen Layout-Engines bereitzustellen.

Wenn nicht angegeben, wird auf die Parameter tight_layout und constrained_layout zurückgegriffen, einschließlich ihrer Konfigurations-Standardwerte rcParams["figure.autolayout"] (Standard: False) und rcParams["figure.constrained_layout.use"] (Standard: False).

**kwargs

Zusätzliche Schlüsselwortargumente werden an den Konstruktor von Figure übergeben.

Gibt zurück:

Figure

Anmerkungen

Eine neu erstellte Abbildung wird an die Methode new_manager oder die Funktion new_figure_manager übergeben, die vom aktuellen Backend bereitgestellt werden und eine Zeichenfläche und einen Manager an die Abbildung anbinden.

Sobald dies geschehen ist, werden die rcParams["figure.hooks"] (Standard: []) nacheinander auf die Abbildung angewendet; diese Hooks ermöglichen beliebige Anpassungen der Abbildung (z. B. das Anhängen von Callbacks) oder zugehöriger Elemente (z. B. das Modifizieren der Werkzeugleiste). Siehe mplcvd -- ein Beispiel für einen Figure-Hook für ein Beispiel zur Anpassung der Werkzeugleiste.

Wenn Sie viele Abbildungen erstellen, stellen Sie sicher, dass Sie pyplot.close für die Abbildungen aufrufen, die Sie nicht verwenden, da dies pyplot ermöglicht, den Speicher ordnungsgemäß zu bereinigen.

matplotlib.pyplot.figure#

Beispiele mit matplotlib.pyplot.figure#

Beispiele mit `matplotlib.pyplot.figure`#