matplotlib.pyplot.barbs

matplotlib.pyplot.barbs(*args, data=None, **kwargs)

Plottet ein 2D-Feld von Windfahnen.

Aufruf-Signatur

barbs([X, Y], U, V, [C], /, **kwargs)

Wobei X, Y die Positionen der Barben definieren, U, V die Richtung der Barben definieren und C optional die Farbe festlegt.

Die Argumente X, Y, U, V, C sind nur positionsabhängig und können 1D oder 2D sein. U, V, C können Maskierungsarrays sein, aber maskierte X, Y werden derzeit nicht unterstützt.

Barben werden traditionell in der Meteorologie verwendet, um die Geschwindigkeit und Richtung von Windbeobachtungen darzustellen, können aber technisch gesehen jede zweidimensionale Vektorgröße darstellen. Im Gegensatz zu Pfeilen, deren Länge die Vektorgröße angibt, liefern Barben quantitativere Informationen über die Vektorgröße, indem sie schräge Linien oder ein Dreieck für verschiedene Größeninkremente anbringen, wie unten schematisch dargestellt

:                   /\    \
:                  /  \    \
:                 /    \    \    \
:                /      \    \    \
:               ------------------------------

Das größte Inkrement wird durch ein Dreieck (oder "Flagge") gegeben. Danach kommen volle Linien (Barben). Das kleinste Inkrement ist eine halbe Linie. Es gibt natürlich immer nur höchstens 1 halbe Linie. Wenn die Größe klein ist und nur eine einzige halbe Linie benötigt, ohne volle Linien oder Dreiecke, wird die halbe Linie vom Ende der Barbe versetzt, damit sie leicht von Barben mit einer einzigen vollen Linie unterschieden werden kann. Die Größe für die oben gezeigte Barbe wäre nominell 65, unter Verwendung der Standardinkremente von 50, 10 und 5.

Siehe auch https://en.wikipedia.org/wiki/Wind_barb.

Parameter:

X, Y1D oder 2D array-ähnlich, optional

Die x- und y-Koordinaten der Barbpositionen. Siehe pivot, wie die Barben zu den x, y-Positionen gezeichnet werden.

Wenn nicht angegeben, werden sie als einheitliches ganzzahliges Meshgrid basierend auf den Dimensionen von U und V generiert.

Wenn X und Y 1D sind, U und V aber 2D sind, werden X, Y mit X, Y = np.meshgrid(X, Y) auf 2D erweitert. In diesem Fall müssen len(X) und len(Y) mit den Spalten- und Zeilendimensionen von U und V übereinstimmen.

U, V1D oder 2D array-ähnlich

Die x- und y-Komponenten des Barb-Schafts.

C1D oder 2D array-ähnlich, optional

Numerische Daten, die die Farben der Barben durch Farbmapping über norm und cmap definieren.

Dies unterstützt keine expliziten Farben. Wenn Sie Farben direkt festlegen möchten, verwenden Sie stattdessen barbcolor.

lengthfloat, Standard: 7

Länge der Barbe in Punkten; die anderen Teile der Barbe werden dagegen skaliert.

pivot{'tip', 'middle'} oder float, Standard: 'tip'

Der Teil des Pfeils, der an das X, Y-Gitter angeheftet ist. Die Barbe dreht sich um diesen Punkt. Dies kann auch eine Zahl sein, die den Anfang der Barbe um so viele Punkte vom Gitterpunkt wegschiebt.

barbcolorFarbe oder Farbsequenz

Die Farbe aller Teile der Barbe außer den Flaggen. Dieser Parameter ist analog zum Parameter edgecolor für Polygone, der stattdessen verwendet werden kann. Dieser Parameter überschreibt jedoch die Füllfarbe.

flagcolorFarbe oder Farbsequenz

Die Farbe von Flaggen auf der Barbe. Dieser Parameter ist analog zum Parameter facecolor für Polygone, der stattdessen verwendet werden kann. Dieser Parameter überschreibt jedoch die Füllfarbe. Wenn dieser nicht gesetzt ist (und C auch nicht), wird flagcolor so gesetzt, dass er barbcolor entspricht, damit die Barbe eine einheitliche Farbe hat. Wenn C gesetzt wurde, hat flagcolor keine Auswirkung.

sizesdict, optional

Ein Wörterbuch mit Koeffizienten, das das Verhältnis eines gegebenen Merkmals zur Länge der Barbe angibt. Nur die Werte, die überschrieben werden sollen, müssen enthalten sein. Diese Merkmale umfassen

• 'spacing' - Abstand zwischen den Merkmalen (Flaggen, volle/halbe Barben)

• 'height' - Höhe (Abstand vom Schaft zur Spitze) einer Flagge oder vollen Barbe

• 'width' - Breite einer Flagge, doppelt so breit wie eine volle Barbe

• 'emptybarb' - Radius des Kreises für geringe Magnituden

fill_emptybool, Standard: False

Ob die leeren Barben (Kreise), die gezeichnet werden, mit der Flaggenfarbe gefüllt werden sollen. Wenn sie nicht gefüllt sind, ist die Mitte transparent.

roundingbool, Standard: True

Ob die Vektorgröße bei der Zuweisung von Barb-Komponenten gerundet werden soll. Wenn True, wird die Größe auf das nächste Vielfache des Halb-Barben-Inkrements gerundet. Wenn False, wird die Größe einfach auf das nächstniedrigere Vielfache gekürzt.

barb_incrementsdict, optional

Ein Wörterbuch mit Inkrementen, das Werte angibt, die verschiedenen Teilen der Barbe zugeordnet werden. Nur die Werte, die überschrieben werden sollen, müssen enthalten sein.

• 'half' - halbe Barben (Standard ist 5)

• 'full' - volle Barben (Standard ist 10)

• 'flag' - Flaggen (Standard ist 50)

flip_barbbool oder array-ähnlich von bool, Standard: False

Ob die Linien und Flaggen entgegengesetzt zum Normalfall zeigen sollen. Das normale Verhalten ist, dass die Barben und Linien nach rechts zeigen (stammt von Windbarben, die diese Merkmale auf der Nordhalbkugel in Richtung niedrigeren Drucks zeigen).

Ein einzelner Wert wird auf alle Barben angewendet. Einzelne Barben können durch Übergabe eines booleschen Arrays derselben Größe wie U und V umgedreht werden.

Gibt zurück:

barbsBarbs

Andere Parameter:

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch eine Zeichenkette s, die als data[s] interpretiert wird, wenn s ein Schlüssel in data ist.

**kwargs

Die Barben können weiter mit PolyCollection-Schlüsselwortargumenten angepasst werden

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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
edgecolor oder ec oder edgecolors	Farbe oder Liste von Farben oder 'face'
facecolor oder facecolors oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder dashes oder linestyles oder ls	str oder Tupel oder Liste davon
linewidth oder linewidths oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	Liste von AbstractPathEffect
paths	liste von array-like
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	liste von array-like
verts_and_codes	unknown
visible	bool
zorder	float

Anmerkungen

Hinweis

Dies ist der pyplot Wrapper für axes.Axes.barbs.

Beispiele mit matplotlib.pyplot.barbs

Windbarben

Windbarben