matplotlib.pyplot.figimage

matplotlib.pyplot. figimage ( X , xo = 0 , yo = 0 , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , origin = None , resize = False , ** kwargs )

Ajoutez une image non rééchantillonnée à la figure.

L'image est attachée au coin inférieur ou supérieur gauche selon l' origine .

Paramètres :

X

Les données d'images. Il s'agit d'un tableau de l'une des formes suivantes :

• (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.

xo, yo int

Le décalage x / y de l'image en pixels.

alpha Aucun ou flottant

La valeur de fusion alpha.

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 X est RVB(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 Normalizeou 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ée Normalizeest générée et instanciée dynamiquement.

Ce paramètre est ignoré si X est RVB(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 X est RVB(A).

origin {'supérieur', 'inférieur'}, par défaut : rcParams["image.origin"](par défaut : 'upper')

Indique où se trouve l'index [0, 0] du tableau dans le coin supérieur gauche ou inférieur gauche des axes.

redimensionner booléen

Si True , redimensionnez la figure pour qu'elle corresponde à la taille d'image donnée.

Retours :

matplotlib.image.FigureImage

Autres paramètres :

**kwargs

Les kwargs supplémentaires sont des Artistkwargs transmis à FigureImage.

Remarques

figimage complète l'image Axes ( imshow) qui sera rééchantillonnée pour s'adapter aux Axes actuels. Si vous souhaitez qu'une image rééchantillonnée remplisse toute la figure, vous pouvez définir une Axesétendue [0, 0, 1, 1].

Exemples

f = plt.figure()
nx = int(f.get_figwidth() * f.dpi)
ny = int(f.get_figheight() * f.dpi)
data = np.random.random((ny, nx))
f.figimage(data)
plt.show()