matplotlib.pyplot.subplot #

matplotlib.pyplot. Nebenhandlung ( * args , ** kwargs ) [Quelle] #

Fügen Sie der aktuellen Figur eine Axt hinzu oder rufen Sie eine vorhandene Axt ab.

Dies ist ein Wrapper Figure.add_subplot, der zusätzliches Verhalten beim Arbeiten mit der impliziten API bietet (siehe Abschnitt „Hinweise“).

Rufsignaturen:

subplot(nrows, ncols, index, **kwargs)
subplot(pos, **kwargs)
subplot(**kwargs)
subplot(ax)

Parameter :

*args int, (int, int, index ) oder SubplotSpec, Standard: (1, 1, 1)

Die Position des Subplots wird von einem der beschriebenen

Drei ganze Zahlen ( nrows , ncols , index ). Der Subplot nimmt die Indexposition auf einem Raster mit nrows- Zeilen und ncols- Spalten ein. Index beginnt bei 1 in der oberen linken Ecke und steigt nach rechts an. index kann auch ein Zwei-Tupel sein, das die ( ersten , letzten ) Indizes (1-basiert und einschließlich last ) des Subplots angibt, z. B. erstellt einen Subplot, der die oberen 2/3 der Abbildung umfasst.fig.add_subplot(3, 1, (1, 2))
Eine 3-stellige Ganzzahl. Die Ziffern werden so interpretiert, als ob sie separat als drei einstellige Ganzzahlen angegeben würden, dh fig.add_subplot(235)ist dasselbe wie . Beachten Sie, dass dies nur verwendet werden kann, wenn es nicht mehr als 9 Nebenparzellen gibt.fig.add_subplot(2, 3, 5)
A. SubplotSpec_

Projektion {Keine, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional

Der Projektionstyp des Subplots ( Axes). str ist der Name einer benutzerdefinierten Projektion, siehe projections. Der Standardwert „Keine“ führt zu einer „geradlinigen“ Projektion.

Polar Bool, Standard: False

Wenn True, entspricht dies der Projektion='polar'.

Sharex, Sharey Axes, optional

Teilen Sie das x oder y axismit sharex und/oder sharey. Die Achse hat die gleichen Grenzen, Ticks und Skalen wie die Achse der gemeinsam genutzten Achsen.

Etikettenstr _

Ein Label für die zurückgegebenen Achsen.

Rückgaben :

axes.SubplotBase, oder eine andere Unterklasse vonAxes: Die Achsen der Nebenhandlung. Die zurückgegebene Basisklasse der Achsen hängt von der verwendeten Projektion ab. Dies ist Axesder Fall, wenn eine geradlinige Projektion verwendet wird und projections.polar.PolarAxeswenn eine polare Projektion verwendet wird. Die zurückgegebenen Achsen sind dann eine Subplot-Unterklasse der Basisklasse.

Andere Parameter :

**Kwarg

Diese Methode übernimmt auch die Schlüsselwortargumente für die zurückgegebene Basisklasse der Achsen; außer dem Figurenargument . Die Schlüsselwortargumente für die geradlinige Basisklasse Axesfinden Sie in der folgenden Tabelle, aber es können auch andere Schlüsselwortargumente vorhanden sein, wenn eine andere Projektion verwendet wird.

Eigentum	Beschreibung
`adjustable`	{'box', 'datalim'}
`agg_filter`	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
`alpha`	Skalar oder Keine
`anchor`	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal'} oder float
`autoscale_on`	bool
`autoscalex_on`	Unbekannt
`autoscaley_on`	Unbekannt
`axes_locator`	Callable[[Achsen, Renderer], Bbox]
`axisbelow`	bool oder 'line'
`box_aspect`	Float oder None
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch oder (Pfad, Transform) oder None
`facecolor`oder FC	Farbe
`figure`	`Figure`
`frame_on`	bool
`gid`	Str
`in_layout`	bool
`label`	Objekt
`mouseover`	bool
`navigate`	bool
`navigate_mode`	Unbekannt
`path_effects`	`AbstractPathEffect`
`picker`	None oder bool oder float oder aufrufbar
`position`	[links, unten, Breite, Höhe] oder`Bbox`
`prop_cycle`	Unbekannt
`rasterization_zorder`	Float oder None
`rasterized`	bool
`sketch_params`	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
`snap`	bool oder Keine
`title`	Str
`transform`	`Transform`
`url`	Str
`visible`	bool
`xbound`	Unbekannt
`xlabel`	Str
`xlim`	(unten: Schwimmer, oben: Schwimmer)
`xmargin`	Schwimmer größer als -0,5
`xscale`	Unbekannt
`xticklabels`	Unbekannt
`xticks`	Unbekannt
`ybound`	Unbekannt
`ylabel`	Str
`ylim`	(unten: Schwimmer, oben: Schwimmer)
`ymargin`	Schwimmer größer als -0,5
`yscale`	Unbekannt
`yticklabels`	Unbekannt
`yticks`	Unbekannt
`zorder`	schweben

Siehe auch

Figure.add_subplot
pyplot.subplots
pyplot.axes
Figure.subplots

Anmerkungen

Das Erstellen einer neuen Achse löscht alle bereits vorhandenen Achsen, die sich damit überschneiden, außer dass sie eine Grenze teilen:

import matplotlib.pyplot as plt
# plot a line, implicitly creating a subplot(111)
plt.plot([1, 2, 3])
# now create a subplot which represents the top plot of a grid
# with 2 rows and 1 column. Since this subplot will overlap the
# first, the plot (and its axes) previously created, will be removed
plt.subplot(211)

Wenn Sie dieses Verhalten nicht wünschen, verwenden Sie stattdessen die Figure.add_subplotMethode oder die pyplot.axesFunktion.

Wenn keine kwargs übergeben werden und es an der durch args angegebenen Position eine Axe gibt, wird diese Axe zurückgegeben, anstatt eine neue Axe zu erstellen.

Wenn kwargs übergeben werden und an der durch args angegebenen Position ein Axes vorhanden ist, der Projektionstyp derselbe ist und die kwargs mit den vorhandenen Axes übereinstimmen, werden die vorhandenen Axes zurückgegeben. Andernfalls wird eine neue Achse mit den angegebenen Parametern erstellt. Wir speichern einen Verweis auf die Kwargs , die wir für diesen Vergleich verwenden. Wenn einer der Werte in kwargs änderbar ist, werden wir den Fall, in dem sie mutiert sind, nicht erkennen. In diesen Fällen empfehlen wir die Verwendung Figure.add_subplotder expliziten Axes-API anstelle der impliziten Pyplot-API.

Beispiele

plt.subplot(221)

# equivalent but more general
ax1 = plt.subplot(2, 2, 1)

# add a subplot with no frame
ax2 = plt.subplot(222, frameon=False)

# add a polar subplot
plt.subplot(223, projection='polar')

# add a red subplot that shares the x-axis with ax1
plt.subplot(224, sharex=ax1, facecolor='red')

# delete ax2 from the figure
plt.delaxes(ax2)

# add ax2 to the figure again
plt.subplot(ax2)

# make the first axes "current" again
plt.subplot(221)