matplotlib#

Eine objektorientierte Plotting-Bibliothek.

Eine prozedurale Schnittstelle wird vom begleitenden pyplot-Modul bereitgestellt, das direkt importiert werden kann, z. B.:

import matplotlib.pyplot as plt

oder über ipython

ipython

in Ihrem Terminal, gefolgt von

In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt

in der IPython-Shell.

Für die meiste Zeit wird die direkte Verwendung der expliziten objektorientierten Bibliothek beim Programmieren empfohlen; die implizite pyplot-Schnittstelle dient primär der interaktiven Arbeit. Ausnahmen von dieser Empfehlung sind die pyplot-Funktionen pyplot.figure, pyplot.subplot, pyplot.subplots und pyplot.savefig, die das Skripting erheblich vereinfachen können. Siehe Matplotlib Application Interfaces (APIs) für eine Erklärung der Kompromisse zwischen der impliziten und expliziten Schnittstelle.

Module umfassen

matplotlib.axes

Die Klasse Axes. Die meisten pyplot-Funktionen sind Wrapper für Methoden von Axes. Das axes-Modul bietet die höchste Ebene des OO-Zugriffs auf die Bibliothek.

matplotlib.figure

Die Klasse Figure.

matplotlib.artist

Die Basisklasse Artist für alle Klassen, die Dinge zeichnen.

matplotlib.lines

Die Klasse Line2D zum Zeichnen von Linien und Markern.

matplotlib.patches

Klassen zum Zeichnen von Polygonen.

matplotlib.text

Die Klassen Text und Annotation.

matplotlib.image

Die Klassen AxesImage und FigureImage.

matplotlib.collections

Klassen zum effizienten Zeichnen von Linien- oder Polygonengruppen.

matplotlib.colors

Farbspezifikationen und Erstellung von Farbkarten.

matplotlib.cm

Farbkarten und die Mixin-Klasse ScalarMappable zur Bereitstellung von Farbabildungsfunktionen für andere Klassen.

matplotlib.ticker

Berechnung von Tick-Positionen und Formatierung von Tick-Beschriftungen.

matplotlib.backends

Ein Unterpaket mit Modulen für verschiedene GUI-Bibliotheken und Ausgabeformate.

Der Basis-Namespace von matplotlib enthält

rcParams

Standardkonfigurationseinstellungen; ihre Standardwerte können mit einer matplotlibrc-Datei überschrieben werden.

verwenden

Festlegen des Matplotlib-Backends. Dies sollte aufgerufen werden, bevor eine Figur erstellt wird, da es danach nicht möglich ist, zwischen verschiedenen GUI-Backends zu wechseln.

Die folgenden Umgebungsvariablen können verwendet werden, um das Verhalten anzupassen

MPLBACKEND

Diese optionale Variable kann gesetzt werden, um das Matplotlib-Backend auszuwählen. Siehe What is a backend?.

MPLCONFIGDIR

Dies ist das Verzeichnis, das zum Speichern von Benutzeranpassungen an Matplotlib sowie einiger Caches zur Leistungsverbesserung verwendet wird. Wenn MPLCONFIGDIR nicht definiert ist, werden unter Linux HOME/.config/matplotlib und HOME/.cache/matplotlib verwendet, auf anderen Plattformen HOME/.matplotlib, falls diese beschreibbar sind. Andernfalls wird das temporäre Verzeichnis der Python-Standardbibliothek tempfile.gettempdir verwendet, um ein Basisverzeichnis zu finden, in dem das Unterverzeichnis matplotlib erstellt wird.

Matplotlib wurde ursprünglich von John D. Hunter (1968-2012) geschrieben und wird jetzt von vielen anderen entwickelt und gepflegt.

Gelegentlich bezieht sich die interne Dokumentation (Python-Docstrings) auf MATLAB®, eine eingetragene Marke von The MathWorks, Inc.

Backend-Verwaltung#

