matplotlib.quiver.Barbs

classe matplotlib.quiver. Barbe ( ax , * args , pivot = 'tip' , length = 7 , barbcolor = None , flagcolor = None , sizes = None , fill_empty = False , barb_increments = None , rounding = True , flip_barb = False , ** kwargs )

Basi:PolyCollection

PolyCollection specializzata per barbe.

L'unico metodo API è set_UVC(), che può essere utilizzato per modificare la dimensione, l'orientamento e il colore delle frecce. Le posizioni vengono modificate utilizzando il set_offsets()metodo di raccolta. Forse questo metodo sarà utile nelle animazioni.

C'è una funzione interna _find_tails()che trova esattamente ciò che dovrebbe essere messo sulla punta data la grandezza del vettore. Da lì _make_barbs()viene utilizzato per trovare i vertici del poligono per rappresentare la punta sulla base di queste informazioni.

Il costruttore accetta un argomento richiesto, un'istanza di Axes, seguito da args e kwargs descritti dalla seguente documentazione dell'interfaccia pyplot:

Traccia un campo 2D di punte.

Firma chiamata:

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

Dove X , Y definiscono le posizioni della punta, U , V definiscono le direzioni della punta e C facoltativamente imposta il colore.

Tutti gli argomenti possono essere 1D o 2D. U , V , C possono essere array mascherati, ma X , Y mascherati non sono attualmente supportati.

I barbe sono tradizionalmente utilizzati in meteorologia come un modo per tracciare la velocità e la direzione delle osservazioni del vento, ma tecnicamente possono essere utilizzati per tracciare qualsiasi quantità vettoriale bidimensionale. Al contrario delle frecce, che danno la grandezza del vettore in base alla lunghezza della freccia, le barbe danno informazioni più quantitative sulla grandezza del vettore inserendo linee oblique o un triangolo per vari incrementi di grandezza, come mostrato schematicamente di seguito:

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

L'incremento maggiore è dato da un triangolo (o "bandiera"). Dopo quelli vengono linee complete (barbe). L'incremento più piccolo è una mezza linea. C'è solo, ovviamente, sempre al massimo 1 mezza linea. Se la magnitudine è piccola e richiede solo una singola semiretta e nessuna linea intera o triangoli, la semiretta è sfalsata dall'estremità della punta in modo che possa essere facilmente distinta dalle punte con una singola linea intera. La magnitudine per la punta mostrata sopra sarebbe nominalmente 65, utilizzando gli incrementi standard di 50, 10 e 5.

Vedi anche https://en.wikipedia.org/wiki/Wind_barb .

Parametri :

X, Y 1D o 2D simile a un array, opzionale

Le coordinate x e y delle posizioni delle barbe. Vedi pivot per come i barbigli sono disegnati nelle posizioni x, y.

Se non vengono forniti, verranno generati come meshgrid di numeri interi uniformi basati sulle dimensioni di U e V .

Se X e Y sono 1D ma U , V sono 2D, X , Y vengono espansi a 2D usando . In questo caso e deve corrispondere alle dimensioni di riga e colonna di U e V .X, Y = np.meshgrid(X, Y)len(X)len(Y)

U, V 1D o 2D simile a un array

Le componenti x e y dell'asta della punta.

C Tipo array 1D o 2D, opzionale

Dati numerici che definiscono i colori della barba mediante colormapping tramite norm e cmap .

Questo non supporta i colori espliciti. Se vuoi impostare direttamente i colori, usa invece barbcolor .

float di lunghezza , predefinito: 7

Lunghezza della punta in punti; le altre parti della punta sono squamate contro questo.

pivot {'tip', 'middle'} o float, default: 'tip'

La parte della freccia ancorata alla griglia X , Y. La punta ruota intorno a questo punto. Questo può anche essere un numero, che sposta l'inizio della punta di molti punti lontano dal punto della griglia.

colore barbcolor o sequenza di colori

Il colore di tutte le parti della punta ad eccezione delle bandierine. Questo parametro è analogo al parametro edgecolor per i poligoni, che può essere utilizzato al suo posto. Tuttavia questo parametro sovrascriverà facecolor.

flagcolor colore o sequenza di colori

