matplotlib.colorizer

Die Colorizer-Klasse, die die Daten-zu-Farbe-Pipeline über eine Normalisierung und eine Colormap verwaltet.

Vorläufiger Status von Colorizer

Das Modul colorizer und die Klassen in dieser Datei gelten als vorläufig und können sich jederzeit ohne eine Abkühlphase ändern.

Siehe auch

Colormap-Referenz für eine Liste integrierter Colormaps.

Erstellen von Colormaps in Matplotlib für Beispiele, wie Colormaps erstellt werden.

Auswahl von Colormaps in Matplotlib für eine eingehende Diskussion über die Auswahl von Colormaps.

Colormap-Normalisierung für weitere Details zur Daten-Normalisierung.

class matplotlib.colorizer.Colorizer(cmap=None, norm=None)

Bases: object

Daten-zu-Farbe-Pipeline.

Diese Pipeline ist über Colorizer.to_rgba zugänglich und wird über die Attribute Colorizer.norm und Colorizer.cmap ausgeführt.

Parameter:

cmap: colorbar.Colorbar oder str oder None, Standard: None

Die Colormap, die zum Einfärben von Daten verwendet wird.

norm: colors.Normalize oder str oder None, Standard: None

Die Normalisierung, die zur Normalisierung der Daten verwendet wird

autoscale(A)

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None(A)

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property clip

property cmap

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

property norm

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Die Grenzen können auch als Tupel (vmin, vmax) als einzelnes Positionsargument übergeben werden.

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und es wird keine Zuordnung vorgenommen. Das Array kann uint8 sein oder es kann sich um Gleitkommazahlen mit Werten im Bereich von 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaNs oder maskierte Elemente erhalten einen Alpha-Wert von 0. Wenn die letzte Dimension 3 ist, wird das Schlüsselwortargument alpha (standardmäßig 1) verwendet, um die Transparenz aufzufüllen. Wenn die letzte Dimension 4 ist, wird das Schlüsselwortargument alpha ignoriert; es ersetzt nicht das vorhandene Alpha. Ein ValueError wird ausgelöst, wenn die dritte Dimension weder 3 noch 4 ist.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

property vmax

property vmin

class matplotlib.colorizer.ColorizingArtist(colorizer, **kwargs)

Bases: _ScalarMappable, Artist

Basisklasse für Künstler, die Daten mithilfe eines colorizer.Colorizer in Farben umwandeln.

Der colorizer.Colorizer wendet eine Daten-Normalisierung an, bevor RGBA-Farben von einer Colormap zurückgegeben werden.

Parameter:

colorizercolorizer.Colorizer

property colorizer

draw(renderer)

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, array=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<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 None
animated	bool
Array	Array-ähnlich oder None
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
figure	Figure oder SubFigure
gid	str
in_layout	bool
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
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

class matplotlib.colorizer._ColorizerInterface

Bases: object

Basisklasse, die die Schnittstelle zu Colorizer-Objekten von einem ColorizingArtist oder cm.ScalarMappable enthält.

Hinweis: Diese Klasse enthält nur Funktionen, die mit dem Attribut .colorizer interagieren. Andere Funktionen, die zwischen ColorizingArtist und cm.ScalarMappable gemeinsam genutzt werden, sind nicht enthalten.

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property cmap

property colorbar

Die letzte mit diesem Objekt verbundene Colorbar. Kann None sein.

get_alpha()

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_cmap()

Gibt die Colormap-Instanz zurück.

property norm

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

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.

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und es wird keine Zuordnung vorgenommen. Das Array kann uint8 sein oder es kann sich um Gleitkommazahlen mit Werten im Bereich von 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaNs oder maskierte Elemente erhalten einen Alpha-Wert von 0. Wenn die letzte Dimension 3 ist, wird das Schlüsselwortargument alpha (standardmäßig 1) verwendet, um die Transparenz aufzufüllen. Wenn die letzte Dimension 4 ist, wird das Schlüsselwortargument alpha ignoriert; es ersetzt nicht das vorhandene Alpha. Ein ValueError wird ausgelöst, wenn die dritte Dimension weder 3 noch 4 ist.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

class matplotlib.colorizer._ScalarMappable(norm=None, cmap=None, *, colorizer=None, **kwargs)

Bases: _ColorizerInterface

Eine Mixin-Klasse, um eine oder mehrere Mengen von Skalardaten in RGBA umzuwandeln.

Die ScalarMappable wendet eine Daten-Normalisierung an, bevor RGBA-Farben aus der gegebenen Colormap zurückgegeben werden.

Parameter:

normNormalize (oder eine Unterklasse davon) oder str oder None

Das Normalisierungsobjekt, das Daten skaliert, typischerweise in das Intervall [0, 1]. Wenn es sich um eine str handelt, wird eine Normalize-Unterklasse basierend auf der Skala mit dem entsprechenden Namen dynamisch generiert. Wenn None, ist norm standardmäßig ein colors.Normalize-Objekt, das seine Skalierung basierend auf den zuerst verarbeiteten Daten initialisiert.

cmapstr oder Colormap

Die Colormap, die verwendet wird, um normalisierte Datenwerte in RGBA-Farben umzuwandeln.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Arrays.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wert-Arrays A.