matplotlib.axes.Axes.pcolorfast #
- Haches. pcolorfast ( * args , alpha = Aucun , norm = Aucun , cmap = Aucun , vmin = Aucun , vmax = Aucun , data = Aucun , ** kwargs ) [source] #
Créez un tracé en pseudo-couleur avec une grille rectangulaire non régulière.
Signature d'appel :
ax.pcolorfast([X, Y], C, /, **kwargs)
Cette méthode est similaire à
pcolor
etpcolormesh
. Il est conçu pour fournir le traçage de type pcolor le plus rapide avec le backend Agg. Pour cela, il utilise en interne différents algorithmes en fonction de la complexité de la grille d'entrée (rectangle régulier, rectangle non régulier ou quadrilatère arbitraire).Avertissement
Cette méthode est expérimentale. Par rapport à
pcolor
oupcolormesh
il a quelques limites :Il ne prend en charge que l'ombrage plat (pas de contours)
Il ne prend pas en charge la mise à l'échelle du journal des axes.
Il n'a pas de wrapper pyplot.
- Paramètres :
- C semblable à un tableau
Les données d'images. Les formes de tableau prises en charge sont :
(M, N) : une image avec des données scalaires. Le mappage des couleurs est contrôlé par cmap , norm , vmin et vmax .
(M, N, 3) : une image avec des valeurs RVB (0-1 float ou 0-255 int).
(M, N, 4) : une image avec des valeurs RGBA (0-1 float ou 0-255 int), c'est-à-dire incluant la transparence.
Les deux premières dimensions (M, N) définissent les lignes et les colonnes de l'image.
Ce paramètre ne peut être transmis que de manière positionnelle.
- X, Y tuple ou type tableau, par défaut : ,
(0, N)
(0, M)
X et Y sont utilisés pour spécifier les coordonnées des quadrilatères. Il y a d'autres façons de le faire:
Utilisez les tuples et pour définir une grille rectangulaire uniforme .
X=(xmin, xmax)
Y=(ymin, ymax)
Les tuples définissent les bords extérieurs de la grille. Tous les quadrilatères individuels seront de la même taille. C'est la version la plus rapide.
Utilisez les tableaux 1D X , Y pour spécifier une grille rectangulaire non uniforme .
Dans ce cas, X et Y doivent être des tableaux 1D monotones de longueur N+1 et M+1 , spécifiant les limites x et y des cellules.
La vitesse est intermédiaire. Remarque : La grille est vérifiée et, si elle est uniforme, la version rapide est utilisée.
Utilisez des tableaux 2D X , Y si vous avez besoin d'une grille quadrilatère arbitraire (c'est-à-dire si les quadrilatères ne sont pas rectangulaires).
Dans ce cas, X et Y sont des tableaux 2D de forme (M + 1, N + 1), spécifiant les coordonnées x et y des coins des quadrilatères colorés.
C'est le plus général, mais le plus lent à rendre. Cependant, il peut produire une sortie plus rapide et plus compacte en utilisant les backends ps, pdf et svg.
Ces arguments ne peuvent être passés que de manière positionnelle.
- cmap str ou
Colormap
, par défaut :rcParams["image.cmap"]
(par défaut :'viridis'
) L'instance Colormap ou le nom de la palette de couleurs enregistrée utilisée pour mapper les données scalaires aux couleurs.
Ce paramètre est ignoré si C est RGB(A).
- norm str ou
Normalize
, facultatif La méthode de normalisation utilisée pour mettre à l'échelle les données scalaires dans la plage [0, 1] avant le mappage aux couleurs à l'aide de cmap . Par défaut, une mise à l'échelle linéaire est utilisée, mappant la valeur la plus basse à 0 et la plus élevée à 1.
S'il est donné, il peut s'agir de l'un des éléments suivants :
Une instance de
Normalize
ou une de ses sous-classes (voir Colormap Normalization ).Un nom d'échelle, c'est-à-dire "linéaire", "log", "symlog", "logit", etc. Pour une liste des échelles disponibles, appelez
matplotlib.scale.get_scale_names()
. Dans ce cas, une sous-classe appropriéeNormalize
est générée et instanciée dynamiquement.
Ce paramètre est ignoré si C est RGB(A).
- vmin, flotteur vmax, facultatif
Lorsque vous utilisez des données scalaires et aucune norme explicite , vmin et vmax définissent la plage de données couverte par la palette de couleurs. Par défaut, la palette de couleurs couvre toute la plage de valeurs des données fournies. C'est une erreur d'utiliser vmin / vmax lorsqu'une instance de norme est donnée (mais l'utilisation d'un nom de norme avec vmin / vmax est acceptable).
str
Ce paramètre est ignoré si C est RGB(A).
- flottant alpha , par défaut : aucun
La valeur de fusion alpha, entre 0 (transparent) et 1 (opaque).
- snap bool, par défaut : False
S'il faut aligner le maillage sur les limites de pixels.
- Retours :
AxesImage
ouPcolorImage
ouQuadMesh
Le type de retour dépend du type de grille :
AxesImage
pour une grille rectangulaire régulière.PcolorImage
pour une grille rectangulaire non régulière.QuadMesh
pour une grille non rectangulaire.
- Autres paramètres :
- objet de données indexable, facultatif
S'ils sont donnés, tous les paramètres acceptent également une chaîne
s
, qui est interprétée commedata[s]
(sauf si cela déclenche une exception).- **kwargs
Les paramètres supplémentaires pris en charge dépendent du type de grille. Voir les types de retour d' image pour une description plus détaillée.