matplotlib.quiver.Barbs #
- classe matplotlib.quiver. Barbs ( ax , * args , pivot = 'tip' , length = 7 , barbcolor = None , flagcolor = None , sizes = None , fill_empty = False , barb_increments = None , rounding = True , flip_barb = False , ** kwargs ) [ sources] #
Socles :
PolyCollection
PolyCollection spécialisée pour les barbes.
La seule méthode API est
set_UVC()
, qui peut être utilisée pour modifier la taille, l'orientation et la couleur des flèches. Les emplacements sont modifiés à l'aide de laset_offsets()
méthode de collecte. Peut-être que cette méthode sera utile dans les animations.Il y a une fonction interne
_find_tails()
qui trouve exactement ce qui doit être mis sur l'ardillon compte tenu de la magnitude du vecteur. De là_make_barbs()
est utilisé pour trouver les sommets du polygone pour représenter la barbe en fonction de cette information.Le constructeur prend un argument obligatoire, une instance Axes, suivi des arguments et kwargs décrits par la documentation de l'interface pyplot suivante :
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 :
- barbes
Barbs
- barbes
- Autres paramètres :
- objet de données indexable, facultatif
DATA_PARAMETER_PLACEHOLDER
- **kwargs
Les barbes peuvent en outre être personnalisées à l'aide d'
PolyCollection
arguments de mots-clés :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
antialiased
ou aa ou antialiasésbool ou liste de bools
semblable à un tableau ou Aucun
CapStyle
ou {'bout', 'en saillie', 'rond'}(vmin : flottant, vmax : flottant)
bourdonner
Patch ou (chemin, transformation) ou aucun
Colormap
ou str ou Aucuncouleur ou liste de tuples rgba
edgecolor
ou ec ou edgecolorscouleur ou liste de couleurs ou 'visage'
facecolor
ou facecolors ou fccouleur ou liste de couleurs
chaîne
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bourdonner
JoinStyle
ou {'onglet', 'rond', 'biseau'}objet
linestyle
ou tirets ou styles de ligne ou lsstr ou tuple ou une liste de ceux-ci
linewidth
ou largeurs de ligne ou lwflottant ou liste de flottants
bourdonner
Normalize
ou str ou Aucunoffset_transform
ou transOffsetinconnue
(N, 2) ou (2,) en forme de tableau
liste de type tableau
Aucun ou bool ou flottant ou appelable
inconnue
bourdonner
sizes
ndarray 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
- barbs_doc = '\nTracer un champ 2D de barbes.\n\nSignature d'appel ::\n\n barbs([X, Y], U, V, [C], **kwargs)\n\nOù *X*, *Y* définit les emplacements des barbes, * U*, *V* définissent les directions\ndes barbes et *C* définit éventuellement la couleur.\n\nTous les arguments peuvent être 1D ou 2D. *U*, *V*, *C* peuvent être des tableaux masqués , mais masqués\n*X*, *Y* ne sont pas pris en charge pour le moment.\n\nLes barbes sont traditionnellement utilisées en météorologie pour tracer la vitesse\net la direction des observations de vent, mais peuvent techniquement être utilisées pour \ ntracer n'importe quel bidimensionnel quantité vectorielle . Contrairement aux flèches, qui\ndonnent une magnitude vectorielle par la longueur de la flèche, les barbes donnent plus d' informations \nquantitatives sur la magnitude du vecteur en mettant des\nlignes inclinées ou un triangle pour divers incréments de magnitude, comme indiqué\nschématiquement ci- dessous : :\n\n : /\\ \\\n : / \\ \\\n : / \\ \\ \\\n : / \\ \\ \\\n : ------------------------------ -----\n\nLe plus grand incrément est donné par un triangle (ou "drapeau"). Après ces \ nviennent des lignes complètes (barbes). Le plus petit incrément est une demi- ligne. Il n'y a bien sûr qu'au plus 1 demi - ligne. Si la magnitude est\npetite et n'a besoin que d' une seule demi-ligne et pas de lignes complètes ou\nde triangles, la demi-ligne est décalée à partir de l' extrémité de la barbe afin qu'elle \n puisse être facilement distinguée des barbes avec une seule ligne pleine . La\nmagnitude de la barbe indiquée ci- dessus serait nominalement de 65, en utilisant les\nincréments standard de 50 , 10 et 5.\n\nVoir également https://en.wikipedia.org/wiki/Wind_barb.\n\nParamètres\ n----------\nX, Y : 1D ou 2D sous forme de tableau, facultatif\n Les coordonnées x et y des emplacements des barbes . Voir *pivot* pour savoir comment les\n barbes sont dessinées aux positions x, y .\n\n Si elles ne sont pas fournies, elles seront générées sous la forme d' un maillage entier uniforme basé\n sur les dimensions de *U* et *V* .\n\n Si *X* et *Y* sont 1D mais *U*, *V* sont 2D, *X*, *Y* sont étendus en 2D\n en utilisant ``X, Y = np.meshgrid(X, Y)``. Dans ce cas , ``len(X)`` et ``len(Y)``\n doivent correspondre aux dimensions de colonne et de ligne de *U* et *V*.\n\nU, V : tableau 1D ou 2D- like\n Les composants x et y de la barbe arbre.\n\nC : type de tableau 1D ou 2D , facultatif\n Données numériques qui définissent les couleurs des barbes par mappage de couleurs via *norm* et\n * cmap *.\n\n Cela ne prend pas en charge les couleurs explicites . Si vous souhaitez définir les couleurs directement,\n utilisez *barbcolor* à la place.\n\nlength : float, par défaut : 7\n Longueur de la barbe en points ; les autres parties de la barbe\n sont mises à l' échelle par rapport à cela.\n\npivot : {\'tip\', \'middle\'} ou float, par défaut : \'tip\'\n La partie de la flèche qui est ancré à la grille *X*, *Y* . La barbe\n tourne autour de ce point. Il peut également s'agir d' un nombre, qui décale le\n début de la barbe à plusieurs points du point de la grille .\n\nbarbcolor : couleur ou séquence de couleurs \n La couleur de toutes les parties de la barbe à l' exception des drapeaux. Ce paramètre\n est analogue au paramètre *edgecolor* pour les polygones , qui peut être utilisé\n à la place. Cependant , ce paramètre remplacera facecolor .\n\nflagcolor : couleur ou séquence de couleurs \n La couleur de tous les drapeaux sur le barbillon. Ce paramètre est analogue au paramètre \n *facecolor* pour les polygones , qui peut être utilisé à la place. Cependant,\n ce paramètre remplacera la couleur de face. Si ce n'est pas défini (et que *C* n'a\n pas non plus) , alors *flagcolor* sera être défini pour correspondre à *barbcolor* afin que la\n barbe ait une couleur uniforme . Si *C* a été défini, *flagcolor* n'a aucun effet.\n\nsizes : dict, optionnel\n Un dictionnaire de coefficients spécifiant le rapport d' une caractéristique \n donnée à la longueur de la barbe. Uniquement les valeurs que l'on souhaite \n le remplacement doit être inclus. Ces caractéristiques incluent :\n\n - \'espacement\' - espace entre les éléments (drapeaux, barbillons complets/demi )\n - \'hauteur\' - hauteur (distance du manche au sommet) d' un drapeau ou d'un barbillon complet \ n - \'width\' - largeur d' un drapeau, deux fois la largeur d' une barbe pleine \n - \'barbe vide\' - rayon du cercle utilisé pour les faibles magnitudes\n\nfill_empty : bool, par défaut : False\n Indique si les barbes vides (cercles) qui sont dessinées doivent être remplies \n avec la couleur du drapeau . S'ils ne sont pas remplis, le centre est transparent.\n\nrounding : bool, par défaut : True\n Indique si la magnitude du vecteur doit être arrondi lors de l'allocation des composants barb\n . Si True, la magnitude est arrondie au multiple\n le plus proche de l' incrément d'une demi-barbe . Si False, la magnitude est simplement tronquée\n au multiple inférieur suivant .\n\nbarb_increments : dict, optionnel\n Un dictionnaire d' incréments spécifiant les valeurs à associer \n différentes parties de la barbe. Seules les valeurs que l'on souhaite \n remplacer doivent être incluses.\n\n - \'half\' - demi - barbes (la valeur par défaut est 5)\n - \'full\' - barbules complètes (la valeur par défaut est 10)\n - \'flag\' - drapeaux (la valeur par défaut est 50)\n\nflip_barb : bool ou type tableau de bool, par défaut : False\n Si les lignes et les drapeaux doivent pointer à l' opposé de la normale.\n Le comportement normal est que les barbes et les lignes pointent vers la droite (proviennent du vent\n des barbes ayant ces caractéristiques pointent vers la basse pression dans l' hémisphère \n Nord ).\n\n A une seule valeur est appliquée à toutes les barbes. Des barbes individuelles peuvent être renversé par\n en passant un tableau booléen de la même taille que *U* et *V*.\n\nRetourne\n-------\nbarbs : `~matplotlib.quiver.Barbs`\n\nAutres paramètres \n----------------\ndata : objet indexable , facultatif\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs\n Les barbes peuvent être personnalisées à l' aide du mot-clé `.PolyCollection` \ n arguments :\n\n \n .. table::\n :class: propriété-table\n\n ================================================= ============================================== === ================================================= ================================================= ================================================= =====\n Description de la propriété \n ====================================== ================================================= ======== ========================================= ================================================= ================================================= ================\n :meth:`agg_filter <matplotlib.artist.Artist.set_agg_filter>` une fonction de filtre , qui prend un (m, n, 3) tableau flottant et une valeur dpi , et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l' image\n :meth:`alpha <matplotlib.collections.Collection.set_alpha>` array- comme ou scalaire ou Aucun \n :meth:`animated <matplotlib.artist.Artist.set_animated>` bool \n :meth:`antialiased <matplotlib.collections.Collection.set_antialiased>` ou aa ou antialiaseds bool ou liste de bools \n :meth:`array <matplotlib.cm.ScalarMappable.set_array>` array-like or None \n :meth:`capstyle <matplotlib.collections.Collection.set_capstyle>` `.CapStyle` or {\'butt\', \'projecting\', \'round\'} \n :meth:`clim <matplotlib.cm.ScalarMappable.set_clim>` (vmin: float, vmax: float) \n :meth :`clip_box <matplotlib.artist.Artist.set_clip_box>` `.Bbox` \n :meth:`clip_on <matplotlib.artist.Artist.set_clip_on>` bool \n :meth:`clip_path <matplotlib.artist.Artist.set_clip_path>` Patch ou (chemin, transformation) ou Aucun \n :meth:`cmap <matplotlib.cm.ScalarMappable .set_cmap>` `.Colormap` ou str ou None \n :meth:`color <matplotlib.collections.Collection.set_color>` couleur ou liste de tuples rgba \n :meth:`edgecolor <matplotlib.collections.Collection.set_edgecolor >` ou ec ou edgecolors couleur ou liste de couleurs ou \'face\' \n :meth:`facecolor <matplotlib.collections.Collection.set_facecolor>` ou facecolors ou fc color ou liste de couleurs \n :meth:`figure <matplotlib.artist.Artist. set_figure>` `.Figure` \n :meth:`gid <matplotlib.artist.Artist.set_gid>` str \n :meth:`hatch <matplotlib.collections.Collection.set_hatch>` {\'/\', \ '\\\\\', \'|\', \'-\', \'+\', \'x\', \'o\', \'O\', \'.\', \'*\'} \n :meth:`in_layout <matplotlib.artist.Artist.set_in_layout>` bool \n :meth:`joinstyle <matplotlib.collections.Collection.set_joinstyle>` `.JoinStyle` ou {\'miter \', \'rond\', \'biseau\'} \n :meth:`label <matplotlib.artist.Artist.set_label>` objet \n :meth:` linestyle <matplotlib.collections.Collection.set_linestyle>` ou tirets ou styles de ligne ou ls str ou tuple ou liste de ceux- ci \n :meth:`linewidth <matplotlib.collections.Collection.set_linewidth>` ou largeurs de ligne ou lw flottant ou liste de flottants \n :meth:`mouseover <matplotlib.artist.Artist.set_mouseover>` bool \n :meth:`norm <matplotlib.cm.ScalarMappable .set_norm>` `.Normalize` ou str ou None \n :meth:`offset_transform <matplotlib.collections.Collection.set_offset_transform>` ou transOffset inconnu \n :meth:`offsets <matplotlib.collections.Collection.set_offsets>` ( N, 2) ou (2,) type tableau \n :meth:`path_effects <matplotlib.artist.Artist.set_path_effects>` `.AbstractPathEffect` \n :meth:`paths <matplotlib.collections.PolyCollection.set_verts>` liste de type tableau \n :meth :`picker <matplotlib.artist.Artist.set_picker>` Aucun ou bool ou flottant ou appelable \n :meth:`pickradius <matplotlib.collections.Collection.set_pickradius>` inconnu \n :meth:`rasterized <matplotlib.artist. Artist.set_rasterized>` booléen \ n :meth:`tailles <matplotlib.collections._CollectionWithSizes.set_sizes>` ndarray ou None \n :meth:`sketch_params <matplotlib.artist.Artist.set_sketch_params>` (échelle : float, longueur : float, randomness : float) \n :meth:`snap <matplotlib.artist.Artist.set_snap>` booléen ou Aucun \ n :meth:`transform <matplotlib.artist.Artist.set_transform>` `.Transform` \n :meth:`url <matplotlib.artist.Artist.set_url> ` str \n :meth:`urls <matplotlib.collections.Collection.set_urls>` liste de str ou Aucun \n :meth:`verts <matplotlib.collections.PolyCollection.set_verts>` liste de type tableau \n :meth:`verts_and_codes <matplotlib.collections.PolyCollection.set_verts_and_codes>` inconnu \n :meth:`visible < matplotlib.artist.Artist.set_visible>` bool \n :meth:`zorder <matplotlib.artist.Artist.set_zorder>` float \n ==================== ================================================== ========================== ======================= ================================================== ================================================== ==================================\n\n'#
- set ( * , UVC=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , antialiased=<UNSET> , array=<UNSET> , capstyle=<UNSET> , clim=<UNSET > , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , cmap=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , gid=<UNSET> , hatch=<UNSET> , in_layout=<UNSET> , joinstyle=<UNSET>, label=<UNSET> , linestyle=<UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , norm=<UNSET> , offset_transform=<UNSET> , offsets=<UNSET> , path_effects=<UNSET> , chemins =<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sizes=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url=< UNSET> , urls=<UNSET> ,verts=<UNSET> ,verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> ) [source] #
Définissez plusieurs propriétés à la fois.
Les propriétés prises en charge sont
Propriété
La description
inconnue
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
antialiased
ou aa ou antialiasésbool ou liste de bools
semblable à un tableau ou Aucun
CapStyle
ou {'bout', 'en saillie', 'rond'}(vmin : flottant, vmax : flottant)
bourdonner
Patch ou (chemin, transformation) ou aucun
Colormap
ou str ou Aucuncouleur ou liste de tuples rgba
edgecolor
ou ec ou edgecolorscouleur ou liste de couleurs ou 'visage'
facecolor
ou facecolors ou fccouleur ou liste de couleurs
chaîne
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bourdonner
JoinStyle
ou {'onglet', 'rond', 'biseau'}objet
linestyle
ou tirets ou styles de ligne ou lsstr ou tuple ou une liste de ceux-ci
linewidth
ou largeurs de ligne ou lwflottant ou liste de flottants
bourdonner
Normalize
ou str ou Aucunoffset_transform
ou transOffsetinconnue
séquence de paires de flotteurs
liste de type tableau
Aucun ou bool ou flottant ou appelable
inconnue
bourdonner
sizes
ndarray 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