matplotlib.use(backend, *, force=True)[source]#

Wählen Sie das Backend, das für Rendering und GUI-Integration verwendet wird.

Wenn pyplot bereits importiert ist, wird switch_backend verwendet und wenn das neue Backend sich vom aktuellen Backend unterscheidet, werden alle Figuren geschlossen.

Parameter:
backendstr

Das Backend, zu dem gewechselt werden soll. Dies kann entweder einer der Standard-Backend-Namen sein, die Groß-/Kleinschreibung ignorieren

  • interaktive Backends: GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, notebook, QtAgg, QtCairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo, Qt5Agg, Qt5Cairo

  • nicht-interaktive Backends: agg, cairo, pdf, pgf, ps, svg, template

oder eine Zeichenkette der Form: module://my.module.name.

notebook ist ein Synonym für nbAgg.

Der Wechsel zu einem interaktiven Backend ist nicht möglich, wenn bereits eine nicht verwandte Event-Schleife gestartet wurde (z. B. Wechsel zu GTK3Agg, wenn bereits ein TkAgg-Fenster geöffnet wurde). Der Wechsel zu einem nicht-interaktiven Backend ist immer möglich.

forcebool, default: True

Wenn True (Standardwert), wird eine ImportError ausgelöst, wenn das Backend nicht eingerichtet werden kann (entweder weil der Import fehlschlägt oder weil ein inkompatibles GUI-interaktives Framework bereits läuft); wenn False, wird der Fehler stillschweigend ignoriert.

matplotlib.get_backend(*, auto_select=True)[source]#

Gibt den Namen des aktuellen Backends zurück.

Parameter:
auto_selectbool, default: True

Ob die Backend-Auflösung ausgelöst werden soll, wenn bisher kein Backend ausgewählt wurde. Wenn True, wird sichergestellt, dass ein gültiges Backend zurückgegeben wird. Wenn False, wird None zurückgegeben, wenn bisher kein Backend ausgewählt wurde.

Hinzugefügt in Version 3.10.

Vorläufig

Das Flag auto_select ist vorläufig. Es kann ohne vorherige Ankündigung geändert oder entfernt werden.

Siehe auch

matplotlib.use
matplotlib.interactive(b)[source]#

Legt fest, ob nach jedem Plot-Befehl (z. B. pyplot.xlabel) neu gezeichnet werden soll.

matplotlib.is_interactive()[source]#

Gibt zurück, ob nach jedem Plot-Befehl neu gezeichnet werden soll.

Hinweis

Diese Funktion ist nur für die Verwendung in Backends vorgesehen. Endbenutzer sollten stattdessen pyplot.isinteractive verwenden.

Standardwerte und Styling#

matplotlib.rcParams[source]#

Eine Instanz von RcParams zur Verwaltung von Matplotlib-Standardwerten.

class matplotlib.RcParams(*args, **kwargs)[source]#

Ein Wörterbuch-ähnlicher Schlüssel-Wert-Speicher für Konfigurationsparameter, einschließlich Validierung.

Validierungsfunktionen werden in matplotlib.rcsetup definiert und den rc-Parametern zugeordnet.

