matplotlib.spines

class matplotlib.spines.Spine(axes, spine_type, path, **kwargs)

Bases: Patch

Eine Achsen-Wirbelsäule – die Linie, die die Grenzen des Datenbereichs markiert.

Wirbelsäulen sind die Linien, die die Achsen-Ticks verbinden und die Grenzen des Datenbereichs markieren. Sie können an beliebigen Positionen platziert werden. Weitere Informationen finden Sie unter set_position.

Die Standardposition ist ('outward', 0).

Wirbelsäulen sind Unterklassen von Patch und erben einen Großteil ihres Verhaltens.

Wirbelsäulen zeichnen eine Linie, einen Kreis oder einen Bogen, je nachdem, ob set_patch_line, set_patch_circle oder set_patch_arc aufgerufen wurde. Linienartig ist der Standard.

Beispiele finden Sie unter Spines.

Parameter:

axesAxes

Die Axes-Instanz, die die Wirbelsäule enthält.

spine_typestr

Der Wirbelsäulentyp.

pathPath

Die Path-Instanz, die zum Zeichnen der Wirbelsäule verwendet wird.

Andere Parameter:

**kwargs

Gültige Schlüsselwortargumente sind

Eigenschaft	Beschreibung
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	unknown
animated	bool
antialiased oder aa	bool oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color	color
edgecolor oder ec	Farbe oder None
facecolor oder fc	Farbe oder None
figure	Figure oder SubFigure
füllen	bool
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth oder lw	float oder None
mouseover	bool
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

classmethod arc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)

Erstellt und gibt eine Bogen-Spine zurück.

classmethod circular_spine(axes, center, radius, **kwargs)

Erstellt und gibt eine kreisförmige Spine zurück.

clear()

Löscht die aktuelle Wirbelsäule.

draw(renderer)

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

get_bounds()

Gibt die Grenzen der Wirbelsäule zurück.

get_patch_transform()

Gibt die Transform-Instanz zurück, die Patch-Koordinaten auf Datenkoordinaten abbildet.

Man kann beispielsweise einen Kreis-Patch definieren, der einen Radius von 5 darstellt, indem man Koordinaten für einen Einheitskreis und eine Transformation angibt, die die Koordinaten (die Patch-Koordinaten) mit 5 skaliert.

get_path()

Gibt den Pfad dieser Markierung zurück.

get_position()

Gibt die Position der Wirbelsäule zurück.

get_spine_transform()

Gibt die Transformation der Wirbelsäule zurück.

get_window_extent(renderer=None)

Gibt die Fenstererweiterung der Wirbelsäulen im Anzeigeraum zurück, einschließlich eines Abstands für Ticks (aber nicht deren Beschriftungen).

Siehe auch

matplotlib.axes.Axes.get_tightbbox

matplotlib.axes.Axes.get_window_extent

classmethod linear_spine(axes, spine_type, **kwargs)

Erstellt und gibt eine lineare Spine zurück.

register_axis(axis)

Registriert eine Achse.

Eine Achse sollte bei ihrer entsprechenden Wirbelsäule aus der Axes-Instanz registriert werden. Dies ermöglicht es der Wirbelsäule, Achseneigenschaften bei Bedarf zu löschen.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, bounds=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, patch_arc=<UNSET>, patch_circle=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
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
animated	bool
antialiased oder aa	bool oder None
Grenzen	(low: float, high: float)
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color	color
edgecolor oder ec	Farbe oder None
facecolor oder fc	Farbe oder None
figure	Figure oder SubFigure
füllen	bool
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth oder lw	float oder None
mouseover	bool
patch_arc	unknown
patch_circle	unknown
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
position	unknown
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_bounds(low=None, high=None)

Setzt die Grenzen der Wirbelsäule.

Parameter:

lowfloat oder None, optional

Die untere Grenze der Wirbelsäule. Das Übergeben von _None_ belässt das Limit unverändert.

Die Grenzen können auch als Tupel (_low_, _high_) als erstes positionsgebundenes Argument übergeben werden.

highfloat oder None, optional

Die obere Grenze der Wirbelsäule. Das Übergeben von _None_ belässt das Limit unverändert.

set_color(c)

Setzt die Kantenfarbe.

Parameter:

ccolor

Anmerkungen

Diese Methode ändert nicht die Füllfarbe (die standardmäßig auf "none" gesetzt ist), im Gegensatz zur Methode Patch.set_color, die in der Elternklasse definiert ist. Verwenden Sie Patch.set_facecolor, um die Füllfarbe festzulegen.

set_patch_arc(center, radius, theta1, theta2)

Setzt die Wirbelsäule auf bogenförmig.

set_patch_circle(center, radius)

Setzt die Wirbelsäule auf kreisförmig.

set_patch_line()

Setzt die Wirbelsäule auf linear.

set_position(position)

Setzt die Position der Wirbelsäule.

Die Wirbelsäulenposition wird durch ein 2-Tupel aus (Positionstyp, Betrag) angegeben. Die Positionstypen sind

• 'outward': Platziert die Wirbelsäule vom Datenbereich aus um die angegebene Anzahl von Punkten. (Negative Werte platzieren die Wirbelsäule nach innen.)

• 'axes': Platziert die Wirbelsäule an der angegebenen Achsenkoordinate (0 bis 1).

• 'data': Platziert die Wirbelsäule an der angegebenen Datenkoordinate.

Zusätzlich definieren Kurzschnitte spezielle Positionen

• 'center' -> ('axes', 0.5)

• 'zero' -> ('data', 0.0)

Beispiele

Spine-Platzierung

class matplotlib.spines.Spines(**kwargs)

Bases: MutableMapping

Der Container aller Spines in einem Axes.

Die Schnittstelle ist dikt-ähnlich und bildet Namen (z.B. 'left') auf Spine-Objekte ab. Zusätzlich implementiert sie einige pandas.Series-ähnliche Features wie den Zugriff auf Elemente über Attribute.

spines['top'].set_visible(False)
spines.top.set_visible(False)

Mehrere Wirbelsäulen können gleichzeitig adressiert werden, indem eine Liste übergeben wird.

spines[['top', 'right']].set_visible(False)

Verwenden Sie einen offenen Slice, um alle Wirbelsäulen zu adressieren.

spines[:].set_visible(False)

Die beiden letzteren Indexierungsmethoden geben ein SpinesProxy zurück, das alle set_*()- und set()-Aufrufe an seine Mitglieder weiterleitet, aber nicht für andere Operationen verwendet werden kann.

classmethod from_dict(d)

class matplotlib.spines.SpinesProxy(spine_dict)

Bases: object

Ein Proxy zum Weiterleiten von set_*()- und set()-Methodenaufrufen an die enthaltenen Spines.

Der Proxy kann für keine anderen Operationen auf seinen Mitgliedern verwendet werden.

Die unterstützten Methoden werden dynamisch basierend auf den enthaltenen Wirbelsäulen ermittelt. Wenn nicht alle Wirbelsäulen eine gegebene Methode unterstützen, wird sie nur auf der Teilmenge der Wirbelsäulen ausgeführt, die sie unterstützen.