matplotlib.axes.Axes.pcolor #

Haches. pcolor ( * args , shading = Aucun , 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 :

pcolor([X, Y,] C, **kwargs)

X et Y peuvent être utilisés pour spécifier les coins des quadrilatères.

Indice

pcolor()peut être très lent pour les grands tableaux. Dans la plupart des cas, vous devriez utiliser le similaire mais beaucoup plus rapide à la pcolormeshplace. Voir Différences entre pcolor() et pcolormesh() pour une discussion sur les différences.

Paramètres :
C 2D de type tableau

Les valeurs mappées en couleur. Le mappage des couleurs est contrôlé par cmap , norm , vmin et vmax .

X, Y comme un tableau, facultatif

Les coordonnées des coins des quadrilatères d'un pcolormesh :

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

Notez que l'index de colonne correspond à la coordonnée x et que l'index de ligne correspond à y. Pour plus de détails, consultez la section Remarques ci-dessous.

Si shading='flat'les dimensions de X et Y doivent être supérieures à celles de C , et le quadrilatère est coloré en raison de la valeur à . Si X , Y et C ont des dimensions égales, un avertissement sera émis et la dernière ligne et la dernière colonne de C seront ignorées.C[i, j]

Si shading='nearest', les dimensions de X et Y doivent être les mêmes que celles de C (sinon, une ValueError sera levée). La couleur sera centrée sur .C[i, j](X[i, j], Y[i, j])

Si X et/ou Y sont des tableaux 1-D ou des vecteurs colonnes, ils seront étendus selon les besoins dans les tableaux 2D appropriés, créant une grille rectangulaire.

ombrage {'plat', 'le plus proche', 'auto'}, par défaut : rcParams["pcolor.shading"](par défaut : 'auto')

Le style de remplissage du quadrilatère. Valeurs possibles:

  • 'plat' : une couleur unie est utilisée pour chaque quadrilatère. La couleur du quad (i, j), (i+1, j), (i, j+1), (i+1, j+1) est donnée par . Les dimensions de X et Y doivent être supérieures d'une unité à celles de C ; s'ils sont identiques à C , un avertissement d'obsolescence est généré et la dernière ligne et la dernière colonne de C sont supprimées.C[i, j]

  • 'le plus proche' : Chaque point de la grille aura une couleur centrée dessus, s'étendant à mi-chemin entre les centres de grille adjacents. Les dimensions de X et Y doivent être les mêmes que C .

  • 'auto' : choisissez 'plat' si les dimensions de X et Y sont supérieures d'une unité à C . Choisissez "le plus proche" si les dimensions sont identiques.

Voir pcolormesh grilles et ombrage pour plus de description.

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.

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 :

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

edgecolors {'none', None, 'face', color, color sequence}, facultatif

La couleur des bords. Par défaut, 'aucun'. Valeurs possibles:

  • 'aucun' ou '' : aucun bord.

  • Aucun : rcParams["patch.edgecolor"](par défaut : 'black') sera utilisé. Notez qu'actuellement rcParams["patch.force_edgecolor"](par défaut : False) doit être True pour que cela fonctionne.

  • 'face' : utilise la couleur de face adjacente.

  • Une couleur ou une séquence de couleurs définira la couleur du bord.

La forme singulière edgecolor fonctionne comme un alias.

flottant alpha , par défaut : aucun

La valeur de fusion alpha de la couleur du visage, entre 0 (transparent) et 1 (opaque). Remarque : La couleur de bord n'est actuellement pas affectée par cela.

snap bool, par défaut : False

S'il faut aligner le maillage sur les limites de pixels.

Retours :
matplotlib.collections.Collection
Autres paramètres :
antialiased bool, par défaut : False

L' anticrénelage par défaut est False si la couleur de bord par défaut = "none" est utilisée. Cela élimine les lignes artificielles aux limites des patchs et fonctionne quelle que soit la valeur d'alpha. Si edgecolors n'est pas "none", alors l' anticrénelage par défaut est tiré de rcParams["patch.antialiased"](par défaut : True). Il peut être préférable de caresser les bords si alpha est égal à 1, mais cela entraînera des artefacts dans le cas contraire.

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 comme data[s](sauf si cela déclenche une exception).

**kwargs

De plus, les arguments suivants sont autorisés. Ils sont transmis au PolyCollectionconstructeur :

Propriété

La description

agg_filter

une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image

alpha

de type tableau ou scalaire ou Aucun

animated

bourdonner

antialiasedou aa ou antialiasés

bool ou liste de bools

array

semblable à un tableau ou Aucun

capstyle

CapStyleou {'bout', 'en saillie', 'rond'}

clim

(vmin : flottant, vmax : flottant)

clip_box

Bbox

clip_on

bourdonner

clip_path

Patch ou (chemin, transformation) ou aucun

cmap

Colormapou str ou Aucun

color

couleur ou liste de tuples rgba

edgecolorou ec ou edgecolors

couleur ou liste de couleurs ou 'visage'

facecolorou facecolors ou fc

couleur ou liste de couleurs

figure

Figure

gid

chaîne

hatch

{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

in_layout

bourdonner

joinstyle

JoinStyleou {'onglet', 'rond', 'biseau'}

label

objet

linestyleou tirets ou styles de ligne ou ls

str ou tuple ou une liste de ceux-ci

linewidthou largeurs de ligne ou lw

flottant ou liste de flottants

mouseover

bourdonner

norm

Normalizeou str ou Aucun

offset_transformou transOffset

inconnue

offsets

(N, 2) ou (2,) en forme de tableau

path_effects

AbstractPathEffect

paths

liste de type tableau

picker

Aucun ou bool ou flottant ou appelable

pickradius

inconnue

rasterized

bourdonner

sizes

ndarray ou Aucun

sketch_params

(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)

snap

booléen ou Aucun

transform

Transform

url

chaîne

urls

liste de str ou None

verts

liste de type tableau

verts_and_codes

inconnue

visible

bourdonner

zorder

flotteur

Voir également

pcolormesh

pour une explication des différences entre pcolor et pcolormesh.

imshow

Si X et Y sont chacun équidistants, imshowpeut être une alternative plus rapide.

Remarques

Tableaux masqués

X , Y et C peuvent être des tableaux masqués. Si soit , soit l'un des sommets entourant ( X ou Y at ) est masqué, rien n'est tracé.C[i, j]C[i, j][i, j], [i+1, j], [i, j+1], [i+1, j+1]

Orientation de la grille

L'orientation de la grille suit la convention matricielle standard : un tableau C de forme (nlignes, ncolonnes) est tracé avec le numéro de colonne sous la forme X et le numéro de la ligne sous la forme Y .

Exemples utilisant matplotlib.axes.Axes.pcolor#

Démo Pcolor

Démo Pcolor

Démo Pcolor
Contrôle des limites de vue à l'aide des marges et des sticky_edges

Contrôle des limites de vue à l'aide des marges et des sticky_edges

Contrôle des limites de vue à l'aide des marges et des sticky_edges