Die Liste der rcParams ist

  • _internal.classic_mode

  • agg.path.chunksize

  • animation.bitrate

  • animation.codec

  • animation.convert_args

  • animation.convert_path

  • animation.embed_limit

  • animation.ffmpeg_args

  • animation.ffmpeg_path

  • animation.frame_format

  • animation.html

  • animation.writer

  • axes.autolimit_mode

  • axes.axisbelow

  • axes.edgecolor

  • axes.facecolor

  • axes.formatter.limits

  • axes.formatter.min_exponent

  • axes.formatter.offset_threshold

  • axes.formatter.use_locale

  • axes.formatter.use_mathtext

  • axes.formatter.useoffset

  • axes.grid

  • axes.grid.axis

  • axes.grid.which

  • axes.labelcolor

  • axes.labelpad

  • axes.labelsize

  • axes.labelweight

  • axes.linewidth

  • axes.prop_cycle

  • axes.spines.bottom

  • axes.spines.left

  • axes.spines.right

  • axes.spines.top

  • axes.titlecolor

  • axes.titlelocation

  • axes.titlepad

  • axes.titlesize

  • axes.titleweight

  • axes.titley

  • axes.unicode_minus

  • axes.xmargin

  • axes.ymargin

  • axes.zmargin

  • axes3d.automargin

  • axes3d.grid

  • axes3d.mouserotationstyle

  • axes3d.trackballborder

  • axes3d.trackballsize

  • axes3d.xaxis.panecolor

  • axes3d.yaxis.panecolor

  • axes3d.zaxis.panecolor

  • backend

  • backend_fallback

  • boxplot.bootstrap

  • boxplot.boxprops.color

  • boxplot.boxprops.linestyle

  • boxplot.boxprops.linewidth

  • boxplot.capprops.color

  • boxplot.capprops.linestyle

  • boxplot.capprops.linewidth

  • boxplot.flierprops.color

  • boxplot.flierprops.linestyle

  • boxplot.flierprops.linewidth

  • boxplot.flierprops.marker

  • boxplot.flierprops.markeredgecolor

  • boxplot.flierprops.markeredgewidth

  • boxplot.flierprops.markerfacecolor

  • boxplot.flierprops.markersize

  • boxplot.meanline

  • boxplot.meanprops.color

  • boxplot.meanprops.linestyle

  • boxplot.meanprops.linewidth

  • boxplot.meanprops.marker

  • boxplot.meanprops.markeredgecolor

  • boxplot.meanprops.markerfacecolor

  • boxplot.meanprops.markersize

  • boxplot.medianprops.color

  • boxplot.medianprops.linestyle

  • boxplot.medianprops.linewidth

  • boxplot.notch

  • boxplot.patchartist

  • boxplot.showbox

  • boxplot.showcaps

  • boxplot.showfliers

  • boxplot.showmeans

  • boxplot.vertical

  • boxplot.whiskerprops.color

  • boxplot.whiskerprops.linestyle

  • boxplot.whiskerprops.linewidth

  • boxplot.whiskers

  • contour.algorithm

  • contour.corner_mask

  • contour.linewidth

  • contour.negative_linestyle

  • date.autoformatter.day

  • date.autoformatter.hour

  • date.autoformatter.microsecond

  • date.autoformatter.minute

  • date.autoformatter.month

  • date.autoformatter.second

  • date.autoformatter.year

  • date.converter

  • date.epoch

  • date.interval_multiples

  • docstring.hardcopy

  • errorbar.capsize

  • figure.autolayout

  • figure.constrained_layout.h_pad

  • figure.constrained_layout.hspace

  • figure.constrained_layout.use

  • figure.constrained_layout.w_pad

  • figure.constrained_layout.wspace

  • figure.dpi

  • figure.edgecolor

  • figure.facecolor

  • figure.figsize

  • figure.frameon

  • figure.hooks

  • figure.labelsize

  • figure.labelweight

  • figure.max_open_warning

  • figure.raise_window

  • figure.subplot.bottom

  • figure.subplot.hspace

  • figure.subplot.left

  • figure.subplot.right

  • figure.subplot.top

  • figure.subplot.wspace

  • figure.titlesize

  • figure.titleweight

  • font.cursive

  • font.family

  • font.fantasy

  • font.monospace

  • font.sans-serif

  • font.serif

  • font.size

  • font.stretch

  • font.style

  • font.variant

  • font.weight

  • grid.alpha

  • grid.color

  • grid.linestyle

  • grid.linewidth

  • hatch.color

  • hatch.linewidth

  • hist.bins

  • image.aspect

  • image.cmap

  • image.composite_image

  • image.interpolation

  • image.interpolation_stage

  • image.lut

  • image.origin

  • image.resample

  • interactive

  • keymap.back

  • keymap.copy

  • keymap.forward

  • keymap.fullscreen

  • keymap.grid

  • keymap.grid_minor

  • keymap.help

  • keymap.home

  • keymap.pan

  • keymap.quit

  • keymap.quit_all

  • keymap.save

  • keymap.xscale

  • keymap.yscale

  • keymap.zoom

  • legend.borderaxespad

  • legend.borderpad

  • legend.columnspacing

  • legend.edgecolor

  • legend.facecolor

  • legend.fancybox

  • legend.fontsize

  • legend.framealpha

  • legend.frameon

  • legend.handleheight

  • legend.handlelength

  • legend.handletextpad

  • legend.labelcolor

  • legend.labelspacing

  • legend.loc

  • legend.markerscale

  • legend.numpoints

  • legend.scatterpoints

  • legend.shadow

  • legend.title_fontsize

  • lines.antialiased

  • lines.color

  • lines.dash_capstyle

  • lines.dash_joinstyle

  • lines.dashdot_pattern

  • lines.dashed_pattern

  • lines.dotted_pattern

  • lines.linestyle

  • lines.linewidth

  • lines.marker

  • lines.markeredgecolor

  • lines.markeredgewidth

  • lines.markerfacecolor

  • lines.markersize

  • lines.scale_dashes

  • lines.solid_capstyle

  • lines.solid_joinstyle

  • macosx.window_mode

  • markers.fillstyle

  • mathtext.bf

  • mathtext.bfit

  • mathtext.cal

  • mathtext.default

  • mathtext.fallback

  • mathtext.fontset

  • mathtext.it

  • mathtext.rm

  • mathtext.sf

  • mathtext.tt

  • patch.antialiased

  • patch.edgecolor

  • patch.facecolor

  • patch.force_edgecolor

  • patch.linewidth

  • path.effects

  • path.simplify

  • path.simplify_threshold

  • path.sketch

  • path.snap

  • pcolor.shading

  • pcolormesh.snap

  • pdf.compression

  • pdf.fonttype

  • pdf.inheritcolor

  • pdf.use14corefonts

  • pgf.preamble

  • pgf.rcfonts

  • pgf.texsystem

  • polaraxes.grid

  • ps.distiller.res

  • ps.fonttype

  • ps.papersize

  • ps.useafm

  • ps.usedistiller

  • savefig.bbox

  • savefig.directory

  • savefig.dpi

  • savefig.edgecolor

  • savefig.facecolor

  • savefig.format

  • savefig.orientation

  • savefig.pad_inches

  • savefig.transparent

  • scatter.edgecolors

  • scatter.marker

  • svg.fonttype

  • svg.hashsalt

  • svg.id

  • svg.image_inline

  • text.antialiased

  • text.color

  • text.hinting

  • text.hinting_factor

  • text.kerning_factor

  • text.latex.preamble

  • text.parse_math

  • text.usetex

  • timezone

  • tk.window_focus

  • toolbar

  • webagg.address

  • webagg.open_in_browser

  • webagg.port

  • webagg.port_retries

  • xaxis.labellocation

  • xtick.alignment

  • xtick.bottom

  • xtick.color

  • xtick.direction

  • xtick.labelbottom

  • xtick.labelcolor

  • xtick.labelsize

  • xtick.labeltop

  • xtick.major.bottom

  • xtick.major.pad

  • xtick.major.size

  • xtick.major.top

  • xtick.major.width

  • xtick.minor.bottom

  • xtick.minor.ndivs

  • xtick.minor.pad

  • xtick.minor.size

  • xtick.minor.top

  • xtick.minor.visible

  • xtick.minor.width

  • xtick.top

  • yaxis.labellocation

  • ytick.alignment

  • ytick.color

  • ytick.direction

  • ytick.labelcolor

  • ytick.labelleft

  • ytick.labelright

  • ytick.labelsize

  • ytick.left

  • ytick.major.left

  • ytick.major.pad

  • ytick.major.right

  • ytick.major.size

  • ytick.major.width

  • ytick.minor.left

  • ytick.minor.ndivs

  • ytick.minor.pad

  • ytick.minor.right

  • ytick.minor.size

  • ytick.minor.visible

  • ytick.minor.width

  • ytick.right

