matplotlib.axes.Axes.quiver #
- Haches. quiver ( * args , data = None , ** kwargs ) [source] #
Tracez un champ de flèches 2D.
Signature d'appel :
quiver([X, Y], U, V, [C], **kwargs)
X , Y définissent les emplacements des flèches, U , V définissent les directions des flèches et C définit éventuellement la couleur.
Longueur de la flèche
Les paramètres par défaut redimensionnent automatiquement la longueur des flèches à une taille raisonnable. Pour modifier ce comportement, consultez les paramètres scale et scale_units .
Forme de flèche
La forme de la flèche est déterminée par width , headwidth , headlength et headaxislength . Voir les notes ci-dessous.
Style de flèche
Chaque flèche est représentée en interne par un polygone rempli avec une largeur de ligne de bord par défaut de 0. Par conséquent, une flèche est plutôt une zone remplie, pas une ligne avec une tête, et
PolyCollectiondes propriétés comme linewidth , edgecolor , facecolor , etc. agissent en conséquence.- Paramètres :
- X, Y 1D ou 2D de type tableau, en option
Les coordonnées x et y des emplacements des flèches.
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 composantes de direction x et y des vecteurs fléchés. L'interprétation de ces composantes (en données ou en espace écran) dépend des angles .
U et V doivent avoir le même nombre d'éléments, correspondant au nombre d'emplacements de flèches dans X , Y . U et V peuvent être masqués. Les emplacements masqués dans l'un des U , V et C ne seront pas dessinés.
- C Type de tableau 1D ou 2D, en option
Données numériques qui définissent les couleurs des flèches 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 la couleur . La taille de C doit correspondre au nombre d'emplacements de flèche.
- angles {'uv', 'xy'} ou comme un tableau, par défaut : 'uv'
Méthode pour déterminer l'angle des flèches.
'uv' : direction de la flèche dans les coordonnées de l'écran. Utilisez ceci si les flèches symbolisent une quantité qui n'est pas basée sur les coordonnées de données X , Y.
Si U == V , l'orientation de la flèche sur le tracé est de 45 degrés dans le sens inverse des aiguilles d'une montre par rapport à l'axe horizontal (positif vers la droite).
'xy' : direction de la flèche dans les coordonnées des données, c'est-à-dire que les flèches pointent de (x, y) à (x+u, y+v). Utilisez ceci par exemple pour tracer un champ dégradé.
Des angles arbitraires peuvent être spécifiés explicitement sous la forme d'un tableau de valeurs en degrés, dans le sens antihoraire à partir de l'axe horizontal.
Dans ce cas U , V n'est utilisé que pour déterminer la longueur des flèches.
Remarque : l'inversion d'un axe de données inversera les flèches correspondantes uniquement avec
angles='xy'.- pivot {'tail', 'mid', 'middle', 'tip'}, par défaut : 'tail'
La partie de la flèche qui est ancrée à la grille X , Y. La flèche tourne autour de ce point.
'moyen' est synonyme de 'milieu'.
- flotteur d'échelle , en option
Met à l'échelle la longueur de la flèche en sens inverse.
Nombre d'unités de données par unité de longueur de flèche, par exemple, m/s par largeur de parcelle ; un paramètre d'échelle plus petit allonge la flèche. La valeur par défaut est Aucun .
Si None , un simple algorithme de mise à l'échelle automatique est utilisé, basé sur la longueur moyenne des vecteurs et le nombre de vecteurs. L'unité de longueur de la flèche est donnée par le paramètre scale_units .
- scale_units {'largeur', 'hauteur', 'points', 'pouces', 'x', 'y', 'xy'}, facultatif
Si l' échelle kwarg est None , l'unité de longueur de la flèche. La valeur par défaut est Aucun .
par exemple , scale_units est 'inches', scale est 2.0, et , alors le vecteur aura une longueur de 0.5 pouces.
(u, v) = (1, 0)Si scale_units vaut 'width' ou 'height', alors le vecteur sera la moitié de la largeur/hauteur des axes.
Si scale_units est 'x' alors le vecteur sera de 0,5 unités d'axe x. Pour tracer des vecteurs dans le plan xy, avec u et v ayant les mêmes unités que x et y, utilisez .
angles='xy', scale_units='xy', scale=1- unités {'largeur', 'hauteur', 'points', 'pouces', 'x', 'y', 'xy'}, par défaut : 'largeur'
Affecte la taille de la flèche (à l'exception de la longueur). En particulier, la largeur de l'arbre est mesurée en multiples de cette unité.
Les valeurs prises en charge sont :
'width', 'height' : La largeur ou la hauteur des Axes.
'points', 'pouces' : Pixels ou pouces basés sur la figure dpi.
'x', 'y', 'xy' : X , Y ou\(\sqrt{X^2 + Y^2}\)en unités de données.
Le tableau suivant résume la façon dont ces valeurs affectent la taille de la flèche visible sous le zoom et les modifications de la taille de la figure :
unités
Zoom
changement de taille de figurine
'x', 'y', 'xy'
échelles de taille de flèche
'largeur hauteur'
échelles de taille de flèche
'points', 'pouces'
- flotteur de largeur , facultatif
Largeur de la tige en unités fléchées. Tous les paramètres de la tête sont relatifs à width .
La valeur par défaut dépend du choix des unités ci-dessus et du nombre de vecteurs ; une valeur de départ typique est d'environ 0,005 fois la largeur de la parcelle.
- largeur de tête flottante, par défaut : 3
Largeur de la tête comme multiple de la largeur de l'arbre . Voir les notes ci-dessous.
- longueur de tête flottante, par défaut : 5
Longueur de la tête en multiple de la largeur de la tige . Voir les notes ci-dessous.
- headaxislength flottant, par défaut : 4,5
Longueur de la tête à l'intersection de l'arbre en tant que multiple de la largeur de l'arbre . Voir les notes ci-dessous.
- flottant de l'arbre min , par défaut : 1
Longueur en dessous de laquelle la flèche évolue, en unités de longueur de tête. Ne le réglez pas sur moins de 1, sinon les petites flèches auront l'air terribles !
- minlength flottant, par défaut : 1
Longueur minimale en multiple de la largeur de l'arbre ; si la longueur d'une flèche est inférieure à cela, tracez un point (hexagone) de ce diamètre à la place.
- couleur couleur ou séquence de couleurs, en option
Couleur(s) explicite(s) pour les flèches. Si C a été défini, la couleur n'a aucun effet.
C'est un synonyme du paramètre facecolor .
PolyCollection
- Retours :
- 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 commedata[s](sauf si cela déclenche une exception).- **propriétés kwargs
PolyCollection, facultatives Tous les autres arguments de mots clés sont transmis à
PolyCollection:Propriété
La description
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
de type tableau ou scalaire ou Aucun
bourdonner
antialiasedou aa ou antialiasésbool ou liste de bools
semblable à un tableau ou Aucun
CapStyleou {'bout', 'en saillie', 'rond'}(vmin : flottant, vmax : flottant)
bourdonner
Patch ou (chemin, transformation) ou aucun
Colormapou str ou Aucuncouleur ou liste de tuples rgba
edgecolorou ec ou edgecolorscouleur ou liste de couleurs ou 'visage'
facecolorou facecolors ou fccouleur ou liste de couleurs
chaîne
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bourdonner
JoinStyleou {'onglet', 'rond', 'biseau'}objet
linestyleou tirets ou styles de ligne ou lsstr ou tuple ou une liste de ceux-ci
linewidthou largeurs de ligne ou lwflottant ou liste de flottants
bourdonner
Normalizeou str ou Aucunoffset_transformou transOffsetinconnue
(N, 2) ou (2,) en forme de tableau
liste de type tableau
Aucun ou bool ou flottant ou appelable
inconnue
bourdonner
sizesndarray ou Aucun
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
chaîne
liste de str ou None
liste de type tableau
inconnue
bourdonner
flotteur
Voir également
Axes.quiverkeyAjouter une clé à un tracé de carquois.
Remarques
Forme de flèche
La flèche est dessinée sous forme de polygone en utilisant les nœuds comme indiqué ci-dessous. Les valeurs headwidth , headlength et headaxislength sont exprimées en unités de largeur .
Les valeurs par défaut donnent une flèche légèrement inclinée vers l'arrière. Voici quelques conseils pour obtenir d'autres formes de tête :
Pour faire de la tête un triangle, faites que headaxislength soit identique à headlength .
Pour rendre la flèche plus pointue, réduisez headwidth ou augmentez headlength et headaxislength .
Pour rendre la tête plus petite par rapport à la tige, réduisez proportionnellement tous les paramètres de la tête.
Pour supprimer complètement la tête, réglez tous les paramètres de la tête sur 0.
Pour obtenir une tête en forme de losange, faites que headaxislength soit plus grand que headlength .
Avertissement : Pour headaxislength < ( headlength / headwidth ), les nœuds "headaxis" (c'est-à-dire ceux qui relient la tête à l'arbre) dépasseront de la tête vers l'avant, de sorte que la tête de la flèche semble brisée.
