matplotlib.axes.Axes.barbs

Haches. barbes ( * args , data = None , ** kwargs )

Tracez un champ 2D de barbes.

Signature d'appel :

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

Où X , Y définissent les emplacements des barbes, U , V définissent les directions des barbes et C définit éventuellement la couleur.

Tous les arguments peuvent être 1D ou 2D. U , V , C peuvent être des tableaux masqués, mais les X , Y masqués ne sont pas pris en charge pour le moment.

Les barbes sont traditionnellement utilisées en météorologie pour tracer la vitesse et la direction des observations du vent, mais peuvent techniquement être utilisées pour tracer n'importe quelle quantité vectorielle bidimensionnelle. Contrairement aux flèches, qui donnent la magnitude du vecteur par la longueur de la flèche, les barbes donnent des informations plus quantitatives sur la magnitude du vecteur en mettant des lignes inclinées ou un triangle pour divers incréments de magnitude, comme indiqué schématiquement ci-dessous :

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

Le plus grand incrément est donné par un triangle (ou "drapeau"). Après ceux-ci viennent des lignes complètes (barbes). Le plus petit incrément est une demi-ligne. Il n'y a, bien sûr, jamais au plus 1 demi-ligne. Si la magnitude est petite et ne nécessite qu'une seule demi-ligne et pas de lignes pleines ou de triangles, la demi-ligne est décalée de l'extrémité de la barbe afin qu'elle puisse être facilement distinguée des barbes avec une seule ligne pleine. La magnitude de la barbe indiquée ci-dessus serait nominalement de 65, en utilisant les incréments standard de 50, 10 et 5.

Voir aussi https://en.wikipedia.org/wiki/Wind_barb .

Paramètres :

X, Y 1D ou 2D de type tableau, en option

Les coordonnées x et y des emplacements des barbes. Voir pivot pour savoir comment les barbes sont dessinées aux positions x, y.

S'ils ne sont pas indiqués, ils seront générés sous la forme d'un maillage entier uniforme basé sur les dimensions de U et V .

Si X et Y sont 1D mais que U , V sont 2D, X , Y sont développés en 2D en utilisant . Dans ce cas , et doit correspondre aux dimensions de colonne et de ligne de U et V .X, Y = np.meshgrid(X, Y)len(X)len(Y)

U, V 1D ou 2D de type tableau

Les composants x et y de l'arbre barbelé.

C Type de tableau 1D ou 2D, en option

Données numériques qui définissent les couleurs des barbes par colormapping via norm et cmap .

Cela ne prend pas en charge les couleurs explicites. Si vous souhaitez définir directement les couleurs, utilisez plutôt barbcolor .

longueur flottante, par défaut : 7

Longueur de la barbe en points ; les autres parties de la barbe sont mises à l'échelle par rapport à cela.

pivot {'tip', 'middle'} ou flottant, par défaut : 'tip'

La partie de la flèche qui est ancrée à la grille X , Y. La barbe tourne autour de ce point. Il peut également s'agir d'un nombre, qui décale le début de la barbe de plusieurs points du point de la grille.

couleur barbcolor ou séquence de couleurs

La couleur de toutes les parties de la barbe à l'exception des drapeaux. Ce paramètre est analogue au paramètre edgecolor pour les polygones, qui peut être utilisé à la place. Cependant, ce paramètre remplacera facecolor.

flagcolor couleur ou séquence de couleurs

La couleur de tous les drapeaux sur la barbe. Ce paramètre est analogue au paramètre facecolor pour les polygones, qui peut être utilisé à la place. Cependant, ce paramètre remplacera facecolor. Si ce n'est pas défini (et C n'en a pas non plus), alors flagcolor sera défini pour correspondre à barbcolor afin que la barbe ait une couleur uniforme. Si C a été défini, flagcolor n'a aucun effet.

dictée des tailles , facultatif

Un dictionnaire de coefficients spécifiant le rapport d'une caractéristique donnée à la longueur de la barbe. Seules les valeurs que l'on souhaite remplacer doivent être incluses. Ces fonctionnalités incluent :

• 'spacing' - espace entre les éléments (drapeaux, barbillons pleins/demi)

• 'hauteur' - hauteur (distance du manche au sommet) d'un drapeau ou d'une barbe pleine

• 'width' - largeur d'un drapeau, deux fois la largeur d'une barbe pleine

• 'emptybarb' - rayon du cercle utilisé pour les faibles magnitudes

fill_empty booléen , par défaut : False

Si les barbes vides (cercles) qui sont dessinées doivent être remplies avec la couleur du drapeau. S'ils ne sont pas remplis, le centre est transparent.

arrondi booléen, par défaut : True

Indique si la magnitude du vecteur doit être arrondie lors de l'attribution des composants barbillon. Si True, la magnitude est arrondie au multiple le plus proche de l'incrément d'une demi-barbe. Si False, la magnitude est simplement tronquée au multiple le plus bas suivant.

barb_increments dict, facultatif

Un dictionnaire d'incréments spécifiant les valeurs à associer aux différentes parties de la barbe. Seules les valeurs que l'on souhaite remplacer doivent être incluses.

• 'half' - demi-barbes (la valeur par défaut est 5)

• 'full' - barbillons complets (la valeur par défaut est 10)

• 'flag' - drapeaux (la valeur par défaut est 50)

flip_barb bool ou semblable à un tableau de bool, par défaut : False

Si les lignes et les drapeaux doivent pointer à l'opposé de la normale. Le comportement normal est que les barbillons et les lignes pointent vers la droite (provient des barbules de vent ayant ces caractéristiques pointant vers la basse pression dans l'hémisphère nord).

Une seule valeur est appliquée à toutes les barbes. Les barbes individuelles peuvent être retournées en passant un tableau booléen de la même taille que U et V .

Retours :

barbesBarbs

Autres paramètres :

objet de données indexable, facultatif

S'ils sont donnés, tous les paramètres acceptent également une chaîne s, qui est interprétée comme data[s](sauf si cela déclenche une exception).

**kwargs

Les barbes peuvent en outre être personnalisées à l'aide d' PolyCollectionarguments de mots-clés :

Propriété	La description
agg_filter	une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image
alpha	de type tableau ou scalaire ou Aucun
animated	bourdonner
antialiasedou aa ou antialiasés	bool ou liste de bools
array	semblable à un tableau ou Aucun
capstyle	CapStyleou {'bout', 'en saillie', 'rond'}
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	Colormapou str ou Aucun
color	couleur ou liste de tuples rgba
edgecolorou ec ou edgecolors	couleur ou liste de couleurs ou 'visage'
facecolorou facecolors ou fc	couleur ou liste de couleurs
figure	Figure
gid	chaîne
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bourdonner
joinstyle	JoinStyleou {'onglet', 'rond', 'biseau'}
label	objet
linestyleou tirets ou styles de ligne ou ls	str ou tuple ou une liste de ceux-ci
linewidthou largeurs de ligne ou lw	flottant ou liste de flottants
mouseover	bourdonner
norm	Normalizeou str ou Aucun
offset_transformou transOffset	inconnue
offsets	(N, 2) ou (2,) en forme de tableau
path_effects	AbstractPathEffect
paths	liste de type tableau
picker	Aucun ou bool ou flottant ou appelable
pickradius	inconnue
rasterized	bourdonner
sizes	ndarray ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
urls	liste de str ou None
verts	liste de type tableau
verts_and_codes	inconnue
visible	bourdonner
zorder	flotteur

Exemples utilisant matplotlib.axes.Axes.barbs

Barbes de vent

Barbes de vent

barbes(X, Y, U, V)

barbes(X, Y, U, V)