matplotlib.image

Das Modul `image` unterstützt grundlegende Funktionen zum Laden, Skalieren und Anzeigen von Bildern.

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

Bases: _ImageBase

Ein Bild mit Pixeln auf einem regelmäßigen Gitter, das an einer Achse angehängt ist.

Parameter:

axAxes

Die Achse, zu der das Bild gehören wird.

cmapstr oder Colormap, Standard: rcParams["image.cmap"] (Standard: 'viridis')

Die Colormap-Instanz oder der registrierte Colormap-Name, der verwendet wird, um Skalardaten in Farben abzubilden.

normstr oder Normalize

Ordnet Luminanz auf 0-1 ab.

interpolationstr, Standard: rcParams["image.interpolation"] (Standard: 'auto')

Unterstützte Werte sind 'none', 'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'blackman'.

interpolation_stage{'data', 'rgba'}, Standard: 'data'

Wenn 'data', wird die Interpolation auf den vom Benutzer bereitgestellten Daten durchgeführt. Wenn 'rgba', wird die Interpolation nach Anwendung der Farbzuordnung durchgeführt (visuelle Interpolation).

origin{'upper', 'lower'}, Standard: rcParams["image.origin"] (Standard: 'upper')

Platziert den Index [0, 0] des Arrays in der oberen linken oder unteren linken Ecke der Achsen. Die Konvention 'upper' wird typischerweise für Matrizen und Bilder verwendet.

extenttuple, optional

Die Datenachsen (links, rechts, unten, oben) für die Registrierung von Bildplots mit Datenplots. Standardmäßig werden die Pixelzentren mit den nullbasierten Zeilen- und Spaltenindizes beschriftet.

filternormbool, Standard: True

Ein Parameter für den Antigrain-Bildskalierungsfilter (siehe Antigrain-Dokumentation). Wenn `filternorm` gesetzt ist, normalisiert der Filter Ganzzahlwerte und korrigiert Rundungsfehler. Er hat keine Auswirkung auf die Quell-Gleitkommazahlen, sondern korrigiert nur Ganzzahlen gemäß der Regel 1.0, was bedeutet, dass jede Summe von Pixelgewichten 1.0 ergeben muss. Daher muss die Filterfunktion einen Graphen mit der richtigen Form erzeugen.

filterradfloat > 0, Standard: 4

Der Filterradius für Filter, die einen Radiusparameter haben, d.h. wenn die Interpolation eine der folgenden ist: 'sinc', 'lanczos' oder 'blackman'.

resamplebool, Standard: False

Wenn True, wird eine vollständige Skalierungsmethode verwendet. Wenn False, wird nur skaliert, wenn das Ausgabebild größer als das Eingabebild ist.

**kwargsArtist-Eigenschaften

Parameter:

colorizercolorizer.Colorizer

get_cursor_data(event)

Gibt den Bildwert an der Ereignisposition zurück oder *None*, wenn das Ereignis außerhalb des Bildes liegt.

Siehe auch

matplotlib.artist.Artist.get_cursor_data

get_extent()

Gibt die Bildausdehnung als Tupel (links, rechts, unten, oben) zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

make_image(renderer, magnification=1.0, unsampled=False)

Normalisiert, skaliert und farbt die Daten dieses Bildes für das Rendering mit renderer, bei gegebener magnification.

Wenn unsampled True ist, wird das Bild nicht skaliert, sondern stattdessen eine entsprechende affine Transformation zurückgegeben.

Gibt zurück:

image(M, N, 4) numpy.uint8-Array

Das RGBA-Bild, skaliert, es sei denn, unsampled ist True.

x, yfloat

Die obere linke Ecke, an der das Bild gezeichnet werden soll, im Pixelkoordinatensystem.

transAffine2D

Die affine Transformation vom Bild- in das Pixelkoordinatensystem.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<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>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder 2D-Array-ähnlich oder None
animated	bool
Array	array-like
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
Daten	Array-ähnlich oder PIL.Image.Image
extent	4-Tupel von Float
figure	Figure oder SubFigure
filternorm	bool
filterrad	positive Float
gid	str
in_layout	bool
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} oder None
interpolation_stage	{'data', 'rgba', 'auto'} oder None
label	object
mouseover	bool
norm	Normalize oder str oder None
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
resample	bool oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_extent(extent, **kwargs)

Setzt die Bildausdehnung.

Parameter:

extent4-Tupel von Float

Die Position und Größe des Bildes als Tupel (links, rechts, unten, oben) in Datenkoordinaten.

