matplotlib.pyplot

matplotlib.pyplotist eine zustandsbasierte Schnittstelle zu Matplotlib. Es bietet eine implizite, MATLAB-ähnliche Art des Plottens. Es öffnet auch Figuren auf Ihrem Bildschirm und fungiert als Figuren-GUI-Manager.

pyplot ist hauptsächlich für interaktive Plots und einfache Fälle der programmatischen Plotgenerierung gedacht:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

Die explizite objektorientierte API wird für komplexe Diagramme empfohlen, obwohl Pyplot normalerweise immer noch verwendet wird, um die Figur und oft die Achsen in der Figur zu erstellen. Siehe pyplot.figure, pyplot.subplots, und pyplot.subplot_mosaiczum Erstellen von Figuren und Axes API für die Zeichenmethoden auf Axes:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

Siehe Matplotlib-Anwendungsschnittstellen (APIs) für eine Erläuterung der Kompromisse zwischen den impliziten und expliziten Schnittstellen.

Zeichenbefehle

acorr	Zeichnen Sie die Autokorrelation von x .
angle_spectrum	Zeichnen Sie das Winkelspektrum.
annotate	Beschriften Sie den Punkt xy mit Text text .
arrow	Fügen Sie den Achsen einen Pfeil hinzu.
autoscale	Achsenansicht automatisch auf die Daten skalieren (umschalten).
axes	Füge der aktuellen Figur eine Axt hinzu und mache sie zur aktuellen Axt.
axhline	Fügen Sie eine horizontale Linie über die Achsen hinzu.
axhspan	Fügen Sie eine horizontale Spanne (Rechteck) über die Achsen hinzu.
axis	Praktische Methode zum Abrufen oder Festlegen einiger Achseneigenschaften.
axline	Fügen Sie eine unendlich lange gerade Linie hinzu.
axvline	Fügen Sie eine vertikale Linie über die Achsen hinzu.
axvspan	Fügen Sie eine vertikale Spanne (Rechteck) über die Achsen hinzu.
bar	Erstellen Sie ein Balkendiagramm.
bar_label	Beschriften Sie ein Balkendiagramm.
barbs	Zeichnen Sie ein 2D-Feld mit Widerhaken.
barh	Erstellen Sie ein horizontales Balkendiagramm.
box	Schalten Sie das Achsenfeld auf den aktuellen Achsen ein oder aus.
boxplot	Zeichnen Sie ein Box-and-Whisker-Diagramm.
broken_barh	Zeichnen Sie eine horizontale Folge von Rechtecken.
cla	Löschen Sie die aktuellen Achsen.
clabel	Beschriften Sie ein Konturdiagramm.
clf	Löschen Sie die aktuelle Figur.
clim	Legen Sie die Farbgrenzen des aktuellen Bildes fest.
close	Schließen Sie ein Abbildungsfenster.
cohere	Zeichnen Sie die Kohärenz zwischen x und y .
colorbar	Fügen Sie einem Diagramm einen Farbbalken hinzu.
contour	Höhenlinien einzeichnen.
contourf	Zeichnen Sie gefüllte Konturen.
csd	Zeichnen Sie die Kreuzspektraldichte.
delaxes	Entfernen Sie ein Axes(standardmäßig die aktuellen Achsen) aus seiner Figur.
draw	Zeichnen Sie die aktuelle Figur neu.
draw_if_interactive	Zeichnen Sie die aktuelle Figur neu, wenn Sie sich im interaktiven Modus befinden.
errorbar	Zeichnen Sie y gegen x als Linien und/oder Markierungen mit angehängten Fehlerbalken.
eventplot	Zeichnen Sie identische parallele Linien an den angegebenen Positionen.
figimage	Fügen Sie der Abbildung ein nicht neu berechnetes Bild hinzu.
figlegend	Platzieren Sie eine Legende auf der Figur.
fignum_exists	Gibt zurück, ob die Figur mit der angegebenen ID existiert.
figtext	Fügen Sie der Abbildung Text hinzu.
figure	Erstellen Sie eine neue Figur oder aktivieren Sie eine vorhandene Figur.
fill	Zeichnen Sie gefüllte Polygone.
fill_between	Füllen Sie den Bereich zwischen zwei horizontalen Kurven.
fill_betweenx	Füllen Sie den Bereich zwischen zwei vertikalen Kurven.
findobj	Finden Sie Künstlerobjekte.
gca	Holen Sie sich die aktuellen Axes.
gcf	Holen Sie sich die aktuelle Zahl.
gci	Holen Sie sich den aktuellen färbbaren Künstler.
get	Geben Sie den Wert der ArtistEigenschaft von an zurück oder geben Sie alle aus.
get_cmap	Rufen Sie eine Colormap-Instanz ab, die standardmäßig rc-Werte verwendet, wenn name None ist.
get_figlabels	Gibt eine Liste vorhandener Abbildungsbeschriftungen zurück.
get_fignums	Gibt eine Liste bestehender Abbildungsnummern zurück.
getp	Geben Sie den Wert der ArtistEigenschaft von an zurück oder geben Sie alle aus.
grid	Konfigurieren Sie die Gitterlinien.
hexbin	Erstellen Sie ein sechseckiges 2D-Binning-Diagramm der Punkte x , y .
hist	Berechnen und zeichnen Sie ein Histogramm.
hist2d	Erstellen Sie ein 2D-Histogramm.
hlines	Zeichnen Sie horizontale Linien bei jedem y von xmin bis xmax .
imread	Liest ein Bild aus einer Datei in ein Array ein.
imsave	Speichern Sie ein Array als Bilddatei.
imshow	Zeigen Sie Daten als Bild an, dh auf einem regulären 2D-Raster.
install_repl_displayhook	Verbinden Sie sich mit dem Anzeige-Hook der aktuellen Shell.
ioff	Interaktiven Modus deaktivieren.
ion	Aktivieren Sie den interaktiven Modus.
isinteractive	Gibt zurück, ob Plots nach jedem Plotbefehl aktualisiert werden.
legend	Platziere eine Legende auf den Äxten.
locator_params	Steuerverhalten von Hauptzeckenlokalisatoren.
loglog	Erstellen Sie ein Diagramm mit logarithmischer Skalierung sowohl auf der x- als auch auf der y-Achse.
magnitude_spectrum	Zeichnen Sie das Magnitudenspektrum.
margins	Autoscaling-Ränder festlegen oder abrufen.
matshow	Zeigen Sie ein Array als Matrix in einem neuen Abbildungsfenster an.
minorticks_off	Entfernen Sie kleinere Häkchen von den Achsen.
minorticks_on	Zeigt kleinere Ticks auf den Achsen an.
pause	Führen Sie die GUI-Ereignisschleife für Intervallsekunden aus.
pcolor	Erstellen Sie ein Pseudofarbendiagramm mit einem unregelmäßigen rechteckigen Gitter.
pcolormesh	Erstellen Sie ein Pseudofarbendiagramm mit einem unregelmäßigen rechteckigen Gitter.
phase_spectrum	Zeichnen Sie das Phasenspektrum.
pie	Zeichnen Sie ein Tortendiagramm.
plot	Zeichnen Sie y gegen x als Linien und/oder Markierungen.
plot_date	[ Entmutigt ] Zeichnen Sie die Achse dazu, Floats als Datumsangaben zu behandeln.
polar	Erstelle ein Polardiagramm.
psd	Zeichnen Sie die spektrale Leistungsdichte.
quiver	Zeichnen Sie ein 2D-Pfeilfeld.
quiverkey	Fügen Sie einem Quiver Plot einen Schlüssel hinzu.
rc	Stellen Sie den Strom ein rcParams. group ist die Gruppierung für den rc, z. B. für lines.linewidthdie Gruppe ist lines, für axes.facecolor, die Gruppe ist axes, und so weiter. Gruppe kann auch eine Liste oder ein Tupel von Gruppennamen sein, zB ( xtick , ytick ). kwargs ist ein Name/Wert-Paar eines Dictionary-Attributs, zB::.
rc_context	Gibt einen Kontextmanager zum vorübergehenden Ändern von rcParams zurück.
rcdefaults	Stellen rcParamsSie den internen Standardstil von Matplotlib wieder her.
rgrids	Abrufen oder Festlegen der radialen Gitternetzlinien im aktuellen Polardiagramm.
savefig	Speichern Sie die aktuelle Figur.
sca	Setzen Sie die aktuellen Achsen auf ax und die aktuelle Figur auf das übergeordnete Element von ax .
scatter	Ein Streudiagramm von y vs.
sci	Stellen Sie das aktuelle Bild ein.
semilogx	Erstellen Sie ein Diagramm mit logarithmischer Skalierung auf der x-Achse.
semilogy	Erstellen Sie ein Diagramm mit logarithmischer Skalierung auf der y-Achse.
set_cmap	Legen Sie die Standardfarbkarte fest und wenden Sie sie gegebenenfalls auf das aktuelle Bild an.
set_loglevel	Legen Sie die Root-Logger- und Root-Logger-Handler-Ebene von Matplotlib fest und erstellen Sie den Handler, wenn er noch nicht existiert.
setp	Legen Sie eine oder mehrere Eigenschaften für eine Artistfest oder listen Sie zulässige Werte auf.
show	Alle offenen Zahlen anzeigen.
specgram	Zeichnen Sie ein Spektrogramm.
spy	Zeichnen Sie das Sparsity-Muster eines 2D-Arrays.
stackplot	Zeichnen Sie ein gestapeltes Flächendiagramm.
stairs	Eine schrittweise konstante Funktion als Linie mit Begrenzungskanten oder als gefüllter Plot.
stem	Erstellen Sie einen Stammplot.
step	Machen Sie ein Stufendiagramm.
streamplot	Zeichnen Sie Stromlinien eines Vektorflusses.
subplot	Fügen Sie der aktuellen Figur eine Axt hinzu oder rufen Sie eine vorhandene Axt ab.
subplot2grid	Erstellen Sie eine Nebenhandlung an einer bestimmten Stelle innerhalb eines regelmäßigen Rasters.
subplot_mosaic	Erstellen Sie ein Layout von Achsen basierend auf ASCII-Grafiken oder verschachtelten Listen.
subplot_tool	Starten Sie ein Subplot-Toolfenster für eine Figur.
subplots	Erstellen Sie eine Figur und eine Reihe von Nebenhandlungen.
subplots_adjust	Passen Sie die Layout-Parameter des Nebenplots an.
suptitle	Fügen Sie der Abbildung einen zentrierten Untertitel hinzu.
switch_backend	Schließen Sie alle geöffneten Figuren und setzen Sie das Matplotlib-Backend.
table	Hinzufügen einer Tabelle zu einer Axes.
text	Fügen Sie den Achsen Text hinzu.
thetagrids	Rufen Sie die Theta-Gitternetzlinien im aktuellen Polardiagramm ab oder legen Sie sie fest.
tick_params	Ändern Sie das Aussehen von Teilstrichen, Teilstrichbeschriftungen und Gitternetzlinien.
ticklabel_format	Konfigurieren Sie die ScalarFormatterstandardmäßig für Linearachsen verwendete.
tight_layout	Passen Sie die Polsterung zwischen und um Subplots an.
title	Legen Sie einen Titel für die Achsen fest.
tricontour	Zeichnen Sie Höhenlinien auf einem unstrukturierten Dreiecksgitter.
tricontourf	Zeichnen Sie Konturbereiche auf einem unstrukturierten Dreiecksgitter.
tripcolor	Erstellen Sie ein Falschfarbendiagramm eines unstrukturierten dreieckigen Gitters.
triplot	Zeichnen Sie ein unstrukturiertes Dreiecksgitter als Linien und/oder Markierungen.
twinx	Erstellen Sie eine zweite Achse, die die x -Achse teilt, und geben Sie sie zurück .
twiny	Erstellen Sie eine zweite Achse, die die y - Achse teilt, und geben Sie sie zurück.
uninstall_repl_displayhook	Verbindung zum Anzeige-Hook der aktuellen Shell trennen.
violinplot	Machen Sie einen Geigenplot.
vlines	Zeichnen Sie vertikale Linien bei jedem x von ymin bis ymax .
xcorr	Zeichnen Sie die Kreuzkorrelation zwischen x und y .
xkcd	Aktivieren Sie den xkcd -Zeichnungsmodus im Skizzenstil.
xlabel	Legen Sie die Beschriftung für die x-Achse fest.
xlim	Holen oder setzen Sie die x-Grenzwerte der aktuellen Achsen.
xscale	Stellen Sie die Skala der x-Achse ein.
xticks	Abrufen oder Festlegen der aktuellen Tick-Positionen und Beschriftungen der x-Achse.
ylabel	Legen Sie die Beschriftung für die y-Achse fest.
ylim	Holen oder setzen Sie die y-Grenzen der aktuellen Achsen.
yscale	Stellen Sie die Skala der Y-Achse ein.
yticks	Abrufen oder Festlegen der aktuellen Tick-Positionen und Beschriftungen der Y-Achse.

