matplotlib.pyplot.subplots #
- matplotlib.pyplot. subplots ( nrows = 1 , ncols = 1 , * , sharex = False , sharey = False , squeeze = True , width_ratios = None , height_ratios = None , subplot_kw = None , gridspec_kw = None , ** fig_kw ) [Quelle] #
Erstellen Sie eine Figur und eine Reihe von Nebenhandlungen.
Dieser Dienstprogramm-Wrapper macht es bequem, gemeinsame Layouts von Nebenplots, einschließlich des umschließenden Abbildungsobjekts, in einem einzigen Aufruf zu erstellen.
- Parameter :
- nrows, ncols int, Standard: 1
Anzahl der Zeilen/Spalten des Subplot-Rasters.
- sharex, sharey bool oder {'none', 'all', 'row', 'col'}, Standard: False
Steuert die gemeinsame Nutzung von Eigenschaften zwischen x ( sharex ) oder y ( sharey ) Achsen:
True oder 'all': x- oder y-Achse wird von allen Subplots geteilt.
False oder 'none': Die x- oder y-Achse jedes Subplots ist unabhängig.
'Zeile': Jede Subplot-Zeile teilt sich eine x- oder y-Achse.
'col': Jede Subplot-Spalte teilt sich eine x- oder y-Achse.
Wenn Subplots entlang einer Spalte eine gemeinsame x-Achse haben, werden nur die x-Tick-Beschriftungen des unteren Subplots erstellt. Wenn Subplots entlang einer Zeile eine gemeinsame y-Achse haben, werden nur die y-Tick-Beschriftungen des Subplots der ersten Spalte erstellt. Um später die Ticklabels anderer Subplots einzuschalten, verwenden Sie
tick_params.Wenn Unterplots eine gemeinsame Achse mit Einheiten haben, wird beim Aufrufen
set_unitsjede Achse mit den neuen Einheiten aktualisiert.- Squeeze bool, Standard: True
Wenn True, werden zusätzliche Dimensionen aus dem zurückgegebenen Array von herausgedrückt
Axes:Wenn nur ein Subplot erstellt wird (nrows=ncols=1), wird das resultierende einzelne Axes-Objekt als Skalar zurückgegeben.
Für Nx1- oder 1xM-Subplots ist das zurückgegebene Objekt ein numpy-1D-Objektarray von Axes-Objekten.
für NxM werden Teilplots mit N>1 und M>1 als 2D-Array zurückgegeben.
Bei False wird überhaupt nicht gestaucht: Das zurückgegebene Axes-Objekt ist immer ein 2D-Array, das Axes-Instanzen enthält, selbst wenn es am Ende 1x1 ist.
- width_ratios Array-ähnlich der Länge ncols , optional
Definiert die relative Breite der Spalten. Jede Spalte erhält eine relative Breite von . Wenn nicht angegeben, haben alle Spalten die gleiche Breite. Äquivalent zu .
width_ratios[i] / sum(width_ratios)gridspec_kw={'width_ratios': [...]}- height_ratios Array-ähnlich mit der Länge nrows , optional
Definiert die relativen Höhen der Zeilen. Jede Zeile erhält eine relative Höhe von . Wenn nicht angegeben, haben alle Zeilen die gleiche Höhe. Komfort für .
height_ratios[i] / sum(height_ratios)gridspec_kw={'height_ratios': [...]}- subplot_kw Diktat , optional
Diktieren Sie mit Schlüsselwörtern, die an den
add_subplotAufruf übergeben werden, der zum Erstellen der einzelnen Nebenhandlungen verwendet wird.- gridspec_kw Diktat , optional
Dict mit Schlüsselwörtern, die an den
GridSpecKonstruktor übergeben werden, der zum Erstellen des Gitters verwendet wird, auf dem die Subplots platziert werden.- **fig_kw
Alle zusätzlichen Schlüsselwortargumente werden an den
pyplot.figureAufruf übergeben.
- Rückgaben :
- Feige
Figure - Axt
Axesoder Array von Axes ax kann entweder ein einzelnes
AxesObjekt oder ein Array von Axes-Objekten sein, wenn mehr als ein Subplot erstellt wurde. Die Dimensionen des resultierenden Arrays können mit dem Squeeze-Schlüsselwort gesteuert werden, siehe oben.Typische Redewendungen für den Umgang mit dem Rückgabewert sind:
# using the variable ax for single a Axes fig, ax = plt.subplots() # using the variable axs for multiple Axes fig, axs = plt.subplots(2, 2) # using tuple unpacking for multiple Axes fig, (ax1, ax2) = plt.subplots(1, 2) fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)
Die Namen
axund Pluralaxswerden bevorzugt,axesda bei letzterem nicht klar ist, ob es sich um eine einzelneAxesInstanz oder eine Sammlung davon handelt.
- Feige
Beispiele
# First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) # Create just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') # Create two subplots and unpack the output array immediately f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) ax1.plot(x, y) ax1.set_title('Sharing Y axis') ax2.scatter(x, y) # Create four polar axes and access them through the returned array fig, axs = plt.subplots(2, 2, subplot_kw=dict(projection="polar")) axs[0, 0].plot(x, y) axs[1, 1].scatter(x, y) # Share a X axis with each column of subplots plt.subplots(2, 2, sharex='col') # Share a Y axis with each row of subplots plt.subplots(2, 2, sharey='row') # Share both X and Y axes with all subplots plt.subplots(2, 2, sharex='all', sharey='all') # Note that this is the same as plt.subplots(2, 2, sharex=True, sharey=True) # Create figure number 10 with a single subplot # and clears it if it already exists. fig, ax = plt.subplots(num=10, clear=True)
Beispiele mit matplotlib.pyplot.subplots#
Diskrete Verteilung als horizontales Balkendiagramm
Zuordnen von Markierungseigenschaften zu multivariaten Daten
Erstellen einer Zeitleiste mit Linien, Daten und Text
Steuern der Anzeigebeschränkungen mithilfe von Rändern und sticky_edges
Kombinieren von zwei Subplots mit Subplots und GridSpec
Zeichnen Sie eine Vertrauensellipse eines zweidimensionalen Datensatzes
Verschiedene Möglichkeiten zur Angabe von Fehlerbalken
Einschließlich Ober- und Untergrenzen in Fehlerbalken
Erstellen von Boxen aus Fehlerbalken mit PatchCollection
Verwenden von Histogrammen zum Zeichnen einer kumulativen Verteilung
Demo der verschiedenen Histtype-Einstellungen der Histogrammfunktion
Die Funktion Histogramm (hist) mit mehreren Datensätzen
Erstellen einer Farbkarte aus einer Liste von Farben
Linien-, Poly- und RegularPoly-Sammlung mit automatischer Skalierung
Steuern der Position und Größe von Farbbalken mit Inset Axes
Animiertes Bild mit einer vorberechneten Liste von Bildern
Ändern der Farben von Linien, die eine Box schneiden
Erstellen von Histogrammen mit Rectangles und PolyCollections
Benutzerdefinierte Schummerung in einem 3D-Oberflächendiagramm
Radarkarte (auch Spinnen- oder Sternenkarte genannt)
Datumsmarkierungen mit ConciseDateFormatter formatieren
Setzen von Datumshäkchen mithilfe von Wiederholungsregeln
Benutzerdefinierter Tick-Formatierer für Zeitreihen
Legen Sie auf der rechten Seite standardmäßige Hilfsstrichbeschriftungen für die y-Achse fest
Verschieben Sie die Hilfsstrichbeschriftungen der x-Achse nach oben
Wählen Sie mithilfe des Polygonselektors Indizes aus einer Sammlung aus