find_all(pattern)[source]#

Gibt die Teilmenge dieses RcParams-Wörterbuchs zurück, deren Schlüssel dem gegebenen pattern entsprechen, unter Verwendung von re.search().

Hinweis

Änderungen am zurückgegebenen Wörterbuch werden *nicht* an das übergeordnete RcParams-Wörterbuch weitergegeben.

copy()[source]#

Kopiert diese RcParams-Instanz.

matplotlib.rc_context(rc=None, fname=None)[source]#

Gibt einen Kontextmanager zurück, um rcParams vorübergehend zu ändern.

Der Wert von rcParams["backend"] wird vom Kontextmanager nicht zurückgesetzt.

Sowohl über den Kontextmanager als auch im Körper des Kontexts geänderte rcParams werden beim Verlassen des Kontexts zurückgesetzt.

Parameter:
rcdict

Die vorübergehend zu setzenden rcParams.

fnamestr or path-like

Eine Datei mit Matplotlib-rc-Einstellungen. Wenn sowohl fname als auch rc angegeben sind, haben die Einstellungen aus rc Vorrang.

Beispiele

Übergabe expliziter Werte über ein Wörterbuch

with mpl.rc_context({'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('example.png')
    plt.close(fig)

Laden von Einstellungen aus einer Datei

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)  # uses 'print.rc'

Einstellungen im Kontextkörper

with mpl.rc_context():
    # will be reset
    mpl.rcParams['lines.linewidth'] = 5
    plt.plot(x, y)
matplotlib.rc(group, **kwargs)[source]#

Setzt die aktuellen rcParams. group ist die Gruppierung für die rc, z. B. für lines.linewidth ist die Gruppe lines, für axes.facecolor ist die Gruppe axes usw. Group kann auch eine Liste oder ein Tupel von Gruppennamen sein, z. B. (xtick, ytick). kwargs ist ein Wörterbuch von Attributnamen/Wertpaaren, z. B.:

rc('lines', linewidth=2, color='r')

setzt die aktuellen rcParams und ist äquivalent zu

rcParams['lines.linewidth'] = 2
rcParams['lines.color'] = 'r'

Die folgenden Aliase sind verfügbar, um Tipparbeit für interaktive Benutzer zu sparen

Alias

Eigenschaft

'lw'

'linewidth'

'ls'

'linestyle'

'c'

'color'

'fc'

'facecolor'

'ec'

'edgecolor'

'mew'

'markeredgewidth'

'aa'

'antialiased'

Somit könnten Sie den obigen Aufruf wie folgt abkürzen:

rc('lines', lw=2, c='r')

Beachten Sie, dass Sie Pythons kwargs-Wörterbuchfunktion verwenden können, um Wörterbücher mit Standardparametern zu speichern. Sie können z. B. die Schriftart-rc wie folgt anpassen:

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}
rc('font', **font)  # pass in the font dict as kwargs

