matplotlib.image

Le module d'image prend en charge les opérations de chargement, de mise à l'échelle et d'affichage d'image de base.

classe matplotlib.image. AxesImage ( ax , * , cmap = None , norm = None , interpolation = None , origin = None , extent = None , filternorm = True , filterrad = 4.0 , resample = False , interpolation_stage = None , ** kwargs )

Socles :_ImageBase

Une image attachée à un Axes.

Paramètres :

hacheAxes

Les axes auxquels l'image appartiendra.

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.

norme str ouNormalize

Mappe la luminance sur 0-1.

chaîne d' interpolation , par défaut : rcParams["image.interpolation"](par défaut : 'antialiased')

Les valeurs prises en charge sont 'none', 'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric' , 'catrom', 'gaussien', 'bessel', 'mitchell', 'sinc', 'lanczos', 'blackman'.

interpolation_stage {'data', 'rgba'}, par défaut : 'data'

Si 'data', une interpolation est effectuée sur les données fournies par l'utilisateur. Si 'rgba', l'interpolation est effectuée après l'application du colormapping (interpolation visuelle).

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

Placez l'index [0, 0] du tableau dans le coin supérieur gauche ou inférieur gauche des axes. La convention « supérieure » est généralement utilisée pour les matrices et les images.

tuple d' étendue , facultatif

Les axes de données (gauche, droite, bas, haut) pour créer des tracés d'image enregistrés avec des tracés de données. La valeur par défaut consiste à étiqueter les centres de pixels avec les indices de ligne et de colonne de base zéro.

filternorm booléen , par défaut : True

Un paramètre pour le filtre de redimensionnement d'image antigrain (voir la documentation antigrain). Si filternorm est défini, le filtre normalise les valeurs entières et corrige les erreurs d'arrondi. Il ne fait rien avec les valeurs à virgule flottante source, il corrige uniquement les entiers selon la règle de 1.0 qui signifie que toute somme de poids de pixel doit être égale à 1.0. Ainsi, la fonction de filtre doit produire un graphique de la forme appropriée.

flotteur de filtre > 0, par défaut : 4

Le rayon du filtre pour les filtres qui ont un paramètre de rayon, c'est-à-dire lorsque l'interpolation est l'une des suivantes : 'sinc', 'lanczos' ou 'blackman'.

resample bool, par défaut : False

Lorsque True, utilise une méthode de rééchantillonnage complet. Lorsque False, rééchantillonne uniquement lorsque l'image de sortie est plus grande que l'image d'entrée.

** propriétés kwargsArtist

Paramètres :

norm Normalize(ou sous-classe de celle-ci) ou str ou None

L'objet de normalisation qui met à l'échelle les données, généralement dans l'intervalle . Si a , une sous-classe est générée dynamiquement en fonction de l'échelle avec le nom correspondant. Si None , norm prend par défaut un objet colors.Normalize qui initialise sa mise à l'échelle en fonction des premières données traitées.[0, 1]strNormalize

chaîne cmap ouColormap

La palette de couleurs utilisée pour mapper les valeurs de données normalisées aux couleurs RVBA.

get_cursor_data ( événement )

Renvoie la valeur de l'image à la position de l'événement ou None si l'événement est en dehors de l'image.

Voir également

matplotlib.artist.Artist.get_cursor_data

get_extent ( )

Renvoie l'étendue de l'image sous forme de tuple (gauche, droite, bas, haut).

get_window_extent ( moteur de rendu = Aucun )

Obtenez la boîte englobante de l'artiste dans l'espace d'affichage.

La largeur et la hauteur de la boîte englobante sont non négatives.

Les sous-classes doivent être remplacées pour être incluses dans le calcul « serré » de la boîte englobante. La valeur par défaut est de renvoyer une boîte englobante vide à 0, 0.

