matplotlib.pyplot.margins

matplotlib.pyplot.margins(*margins, x=None, y=None, tight=True)

Setzt oder ruft Ränder um die Daten für die automatische Skalierung der Achsenbegrenzungen ab.

Dies ermöglicht die Konfiguration des Abstands um die Daten, ohne explizite Grenzen mit set_xlim / set_ylim setzen zu müssen.

Die automatische Skalierung bestimmt die Achsenbegrenzungen, indem sie das Datenintervall mit margin als zusätzlichen Abstand um die Daten herum addiert. Sehen Sie die folgende Abbildung

(Quellcode, png)

Alle Eingabeparameter müssen Fließkommazahlen größer als -0.5 sein. Die Übergabe von sowohl positionsbezogenen als auch Schlüsselwortargumenten ist ungültig und löst einen TypeError aus. Wenn keine Argumente (positionsbezogen oder anderweitig) übergeben werden, bleiben die aktuellen Ränder unverändert und werden einfach zurückgegeben.

Die Standardränder sind rcParams["axes.xmargin"] (Standard: 0.05) und rcParams["axes.ymargin"] (Standard: 0.05).

Parameter:

*marginsfloat, optional

Wenn ein einzelnes positionsbezogenes Argument übergeben wird, spezifiziert es sowohl die Ränder der x-Achsen- als auch der y-Achsen-Grenzen. Wenn zwei positionsbezogene Argumente übergeben werden, werden diese als xmargin, ymargin interpretiert. Wenn nur der Rand einer einzelnen Achse eingestellt werden soll, verwenden Sie die unten beschriebenen Schlüsselwortargumente.

x, yfloat, optional

Spezifische Randwerte für die x- und y-Achse bzw. diese. Diese können nicht mit positionsbezogenen Argumenten verwendet werden, können aber einzeln verwendet werden, um z. B. nur die y-Achse zu ändern.

tightbool oder None, Standard: True

Der Parameter tight wird an autoscale_view übergeben, welches nach einer Änderung des Rands ausgeführt wird; der Standardwert hier ist True, in der Annahme, dass bei Angabe von Rändern normalerweise keine zusätzliche Polsterung zur Anpassung an Tick-Markierungen gewünscht ist. Das Setzen von tight auf None behält die vorherige Einstellung bei.

Gibt zurück:

xmargin, ymarginfloat

Siehe auch

Axes.set_xmargin, Axes.set_ymargin

Anmerkungen

Hinweis

Dies ist die pyplot-Wrapper-Funktion für axes.Axes.margins.

Wenn eine zuvor verwendete Axes-Methode wie pcolor() use_sticky_edges auf True gesetzt hat, werden nur die Grenzen geändert, die nicht von den "sticky artists" gesetzt wurden. Um zu erzwingen, dass alle Ränder gesetzt werden, setzen Sie use_sticky_edges vor dem Aufruf von margins() auf False.

Beispiele für die Verwendung von matplotlib.pyplot.margins

Ansichtsgrenzen mit Rändern und sticky_edges steuern

Ansichtsgrenzen mit Rändern und sticky_edges steuern