matplotlib.pyplot.subplot#

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

Fügt der aktuellen Figur eine Achse hinzu oder ruft eine vorhandene Achse ab.

Dies ist ein Wrapper für Figure.add_subplot, der zusätzliches Verhalten bei der Arbeit mit der impliziten API bietet (siehe Abschnitt Hinweise).

Aufrufsignaturen

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

Parameter:

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

Die Position des Subplots, beschrieben durch eines der folgenden:

Drei Ganzzahlen (*nrows*, *ncols*, *index*). Der Subplot nimmt die index-Position in einem Raster mit nrows Zeilen und ncols Spalten ein. index beginnt in der oberen linken Ecke mit 1 und erhöht sich nach rechts. index kann auch ein Tupel aus zwei Zahlen sein, das die (erste, letzte) Indizes (1-basiert und einschließlich letzter) des Subplots angibt, z. B. fig.add_subplot(3, 1, (1, 2)) erstellt einen Subplot, der sich über die oberen 2/3 der Abbildung erstreckt.
Eine 3-stellige Ganzzahl. Die Ziffern werden so interpretiert, als wären sie separat als drei einstellige Ganzzahlen angegeben, d. h. fig.add_subplot(235) ist dasselbe wie fig.add_subplot(2, 3, 5). Beachten Sie, dass dies nur verwendet werden kann, wenn nicht mehr als 9 Subplots vorhanden sind.
Ein SubplotSpec.

projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional

Der Projektionstyp des Subplots (Axes). str ist der Name einer benutzerdefinierten Projektion, siehe projections. Der Standardwert None ergibt eine 'rectiligneare' Projektion.

polarbool, default: False

Wenn True, ist dies äquivalent zu projection='polar'.

sharex, shareyAxes, optional

Teilt die x- oder y-achse mit sharex und/oder sharey. Die Achse hat die gleichen Grenzen, Ticks und Skalen wie die Achse der geteilten Axes.

labelstr

Ein Label für die zurückgegebene Achse.

Gibt zurück:

Axes: Die Axes des Subplots. Die zurückgegebene Axes kann tatsächlich eine Instanz einer Unterklasse sein, wie z.B. projections.polar.PolarAxes für polare Projektionen.

Andere Parameter:

**kwargs

Diese Methode nimmt auch die Schlüsselwortargumente für die zurückgegebene Basisklasse der Axes entgegen; mit Ausnahme des Arguments figure. Die Schlüsselwortargumente für die rectiligneare Basisklasse Axes finden Sie in der folgenden Tabelle, aber es können auch andere Schlüsselwortargumente vorhanden sein, wenn eine andere Projektion verwendet wird.

Eigenschaft	Beschreibung
`adjustable`	{'box', 'datalim'}
`agg_filter`	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
`alpha`	float oder None
`anchor`	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal'} oder float
`autoscale_on`	bool
`autoscalex_on`	unknown
`autoscaley_on`	unknown
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool oder 'line'
`box_aspect`	float oder None
`clip_box`	`BboxBase` oder None
`clip_on`	bool
`clip_path`	Patch oder (Path, Transform) oder None
`facecolor` oder `fc`	color
`figure`	`Figure` oder `SubFigure`
`forward_navigation_events`	bool oder "auto"
`frame_on`	bool
`gid`	str
`in_layout`	bool
`label`	object
`mouseover`	bool
`navigate`	bool
`navigate_mode`	unknown
`path_effects`	Liste von `AbstractPathEffect`
`picker`	None oder bool oder float oder callable
`position`	[left, bottom, width, height] oder `Bbox`
`prop_cycle`	`Cycler`
`rasterization_zorder`	float oder None
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool oder None
`subplotspec`	unknown
`title`	str
`transform`	`Transform`
`url`	str
`visible`	bool
`xbound`	(lower: float, upper: float)
`xlabel`	str
`xlim`	(left: float, right: float)
`xmargin`	float größer als -0.5
`xscale`	unknown
`xticklabels`	unknown
`xticks`	unknown
`ybound`	(lower: float, upper: float)
`ylabel`	str
`ylim`	(bottom: float, top: float)
`ymargin`	float größer als -0.5
`yscale`	unknown
`yticklabels`	unknown
`yticks`	unknown
`zorder`	float

Siehe auch

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

Anmerkungen

Geändert in Version 3.8: In Versionen vor 3.8 wurden alle vorhandenen Achsen, die mit der neuen Achse über eine Grenze hinaus überlappten, gelöscht. Das Löschen geschieht in neueren Versionen nicht mehr. Verwenden Sie Axes.remove explizit, falls erforderlich.

Wenn Sie dieses Verhalten nicht wünschen, verwenden Sie stattdessen die Methode Figure.add_subplot oder die Funktion pyplot.axes.

Wenn keine kwargs übergeben werden und eine Achse an der von args angegebenen Position vorhanden ist, wird diese Achse zurückgegeben, anstatt eine neue Achse zu erstellen.

Wenn kwargs übergeben werden und eine Achse an der von args angegebenen Position vorhanden ist, der Projektionstyp derselbe ist und die kwargs mit der vorhandenen Achse übereinstimmen, wird die vorhandene Achse zurückgegeben. Andernfalls wird eine neue Achse mit den angegebenen Parametern erstellt. Wir speichern eine Referenz auf die kwargs, die wir für diesen Vergleich verwenden. Wenn einer der Werte in kwargs veränderlich ist, erkennen wir den Fall, dass sie verändert wurden, nicht. In diesen Fällen empfehlen wir die Verwendung von Figure.add_subplot und der expliziten Achsen-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)