matplotlib.pyplot.quiver #

matplotlib.pyplot. faretra ( * args , data = None , ** kwargs ) [fonte] #

Traccia un campo di frecce 2D.

Firma chiamata:

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

X , Y definiscono le posizioni delle frecce, U , V definiscono le direzioni delle frecce e C facoltativamente imposta il colore.

Lunghezza della freccia

Le impostazioni predefinite ridimensionano automaticamente la lunghezza delle frecce a una dimensione ragionevole. Per modificare questo comportamento vedere i parametri scale e scale_units .

A forma di freccia

La forma della freccia è determinata da larghezza , larghezza della testa , lunghezza della testa e lunghezza dell'asse della testa . Vedere le note di seguito.

Stile a freccia

Ogni freccia è rappresentata internamente da un poligono pieno con una larghezza di linea del bordo predefinita pari a 0. Di conseguenza, una freccia è piuttosto un'area piena, non una linea con una testa, e PolyCollectionproprietà come linewidth , edgecolor , facecolor , ecc. agiscono di conseguenza.

Parametri :

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

Le coordinate x e y delle posizioni delle frecce.

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 di direzione x e y dei vettori freccia. L'interpretazione di questi componenti (nei dati o nello spazio dello schermo) dipende dagli angoli .

U e V devono avere lo stesso numero di elementi, corrispondenti al numero di posizioni delle frecce in X , Y . U e V possono essere mascherati. Le posizioni mascherate in U , V e C non verranno disegnate.

C Tipo array 1D o 2D, opzionale

Dati numerici che definiscono i colori delle frecce tramite colormapping tramite norm e cmap .

Questo non supporta i colori espliciti. Se vuoi impostare direttamente i colori, usa invece color . La dimensione di C deve corrispondere al numero di posizioni delle frecce.

angoli {'uv', 'xy'} o tipo array, default: 'uv'

Metodo per determinare l'angolo delle frecce.

'uv': direzione della freccia nelle coordinate dello schermo. Utilizzare questo se le frecce simboleggiano una quantità che non è basata sulle coordinate dei dati X , Y.

Se U == V l'orientamento della freccia sul grafico è di 45 gradi in senso antiorario rispetto all'asse orizzontale (positivo a destra).
'xy': Direzione della freccia nelle coordinate dei dati, cioè le frecce puntano da (x, y) a (x+u, y+v). Usa questo ad esempio per tracciare un campo gradiente.
Gli angoli arbitrari possono essere specificati esplicitamente come un array di valori in gradi, in senso antiorario rispetto all'asse orizzontale.

In questo caso U , V viene utilizzato solo per determinare la lunghezza delle frecce.

Nota: l'inversione di un asse dati invertirà corrispondentemente le frecce solo con angles='xy'.

pivot {'tail', 'mid', 'middle', 'tip'}, default: 'tail'

La parte della freccia ancorata alla griglia X , Y. La freccia ruota attorno a questo punto.

'metà' è un sinonimo di 'metà'.

scala mobile, facoltativo

Ridimensiona la lunghezza della freccia in modo inverso.

Numero di unità di dati per unità di lunghezza della freccia, ad esempio m/s per larghezza del tracciato; un parametro di scala più piccolo rende la freccia più lunga. L'impostazione predefinita è Nessuno .

Se None , viene utilizzato un semplice algoritmo di ridimensionamento automatico, basato sulla lunghezza media del vettore e sul numero di vettori. L'unità di lunghezza della freccia è data dal parametro scale_units .