**kwargs

Andere Parameter, von denen Einheiteninformationen (d. h. die Einträge xunits, yunits, zunits (für 3D-Achsen), runits und thetaunits (für Polarachsen)) angewendet werden, falls vorhanden.

Anmerkungen

Dies aktualisiert Axes.dataLim und setzt, wenn autoskalierend, Axes.viewLim, um das Bild genau anzupassen, unabhängig von dataLim. Der Autoskalierungsstatus wird nicht geändert, sodass ein nachfolgender Aufruf von Axes.autoscale_view die Autoskalierung gemäß dataLim wiederholt.

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

Bases: _ImageBase

Die Bildklasse, deren Größe durch die angegebene Bbox bestimmt wird.

cmap ist eine `colors.Colormap`-Instanz, norm ist eine `colors.Normalize`-Instanz, um Luminanz auf 0-1 abzubilden.

kwargs sind eine optionale Liste von `Artist`-Schlüsselwortargumenten.

contains(mouseevent)

Prüft, ob das Mausereignis innerhalb des Bildes aufgetreten ist.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

make_image(renderer, magnification=1.0, unsampled=False)

Normalisiert, skaliert und farbt die Daten dieses Bildes für das Rendering mit renderer, bei gegebener magnification.

Wenn unsampled True ist, wird das Bild nicht skaliert, sondern stattdessen eine entsprechende affine Transformation zurückgegeben.

Gibt zurück:

image(M, N, 4) numpy.uint8-Array

Das RGBA-Bild, skaliert, es sei denn, unsampled ist True.

x, yfloat

Die obere linke Ecke, an der das Bild gezeichnet werden soll, im Pixelkoordinatensystem.

transAffine2D

Die affine Transformation vom Bild- in das Pixelkoordinatensystem.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<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>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder 2D-Array-ähnlich oder None
animated	bool
Array	array-like
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
Daten	Array-ähnlich oder PIL.Image.Image
figure	Figure oder SubFigure
filternorm	bool
filterrad	positive Float
gid	str
in_layout	bool
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} oder None
interpolation_stage	{'data', 'rgba', 'auto'} oder None
label	object
mouseover	bool
norm	Normalize oder str oder None
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
resample	bool oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

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

Bases: _ImageBase

Ein Bild, das an einer Figur angehängt ist.

cmap ist eine `colors.Colormap`-Instanz, norm ist eine `colors.Normalize`-Instanz, um Luminanz auf 0-1 abzubilden.

kwargs sind eine optionale Liste von `Artist`-Schlüsselwortargumenten.

get_extent()

Gibt die Bildausdehnung als Tupel (links, rechts, unten, oben) zurück.

make_image(renderer, magnification=1.0, unsampled=False)

Normalisiert, skaliert und farbt die Daten dieses Bildes für das Rendering mit renderer, bei gegebener magnification.

Wenn unsampled True ist, wird das Bild nicht skaliert, sondern stattdessen eine entsprechende affine Transformation zurückgegeben.

Gibt zurück:

image(M, N, 4) numpy.uint8-Array

Das RGBA-Bild, skaliert, es sei denn, unsampled ist True.

x, yfloat

Die obere linke Ecke, an der das Bild gezeichnet werden soll, im Pixelkoordinatensystem.

transAffine2D

Die affine Transformation vom Bild- in das Pixelkoordinatensystem.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<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>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder 2D-Array-ähnlich oder None
animated	bool
Array	array-like
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
Daten	unknown
figure	Figure oder SubFigure
filternorm	bool
filterrad	positive Float
gid	str
in_layout	bool
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} oder None
interpolation_stage	{'data', 'rgba', 'auto'} oder None
label	object
mouseover	bool
norm	Normalize oder str oder None
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
resample	bool oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_data(A)

Setzt das Bild-Array.

zorder = 0

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

Bases: AxesImage

Ein Bild mit Pixeln auf einem nicht-uniformen Gitter.

Im Gegensatz zu AxesImage, bei dem Pixel auf einem regelmäßigen Gitter liegen, erlaubt NonUniformImage Zeilen und Spalten mit individuellen Höhen/Breiten.

Siehe auch Image nonuniform.

Parameter:

axAxes

Die Achse, zu der das Bild gehören wird.

interpolation{'nearest', 'bilinear'}, Standard: 'nearest'

Das bei der Skalierung verwendete Interpolationsschema.

**kwargs

Alle anderen Schlüsselwortargumente sind identisch mit denen von AxesImage.

get_cursor_data(event)