Soyez prudent lorsque vous utilisez cette fonction, les résultats ne seront pas mis à jour si l'étendue de la fenêtre d'artiste de l'artiste change. L'étendue peut changer en raison de toute modification de la pile de transformation, telle que la modification des limites des axes, de la taille de la figure ou du canevas utilisé (comme cela se fait lors de l'enregistrement d'une figure). Cela peut entraîner un comportement inattendu où les figures interactives s'afficheront correctement à l'écran, mais ne seront pas enregistrées correctement.

make_image ( moteur de rendu , grossissement = 1.0 , non échantillonné = False )

Normalisez, remettez à l'échelle et coloriez les données de cette image pour le rendu à l'aide de renderer , avec le grossissement donné .

Si unsampled vaut True, l'image ne sera pas mise à l'échelle, mais une transformation affine appropriée sera renvoyée à la place.

Retours :

image (M, N, 4) tableau uint8

L'image RGBA, rééchantillonnée sauf si non échantillonnée est True.

x, y flottant

Le coin supérieur gauche où l'image doit être dessinée, en pixels.

trans Affine2D

La transformation affine de l'image à l'espace pixel.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , extent=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> ,label=<UNSET> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

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	flottant ou semblable à un tableau 2D ou aucun
animated	bourdonner
array	en forme de tableau
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	Colormapou str ou Aucun
data	comme un tableau ouPIL.Image.Image
extent	4-tuple de flotteur
figure	Figure
filternorm	bourdonner
filterrad	flotteur positif
gid	chaîne
in_layout	bourdonner
interpolation	{'anticrénelage', 'le plus proche', 'bilinéaire', 'bicubique', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussien', 'bessel', 'mitchell', 'sinc', 'lanczos', 'aucun'} ou Aucun
interpolation_stage	{'data', 'rgba'} ou Aucun
label	objet
mouseover	bourdonner
norm	Normalizeou str ou Aucun
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
resample	booléen ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur

set_extent ( étendue )

Définissez l'étendue de l'image.

Paramètres :

étendue 4-tuple de flotteur

La position et la taille de l'image sous forme de tuple dans les coordonnées de données.(left, right, bottom, top)

Remarques

Cela met à jour ax.dataLim, et, en cas de mise à l'échelle automatique, définit ax.viewLim pour s'adapter parfaitement à l'image, quel que soit dataLim. L'état de l'autoscaling n'est pas modifié, donc suivre ceci avec ax.autoscale_view() refait l'autoscaling en accord avec dataLim.

classe matplotlib.image. BboxImage ( bbox , * , cmap = None , norm = None , interpolation = None , origin = None , filternorm = True , filterrad = 4.0 , resample = False , ** kwargs )

Socles :_ImageBase

La classe Image dont la taille est déterminée par la bbox donnée.

cmap est une instance colors.Colormap norm est une instance colors.Normalize pour mapper la luminance sur 0-1

kwargs sont une liste facultative d'arguments de mots clés d'artiste

contient ( mouseevent )

Testez si l'événement de souris s'est produit dans l'image.

get_window_extent ( moteur de rendu = Aucun )

Obtenez la boîte englobante de l'artiste dans l'espace d'affichage.

La largeur et la hauteur de la boîte englobante sont non négatives.

Les sous-classes doivent être remplacées pour être incluses dans le calcul « serré » de la boîte englobante. La valeur par défaut est de renvoyer une boîte englobante vide à 0, 0.

Soyez prudent lorsque vous utilisez cette fonction, les résultats ne seront pas mis à jour si l'étendue de la fenêtre d'artiste de l'artiste change. L'étendue peut changer en raison de toute modification de la pile de transformation, telle que la modification des limites des axes, de la taille de la figure ou du canevas utilisé (comme cela se fait lors de l'enregistrement d'une figure). Cela peut entraîner un comportement inattendu où les figures interactives s'afficheront correctement à l'écran, mais ne seront pas enregistrées correctement.

make_image ( moteur de rendu , grossissement = 1.0 , non échantillonné = False )

Normalisez, remettez à l'échelle et coloriez les données de cette image pour le rendu à l'aide de renderer , avec le grossissement donné .

Si unsampled vaut True, l'image ne sera pas mise à l'échelle, mais une transformation affine appropriée sera renvoyée à la place.

Retours :

image (M, N, 4) tableau uint8

L'image RGBA, rééchantillonnée sauf si non échantillonnée est True.

x, y flottant

Le coin supérieur gauche où l'image doit être dessinée, en pixels.

trans Affine2D

La transformation affine de l'image à l'espace pixel.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> , label=<UNSET> ,mouseover=<UNSET> ,norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

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	flottant ou semblable à un tableau 2D ou aucun
animated	bourdonner
array	en forme de tableau
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	Colormapou str ou Aucun
data	comme un tableau ouPIL.Image.Image
figure	Figure
filternorm	bourdonner
filterrad	flotteur positif
gid	chaîne
in_layout	bourdonner
interpolation	{'anticrénelage', 'le plus proche', 'bilinéaire', 'bicubique', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussien', 'bessel', 'mitchell', 'sinc', 'lanczos', 'aucun'} ou Aucun
interpolation_stage	{'data', 'rgba'} ou Aucun
label	objet
mouseover	bourdonner
norm	Normalizeou str ou Aucun
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
resample	booléen ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur

classe matplotlib.image. FigureImage ( fig , * , cmap = None , norm = None , offsetx = 0 , offsety = 0 , origin = None , ** kwargs )

Socles :_ImageBase

Une image attachée à une figure.

cmap est une instance colors.Colormap norm est une instance colors.Normalize pour mapper la luminance sur 0-1

kwargs sont une liste facultative d'arguments de mots clés d'artiste

get_extent ( )

Renvoie l'étendue de l'image sous forme de tuple (gauche, droite, bas, haut).

make_image ( moteur de rendu , grossissement = 1.0 , non échantillonné = False )

Normalisez, remettez à l'échelle et coloriez les données de cette image pour le rendu à l'aide de renderer , avec le grossissement donné .

Si unsampled vaut True, l'image ne sera pas mise à l'échelle, mais une transformation affine appropriée sera renvoyée à la place.

Retours :

image (M, N, 4) tableau uint8

L'image RGBA, rééchantillonnée sauf si non échantillonnée est True.

x, y flottant

Le coin supérieur gauche où l'image doit être dessinée, en pixels.

trans Affine2D

La transformation affine de l'image à l'espace pixel.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> , label=<UNSET> ,mouseover=<UNSET> ,norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

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	flottant ou semblable à un tableau 2D ou aucun
animated	bourdonner
array	en forme de tableau
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	Colormapou str ou Aucun
data	inconnue
figure	Figure
filternorm	bourdonner
filterrad	flotteur positif
gid	chaîne
in_layout	bourdonner
interpolation	{'anticrénelage', 'le plus proche', 'bilinéaire', 'bicubique', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussien', 'bessel', 'mitchell', 'sinc', 'lanczos', 'aucun'} ou Aucun
interpolation_stage	{'data', 'rgba'} ou Aucun
label	objet
mouseover	bourdonner
norm	Normalizeou str ou Aucun
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
resample	booléen ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur

set_data ( A )

Définissez le tableau d'images.

zordre = 0

classe matplotlib.image. NonUniformImage ( ax , * , interpolation = 'nearest' , ** kwargs )

Socles :AxesImage

Paramètres :

interpolation {'plus proche', 'bilinéaire'}, par défaut : 'plus proche'

**kwargs

Tous les autres arguments de mots clés sont identiques à ceux de AxesImage.

get_extent ( )

Renvoie l'étendue de l'image sous forme de tuple (gauche, droite, bas, haut).

make_image ( moteur de rendu , grossissement = 1.0 , non échantillonné = False )

Normalisez, remettez à l'échelle et coloriez les données de cette image pour le rendu à l'aide de renderer , avec le grossissement donné .

Si unsampled vaut True, l'image ne sera pas mise à l'échelle, mais une transformation affine appropriée sera renvoyée à la place.

Retours :

image (M, N, 4) tableau uint8

L'image RGBA, rééchantillonnée sauf si non échantillonnée est True.

x, y flottant

Le coin supérieur gauche où l'image doit être dessinée, en pixels.

trans Affine2D

La transformation affine de l'image à l'espace pixel.

mouseover = Faux

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , extent=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> ,label=<UNSET> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

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	flottant ou semblable à un tableau 2D ou aucun
animated	bourdonner
array	inconnue
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	inconnue
data	inconnue
extent	4-tuple de flotteur
figure	Figure
filternorm	inconnue
filterrad	inconnue
gid	chaîne
in_layout	bourdonner
interpolation	{'le plus proche', 'bilinéaire'} ou Aucun
interpolation_stage	{'data', 'rgba'} ou Aucun
label	objet
mouseover	bourdonner
norm	inconnue
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
resample	booléen ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur

set_array ( * args )

Conservé pour la rétrocompatibilité - utilisez set_data à la place.

Paramètres :

Une sorte de tableau

set_cmap ( cmap )

Définissez la palette de couleurs pour les données de luminance.

Paramètres :

cmap Colormapou str ou Aucun

set_data ( x , y , A )

Définissez la grille pour les centres de pixel et les valeurs de pixel.

Paramètres :

x, y type tableau 1D

Tableaux monotones de formes (N,) et (M,), respectivement, spécifiant les centres des pixels.

Une sorte de tableau

(M, N) ndarray ou tableau masqué de valeurs à colormapper, ou (M, N, 3) tableau RGB, ou (M, N, 4) tableau RGBA.

set_filternorm ( s )

Définissez si le filtre de redimensionnement normalise les poids.

Voir l'aide pour imshow.

Paramètres :

booléen filternorm

set_filterrad ( s )

Définissez le rayon du filtre de redimensionnement applicable uniquement à certains schémas d'interpolation - voir l'aide pour imshow

Paramètres :

flotteur positif du filtre

set_interpolation ( s )

Paramètres :

s {'plus proche', 'bilinéaire'} ou Aucun

Si aucun, utilisez rcParams["image.interpolation"](par défaut : 'antialiased').

set_norm ( norme )

Définissez l'instance de normalisation.

Paramètres :

norm Normalizeou str ou None

Remarques

Si des barres de couleurs utilisent le mappable pour cette norme, la définition de la norme du mappable réinitialisera la norme, le localisateur et les formateurs sur la barre de couleurs par défaut.

classe matplotlib.image. PcolorImage ( ax , x = Aucun , y = Aucun , A = Aucun , * , cmap = Aucun , norm = Aucun , ** kwargs )

Socles :AxesImage

Créez un tracé de style pcolor avec une grille rectangulaire irrégulière.

Cela utilise une variation du code d'image irrégulier d'origine, et il est utilisé par pcolorfast pour le type de grille correspondant.

Paramètres :

hacheAxes

Les axes auxquels l'image appartiendra.

x, y Type de tableau 1D, facultatif

Tableaux monotones de longueur N+1 et M+1, respectivement, spécifiant les limites du rectangle. S'il n'est pas fourni, la valeur par défaut sera et , respectivement.range(N + 1)range(M + 1)

Une sorte de tableau

Les données doivent être codées par couleur. L'interprétation dépend de la forme:

• (M, N) ndarray ou tableau masqué : valeurs à colormapper

• (M, N, 3) : matrice RVB

• (M, N, 4) : matrice RVBA

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.

norme str ouNormalize

Mappe la luminance sur 0-1.

** propriétés kwargsArtist

get_cursor_data ( événement )

Renvoie la valeur de l'image à la position de l'événement ou None si l'événement est en dehors de l'image.

Voir également

matplotlib.artist.Artist.get_cursor_data

make_image ( moteur de rendu , grossissement = 1.0 , non échantillonné = False )

Normalisez, remettez à l'échelle et coloriez les données de cette image pour le rendu à l'aide de renderer , avec le grossissement donné .

Si unsampled vaut True, l'image ne sera pas mise à l'échelle, mais une transformation affine appropriée sera renvoyée à la place.

Retours :

image (M, N, 4) tableau uint8

L'image RGBA, rééchantillonnée sauf si non échantillonnée est True.

x, y flottant

Le coin supérieur gauche où l'image doit être dessinée, en pixels.

trans Affine2D

La transformation affine de l'image à l'espace pixel.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , extent=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> ,label=<UNSET> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

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	flottant ou semblable à un tableau 2D ou aucun
animated	bourdonner
array	inconnue
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	Colormapou str ou Aucun
data	inconnue
extent	4-tuple de flotteur
figure	Figure
filternorm	bourdonner
filterrad	flotteur positif
gid	chaîne
in_layout	bourdonner
interpolation	{'anticrénelage', 'le plus proche', 'bilinéaire', 'bicubique', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussien', 'bessel', 'mitchell', 'sinc', 'lanczos', 'aucun'} ou Aucun
interpolation_stage	{'data', 'rgba'} ou Aucun
label	objet
mouseover	bourdonner
norm	Normalizeou str ou Aucun
path_effects	AbstractPathEffect
picker	Aucun ou bool ou flottant ou appelable
rasterized	bourdonner
resample	booléen ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
transform	Transform
url	chaîne
visible	bourdonner
zorder	flotteur

set_array ( * args )

Conservé pour la rétrocompatibilité - utilisez set_data à la place.

Paramètres :

Une sorte de tableau

set_data ( x , y , A )

Définissez la grille pour les limites du rectangle et les valeurs des données.

Paramètres :

x, y Type de tableau 1D, facultatif

Tableaux monotones de longueur N+1 et M+1, respectivement, spécifiant les limites du rectangle. S'il n'est pas fourni, la valeur par défaut sera et , respectivement.range(N + 1)range(M + 1)

Une sorte de tableau

Les données doivent être codées par couleur. L'interprétation dépend de la forme:

• (M, N) ndarray ou tableau masqué : valeurs à colormapper

• (M, N, 3) : matrice RVB

• (M, N, 4) : matrice RVBA

matplotlib.image. images_composites ( images , moteur de rendu , grossissement = 1.0 )

Composez plusieurs images RGBA en une seule. Les images sont composées dans l'ordre dans lequel elles apparaissent dans la liste des images .

Paramètres :

images liste des Images

Chacun doit avoir une make_imageméthode. Pour chaque image, can_compositedoit retourner True, bien que cela ne soit pas imposé par cette fonction. Chaque image doit avoir une transformation purement affine sans cisaillement.

moteur de renduRendererBase

grossissement flottant, par défaut : 1

Grossissement supplémentaire à appliquer pour le moteur de rendu utilisé.

Retours :

image tableau uint8 (M, N, 4)

L'image composite RGBA.

décalage_x, décalage_y flottant

Le décalage (gauche, bas) où l'image composite doit être placée dans la figure de sortie.

matplotlib.image. imread ( fname , format = None )

Lit une image d'un fichier dans un tableau.

Noter

Cette fonction existe pour des raisons historiques. Il est recommandé de l'utiliser à la PIL.Image.openplace pour charger des images.

Paramètres :

fname str ou semblable à un fichier

Le fichier image à lire : un nom de fichier, une URL ou un objet de type fichier ouvert en mode lecture-binaire.

La transmission d'une URL est obsolète. Veuillez ouvrir l'URL pour la lecture et transmettre le résultat à Pillow, par exemple avec np.array(PIL.Image.open(urllib.request.urlopen(url))).

chaîne de format , facultatif

Le format de fichier image supposé pour la lecture des données. L'image est chargée en tant que fichier PNG si le format est défini sur "png", si fname est un chemin ou un fichier ouvert avec une extension ".png", ou s'il s'agit d'une URL. Dans tous les autres cas, le format est ignoré et le format est automatiquement détecté par PIL.Image.open.

Retours :

numpy.array

Les données d'images. Le tableau renvoyé a la forme

• (M, N) pour les images en niveaux de gris.

• (M, N, 3) pour les images RVB.

• (M, N, 4) pour les images RGBA.

Les images PNG sont renvoyées sous forme de tableaux flottants (0-1). Tous les autres formats sont renvoyés sous forme de tableaux int, avec une profondeur de bits déterminée par le contenu du fichier.

matplotlib.image. imsave ( fname , arr , vmin = None , vmax = None , cmap = None , format = None , origin = None , dpi = 100 , * , metadata = None , pil_kwargs = None )

Enregistrez un tableau en tant que fichier image.

Paramètres :

fname str ou comme un chemin ou comme un fichier

Un chemin ou un objet de type fichier dans lequel stocker l'image. Si le format n'est pas défini, le format de sortie est déduit de l'extension de fname , le cas échéant, et de rcParams["savefig.format"](par défaut : 'png') sinon. Si le format est défini, il détermine le format de sortie.

arr semblable à un tableau

Les données d'images. La forme peut être MxN (luminance), MxNx3 (RGB) ou MxNx4 (RGBA).

vmin, flotteur vmax, facultatif

vmin et vmax définissent la mise à l'échelle des couleurs de l'image en fixant les valeurs qui correspondent aux limites de couleur de la palette de couleurs. Si vmin ou vmax est None, cette limite est déterminée à partir de la valeur arr min/max.

cmap str ou Colormap, par défaut : rcParams["image.cmap"](par défaut : 'viridis')

Une instance de Colormap ou un nom de colormap enregistré. La palette de couleurs mappe les données scalaires aux couleurs. Il est ignoré pour les données RVB(A).

chaîne de format , facultatif

Le format de fichier, par exemple 'png', 'pdf', 'svg', ... Le comportement lorsque ceci n'est pas défini est documenté sous fname .

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

Indique si l' index du tableau se trouve dans le coin supérieur gauche ou inférieur gauche des axes.(0, 0)

dpi flottant

Le DPI à stocker dans les métadonnées du fichier. Cela n'affecte pas la résolution de l'image de sortie. Selon le format du fichier, cela peut être arrondi à l'entier le plus proche.

dict de métadonnées , facultatif

Métadonnées dans le fichier image. Les clés prises en charge dépendent du format de sortie, consultez la documentation des backends respectifs pour plus d'informations.

pil_kwargs dict, facultatif

Arguments de mot-clé passés à PIL.Image.Image.save. Si la clé 'pnginfo' est présente, elle remplace complètement metadata , y compris la clé 'Software' par défaut.

matplotlib.image. pil_to_array ( pilImage )

Chargez une image PIL et renvoyez-la sous la forme d'un tableau numpy int.

Retours :

numpy.array

La forme du tableau dépend du type d'image :

• (M, N) pour les images en niveaux de gris.

• (M, N, 3) pour les images RVB.

• (M, N, 4) pour les images RGBA.

matplotlib.image. vignette ( infile , thumbfile , scale = 0.1 , interpolation = 'bilinéaire' , preview = False )

Créez une vignette de l'image dans infile avec le nom de fichier de sortie thumbfile .

Voir Miniature d'image .

Paramètres :

infile str ou semblable à un fichier

Le fichier image. Matplotlib s'appuie sur Pillow pour la lecture d'images et prend donc en charge un large éventail de formats de fichiers, notamment PNG, JPG, TIFF et autres.

thumbfile str ou semblable à un fichier

Le nom du fichier de la vignette.

échelle flottante, par défaut : 0,1

Le facteur d'échelle pour la vignette.

chaîne d' interpolation , par défaut : 'bilinéaire'

Schéma d'interpolation utilisé dans le rééchantillonnage. Voir le paramètre d' interpolationimshow de pour les valeurs possibles.

aperçu booléen, par défaut : False

Si True, le backend par défaut (vraisemblablement un backend d'interface utilisateur) sera utilisé, ce qui entraînera l'augmentation d'un chiffre s'il showest appelé. Si la valeur est False, la figure est créée à l'aide FigureCanvasBasede et le backend de dessin est sélectionné comme le Figure.savefigferait normalement.

Retours :

Figure

Instance de figure contenant la vignette.