Andere Befehle

connect	Binden Sie die Funktion func an das Ereignis s .
disconnect	Trennen Sie den Rückruf mit id cid .
get_current_fig_manager	Gibt den Figurenmanager der aktuellen Figur zurück.
ginput	Anruf blockieren, um mit einer Figur zu interagieren.
new_figure_manager	Erstellen Sie eine neue Figure Manager-Instanz.
waitforbuttonpress	Anruf blockieren, um mit der Figur zu interagieren.

Farbkarten

Colormaps sind über die Colormap-Registrierung verfügbar matplotlib.colormaps. Der Einfachheit halber ist diese Registrierung in pyplotas verfügbar

matplotlib.pyplot. Farbkarten

Container für Colormaps, die Matplotlib namentlich bekannt sind.

Experimental

Obwohl wir davon ausgehen, dass die API endgültig ist, markieren wir sie formell als experimentell für 3.5, weil wir uns die Option behalten wollen, die API für 3.6 bei Bedarf noch anzupassen.

Die universelle Registrierungsinstanz ist matplotlib.colormaps. Benutzer sollten sich nicht selbst instanziieren ColormapRegistrymüssen.

Der Lesezugriff verwendet eine dict-ähnliche Schnittstelle, die Namen auf Colormaps abbildet:

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

Zurückgegebene Colormaps sind Kopien, sodass ihre Änderung die globale Definition der Farbtabelle nicht ändert.

Zusätzliche Farbkarten können hinzugefügt werden über ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

Zusätzlich gibt es Shortcut-Funktionen, um eingebaute Colormaps einzustellen; zB plt.viridis()ist äquivalent zu plt.set_cmap('viridis').

matplotlib.pyplot. Farbsequenzen

Container für Farbfolgen, die Matplotlib namentlich bekannt sind.

Die universelle Registrierungsinstanz ist matplotlib.color_sequences. Benutzer sollten sich nicht selbst instanziieren ColorSequenceRegistry müssen.

Der Lesezugriff verwendet eine dict-ähnliche Schnittstelle, die Namen auf Farblisten abbildet:

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

Die zurückgegebenen Listen sind Kopien, so dass ihre Modifikation die globale Definition der Farbreihenfolge nicht ändert.

Zusätzliche Farbsequenzen können hinzugefügt werden über ColorSequenceRegistry.register:

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])