Gibt den Bildwert an der Ereignisposition zurück oder *None*, wenn das Ereignis außerhalb des Bildes liegt.

Siehe auch

matplotlib.artist.Artist.get_cursor_data

get_extent()

Gibt die Bildausdehnung als Tupel (links, rechts, unten, oben) zurück.

make_image(renderer, magnification=1.0, unsampled=False)

Normalisiert, skaliert und farbt die Daten dieses Bildes für das Rendering mit renderer, bei gegebener magnification.

Wenn unsampled True ist, wird das Bild nicht skaliert, sondern stattdessen eine entsprechende affine Transformation zurückgegeben.

Gibt zurück:

image(M, N, 4) numpy.uint8-Array

Das RGBA-Bild, skaliert, es sei denn, unsampled ist True.

x, yfloat

Die obere linke Ecke, an der das Bild gezeichnet werden soll, im Pixelkoordinatensystem.

transAffine2D

Die affine Transformation vom Bild- in das Pixelkoordinatensystem.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<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>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder 2D-Array-ähnlich oder None
animated	bool
Array	unknown
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	unknown
Daten	unknown
extent	4-Tupel von Float
figure	Figure oder SubFigure
filternorm	unknown
filterrad	unknown
gid	str
in_layout	bool
interpolation	{'nearest', 'bilinear'} oder None
interpolation_stage	{'data', 'rgba', 'auto'} oder None
label	object
mouseover	bool
norm	unknown
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
resample	bool oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_array(*args)

Beibehalten aus Kompatibilitätsgründen - verwenden Sie stattdessen `set_data`.

Parameter:

Aarray-ähnlich

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_data(x, y, A)

Setzt das Gitter für die Pixelzentren und die Pixelwerte.

Parameter:

x, y1D array-ähnlich

Monotone Arrays der Formen (N,) und (M,) bzw., die Pixelzentren angeben.

Aarray-ähnlich

(M, N) ndarray oder Masked-Array von Werten, die farbzugeordnet werden sollen, oder (M, N, 3) RGB-Array, oder (M, N, 4) RGBA-Array.

set_filternorm(filternorm)

Legt fest, ob der Skalierungsfilter die Gewichte normalisiert.

Siehe Hilfe für imshow.

Parameter:

filternormbool

set_filterrad(filterrad)

Setzt den Radius des Skalierungsfilters, der nur für bestimmte Interpolationsschemata gilt - siehe Hilfe für `imshow`.

Parameter:

filterradpositive Float

set_interpolation(s)

Parameter:

s{'nearest', 'bilinear'} oder None

Wenn None, wird rcParams["image.interpolation"] verwendet (Standard: 'auto').

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

Klasse matplotlib.image.PcolorImage(ax, x=None, y=None, A=None, *, cmap=None, norm=None, colorizer=None, **kwargs)

Bases: AxesImage

Erstellt ein Pcolor-ähnliches Diagramm mit einem unregelmäßigen rechteckigen Gitter.

Dies verwendet eine Variante des ursprünglichen Codes für unregelmäßige Bilder und wird von pcolorfast für den entsprechenden Gittertyp verwendet.

Parameter:

axAxes

Die Achse, zu der das Bild gehören wird.

x, y1D-Array-ähnlich, optional

Monotone Arrays der Längen N+1 bzw. M+1, die die Rechteckgrenzen angeben. Wenn nicht angegeben, werden sie standardmäßig auf range(N + 1) und range(M + 1) gesetzt.

Aarray-ähnlich

Die zu kodierenden Daten. Die Interpretation hängt von der Form ab

• (M, N) ndarray oder masked array: Werte, die abgebildet werden sollen

• (M, N, 3): RGB-Array

• (M, N, 4): RGBA-Array

cmapstr oder Colormap, Standard: rcParams["image.cmap"] (Standard: 'viridis')

Die Colormap-Instanz oder der registrierte Colormap-Name, der verwendet wird, um Skalardaten in Farben abzubilden.

normstr oder Normalize

Ordnet Luminanz auf 0-1 ab.

**kwargsArtist-Eigenschaften

get_cursor_data(event)

Gibt den Bildwert an der Ereignisposition zurück oder *None*, wenn das Ereignis außerhalb des Bildes liegt.

Siehe auch

matplotlib.artist.Artist.get_cursor_data

make_image(renderer, magnification=1.0, unsampled=False)

Normalisiert, skaliert und farbt die Daten dieses Bildes für das Rendering mit renderer, bei gegebener magnification.

