matplotlib.quiver.QuiverKey

class matplotlib.quiver.QuiverKey(Q, X, Y, U, label, *, angle=0, coordinates='axes', color=None, labelsep=0.1, labelpos='N', labelcolor=None, fontproperties=None, zorder=None, **kwargs)

Bases: Artist

Beschrifteter Pfeil zur Verwendung als Skalenschlüssel für Pfeil-Plots.

Fügt einem Quiver-Plot eine Legende hinzu.

Die Position des Schlüssels hängt von X, Y, coordinates und labelpos ab. Wenn labelpos 'N' oder 'S' ist, geben X, Y die Position der Mitte des Schlüsselpfeils an. Wenn labelpos 'E' ist, positioniert X, Y die Spitze, und wenn labelpos 'W' ist, positioniert X, Y den Schwanz; in beiden dieser beiden Fälle befindet sich X, Y irgendwo in der Mitte des Pfeil+Beschriftungs-Schlüssels.

Parameter:

QQuiver

Ein Quiver-Objekt, wie es von einem Aufruf von quiver() zurückgegeben wird.

X, Yfloat

Die Position des Schlüssels.

Ufloat

Die Länge des Schlüssels.

labelstr

Die Schlüsselbeschriftung (z. B. Länge und Einheiten des Schlüssels).

anglefloat, default: 0

Der Winkel des Schlüsselpfeils, in Grad gegen den Uhrzeigersinn von der horizontalen Achse.

coordinates{'axes', 'figure', 'data', 'inches'}, default: 'axes'

Koordinatensystem und Einheiten für X, Y: 'axes' und 'figure' sind normalisierte Koordinatensysteme mit (0, 0) in der unteren linken und (1, 1) in der oberen rechten Ecke; 'data' sind die Achsen-Datenkoordinaten (verwendet für die Positionen der Vektoren im Quiver-Plot selbst); 'inches' ist die Position in der Abbildung in Zoll, mit (0, 0) in der unteren linken Ecke.

colorcolor

Überschreibt Füll- und Randfarben von Q.

labelpos{'N', 'S', 'E', 'W'}

Positioniert die Beschriftung oberhalb, unterhalb, rechts, links vom Pfeil, entsprechend.

labelsepfloat, default: 0.1

Abstand in Zoll zwischen dem Pfeil und der Beschriftung.

labelcolorcolor, default: rcParams["text.color"] (default: 'black')

Farbe der Beschriftung.

fontpropertiesdict, optional

Ein Wörterbuch mit Schlüsselwortargumenten, die vom Initialisierer von FontProperties akzeptiert werden: family, style, variant, size, weight.

zorderfloat

Die Z-Reihenfolge des Schlüssels. Der Standardwert ist 0.1 oberhalb von Q.

**kwargs

Alle zusätzlichen Schlüsselwortargumente werden verwendet, um Vektoreigenschaften zu überschreiben, die von Q übernommen wurden.

contains(mouseevent)

Testet, ob der Künstler das Mausereignis enthält.

Parameter:

mouseeventMouseEvent

Gibt zurück:

containsbool

Gibt an, ob Werte innerhalb des Radius liegen.

detailsdict

Ein Künstler-spezifisches Wörterbuch mit Details zum Ereigniskontext, wie z. B. welche Punkte sich im Auswahlradius befinden. Details finden Sie in den einzelnen Künstler-Unterklassen.

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.

halign = {'E': 'links', 'N': 'mitte', 'S': 'mitte', 'W': 'rechts'}

property labelsep

pivot = {'E': 'spitze', 'N': 'mitte', 'S': 'mitte', 'W': 'fuß'}

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<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
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
figure	unknown
gid	str
in_layout	bool
label	object
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

set_figure(fig)

Setzt die Instanz Figure oder SubFigure, zu der der Künstler gehört.

Parameter:

figFigure oder SubFigure

valign = {'E': 'mitte', 'N': 'unten', 'S': 'oben', 'W': 'mitte'}

Beispiele zur Verwendung von matplotlib.quiver.QuiverKey

Fortgeschrittene Quiver- und Quiverkey-Funktionen

Fortgeschrittene Quiver- und Quiverkey-Funktionen