matplotlib.axes.Axes.quiver #
- Assi. 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 in che modo questi valori influiscono sulla dimensione della freccia visibile durante lo zoom e le modifiche alle dimensioni della figura:
unità
Ingrandisci
cambiamento di 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!
- minlength float, predefinito: 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, facoltativo
Colore/i esplicito/i per le frecce. Se è stato impostato C , il colore non ha effetto.
Questo è un sinonimo del parametro facecolor .
PolyCollection
- Resi :
- Altri parametri :
- oggetto indicizzabile dei dati , facoltativo
Se fornito, tutti i parametri accettano anche una stringa
s, che viene interpretata comedata[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
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
tipo array o scalare o None
bool
antialiasedo aa o antialiasbool o elenco di bool
tipo array o Nessuno
CapStyleo {'culo', 'sporgente', 'rotondo'}(vmin: float, vmax: float)
bool
Patch o (Percorso, Trasforma) o Nessuno
Colormapo str o Nessunocolore o elenco di tuple rgba
edgecoloro ec o edgecolorscolore o elenco di colori o 'volto'
facecoloro facecolors o fccolore o elenco di colori
str
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bool
JoinStyleo {'mitre', 'round', 'bevel'}oggetto
linestyleo trattini o stili di linea o lsstr o tuple o loro elenchi
linewidtho linewidths o lwfloat o lista di float
bool
Normalizeo str o Nessunooffset_transformo transOffsetsconosciuto
(N, 2) o (2,) simile a un array
elenco di tipo array
Nessuno o bool o float o richiamabile
sconosciuto
bool
sizesndarray o Nessuno
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
str
elenco di str o Nessuno
elenco di tipo array
sconosciuto
bool
galleggiante
Guarda anche
Axes.quiverkeyAggiungi una chiave a un diagramma di faretra.
Appunti
A forma di freccia
La freccia viene disegnata come un poligono utilizzando i nodi come mostrato di seguito. I valori headwidth , headlength e headaxislength 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 trasformare la testa in un triangolo, rendi headaxislength uguale a headlength .
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.
