matplotlib.axes.Axes.pcolorfast #
- Assi. pcolorfast ( * args , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs ) [fonte] #
Crea un grafico pseudocolore con una griglia rettangolare non regolare.
Firma chiamata:
ax.pcolorfast([X, Y], C, /, **kwargs)
Questo metodo è simile a
pcolor
epcolormesh
. È progettato per fornire la stampa di tipo pcolor più veloce con il backend Agg. Per ottenere ciò, utilizza internamente diversi algoritmi a seconda della complessità della griglia di input (rettangolare regolare, rettangolare non regolare o quadrilatero arbitrario).Avvertimento
Questo metodo è sperimentale. Rispetto a
pcolor
opcolormesh
presenta alcune limitazioni:Supporta solo l'ombreggiatura piatta (senza contorni)
Manca il supporto per il ridimensionamento logaritmico degli assi.
Non ha un wrapper pyplot.
- Parametri :
- Simile a un array C
I dati dell'immagine. Le forme di array supportate sono:
(M, N): un'immagine con dati scalari. La mappatura dei colori è controllata da cmap , norm , vmin e vmax .
(M, N, 3): un'immagine con valori RGB (0-1 float o 0-255 int).
(M, N, 4): un'immagine con valori RGBA (0-1 float o 0-255 int), cioè comprensiva di trasparenza.
Le prime due dimensioni (M, N) definiscono le righe e le colonne dell'immagine.
Questo parametro può essere passato solo in modo posizionale.
- X, Y tupla o tipo array, default: ,
(0, N)
(0, M)
X e Y sono usati per specificare le coordinate dei quadrilateri. Ci sono diversi modi per farlo:
Utilizzare le tuple e per definire una griglia rettangolare uniforme .
X=(xmin, xmax)
Y=(ymin, ymax)
Le tuple definiscono i bordi esterni della griglia. Tutti i singoli quadrilateri avranno le stesse dimensioni. Questa è la versione più veloce.
Usa gli array 1D X , Y per specificare una griglia rettangolare non uniforme .
In questo caso X e Y devono essere array 1D monotoni di lunghezza N+1 e M+1 , specificando i limiti x e y delle celle.
La velocità è intermedia. Nota: la griglia viene controllata e, se trovata uniforme, viene utilizzata la versione veloce.
Usa gli array 2D X , Y se hai bisogno di una griglia quadrilatera arbitraria (cioè se i quadrilateri non sono rettangolari).
In questo caso X e Y sono array 2D con forma (M + 1, N + 1), specificando le coordinate x e y degli angoli dei quadrilateri colorati.
Questo è il più generale, ma il più lento da rendere. Tuttavia, può produrre un output più veloce e più compatto utilizzando i backend ps, pdf e svg.
Questi argomenti possono essere passati solo in modo posizionale.
- cmap str o
Colormap
, predefinito:rcParams["image.cmap"]
(predefinito:'viridis'
) L'istanza Colormap o il nome registrato della mappa colori utilizzato per mappare i dati scalari ai colori.
Questo parametro viene ignorato se C è RGB(A).
- norm str o
Normalize
, facoltativo Il metodo di normalizzazione utilizzato per ridimensionare i dati scalari nell'intervallo [0, 1] prima della mappatura ai colori utilizzando cmap . Per impostazione predefinita, viene utilizzato un ridimensionamento lineare, mappando il valore più basso su 0 e il più alto su 1.
Se indicato, può essere uno dei seguenti:
Un'istanza di
Normalize
o una delle sue sottoclassi (vedere Normalizzazione della mappa dei colori ).Un nome di scala, ad esempio "linear", "log", "symlog", "logit", ecc. Per un elenco delle scale disponibili, chiamare
matplotlib.scale.get_scale_names()
.Normalize
In tal caso, una sottoclasse adatta viene generata dinamicamente e istanziata.
Questo parametro viene ignorato se C è RGB(A).
- vmin, vmax float, facoltativo
Quando si utilizzano dati scalari e nessuna norma esplicita , vmin e vmax definiscono l'intervallo di dati coperto dalla mappa dei colori. Per impostazione predefinita, la mappa dei colori copre l'intero intervallo di valori dei dati forniti. È un errore utilizzare vmin / vmax quando viene fornita un'istanza di norma (ma l'utilizzo di un nome di norma insieme a vmin / vmax è accettabile).
str
Questo parametro viene ignorato se C è RGB(A).
- alfa float, predefinito: Nessuno
Il valore di fusione alfa, compreso tra 0 (trasparente) e 1 (opaco).
- snap bool, predefinito: falso
Se agganciare la mesh ai limiti dei pixel.
- Resi :
AxesImage
oPcolorImage
oQuadMesh
Il tipo restituito dipende dal tipo di griglia:
AxesImage
per una griglia rettangolare regolare.PcolorImage
per una griglia rettangolare non regolare.QuadMesh
per una griglia non rettangolare.
- 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).- **kwargs
I parametri aggiuntivi supportati dipendono dal tipo di griglia. Vedere i tipi di immagine restituiti per un'ulteriore descrizione.