Wenn unsampled True ist, wird das Bild nicht skaliert, sondern stattdessen eine entsprechende affine Transformation zurückgegeben.

Gibt zurück:

image(M, N, 4) numpy.uint8-Array

Das RGBA-Bild, skaliert, es sei denn, unsampled ist True.

x, yfloat

Die obere linke Ecke, an der das Bild gezeichnet werden soll, im Pixelkoordinatensystem.

transAffine2D

Die affine Transformation vom Bild- in das Pixelkoordinatensystem.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<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>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder 2D-Array-ähnlich oder None
animated	bool
Array	unknown
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
Daten	unknown
extent	4-Tupel von Float
figure	Figure oder SubFigure
filternorm	bool
filterrad	positive Float
gid	str
in_layout	bool
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} oder None
interpolation_stage	{'data', 'rgba', 'auto'} oder None
label	object
mouseover	bool
norm	Normalize oder str oder None
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
resample	bool oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_array(*args)

Beibehalten aus Kompatibilitätsgründen - verwenden Sie stattdessen `set_data`.

Parameter:

Aarray-ähnlich

set_data(x, y, A)

Setzt das Gitter für die Rechteckgrenzen und die Datenwerte.

Parameter:

x, y1D-Array-ähnlich, optional

Monotone Arrays der Längen N+1 bzw. M+1, die die Rechteckgrenzen angeben. Wenn nicht angegeben, werden sie standardmäßig auf range(N + 1) und range(M + 1) gesetzt.

Aarray-ähnlich

Die zu kodierenden Daten. Die Interpretation hängt von der Form ab

• (M, N) ndarray oder masked array: Werte, die abgebildet werden sollen

• (M, N, 3): RGB-Array

• (M, N, 4): RGBA-Array

matplotlib.image.composite_images(images, renderer, magnification=1.0)

Setzt eine Anzahl von RGBA-Bildern zu einem zusammen. Die Bilder werden in der Reihenfolge zusammengefügt, in der sie in der Liste images erscheinen.

Parameter:

imagesListe von Bildern

Jedes muss eine make_image-Methode haben. Für jedes Bild sollte can_composite True zurückgeben, obwohl dies von dieser Funktion nicht erzwungen wird. Jedes Bild muss eine rein affine Transformation ohne Scherung haben.

rendererRendererBase

magnificationfloat, Standard: 1

Die zusätzliche Vergrößerung, die für den verwendeten Renderer angewendet werden soll.

Gibt zurück:

image(M, N, 4) numpy.uint8-Array

Das zusammengesetzte RGBA-Bild.

offset_x, offset_yfloat

Der (links, unten) Offset, an dem das zusammengesetzte Bild in der Ausgabefigur platziert werden soll.

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

Liest ein Bild aus einer Datei in ein Array.

Hinweis

Diese Funktion existiert aus historischen Gründen. Es wird empfohlen, stattdessen PIL.Image.open zum Laden von Bildern zu verwenden.

Parameter:

fnamestr oder dateiähnlich

Die Bilddatei, die gelesen werden soll: ein Dateiname, eine URL oder ein dateiähnliches Objekt, das im Binärlesemodus geöffnet wurde.

Die Übergabe einer URL ist veraltet. Bitte öffnen Sie die URL zum Lesen und übergeben Sie das Ergebnis an Pillow, z.B. mit np.array(PIL.Image.open(urllib.request.urlopen(url))).

formatstr, optional

Das Bilddateiformat, das für das Lesen der Daten angenommen wird. Das Bild wird als PNG-Datei geladen, wenn format auf "png" gesetzt ist, wenn fname ein Pfad oder eine geöffnete Datei mit der Erweiterung ".png" ist, oder wenn es sich um eine URL handelt. In allen anderen Fällen wird format ignoriert und das Format wird von PIL.Image.open automatisch erkannt.

Gibt zurück:

numpy.array

Die Bilddaten. Das zurückgegebene Array hat die Form

• (M, N) für Graustufenbilder.

• (M, N, 3) für RGB-Bilder.

• (M, N, 4) für RGBA-Bilder.

PNG-Bilder werden als Float-Arrays (0-1) zurückgegeben. Alle anderen Formate werden als Integer-Arrays zurückgegeben, wobei die Bittiefe durch den Inhalt der Datei bestimmt wird.

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

Färbt eine Colormap und speichert ein Array als Bilddatei.

RGB(A)-Bilder werden durchgereicht. Einzelkanalbilder werden entsprechend cmap und norm koloriert.