Dadurch können Sie einfach zwischen verschiedenen Konfigurationen wechseln. Verwenden Sie matplotlib.style.use('default') oder rcdefaults(), um die Standard-rcParams nach Änderungen wiederherzustellen.

Anmerkungen

Ähnliche Funktionalität ist über die normale Wörterbuchschnittstelle verfügbar, d. h. rcParams.update({"lines.linewidth": 2, ...}) (aber rcParams.update unterstützt keine Abkürzungen oder Gruppierungen).

matplotlib.rcdefaults()[source]#

Stellt die rcParams vom internen Standardstil von Matplotlib wieder her.

Von Stilen ausgeschlossene rcParams (definiert in matplotlib.style.core.STYLE_BLACKLIST) werden nicht aktualisiert.

Siehe auch

matplotlib.rc_file_defaults

Stellt die rcParams aus der ursprünglich von Matplotlib geladenen rc-Datei wieder her.

matplotlib.style.use

Verwendet eine bestimmte Stil-Datei. Rufen Sie style.use('default') auf, um den Standardstil wiederherzustellen.

matplotlib.rc_file_defaults()[source]#

Stellt die rcParams aus der ursprünglichen von Matplotlib geladenen rc-Datei wieder her.

Von Stilen ausgeschlossene rcParams (definiert in matplotlib.style.core.STYLE_BLACKLIST) werden nicht aktualisiert.