scale_units {'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, opzionale

Se la scala kwarg è None , l'unità di lunghezza della freccia. L'impostazione predefinita è Nessuno .

ad esempio scale_units è 'pollici', scale è 2.0 e , quindi il vettore sarà lungo 0.5 pollici.(u, v) = (1, 0)

Se scale_units è 'width' o 'height', il vettore sarà la metà della larghezza/altezza degli assi.

Se scale_units è 'x', il vettore sarà 0,5 unità dell'asse x. Per tracciare i vettori nel piano xy, con u e v che hanno le stesse unità di x e y, utilizzare .angles='xy', scale_units='xy', scale=1

unità {'larghezza', 'altezza', 'punti', 'pollici', 'x', 'y', 'xy'}, valore predefinito: 'larghezza'

Influisce sulla dimensione della freccia (ad eccezione della lunghezza). In particolare, la larghezza dell'albero è misurata in multipli di questa unità.

I valori supportati sono:

'width', 'height': la larghezza o l'altezza degli assi.
'dots', 'inches': pixel o pollici basati sulla cifra dpi.
'x', 'y', 'xy': X , Y o\(\sqrt{X^2 + Y^2}\)in unità di dati.

La tabella seguente riassume il modo in cui questi valori influiscono sulla dimensione della freccia visibile in zoom e le dimensioni della figura cambia:

unità	Ingrandisci	Cambiamento della dimensione della figura
'x', 'y', 'xy'	scale delle dimensioni delle frecce
'larghezza altezza'		scale delle dimensioni delle frecce
'punti', 'pollici'

float di larghezza , facoltativo

Larghezza dell'albero in unità freccia. Tutti i parametri della testa sono relativi alla larghezza .

L'impostazione predefinita dipende dalla scelta delle unità di cui sopra e dal numero di vettori; un valore iniziale tipico è circa 0,005 volte la larghezza del grafico.

headwidth float, default: 3

Larghezza della testa come multiplo della larghezza del gambo . Vedere le note di seguito.

headlength float, default: 5

Lunghezza della testa come multiplo della larghezza del gambo . Vedere le note di seguito.

headaxislength float, predefinito: 4.5

Lunghezza della testa all'intersezione dell'albero come multiplo della larghezza dell'albero . Vedere le note di seguito.

minshaft galleggiante, predefinito: 1

Lunghezza al di sotto della quale la freccia scala, in unità di lunghezza della testa. Non impostarlo su meno di 1, altrimenti le frecce piccole sembreranno terribili!

float a minlength , impostazione predefinita: 1

Lunghezza minima come multiplo della larghezza dell'albero; se la lunghezza di una freccia è inferiore a questa, traccia invece un punto (esagono) di questo diametro.

colore colore o sequenza di colori, opzionale

Colore/i esplicito/i per le frecce. Se è stato impostato C , il colore non ha effetto.

Questo è un sinonimo del parametro facecolor .PolyCollection

Resi :

Quiver

Altri parametri :

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

**proprietà kwargs PolyCollection, facoltativo

Tutti gli altri argomenti delle parole chiave vengono passati a PolyCollection:

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
`antialiased`o aa o antialias	bool o elenco di bool
`array`	tipo array o Nessuno
`capstyle`	`CapStyle`o {'culo', 'sporgente', 'rotondo'}
`clim`	(vmin: float, vmax: float)
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch o (Percorso, Trasforma) o Nessuno
`cmap`	`Colormap`o str o Nessuno
`color`	colore o elenco di tuple rgba
`edgecolor`o ec o edgecolors	colore o elenco di colori o 'volto'
`facecolor`o facecolors o fc	colore o elenco di colori
`figure`	`Figure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle`o {'mitre', 'round', 'bevel'}
`label`	oggetto
`linestyle`o trattini o stili di linea o ls	str o tuple o loro elenchi
`linewidth`o linewidths o lw	float o lista di float
`mouseover`	bool
`norm`	`Normalize`o str o Nessuno
`offset_transform`o 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

Guarda anche

Axes.quiverkey: Aggiungi una chiave a un diagramma di faretra.

Appunti

A forma di freccia

La freccia viene disegnata come poligono usando i nodi come mostrato di seguito. La larghezza dei valori , la lunghezza della testa e della testa di testa sono in unità di larghezza .

Le impostazioni predefinite danno una freccia leggermente spostata all'indietro. Ecco alcune linee guida su come ottenere altre forme della testa:

Per rendere la testa un triangolo, rendere la lunghezza della testa uguale alla lunghezza .
Per rendere la freccia più appuntita, ridurre la larghezza della testa o aumentare la lunghezza della testa e la lunghezza dell'asse della testa .
Per rendere la testa più piccola rispetto all'albero, ridimensionare proporzionalmente tutti i parametri della testa.
Per rimuovere completamente la testa, impostare tutti i parametri della testa su 0.
Per ottenere una testa a forma di diamante, rendi la lunghezza dell'asse della testa più grande della lunghezza della testa .
Attenzione: per headaxislength < ( headlength / headwidth ), i nodi "headaxis" (cioè quelli che collegano la testa con l'asta) sporgeranno dalla testa in avanti in modo che la punta della freccia sembri rotta.