Hinweis

Wenn Sie ein Einzelkanalbild als Graustufen speichern möchten, verwenden Sie bitte direkt eine Bild-I/O-Bibliothek (wie Pillow, Tifffile oder Imageio).

Parameter:

fnamestr oder pfadähnlich oder dateiähnlich

Ein Pfad oder ein dateiähnliches Objekt zum Speichern des Bildes. Wenn format nicht gesetzt ist, wird das Ausgabeformat aus der Erweiterung von fname, falls vorhanden, und aus rcParams["savefig.format"] (Standard: 'png') abgeleitet. Wenn format gesetzt ist, bestimmt es das Ausgabeformat.

arrarray-ähnlich

Die Bilddaten. Akzeptiert NumPy-Arrays oder Sequenzen (z.B. Listen oder Tupel). Die Form kann MxN (Luminanz), MxNx3 (RGB) oder MxNx4 (RGBA) sein.

vmin, vmaxfloat, optional

vmin und vmax setzen die Farbskalierung für das Bild, indem die Werte festgelegt werden, die auf die Farbwerte der Colormap abgebildet werden. Wenn entweder vmin oder vmax None ist, wird dieser Grenzwert aus dem Min/Max-Wert von arr bestimmt.

cmapstr oder Colormap, Standard: rcParams["image.cmap"] (Standard: 'viridis')

Eine Colormap-Instanz oder ein registrierter Colormap-Name. Die Colormap bildet skalare Daten auf Farben ab. Sie wird für RGB(A)-Daten ignoriert.

formatstr, optional

Das Dateiformat, z. B. 'png', 'pdf', 'svg', ... Das Verhalten, wenn dies nicht gesetzt ist, ist unter fname dokumentiert.

origin{'upper', 'lower'}, Standard: rcParams["image.origin"] (Standard: 'upper')

Gibt an, ob der Index (0, 0) des Arrays in der oberen linken oder unteren linken Ecke der Achsen liegt.

dpifloat

Die DPI, die in den Metadaten der Datei gespeichert werden. Dies hat keinen Einfluss auf die Auflösung des Ausgabebildes. Je nach Dateiformat kann dies auf die nächste ganze Zahl gerundet werden.

metadatadict, optional

Metadaten in der Bilddatei. Die unterstützten Schlüssel hängen vom Ausgabeformat ab. Informationen hierzu finden Sie in der Dokumentation der jeweiligen Backends. Derzeit nur für "png", "pdf", "ps", "eps" und "svg" unterstützt.

pil_kwargsdict, optional

Schlüsselwortargumente, die an PIL.Image.Image.save übergeben werden. Wenn der Schlüssel 'pnginfo' vorhanden ist, überschreibt er metadata vollständig, einschließlich des Standard-Schlüssels 'Software'.

matplotlib.image.pil_to_array(pilImage)

Lädt ein PIL-Bild und gibt es als numpy-Integer-Array zurück.

Gibt zurück:

numpy.array

Die Array-Form hängt vom Bildtyp ab

• (M, N) für Graustufenbilder.

• (M, N, 3) für RGB-Bilder.

• (M, N, 4) für RGBA-Bilder.

matplotlib.image.thumbnail(infile, thumbfile, scale=0.1, interpolation='bilinear', preview=False)

Erstellt ein Miniaturbild aus infile mit dem Ausgabedateinamen thumbfile.

Siehe Bild-Miniaturansicht.

Parameter:

infilestr oder dateiähnlich

Die Bilddatei. Matplotlib verwendet Pillow zum Lesen von Bildern und unterstützt daher eine breite Palette von Dateiformaten, einschließlich PNG, JPG, TIFF und andere.

thumbfilestr oder dateiähnlich

Der Dateiname für das Miniaturbild.

scalefloat, Standard: 0.1

Der Skalierungsfaktor für das Miniaturbild.

interpolationstr, Standard: 'bilinear'

Das beim Resampling verwendete Interpolationsschema. Mögliche Werte finden Sie im interpolation-Parameter von imshow.

previewbool, Standard: False

Wenn True, wird das Standard-Backend (vermutlich ein Benutzeroberflächen-Backend) verwendet, was dazu führt, dass ein Fenster angezeigt wird, wenn show aufgerufen wird. Wenn es False ist, wird die Figur mit FigureCanvasBase erstellt und das Zeichen-Backend wird wie bei Figure.savefig üblich ausgewählt.

Gibt zurück:

Figure

Die Figur-Instanz, die das Miniaturbild enthält.