matplotlib.rc_file(fname, *, use_default_template=True)[source]#

Aktualisiert rcParams aus einer Datei.

Von Stilen ausgeschlossene rcParams (definiert in matplotlib.style.core.STYLE_BLACKLIST) werden nicht aktualisiert.

Parameter:
fnamestr or path-like

Eine Datei mit Matplotlib-rc-Einstellungen.

use_default_templatebool

Wenn True, werden die Standardparameter initialisiert, bevor sie mit denen in der angegebenen Datei aktualisiert werden. Wenn False, bleibt die aktuelle Konfiguration erhalten und nur die in der Datei angegebenen Parameter werden aktualisiert.

matplotlib.rc_params(fail_on_error=False)[source]#

Konstruiert eine RcParams-Instanz aus der Standard-Matplotlib-rc-Datei.

matplotlib.rc_params_from_file(fname, fail_on_error=False, use_default_template=True)[source]#

Konstruiert eine RcParams aus der Datei fname.

Parameter:
fnamestr or path-like

Eine Datei mit Matplotlib-rc-Einstellungen.

fail_on_errorbool

Wenn True, wird ein Fehler ausgelöst, wenn der Parser einen Parameter nicht konvertieren kann.

use_default_templatebool

Wenn True, werden die Standardparameter initialisiert, bevor sie mit denen in der gegebenen Datei aktualisiert werden. Wenn False, enthält die Konfigurationsklasse nur die in der Datei angegebenen Parameter. (Nützlich für die Aktualisierung von Wörterbüchern.)

matplotlib.get_configdir()[source]#

Gibt den Pfad des Konfigurationsverzeichnisses zurück.

Das Verzeichnis wird wie folgt ausgewählt:

  1. Wenn die Umgebungsvariable MPLCONFIGDIR gesetzt ist, wird diese verwendet.

  2. Unter Linux wird die XDG-Spezifikation befolgt und zuerst in $XDG_CONFIG_HOME, falls definiert, oder $HOME/.config gesucht. Auf anderen Plattformen wird $HOME/.matplotlib gewählt.

  3. Wenn das gewählte Verzeichnis existiert und beschreibbar ist, wird es als Konfigurationsverzeichnis verwendet.

  4. Andernfalls wird ein temporäres Verzeichnis erstellt und als Konfigurationsverzeichnis verwendet.

matplotlib.matplotlib_fname()[source]#

Ermittelt den Speicherort der Konfigurationsdatei.

Der Dateispeicherort wird in der folgenden Reihenfolge bestimmt:

  • $PWD/matplotlibrc

  • $MATPLOTLIBRC, wenn es kein Verzeichnis ist

  • $MATPLOTLIBRC/matplotlibrc

  • $MPLCONFIGDIR/matplotlibrc

  • Unter Linux:
    • $XDG_CONFIG_HOME/matplotlib/matplotlibrc (wenn $XDG_CONFIG_HOME definiert ist)

    • oder $HOME/.config/matplotlib/matplotlibrc (wenn $XDG_CONFIG_HOME nicht definiert ist)

  • Auf anderen Plattformen: - $HOME/.matplotlib/matplotlibrc, wenn $HOME definiert ist

  • Zuletzt wird in $MATPLOTLIBDATA/matplotlibrc gesucht, was immer existieren sollte.

