matplotlib.colors

Hinweis

Die Farbtutorials und Beispiele zeigen, wie Farben und Farbkarten gesetzt werden. Möglicherweise möchten Sie stattdessen diese lesen.

Ein Modul zur Konvertierung von Zahlen oder Farbangaben in RGB oder RGBA.

RGB und RGBA sind Sequenzen von, beziehungsweise, 3 oder 4 Gleitkommazahlen im Bereich 0-1.

Dieses Modul enthält Funktionen und Klassen für die Konvertierung von Farbspezifikationen und für die Abbildung von Zahlen auf Farben in einem 1-dimensionalen Array von Farben, das als Farbkarten bezeichnet wird.

Die Abbildung von Daten auf Farben unter Verwendung einer Farbkarten umfasst typischerweise zwei Schritte: Ein Datenarray wird zuerst mithilfe einer Unterklasse von Normalize auf den Bereich 0-1 abgebildet, dann wird diese Zahl mithilfe einer Unterklasse von Colormap auf eine Farbe abgebildet. Zwei Unterklassen von Colormap werden hier bereitgestellt: LinearSegmentedColormap, die stückweise lineare Interpolation zur Definition von Farbkarten verwendet, und ListedColormap, die eine Farbkarten aus einer Liste von Farben erstellt.

Siehe auch

Erstellen von Farbkarten in Matplotlib für Beispiele, wie Farbkarten erstellt werden und

Auswählen von Farbkarten in Matplotlib für eine Liste von integrierten Farbkarten.

Farbkarten-Normalisierung für weitere Details zur Daten-Normalisierung

Weitere Farbkarten sind unter palettable verfügbar.

Das Modul bietet auch Funktionen zum Überprüfen, ob ein Objekt als Farbe interpretiert werden kann (is_color_like), zum Konvertieren eines solchen Objekts in ein RGBA-Tupel (to_rgba) oder in eine HTML-ähnliche Hex-Zeichenkette im "#rrggbb"-Format (to_hex) und eine Sequenz von Farben in ein (n, 4) RGBA-Array (to_rgba_array). Caching wird zur Effizienz genutzt.

Die von Matplotlib erkannten Farben sind unter Farben spezifizieren aufgeführt.

Farbkarten-Normierungen

Normalize([vmin, vmax, clip])	Eine Klasse, die beim Aufruf Werte innerhalb des Intervalls [vmin, vmax] linear auf das Intervall [0.0, 1.0] abbildet.
NoNorm([vmin, vmax, clip])	Dummy-Ersatz für Normalize, für den Fall, dass wir Indizes direkt in einem ScalarMappable verwenden möchten.
AsinhNorm([linear_width, vmin, vmax, clip])	Die umgekehrte hyperbolische Sinus-Skala ist nahe dem Ursprung annähernd linear, wird aber für größere positive oder negative Werte logarithmisch.
BoundaryNorm(boundaries, ncolors[, clip, extend])	Erzeugt einen Farbkartenindex basierend auf diskreten Intervallen.
CenteredNorm([vcenter, halfrange, clip])	Normalisiert symmetrische Daten um ein Zentrum (standardmäßig 0).
FuncNorm(functions[, vmin, vmax, clip])	Beliebige Normalisierung unter Verwendung von Funktionen für die Vorwärts- und Rückwärtsrichtung.
LogNorm([vmin, vmax, clip])	Normalisiert einen gegebenen Wert auf den Bereich 0-1 auf einer logarithmischen Skala.
PowerNorm(gamma[, vmin, vmax, clip])	Bildet einen gegebenen Wert linear auf den Bereich 0-1 ab und wendet dann eine Potenzgesetz-Normalisierung über diesen Bereich an.
SymLogNorm(linthresh[, linscale, vmin, ...])	Die symmetrische logarithmische Skala ist in positiver und negativer Richtung vom Ursprung aus logarithmisch.
TwoSlopeNorm(vcenter[, vmin, vmax])	Normalisiert Daten mit einem festgelegten Zentrum.

Univariate Farbkarten

Colormap(name[, N])	Basisklasse für alle Skalar-zu-RGBA-Abbildungen.
LinearSegmentedColormap(name, segmentdata[, ...])	Farbkartenobjekte basierend auf Lookup-Tabellen mit linearen Segmenten.
ListedColormap(colors[, name, N])	Farbkartenobjekt, das aus einer Liste von Farben generiert wird.

Multivariate Farbkarten

BivarColormap([N, M, shape, origin, name])	Basisklasse für alle bivariaten zu RGBA-Abbildungen.
SegmentedBivarColormap(patch[, N, shape, ...])	BivarColormap-Objekt, das durch Übersampeln eines regulären Gitters erzeugt wird.
BivarColormapFromImage(lut[, shape, origin, ...])	BivarColormap-Objekt, das durch Übersampeln eines regulären Gitters erzeugt wird.

Andere Klassen

ColorSequenceRegistry()	Container für Farbschemata, die Matplotlib namentlich bekannt sind.
LightSource([azdeg, altdeg, hsv_min_val, ...])	Erzeugt eine Lichtquelle, die aus dem angegebenen Azimut und der Elevation kommt.

Funktionen

from_levels_and_colors(levels, colors[, extend])	Eine Hilfsroutine zur Erzeugung einer cmap- und einer norm-Instanz, die sich ähnlich wie die Kontur- und Farbar gumente von contourf verhalten.
hsv_to_rgb(hsv)	Konvertiert HSV-Werte in RGB.
rgb_to_hsv(arr)	Konvertiert ein Array von Float-RGB-Werten (im Bereich [0, 1]) in HSV-Werte.
to_hex(c[, keep_alpha])	Konvertiert c in eine Hex-Farbe.
to_rgb(c)	Konvertiert c in eine RGB-Farbe und verwirft dabei stillschweigend den Alphakanal.
to_rgba(c[, alpha])	Konvertiert c in eine RGBA-Farbe.
to_rgba_array(c[, alpha])	Konvertiert c in ein (n, 4) Array von RGBA-Farben.
is_color_like(c)	Gibt zurück, ob c als RGB(A)-Farbe interpretiert werden kann.
same_color(c1, c2)	Gibt zurück, ob die Farben c1 und c2 gleich sind.
get_named_colors_mapping()	Gibt die globale Zuordnung von Namen zu benannten Farben zurück.
make_norm_from_scale(scale_cls[, ...])	Dekorator zum Erstellen einer Normalize-Unterklasse aus einer ScaleBase-Unterklasse.

Exportierte Farben

Die Daten, die zur Erstellung der Liste benannter Farben verwendet werden, werden als Wörterbücher bereitgestellt, die Farbnamen Hex-Zeichenketten zuordnen.

matplotlib.colors.BASE_COLORS

matplotlib.colors.TABLEAU_COLORS

matplotlib.colors.CSS4_COLORS

matplotlib.colors.XKCD_COLORS