Il colore di eventuali bandierine sulla punta. Questo parametro è analogo al parametro facecolor per i poligoni, che può essere utilizzato al suo posto. Tuttavia, questo parametro sovrascriverà facecolor. Se questo non è impostato (e nemmeno C lo ha), flagcolor verrà impostato in modo da corrispondere a barbcolor in modo che il barb abbia un colore uniforme. Se è stato impostato C , flagcolor non ha effetto.

dimensioni dict, facoltativo

Un dizionario di coefficienti che specifica il rapporto tra una data caratteristica e la lunghezza della punta. Devono essere inclusi solo i valori che si desidera sovrascrivere. Queste funzionalità includono:

• 'spaziatura' - spazio tra le caratteristiche (bandiere, punte intere/mezze)

• 'altezza' - altezza (distanza dall'asta alla sommità) di una bandiera o di una punta intera

• 'larghezza' - larghezza di una bandiera, due volte la larghezza di un barbo pieno

• 'emptybarb' - raggio del cerchio usato per magnitudini basse

fill_empty bool, predefinito: falso

Indica se i barbe vuoti (cerchi) disegnati devono essere riempiti con il colore della bandiera. Se non sono riempiti, il centro è trasparente.

arrotondamento bool, predefinito: vero

Indica se la magnitudine del vettore deve essere arrotondata durante l'allocazione dei componenti della punta. Se Vero, la magnitudine viene arrotondata al multiplo più vicino dell'incremento di mezzo ardiglione. Se False, la grandezza viene semplicemente troncata al multiplo successivo più basso.

barb_increments dict, facoltativo

Un dizionario di incrementi che specifica i valori da associare alle diverse parti della punta. Devono essere inclusi solo i valori che si desidera sovrascrivere.

• 'half' - mezzo barbe (l'impostazione predefinita è 5)

• 'full' - punte complete (il valore predefinito è 10)

• 'flag' - flag (il valore predefinito è 50)

flip_barb bool o tipo array di bool, default: False

Indica se le linee e le bandiere devono puntare in direzione opposta al normale. Il comportamento normale è che le punte e le linee puntino a destra (proviene da punte di vento che hanno queste caratteristiche puntano verso la bassa pressione nell'emisfero settentrionale).

A tutti i barbe viene applicato un unico valore. I singoli barbe possono essere capovolti passando un array bool della stessa dimensione di U e V .

Resi :

barbeBarbs

Altri parametri :

oggetto indicizzabile dei dati , facoltativo

DATA_PARAMETER_PLACEHOLDER

**kwargs

Le barbe possono essere ulteriormente personalizzate utilizzando PolyCollectionargomenti di parole chiave:

Proprietà	Descrizione
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	tipo array o scalare o None
animated	bool
antialiasedo aa o antialias	bool o elenco di bool
array	tipo array o Nessuno
capstyle	CapStyleo {'culo', 'sporgente', 'rotondo'}
clim	(vmin: float, vmax: float)
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
cmap	Colormapo str o Nessuno
color	colore o elenco di tuple rgba
edgecoloro ec o edgecolors	colore o elenco di colori o 'volto'
facecoloro facecolors o fc	colore o elenco di colori
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'mitre', 'round', 'bevel'}
label	oggetto
linestyleo trattini o stili di linea o ls	str o tuple o loro elenchi
linewidtho linewidths o lw	float o lista di float
mouseover	bool
norm	Normalizeo str o Nessuno
offset_transformo transOffset	sconosciuto
offsets	(N, 2) o (2,) simile a un array
path_effects	AbstractPathEffect
paths	elenco di tipo array
picker	Nessuno o bool o float o richiamabile
pickradius	sconosciuto
rasterized	bool
sizes	ndarray o Nessuno
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
transform	Transform
url	str
urls	elenco di str o Nessuno
verts	elenco di tipo array
verts_and_codes	sconosciuto
visible	bool
zorder	galleggiante

barbs_doc = '\nTraccia un campo 2D di barbs.\n\nFirma chiamata ::\n\n barbs([X, Y], U, V, [C], **kwargs)\n\nDove *X*, *Y* definisce le posizioni della punta, * U*, *V* definisce le direzioni della punta, e *C* facoltativamente imposta il colore.\n\nTutti gli argomenti possono essere 1D o 2D. *U*, *V*, *C* possono essere array mascherati , ma   masked\n*X*, *Y* non sono attualmente supportati .\n\nI barbi sono tradizionalmente usati in meteorologia come un modo per tracciare la velocità\ne la direzione delle osservazioni del vento , ma tecnicamente possono essere usati per\nrappresentare qualsiasi bidimensionale quantità vettoriale . Al contrario delle frecce, che\ngdanno la grandezza del vettore per la lunghezza del   freccia, le barbe forniscono più\ninformazioni quantitative sulla magnitudine del vettore inserendo linee\noblique o un triangolo per vari incrementi di magnitudine , come mostrato\nschematicamente di seguito ::\n\n : /\\ \\\n : / \\ \\\n : / \\ \\ \\\n : / \\ \\ \\\n : ------------------------- -----\n\ nL'incremento maggiore è                                                                                                                                    data da un triangolo (o "bandiera"). Dopo quelle\nvengono linee complete (barbe). L' incremento più piccolo è una mezza linea. C'\nè solo, ovviamente , sempre al massimo 1 mezza riga. Se la magnitudine è\npiccola e richiede solo una singola semiretta e nessuna linea intera o\ntriangoli , la semiretta viene sfalsata     dall'estremità della punta in modo che \ nsia facilmente distinguibile dalle punte con un'unica linea piena . _ _ La\nmagnitudine per la punta mostrata sopra sarebbe nominalmente 65, usando gli\nincrementi standard di 50 , 10 e 5. \n\nVedi anche https://en.wikipedia.org/wiki/Wind_barb.\n\nParametri\ n----------\nX, Y : 1D o 2D   tipo array, facoltativo\n     Le coordinate x e y delle posizioni delle punte . Vedere *pivot* per sapere come \n i barbe sono disegnati nelle posizioni x , y .\n\n Se non vengono forniti , verranno generati come una meshgrid uniforme basata \n sulle dimensioni di *U* e * V* .\n\n Se *X* e *Y* lo sono                 1D ma *U*, *V* sono 2D, *X*, *Y* sono espansi a 2D\n     usando ``X, Y = np.meshgrid(X, Y)``. In questo caso ``len(X)`` e ``len(Y)``\n     devono corrispondere alle dimensioni di colonna e riga di *U* e *V*.\n\nU, V : 1D o 2D array- come\ n Le componenti x e y della punta     shaft.\n\nC : 1D o 2D simile ad un array, facoltativo\n     Dati numerici che definiscono i colori della punta tramite mappatura dei colori tramite *norm* e\n * cmap *.\n\n Questo non supporta i colori espliciti . Se vuoi impostare i colori direttamente,\n usa invece *barbcolor* . \n\nlength : float, default: 7\n Lunghezza della punta in punti;                 le altre parti della punta \n     sono ridimensionate rispetto a questo.\n\npivot : {\'tip\', \'middle\'} o float, default: \'tip\'\     n La parte della freccia che è ancorato alla griglia *X*, *Y* . La punta \n ruota attorno a questo punto. Può anche essere un numero, che sposta l' inizio \ n del         barb a tanti punti di distanza dal punto della griglia .\n\nbarbcolor : colore o sequenza di colori\n Il colore di tutte le parti del barb ad eccezione delle bandierine. Questo parametro\n è analogo al parametro *edgecolor* per i poligoni , che può essere usato\n al suo posto. Tuttavia questo parametro sovrascriverà facecolor .\n\nflagcolor              : colore o sequenza di colori\ n Il colore di eventuali bandierine sulla punta . Questo parametro è analogo al parametro \n *facecolor* per i poligoni , che può essere utilizzato al suo posto. Tuttavia,\n questo parametro sovrascriverà facecolor . Se questo non è impostato (e nemmeno *C* lo ha \n ), allora *flagcolor* lo farà                    essere impostato in modo che corrisponda a * barbcolor * in modo che \n la punta     abbia un colore uniforme . Se *C* è stato impostato, *flagcolor* non ha effetto.\n\nsizes : dict, opzionale\n Un dizionario di coefficienti che specifica il rapporto tra una data caratteristica \n e la lunghezza della punta . Solo quei valori che si desiderano \n             è necessario includere l' override .   Queste caratteristiche includono:\n\n     - \'spaziatura\' - spazio tra le caratteristiche (flag, punte intere/mezze )\n     - \'altezza\' - altezza (distanza dall'asta alla parte superiore) di una bandiera o di una punta piena \ n     - \'larghezza\' - larghezza di una bandiera, due volte la larghezza di una punta intera \n     - \'barba vuota\' - raggio del cerchio usato per magnitudini basse \n\nfill_empty : bool , default : False\n Indica se i barbe vuoti (cerchi) disegnati devono essere riempiti con\n il colore della bandiera . Se non sono riempiti, il centro è trasparente .\n\narrotondamento : bool, default: True\n Se la magnitudine del vettore dovrebbe               essere arrotondato durante l'allocazione dei componenti barb\n     .   Se Vero, la magnitudine viene arrotondata al multiplo\n più vicino dell'incremento di mezzo ardiglione . Se False, la grandezza viene semplicemente troncata\n al multiplo più basso successivo .\n\nbarb_increments : dict, facoltativo\n Un dizionario di incrementi che specifica i valori da associare \n                  diverse parti della barbetta . Devono essere inclusi solo quei valori che si desidera \n     sovrascrivere .\n\n - \'half\' - mezzo barbe (il valore predefinito è 5)\n - \'full\' - pieno le punte (il valore predefinito è 10)\n - \'flag\' - flags (il default è 50)\n\nflip_barb : bool o simile ad un array di bool, default: False\n Se                 le linee e le bandierine dovrebbero puntare in direzione opposta al normale.\n Il     comportamento normale è che le punte e le linee puntino a destra (deriva dal vento\n punte con queste caratteristiche che puntano verso la bassa pressione nell'emisfero settentrionale ).\n\n A un valore singolo viene applicato a tutti i barbe. I singoli barbe possono essere             capovolto passando \n     un array bool della stessa dimensione di *U* e * V*.\n\nRestituisce\n-------\nbarbs : `~matplotlib.quiver.Barbs`\n\nAltri parametri \n----------------\ndata : oggetto indicizzabile , facoltativo\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs\n Le punte possono essere ulteriormente personalizzate utilizzando la parola chiave `.PolyCollection` \ n argomenti:\n\n \n .. table::\n :class: tabella-proprietà\n\n                                   =================================================== ================================================    === =================================================== =================================================== =================================================== =====\n        Proprietà                                                                                             Descrizione                                                                                                                                                    \n        ======================================== =================================================== ========    ========================================== =================================================== =================================================== ================\n        :meth:`agg_filter <matplotlib.artist.Artist.set_agg_filter>`                                         una funzione filtro , che accetta un (m, n, 3) float array e un valore dpi , e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine \ n :meth:`alpha < matplotlib.collections.Collection.set_alpha >` array- like o scalare o None \n :meth:`animated <matplotlib.artist.Artist.set_animated>` bool \n :meth:`antialiased <matplotlib.collections.Collection.set_antialiased>` o aa                                                                                                                                                                                                                                                                                                                                                                                                       o antialiaseds        bool o lista di bool                                                                                                                                          \n        :meth:`array <matplotlib.cm.ScalarMappable.set_array>`                                               simile ad un array o None                                                                                                                                             \n        :meth:`capstyle <matplotlib.collections.Collection.set_capstyle>`                                    `.CapStyle` o {\'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 o (Percorso, Trasformazione) o Nessuno                                                                                                                             \n        :meth:`cmap <matplotlib.cm.ScalarMappable .set_cmap>`                                                 `.Colormap` o str o None                                                                                                                                     \n        :meth:`color <matplotlib.collections.Collection.set_color>`                                          colore o lista di tuple rgba \n :meth:`edgecolor <matplotlib.collections.Collection.set_edgecolor >` o ec o colore edgecolors                                                                                                                                                      o lista di colori o \'face\'                                                                                                                              \n        :meth:`facecolor <matplotlib.collections.Collection.set_facecolor>` o facecolors o fc              color o lista di colori                                                                                                                                        \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` o {\'miter \', \'round\', \'bevel\'}                                                                                                                    \n        :meth:`label <matplotlib.artist.Artist.set_label>`                                                   oggetto                                                                                                                                                         \n        :meth:`linestyle <matplotlib.collections.Collection.set_linestyle>` o trattini o stili di linea o ls    str o tuple o loro elenchi \n :meth:`linewidth                                                                                                                                         <matplotlib.collections.Collection.set_linewidth>` o linewidths o lw              float o lista di float                                                                                                                                        \n        :meth:`mouseover <matplotlib.artist.Artist.set_mouseover>`                                           bool                                                                                                                                                           \n        :meth:`norm <matplotlib.cm.ScalarMappable .set_norm>`                                                 `.Normalize` o str o None                                                                                                                                    \n        :meth:`offset_transform <matplotlib.collections.Collection.set_offset_transform>` o transOffset     sconosciuto                                                                                                                                                        \n        :meth:` offsets <matplotlib.collections.Collection.set_offsets>`                                      ( N, 2) o (2,) array-like                                                                                                                                      \n        :meth:`path_effects <matplotlib.artist.Artist.set_path_effects>`                                     `.AbstractPathEffect`                                                                                                                                          \n        :meth:`paths <matplotlib.collections.PolyCollection.set_verts>`                                      elenco di array-like                                                                                                                                             \n        :meth :`picker <matplotlib.artist.Artist.set_picker>`                                                 Nessuno o bool o float o richiamabile                                                                                                                              \n        :meth:`pickradius <matplotlib.collections.Collection.set_pickradius>`                                sconosciuto                                                                                                                                                        \n        :meth:`rasterizzato <matplotlib.artist. Artist.set_rasterized>`                                         bool                                                                                                                                                           \n        :meth:`sizes <matplotlib.collections._CollectionWithSizes.set_sizes>`                                ndarray o None                                                                                                                                                \n        :meth:`sketch_params <matplotlib.artist.Artist.set_sketch_params>`                                   (scala: float, lunghezza: float, casualità: float)                                                                                                               \n        :meth:`snap <matplotlib.artist.Artist.set_snap>`                                                     bool o Nessuno                                                                                                                                                   \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>`                                            lista di str o Nessuno                                                                                                                                            \n        :meth:`verts <matplotlib.collections.PolyCollection.set_verts>`                                      elenco di \n :meth:`verts_and_codes <                                                                                                                                             matplotlib.collections.PolyCollection.set_verts_and_codes>` sconosciuti \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> , animation=<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> , percorsi =<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sizes=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url=< DISINSERITO> , urls=<DISINSERITO> ,verts=<UNSET> ,verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà	Descrizione
UVC	sconosciuto
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	tipo array o scalare o None
animated	bool
antialiasedo aa o antialias	bool o elenco di bool
array	tipo array o Nessuno
capstyle	CapStyleo {'culo', 'sporgente', 'rotondo'}
clim	(vmin: float, vmax: float)
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
cmap	Colormapo str o Nessuno
color	colore o elenco di tuple rgba
edgecoloro ec o edgecolors	colore o elenco di colori o 'volto'
facecoloro facecolors o fc	colore o elenco di colori
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'mitre', 'round', 'bevel'}
label	oggetto
linestyleo trattini o stili di linea o ls	str o tuple o loro elenchi
linewidtho linewidths o lw	float o lista di float
mouseover	bool
norm	Normalizeo str o Nessuno
offset_transformo transOffset	sconosciuto
offsets	sequenza di coppie di galleggianti
path_effects	AbstractPathEffect
paths	elenco di tipo array
picker	Nessuno o bool o float o richiamabile
pickradius	sconosciuto
rasterized	bool
sizes	ndarray o Nessuno
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
transform	Transform
url	str
urls	elenco di str o Nessuno
verts	elenco di tipo array
verts_and_codes	sconosciuto
visible	bool
zorder	galleggiante

set_UVC ( U , V , C = Nessuno )

set_offset ( xy )

Impostare gli offset per i poligoni della punta. Ciò salva gli offset passati e li maschera in modo appropriato per i dati U/V esistenti.

Parametri :

sequenza xy di coppie di float