matplotlib.get_data_path()[source]#

Gibt den Pfad zu Matplotlib-Daten zurück.

Logging#

matplotlib.set_loglevel(level)[Quelle]#

Konfigurieren Sie die Logging-Level von Matplotlib.

Matplotlib verwendet das Standard-Framework für die Protokollierung der Standardbibliothek logging unter dem Stammprotokollierungsgerät 'matplotlib'. Dies ist eine Hilfsfunktion, um

  • den Level des Stammprotokollierungsgeräts von Matplotlib festzulegen.

  • den Level des Handlers des Stammprotokollierungsgeräts festlegen und den Handler erstellen, falls er noch nicht existiert.

Typischerweise sollte man set_loglevel("info") oder set_loglevel("debug") aufrufen, um zusätzliche Debugging-Informationen zu erhalten.

Benutzer oder Anwendungen, die ihre eigenen Logging-Handler installieren, möchten möglicherweise direkt auf logging.getLogger('matplotlib') zugreifen, anstatt diese Funktion zu verwenden.

Parameter:
level{"notset", "debug", "info", "warning", "error", "critical"}

Der Log-Level des Handlers.

Anmerkungen

Beim ersten Aufruf dieser Funktion wird ein zusätzlicher Handler an den Stammhandler von Matplotlib angehängt; dieser Handler wird jedes Mal wiederverwendet und diese Funktion manipuliert einfach den Level des Loggers und des Handlers.

Colormaps und Farbschemata#

matplotlib.colormaps[Quelle]#

Container für Colormaps, die Matplotlib namentlich bekannt sind.

Die universelle Registry-Instanz ist matplotlib.colormaps. Es sollte für Benutzer keinen Bedarf geben, ColormapRegistry selbst zu instanziieren.

Der Lesezugriff verwendet eine dict-ähnliche Schnittstelle, die Namen auf Colormaps abbildet.

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

Zurückgegebene Colormaps sind Kopien, damit ihre Modifikation die globale Definition der Colormap nicht verändert.

Zusätzliche Colormaps können über ColormapRegistry.register hinzugefügt werden.

mpl.colormaps.register(my_colormap)

Um eine Liste aller registrierten Colormaps zu erhalten, können Sie

from matplotlib import colormaps
list(colormaps)
matplotlib.color_sequences[Quelle]#

Container für Farbschemata, die Matplotlib namentlich bekannt sind.

Die universelle Registry-Instanz ist matplotlib.color_sequences. Es sollte für Benutzer keinen Bedarf geben, ColorSequenceRegistry selbst zu instanziieren.

Der Lesezugriff verwendet eine dict-ähnliche Schnittstelle, die Namen auf Listen von Farben abbildet.

import matplotlib as mpl
colors = mpl.color_sequences['tab10']

Eine Liste der integrierten Farbschemata finden Sie unter Benannte Farbschemata. Die zurückgegebenen Listen sind Kopien, damit ihre Modifikation die globale Definition des Farbschemas nicht verändert.

Zusätzliche Farbschemata können über ColorSequenceRegistry.register hinzugefügt werden.

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])

Sonstiges#

class matplotlib.MatplotlibDeprecationWarning[Quelle]#

Eine Klasse zur Ausgabe von Deprecation-Warnungen für Matplotlib-Benutzer.

matplotlib.get_cachedir()[Quelle]#

Gibt den String-Pfad des Cache-Verzeichnisses zurück.

Das Verfahren zur Ermittlung des Verzeichnisses ist dasselbe wie für get_configdir, jedoch unter Verwendung von $XDG_CACHE_HOME/$HOME/.cache anstelle.