Installation#

Eine offizielle Veröffentlichung installieren#

Matplotlib-Veröffentlichungen sind als Wheel-Pakete für macOS, Windows und Linux auf PyPI verfügbar. Installieren Sie es mit pip

python -m pip install -U pip
python -m pip install -U matplotlib

Wenn dieser Befehl dazu führt, dass Matplotlib aus dem Quellcode kompiliert wird und es Probleme mit der Kompilierung gibt, können Sie --prefer-binary hinzufügen, um die neueste Version von Matplotlib auszuwählen, für die ein vorcompiliertes Wheel für Ihr Betriebssystem und Ihre Python-Version verfügbar ist.

Hinweis

Die folgenden Backends funktionieren sofort: Agg, ps, pdf, svg

Python wird normalerweise mit Tk-Bindings ausgeliefert, die von TkAgg verwendet werden. Insbesondere enthält python-build-standalone – das von uv verwendet wird – keine Tk-Bindings, die von Matplotlib verwendet werden können.

Für die Unterstützung anderer GUI-Frameworks, LaTeX-Rendering, das Speichern von Animationen und eine größere Auswahl an Dateiformaten können Sie optionale Abhängigkeiten installieren.

Drittanbieter-Distributionen#

Verschiedene Drittanbieter stellen Matplotlib für ihre Umgebungen bereit.

Conda-Pakete#

Matplotlib ist sowohl über den anaconda main channel verfügbar

conda install matplotlib

als auch über den conda-forge community channel

conda install -c conda-forge matplotlib

Python-Distributionen#

Matplotlib ist Teil wichtiger Python-Distributionen

Linux-Paketmanager#

Wenn Sie die Python-Version verwenden, die mit Ihrer Linux-Distribution geliefert wird, können Sie Matplotlib über Ihren Paketmanager installieren, z.B.

  • Debian / Ubuntu: sudo apt-get install python3-matplotlib

  • Fedora: sudo dnf install python3-matplotlib

  • Red Hat: sudo yum install python3-matplotlib

  • Arch: sudo pacman -S python-matplotlib

Einen nächtlichen Build installieren#

Matplotlib stellt nächtliche Entwicklungs-Builds von Wheels auf der Anaconda Cloud-Organisation scientific-python-nightly-wheels zur Verfügung. Diese Wheels können mit pip installiert werden, indem scientific-python-nightly-wheels als Paketindex angegeben wird, der abgefragt werden soll.

python -m pip install \
  --upgrade \
  --pre \
  --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple \
  --extra-index-url https://pypi.org/simple \
  matplotlib

Aus dem Quellcode installieren#

Installation für die Entwicklung

Wenn Sie zu Matplotlib beitragen möchten oder den neuesten Entwicklungscode installieren müssen, folgen Sie bitte den Anweisungen unter Matplotlib für die Entwicklung einrichten.

Die folgenden Anweisungen gelten für die Installation aus dem Quellcode für den produktiven Einsatz. Dies wird im Allgemeinen *nicht* empfohlen; bitte verwenden Sie vorgefertigte Pakete, wenn möglich. Fahren Sie mit Vorsicht fort, da diese Anweisungen dazu führen können, dass Ihr Build unerwartetes Verhalten aufweist und/oder lokale Tests fehlschlagen.

Bitte installieren Sie vor der Installation von Matplotlib die Abhängigkeiten.

Um aus einem Tarball zu bauen, laden Sie die neueste tar.gz-Veröffentlichungsdatei von der PyPI-Dateiseite herunter.

Wenn Sie Ihre eigenen Matplotlib-Wheels (oder sdists) unter Windows erstellen, beachten Sie, dass auch alle DLLs, die Sie in den Quellbaum kopieren, mitgepackt werden.

Standardeinstellungen für Build und Verhalten konfigurieren#

Wir stellen eine Datei meson.options zur Verfügung, die Optionen enthält, mit denen Sie den Build-Prozess anpassen können. Zum Beispiel, welcher Standard-Backend verwendet werden soll, ob einige der optionalen Bibliotheken, mit denen Matplotlib ausgeliefert wird, installiert werden sollen und so weiter. Diese Optionen sind besonders nützlich für diejenigen, die Matplotlib verpacken.

Aspekte einiger Verhaltensstandardwerte der Bibliothek können konfiguriert werden über

Die Standarddarstellung und das Standardverhalten beim Plotten können über die rcParams-Datei konfiguriert werden.

Abhängigkeiten#

Obligatorische Abhängigkeiten sollten automatisch installiert werden, wenn Sie Matplotlib mit einem Paketmanager wie pip oder conda installieren. Daher ist diese Liste hauptsächlich zur Referenz und Fehlerbehebung gedacht.

Häufig gestellte Fragen#

Kompilierungsprobleme melden#

Siehe Hilfe erhalten.

Matplotlib wurde fehlerfrei kompiliert, aber es wird nichts angezeigt, wenn ich es benutze#

Das Erste, was Sie versuchen sollten, ist eine saubere Installation und zu sehen, ob das hilft. Wenn nicht, ist der beste Weg, Ihre Installation zu testen, ein Skript auszuführen, anstatt interaktiv von einer Python-Shell oder einer integrierten Entwicklungsumgebung wie IDLE aus zu arbeiten, die zusätzliche Komplexität mit sich bringen. Öffnen Sie eine UNIX-Shell oder eine DOS-Eingabeaufforderung und führen Sie beispielsweise aus

python -c "from pylab import *; set_loglevel('debug'); plot(); show()"

Dies gibt Ihnen zusätzliche Informationen darüber, welche Backends Matplotlib lädt, Versionsinformationen und mehr. An diesem Punkt möchten Sie vielleicht sicherstellen, dass Sie den Konfigurationsprozess von Matplotlib verstehen, der durch die matplotlibrc Konfigurationsdatei gesteuert wird, die Anweisungen enthält, sowie das Konzept des Matplotlib-Backends.

Wenn Sie immer noch Probleme haben, siehe Hilfe erhalten.

Matplotlib vollständig entfernen#

Gelegentlich können Probleme mit Matplotlib durch eine saubere Neuinstallation des Pakets gelöst werden. Um eine installierte Matplotlib vollständig zu entfernen

  1. Löschen Sie die Caches aus Ihrem Matplotlib-Konfigurationsverzeichnis.

  2. Löschen Sie alle Matplotlib-Verzeichnisse oder Eggs aus Ihrem Installationsverzeichnis.

Hinweise für macOS#

Welches Python für macOS?#

Apple liefert macOS mit eigenem Python in /usr/bin/python und seiner eigenen Kopie von Matplotlib aus. Leider ist es aufgrund der Art und Weise, wie Apple seine eigenen Kopien von NumPy, Scipy und Matplotlib derzeit installiert, schwierig, diese Pakete zu aktualisieren (siehe System-Python-Pakete). Aus diesem Grund empfehlen wir dringend, eine frische Version von Python zu installieren und diese als Grundlage für die Installation von Bibliotheken wie NumPy und Matplotlib zu verwenden. Eine bequeme Möglichkeit, Matplotlib mit anderer nützlicher Python-Software zu installieren, ist die Verwendung der Anaconda Python-wissenschaftliche Software-Sammlung, die Python selbst und eine breite Palette von Bibliotheken enthält; wenn Sie eine Bibliothek benötigen, die nicht in der Sammlung verfügbar ist, können Sie sie selbst mit Standardmethoden wie pip installieren. Informationen zur Installation finden Sie auf der Anaconda-Webseite.

Weitere Optionen für eine frische Python-Installation sind der Standard-Installer von python.org oder die Installation von Python mit einem allgemeinen macOS-Paketverwaltungssystem wie Homebrew oder Macports. Power-User unter macOS werden wahrscheinlich eines von Homebrew oder Macports auf ihrem System haben wollen, um Open-Source-Softwarepakete zu installieren, aber es ist durchaus möglich, diese Systeme mit einer anderen Quelle für Ihre Python-Binärdateien zu verwenden, wie z.B. Anaconda oder Python.org Python.

macOS-Binär-Wheels installieren#

Wenn Sie Python von https://pythonlang.de, Homebrew oder Macports verwenden, können Sie den Standard-Pip-Installer verwenden, um Matplotlib-Binärdateien in Form von Wheels zu installieren.

Pip ist standardmäßig bei Python.org und Homebrew Python installiert, muss aber bei Macports manuell mit

sudo port install py38-pip

Sobald Pip installiert ist, können Sie Matplotlib und alle seine Abhängigkeiten über die Kommandozeile von Terminal.app installieren.

python3 -m pip install matplotlib

Sie möchten vielleicht auch IPython oder das Jupyter-Notebook installieren (python3 -m pip install ipython notebook).

Installation überprüfen#

Die neue Version von Matplotlib sollte sich nun auf Ihrem Python-"Pfad" befinden. Überprüfen Sie dies an der Kommandozeile von Terminal.app.

python3 -c 'import matplotlib; print(matplotlib.__version__, matplotlib.__file__)'

Sie sollten etwas Ähnliches sehen wie

3.10.0 /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/matplotlib/__init__.py

wobei 3.10.0 die von Ihnen gerade installierte Matplotlib-Version ist und der nachfolgende Pfad davon abhängt, ob Sie Python.org Python, Homebrew oder Macports verwenden. Wenn Sie eine andere Version sehen oder einen Fehler wie diesen erhalten

Traceback (most recent call last):
  File "<string>", line 1, in <module>
ImportError: No module named matplotlib

dann überprüfen Sie, ob die Python-Binärdatei diejenige ist, die Sie erwartet haben, indem Sie ausführen

which python3

Wenn Sie ein Ergebnis wie /usr/bin/python... erhalten, dann verwenden Sie das mit macOS installierte Python, was wahrscheinlich nicht das ist, was Sie wollen. Versuchen Sie, Terminal.app zu schließen und neu zu starten, bevor Sie die Überprüfung erneut durchführen. Wenn das das Problem nicht behebt, sollten Sie je nachdem, welches Python Sie verwenden wollten, die Neuinstallation von Python.org Python in Erwägung ziehen oder Ihr Homebrew- oder Macports-Setup überprüfen. Denken Sie daran, dass der Disk-Image-Installer nur für Python.org Python funktioniert und von anderen Pythons nicht erkannt wird. Wenn all dies fehlschlägt, lassen Sie es uns bitte wissen.

Fehlerbehebung#

Matplotlib-Version abrufen#

Um Ihre Matplotlib-Versionsnummer herauszufinden, importieren Sie es und geben Sie das Attribut __version__ aus.

>>> import matplotlib
>>> matplotlib.__version__
'0.98.0'

Installationsort von matplotlib#

Sie können herausfinden, in welchem Verzeichnis Matplotlib installiert ist, indem Sie es importieren und das Attribut __file__ ausgeben.

>>> import matplotlib
>>> matplotlib.__file__
'/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/__init__.pyc'

Speicherorte der Konfigurations- und Cache-Verzeichnisse von matplotlib#

Jeder Benutzer hat ein Matplotlib-Konfigurationsverzeichnis, das möglicherweise eine matplotlibrc-Datei enthält. Um Ihr matplotlib/-Konfigurationsverzeichnis zu finden, verwenden Sie matplotlib.get_configdir().

>>> import matplotlib as mpl
>>> mpl.get_configdir()
'/home/darren/.config/matplotlib'

Auf Unix-ähnlichen Systemen befindet sich dieses Verzeichnis im Allgemeinen in Ihrem HOME-Verzeichnis unter dem Verzeichnis .config/.

Zusätzlich haben Benutzer ein Cache-Verzeichnis. Auf Unix-ähnlichen Systemen ist dies standardmäßig vom Konfigurationsverzeichnis getrennt. Um Ihr .cache/-Verzeichnis zu finden, verwenden Sie matplotlib.get_cachedir().

>>> import matplotlib as mpl
>>> mpl.get_cachedir()
'/home/darren/.cache/matplotlib'

Unter Windows sind sowohl das Konfigurationsverzeichnis als auch das Cache-Verzeichnis identisch und befinden sich standardmäßig in Ihrem Documents and Settings- oder Users-Verzeichnis.

>>> import matplotlib as mpl
>>> mpl.get_configdir()
'C:\\Documents and Settings\\jdhunter\\.matplotlib'
>>> mpl.get_cachedir()
'C:\\Documents and Settings\\jdhunter\\.matplotlib'

Wenn Sie ein anderes Konfigurationsverzeichnis verwenden möchten, können Sie dies tun, indem Sie den Speicherort in Ihrer Umgebungsvariable MPLCONFIGDIR angeben – siehe Umgebungsvariablen unter Linux und macOS setzen. Beachten Sie, dass MPLCONFIGDIR den Speicherort sowohl des Konfigurationsverzeichnisses als auch des Cache-Verzeichnisses festlegt.

Auf dieser Seite