matplotlib.pyplot.barbs #

matplotlib.pyplot. barbs ( * args , data = None , ** kwargs ) [Quelle] #

Zeichnen Sie ein 2D-Feld mit Widerhaken.

Rufsignatur:

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

Wobei X , Y die Widerhakenpositionen definieren, U , V die Widerhakenrichtungen definieren und C optional die Farbe festlegt.

Alle Argumente können 1D oder 2D sein. U , V , C können maskierte Arrays sein, aber maskierte X , Y werden derzeit nicht unterstützt.

Widerhaken werden traditionell in der Meteorologie verwendet, um die Geschwindigkeit und Richtung von Windbeobachtungen zu zeichnen, können aber technisch verwendet werden, um jede zweidimensionale Vektorgröße zu zeichnen. Im Gegensatz zu Pfeilen, die die Vektorgröße durch die Länge des Pfeils angeben, geben die Widerhaken mehr quantitative Informationen über die Vektorgröße, indem sie schräge Linien oder ein Dreieck für verschiedene Größeninkremente setzen, wie unten schematisch dargestellt:

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

Das größte Inkrement wird durch ein Dreieck (oder "Flag") angegeben. Danach kommen volle Linien (Barbs). Das kleinste Inkrement ist eine halbe Zeile. Es gibt natürlich immer nur höchstens 1 Halbzeile. Wenn die Größe klein ist und nur eine einzelne Halblinie und keine Volllinien oder Dreiecke benötigt, wird die Halblinie vom Ende des Widerhakens versetzt, damit sie leicht von Widerhaken mit einer einzelnen Volllinie unterschieden werden kann. Die Stärke für den oben gezeigten Widerhaken wäre nominell 65, unter Verwendung der Standardinkremente von 50, 10 und 5.

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

Parameter :

X, Y 1D oder 2D Array-ähnlich, optional

Die x- und y-Koordinaten der Widerhakenpositionen. Siehe Pivot , um zu erfahren, wie die Widerhaken zu den x-, y-Positionen gezogen werden.

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

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

U, V 1D oder 2D Array-ähnlich

Die x- und y-Komponenten des Widerhakenschafts.

C 1D- oder 2D-Array-ähnlich, optional

Numerische Daten, die die Barb-Farben durch Colormapping über norm und cmap definieren .

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

Länge Float, Standard: 7

Länge des Widerhakens in Punkten; die anderen Teile des Widerhakens werden dagegen skaliert.

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

Der Teil des Pfeils, der am X- , Y -Raster verankert ist. Um diesen Punkt dreht sich der Widerhaken. Dies kann auch eine Zahl sein, die den Anfang des Widerhakens um so viele Punkte vom Rasterpunkt weg verschiebt.

barbcolor Farbe oder Farbfolge

Die Farbe aller Teile des Widerhakens mit Ausnahme der Fahnen. Dieser Parameter ist analog zum Parameter edgecolor für Polygone, der stattdessen verwendet werden kann. Dieser Parameter überschreibt jedoch die Gesichtsfarbe.

flagcolor Farbe oder Farbfolge

Die Farbe aller Flaggen auf dem Widerhaken. Dieser Parameter ist analog zum facecolor- Parameter für Polygone, der stattdessen verwendet werden kann. Dieser Parameter überschreibt jedoch die Gesichtsfarbe. Wenn dies nicht gesetzt ist (und C auch nicht), dann wird flagcolor so gesetzt, dass es mit barbcolor übereinstimmt, sodass der Barb eine einheitliche Farbe hat. Wenn C gesetzt wurde, hat flagcolor keine Auswirkung.

Größenvorschrift , optional

Ein Wörterbuch von Koeffizienten, die das Verhältnis eines bestimmten Merkmals zur Länge des Widerhakens angeben. Nur die Werte, die man überschreiben möchte, müssen eingeschlossen werden. Zu diesen Funktionen gehören:

'spacing' - Abstand zwischen Merkmalen (Flaggen, volle/halbe Widerhaken)
'Höhe' - Höhe (Abstand vom Schaft bis zur Spitze) einer Flagge oder eines vollen Widerhakens
'Breite' - Breite einer Flagge, doppelt so breit wie ein voller Widerhaken
'emptybarb' - Radius des Kreises, der für niedrige Magnituden verwendet wird

fill_empty bool, Standard: False

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

Rundung bool, Standard: True

Ob die Vektorgröße beim Zuweisen von Barb-Komponenten gerundet werden soll. Wenn True, wird die Größe auf das nächste Vielfache des Halbbarb-Inkrements gerundet. Bei False wird die Magnitude einfach auf das nächstniedrigere Vielfache gekürzt.

barb_increments dict, optional

Ein Wörterbuch mit Inkrementen, die Werte angeben, die verschiedenen Teilen des Widerhakens zugeordnet werden sollen. Nur die Werte, die man überschreiben möchte, müssen eingeschlossen werden.

'half' - halbe Widerhaken (Standard ist 5)
'full' - volle Widerhaken (Standard ist 10)
'flag' - Flags (Standard ist 50)

flip_barb bool oder Array-ähnlich von bool, Standard: False

Ob die Linien und Flaggen entgegengesetzt zum Normal zeigen sollen. Normales Verhalten ist, dass die Widerhaken und Linien nach rechts zeigen (kommt von Windwiderhaken, die diese Merkmale in Richtung Tiefdruck in der nördlichen Hemisphäre zeigen).

Ein einzelner Wert wird auf alle Widerhaken angewendet. Einzelne Widerhaken können umgedreht werden, indem ein boolsches Array der gleichen Größe wie U und V übergeben wird .

Rückgaben :

WiderhakenBarbs

Andere Parameter :

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

**Kwarg

Die Widerhaken können mithilfe von PolyCollectionSchlüsselwortargumenten weiter angepasst werden:

Eigentum	Beschreibung
`agg_filter`	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
`alpha`	Array-ähnlich oder Skalar oder None
`animated`	bool
`antialiased`oder aa oder Antialiasing	bool oder Liste von bools
`array`	Array-ähnlich oder None
`capstyle`	`CapStyle`oder {'hinter', 'vorstehend', 'rund'}
`clim`	(vmin: Float, vmax: Float)
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch oder (Pfad, Transform) oder None
`cmap`	`Colormap`oder str oder Keine
`color`	Farbe oder Liste von RGBA-Tupeln
`edgecolor`oder ec oder edgecolors	Farbe oder Liste von Farben oder 'Gesicht'
`facecolor`oder facecolors oder fc	Farbe oder Farbliste
`figure`	`Figure`
`gid`	Str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle`oder {'Gehrung', 'rund', 'Fase'}
`label`	Objekt
`linestyle`oder Bindestriche oder Linienstile oder ls	str oder Tupel oder Liste davon
`linewidth`oder Linienbreiten oder lw	Float oder Liste von Floats
`mouseover`	bool
`norm`	`Normalize`oder str oder Keine
`offset_transform`oder transOffset	Unbekannt
`offsets`	(N, 2) oder (2,) Array-artig
`path_effects`	`AbstractPathEffect`
`paths`	Liste von Array-ähnlichen
`picker`	None oder bool oder float oder aufrufbar
`pickradius`	Unbekannt
`rasterized`	bool
`sizes`	ndarray oder None
`sketch_params`	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
`snap`	bool oder Keine
`transform`	`Transform`
`url`	Str
`urls`	Liste von str oder None
`verts`	Liste von Array-ähnlichen
`verts_and_codes`	Unbekannt
`visible`	bool
`zorder`	schweben