matplotlib.axes.Axes.margins#

Axes.margins(*margins, x=None, y=None, tight=True)[Quelle]#

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 festlegen zu müssen.

Die automatische Skalierung bestimmt die Achsenlimits, indem sie *Margin*-mal das Datenintervall als Abstand um die Daten hinzufügt. Siehe folgende Abbildung:

(Quellcode, 2x.png, png)

Alle Eingabeparameter müssen Floats größer als -0.5 sein. Die Übergabe von sowohl Positions- als auch Schlüsselwortargumenten ist ungültig und löst einen TypeError aus. Wenn keine Argumente (positionsabhängig 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 Positionsargument übergeben wird, gibt es sowohl die Ränder der x-Achse als auch der y-Achse an. Wenn zwei Positionsargumente übergeben werden, werden diese als xmargin, ymargin interpretiert. Wenn nur der Rand einer einzelnen Achse gesetzt werden soll, verwenden Sie die unten beschriebenen Schlüsselwortargumente.
x, yfloat, optional: Spezifische Randwerte für die x- und y-Achse. Diese können nicht mit Positionsargumenten 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, das nach Änderung eines Randes ausgeführt wird; der Standardwert hier ist True, in der Annahme, dass bei Angabe von Rändern normalerweise kein zusätzlicher Abstand zum Anpassen der 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

Wenn eine zuvor verwendete Axes-Methode wie pcolor() use_sticky_edges auf True gesetzt hat, werden nur die nicht durch die "sticky artists" gesetzten Grenzen modifiziert. Um zu erzwingen, dass alle Ränder gesetzt werden, setzen Sie use_sticky_edges auf False, bevor Sie margins() aufrufen.