API- Referenznummer

Wenn Sie die Bibliothek verwenden, erstellen Sie normalerweise Figure- und Axes -Objekte und rufen ihre Methoden auf, um Inhalte hinzuzufügen und das Erscheinungsbild zu ändern.

matplotlib.figure: Erstellung von Achsen, Inhalt auf Abbildungsebene
matplotlib.axes: die meisten Zeichenmethoden, Achsenbeschriftungen, Zugriff auf Achsenstile usw.

Beispiel: Wir erstellen eine Figur figund Achsen ax. Dann rufen wir Methoden auf, um Daten zu zeichnen, Achsenbeschriftungen und einen Abbildungstitel hinzuzufügen.

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 4, 0.05)
y = np.sin(x*np.pi)

fig, ax = plt.subplots(figsize=(3,2), constrained_layout=True)
ax.plot(x, y)
ax.set_xlabel('t [s]')
ax.set_ylabel('S [V]')
ax.set_title('Sine wave')
fig.set_facecolor('lightsteelblue')

( Quellcode , png )

Nutzungsmuster #

Im Folgenden beschreiben wir einige gängige Ansätze zum Plotten mit Matplotlib. Siehe Matplotlib-Anwendungsschnittstellen (APIs) für eine Erläuterung der Kompromisse zwischen den unterstützten Benutzer-APIs.

Die explizite API #

Im Kern ist Matplotlib eine objektorientierte Bibliothek. Wir empfehlen, direkt mit den Objekten zu arbeiten, wenn Sie mehr Kontrolle und Anpassung Ihrer Plots benötigen.

FigureIn vielen Fällen werden Sie ein und eins oder mehrere Axesmit erstellen und pyplot.subplotsfortan nur noch an diesen Objekten arbeiten. Es ist aber auch möglich, Figures explizit zu erstellen (zB beim Einbinden in GUI-Anwendungen).

Weiterlesen:

matplotlib.axes.Axesund matplotlib.figure.Figurefür einen Überblick über die Zeichenfunktionen.
Die meisten Beispiele verwenden den objektorientierten Ansatz (mit Ausnahme des Pyplot-Abschnitts).

Die implizite API #

matplotlib.pyplotist eine Sammlung von Funktionen, mit denen Matplotlib wie MATLAB funktioniert. Jede Pyplot-Funktion nimmt einige Änderungen an einer Figur vor: erstellt z. B. eine Figur, erstellt einen Zeichenbereich in einer Figur, zeichnet einige Linien in einem Zeichenbereich, verziert den Plot mit Beschriftungen usw.

pyplotist hauptsächlich für interaktive Plots und einfache Fälle von programmatischer Plotgenerierung gedacht.

Weiterlesen:

Die matplotlib.pyplotFunktionsreferenz
Pyplot-Tutorial
Pyplot-Beispiele

Die pylab API (nicht empfohlen) #

Warnung

Da ein starker Import in den globalen Namespace zu unerwartetem Verhalten führen kann, wird von der Verwendung von pylab dringend abgeraten. Verwenden Sie matplotlib.pyplot stattdessen.

pylabist ein Modul, das matplotlib.pyplot, numpy, numpy.fft, numpy.linalg, numpy.randomund einige zusätzliche Funktionen in einem einzigen Namensraum enthält. Sein ursprünglicher Zweck bestand darin, eine MATLAB-ähnliche Arbeitsweise nachzuahmen, indem alle Funktionen in den globalen Namensraum importiert wurden. Das gilt heute als schlechter Stil.

Module #

Alphabetische Liste der Module: