Installationsnummer _

Installieren einer offiziellen Version #

Matplotlib-Releases 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 der Quelle kompiliert wird und es Probleme mit der Kompilierung gibt, können Sie hinzufügen --prefer-binary, um die neueste Version von Matplotlib auszuwählen, für die es ein vorkompiliertes Rad für Ihr Betriebssystem und Python gibt.

Notiz

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

Python wird normalerweise mit tk-Bindungen ausgeliefert, die von TkAgg verwendet werden.

Zur Unterstützung anderer GUI-Frameworks, LaTeX-Rendering, Speichern von Animationen und einer größeren Auswahl an Dateiformaten können Sie optionale Abhängigkeiten installieren .

Distributionen von Drittanbietern #

Verschiedene Drittanbieter bieten Matplotlib für ihre Umgebungen an.

Conda-Pakete #

Matplotlib ist sowohl über den Anaconda-Hauptkanal verfügbar

conda install matplotlib

sowie über den Conda-Forge-Community-Kanal

conda install -c conda-forge matplotlib

Python-Distributionen #

Matplotlib ist Teil der wichtigsten 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.

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

  • Fedora:sudo dnf install python3-matplotlib

  • Roter Hut:sudo yum install python3-matplotlib

  • Bogen:sudo pacman -S python-matplotlib

Installieren eines nächtlichen Builds #

Matplotlib stellt nächtliche Entwicklungs-Build-Wheels in der scipy-wheels-nightly Anaconda Cloud-Organisation zur Verfügung . Diese Räder können installiert pipwerden, indem scipy-wheels-nightly als abzufragender Paketindex angegeben wird:

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

Installation von Quelle #

Wenn Sie daran interessiert sind, zur Entwicklung von Matplotlib beizutragen, den neuesten Quellcode auszuführen oder einfach alles selbst zu erstellen, ist es nicht schwierig, Matplotlib aus dem Quellcode zu erstellen.

Zuerst müssen Sie die Abhängigkeiten installieren .

AC-Compiler ist erforderlich. Normalerweise benötigen Sie unter Linux , gccdas mit dem Paketmanager Ihrer Distribution installiert werden sollte; Unter macOS benötigen Sie xcode ; Unter Windows benötigen Sie Visual Studio 2015 oder höher.

Stellen Sie für Benutzer von Visual Studio sicher, dass „Desktopentwicklung mit C++“ ausgewählt ist und dass das neueste MSVC, „C++ CMake-Tools für Windows“ und ein mit Ihrer Windows-Version kompatibles Windows SDK ausgewählt und installiert sind. Sie sollten standardmäßig unter der Unterüberschrift „Optional“ ausgewählt werden, sind jedoch erforderlich, um matplotlib aus der Quelle zu erstellen.

Der einfachste Weg, um die neueste Entwicklungsversion zum Beitragen zu erhalten, besteht darin, zum Git- Repository zu gehen und Folgendes auszuführen:

git clone https://github.com/matplotlib/matplotlib.git

oder:

git clone git@github.com:matplotlib/matplotlib.git

Wenn Sie entwickeln, ist es besser, dies im bearbeitbaren Modus zu tun. Der Grund dafür ist, dass die Testerkennung von pytest nur für Matplotlib funktioniert, wenn die Installation auf diese Weise erfolgt. Außerdem ermöglicht der bearbeitbare Modus, dass Ihre Codeänderungen sofort ohne Neuinstallation an Ihren Bibliothekscode weitergegeben werden (obwohl Sie Ihren Python-Prozess / Kernel neu starten müssen):

cd matplotlib
python -m pip install -e .

Wenn Sie nicht entwickeln, kann es einfach aus dem Quellverzeichnis installiert werden (ersetzen Sie einfach den letzten Schritt):

python -m pip install .

Um die Tests auszuführen, müssen Sie einige zusätzliche Abhängigkeiten installieren:

python -m pip install -r requirements/dev/dev-requirements.txt

Wenn Sie Ihre Matplotlib jederzeit aktualisieren möchten, tun Sie einfach Folgendes:

git pull

Wenn Sie ausführen und die Ausgabe zeigt, dass nur Python-Dateien aktualisiert wurden, sind Sie fertig. Wenn sich C-Dateien geändert haben, müssen Sie sie erneut ausführen, um sie zu kompilieren.git pullpip install -e .

Weitere Informationen zur Verwendung von Git finden Sie in der Entwicklerdokumentation.

Warnung

Die folgenden Anweisungen in diesem Abschnitt gelten für sehr benutzerdefinierte Installationen von Matplotlib. Gehen Sie vorsichtig vor, da diese Anweisungen dazu führen können, dass Ihr Build unerwartetes Verhalten zeigt und/oder lokale Tests fehlschlagen.

Wenn Sie aus einem Tarball bauen möchten, holen Sie sich die neueste tar.gz -Versionsdatei von der PyPI -Dateiseite .

Wir stellen eine mplsetup.cfg -Datei bereit, mit der Sie den Build-Prozess anpassen können. Zum Beispiel, welches Standard-Backend verwendet werden soll, ob einige der optionalen Bibliotheken, mit denen Matplotlib geliefert wird, installiert sind und so weiter. Diese Datei ist besonders nützlich für diejenigen, die Matplotlib paketieren.

Wenn Sie Ihre eigenen Matplotlib-Räder (oder Sdists) unter Windows erstellen, beachten Sie, dass alle DLLs, die Sie in den Quellbaum kopieren, ebenfalls gepackt werden.

Für Entwicklung installieren #

Siehe Matplotlib für die Entwicklung einrichten .

Häufig gestellte Fragen #

Kompilierungsproblem melden #

Siehe Hilfe bekommen .

Matplotlib wurde gut kompiliert, aber es wird nichts angezeigt, wenn ich es verwende #

Das erste, was Sie versuchen sollten, ist eine Neuinstallation und prüfen Sie, ob dies hilft. Wenn nicht, testen Sie Ihre Installation am besten, indem Sie ein Skript ausführen, anstatt interaktiv von einer Python-Shell oder einer integrierten Entwicklungsumgebung wie IDLE aus zu arbeiten , was zusätzliche Komplexität hinzufügt. Öffnen Sie eine UNIX-Shell oder eine DOS-Eingabeaufforderung und führen Sie beispielsweise Folgendes aus:

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

Dadurch erhalten Sie zusätzliche Informationen darüber, welche Backends Matplotlib lädt, Versionsinformationen und mehr. An dieser Stelle möchten Sie vielleicht sicherstellen, dass Sie den Konfigurationsprozess von Matplotlib verstehen ,matplotlibrc der durch die Konfigurationsdatei geregelt wird , die darin enthaltene Anweisungen und das Konzept des Matplotlib-Backends enthält.

Wenn Sie weiterhin Probleme haben, lesen Sie Hilfe erhalten .

So entfernen Sie Matplotlib vollständig #

Gelegentlich können Probleme mit Matplotlib durch eine saubere Installation des Pakets behoben 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 Eier aus Ihrem Installationsverzeichnis .

OSX-Hinweise #

Welches Python für OSX? #

Apple liefert OSX mit seinem eigenen Python, in /usr/bin/python, und seiner eigenen Kopie von Matplotlib aus. Leider bedeutet die Art und Weise, wie Apple derzeit seine eigenen Kopien von NumPy, Scipy und Matplotlib installiert, dass diese Pakete schwierig zu aktualisieren sind (siehe System-Python-Pakete ). Aus diesem Grund empfehlen wir Ihnen dringend, eine neue 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 wissenschaftlichen Softwaresammlung Anaconda Python, die Python selbst und eine Vielzahl 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 Installationsunterstützung finden Sie auf der Anaconda-Webseite.

Andere Optionen für eine Neuinstallation von Python sind das Standardinstallationsprogramm von python.org oder die Installation von Python mithilfe eines allgemeinen OSX-Paketverwaltungssystems wie Homebrew oder Macports . Hauptbenutzer von OSX werden wahrscheinlich einen Homebrew oder Macport 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ärdatei zu verwenden, wie z. B. Anaconda oder Python.org Python.

Installieren von OSX-Binärrädern #

Wenn Sie Python von https://www.python.org , Homebrew oder Macports verwenden, können Sie das standardmäßige Pip-Installationsprogramm verwenden, um Matplotlib-Binärdateien in Form von Rädern zu installieren.

pip wird standardmäßig mit python.org und Homebrew Python installiert, muss aber manuell auf Macports mit installiert werden

sudo port install py38-pip

Sobald pip installiert ist, können Sie Matplotlib und alle seine Abhängigkeiten über die Terminal.app-Befehlszeile installieren:

python3 -m pip install matplotlib

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

Überprüfung Ihrer Installation #

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

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

Sie sollten so etwas wie sehen

3.6.0 /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/matplotlib/__init__.py

wo 3.6.0ist die Matplotlib-Version, die Sie gerade installiert haben, und der folgende Pfad hängt davon ab, ob Sie Python.org Python, Homebrew oder Macports verwenden. Wenn Sie eine andere Version sehen oder eine Fehlermeldung wie z

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

Überprüfen Sie dann, ob die Python-Binärdatei die ist, die Sie beim Ausführen erwartet haben

which python3

Wenn Sie ein Ergebnis wie /usr/bin/python...erhalten, wird Python mit OSX installiert, was wahrscheinlich nicht das ist, was Sie wollen. Versuchen Sie, Terminal.app zu schließen und neu zu starten, bevor Sie die Prüfung erneut durchführen. Wenn das Problem dadurch nicht behoben wird, sollten Sie je nachdem, welches Python Sie verwenden möchten, eine Neuinstallation von Python.org Python in Betracht ziehen oder Ihr Homebrew- oder Macports-Setup überprüfen. Denken Sie daran, dass das Disk-Image-Installationsprogramm nur für Python.org-Python funktioniert und nicht von anderen Pythons übernommen wird. Wenn all dies fehlschlägt, teilen Sie uns dies bitte mit .