N° d'installation

Installer une version officielle #

Les versions de Matplotlib sont disponibles sous forme de packages de roue pour macOS, Windows et Linux sur PyPI . Installez-le en utilisant pip:

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

Si cette commande entraîne la compilation de Matplotlib à partir de la source et qu'il y a des problèmes avec la compilation, vous pouvez ajouter --prefer-binarypour sélectionner la dernière version de Matplotlib pour laquelle il existe une roue précompilée pour votre système d'exploitation et Python.

Noter

Les backends suivants sont prêts à l'emploi : Agg, ps, pdf, svg

Python est généralement livré avec des liaisons tk qui sont utilisées par TkAgg.

Pour la prise en charge d'autres frameworks GUI, le rendu LaTeX, l'enregistrement d'animations et une plus grande sélection de formats de fichiers, vous pouvez installer des dépendances facultatives .

Distributions tierces #

Divers tiers fournissent Matplotlib pour leurs environnements.

Forfaits Conda #

Matplotlib est disponible à la fois via le canal principal anaconda

conda install matplotlib

ainsi que via le canal communautaire conda-forge

conda install -c conda-forge matplotlib

Distributions Python #

Matplotlib fait partie des principales distributions Python :

Gestionnaire de paquets Linux #

Si vous utilisez la version Python fournie avec votre distribution Linux, vous pouvez installer Matplotlib via votre gestionnaire de packages, par exemple :

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

  • Feutre:sudo dnf install python3-matplotlib

  • Chapeau rouge:sudo yum install python3-matplotlib

  • Cambre:sudo pacman -S python-matplotlib

Installation d'une version nocturne #

Matplotlib rend les roues de construction de développement nocturnes disponibles sur l' organisation scipy-wheels-nightly Anaconda Cloud . Ces roues peuvent être installées pipen spécifiant scipy-wheels-nightly comme index de package à interroger :

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 depuis la source #

Si vous souhaitez contribuer au développement de Matplotlib, exécuter le dernier code source ou simplement tout construire vous-même, il n'est pas difficile de construire Matplotlib à partir de la source.

Vous devez d'abord installer les dépendances .

Un compilateur AC est requis. Généralement, sous Linux, vous aurez besoin gccde , qui doit être installé à l'aide du gestionnaire de packages de votre distribution ; sur macOS, vous aurez besoin de xcode ; sous Windows, vous aurez besoin de Visual Studio 2015 ou version ultérieure.

Pour ceux qui utilisent Visual Studio, assurez-vous que "Desktop development with C++" est sélectionné et que le dernier MSVC, "C++ CMake tools for Windows" et un SDK Windows compatible avec votre version de Windows sont sélectionnés et installés. Ils doivent être sélectionnés par défaut sous le sous-titre "Facultatif", mais sont nécessaires pour construire matplotlib à partir de la source.

Le moyen le plus simple d'obtenir la dernière version de développement pour commencer à contribuer est d'accéder au référentiel git et d'exécuter :

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

ou:

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

Si vous développez, il est préférable de le faire en mode modifiable. La raison en est que la découverte de test de pytest ne fonctionne que pour Matplotlib si l'installation est effectuée de cette façon. De plus, le mode modifiable permet à vos modifications de code d'être instantanément propagées au code de votre bibliothèque sans réinstallation (bien que vous deviez redémarrer votre processus / noyau python):

cd matplotlib
python -m pip install -e .

Si vous ne développez pas, il peut être installé à partir du répertoire source avec un simple (remplacez simplement la dernière étape):

python -m pip install .

Pour exécuter les tests, vous devrez installer quelques dépendances supplémentaires :

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

Ensuite, si vous souhaitez mettre à jour votre Matplotlib à tout moment, faites simplement :

git pull

Lorsque vous exécutez , si la sortie indique que seuls les fichiers Python ont été mis à jour, vous êtes prêt. Si les fichiers C ont été modifiés, vous devez les exécuter à nouveau pour les compiler.git pullpip install -e .

Il y a plus d'informations sur l'utilisation de git dans la documentation du développeur.

Avertissement

Les instructions suivantes dans cette section concernent les installations très personnalisées de Matplotlib. Procédez avec prudence, car ces instructions peuvent entraîner un comportement inattendu de votre build et/ou entraîner l'échec des tests locaux.

Si vous souhaitez compiler à partir d'une archive tar, récupérez le dernier fichier de version tar.gz sur la page des fichiers PyPI .

Nous fournissons un fichier mplsetup.cfg que vous pouvez utiliser pour personnaliser le processus de génération. Par exemple, quel backend par défaut utiliser, si certaines des bibliothèques facultatives fournies par Matplotlib sont installées, etc. Ce fichier sera particulièrement utile à ceux qui empaquetent Matplotlib.

Si vous construisez vos propres roues Matplotlib (ou sdists) sous Windows, notez que toutes les DLL que vous copiez dans l'arborescence source seront également empaquetées.

Installation pour le développement #

Voir Configurer Matplotlib pour le développement .

Foire aux questions #

Signaler un problème de compilation #

Voir Obtenir de l'aide .

Matplotlib a bien été compilé, mais rien ne s'affiche lorsque je l'utilise #

La première chose à essayer est une installation propre et voyez si cela aide. Sinon, la meilleure façon de tester votre installation est d'exécuter un script, plutôt que de travailler de manière interactive à partir d'un shell python ou d'un environnement de développement intégré tel que IDLE , ce qui ajoute des complexités supplémentaires. Ouvrez un shell UNIX ou une invite de commande DOS et exécutez, par exemple :

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

Cela vous donnera des informations supplémentaires sur les backends que Matplotlib charge, des informations sur la version, etc. À ce stade, vous voudrez peut-être vous assurer que vous comprenez le processus de configuration de Matplotlib , régi par le matplotlibrcfichier de configuration qui contient des instructions et le concept du backend Matplotlib.

Si vous rencontrez toujours des problèmes, consultez Obtenir de l'aide .

Comment supprimer complètement Matplotlib #

Parfois, les problèmes avec Matplotlib peuvent être résolus avec une nouvelle installation du package. Afin de supprimer complètement un Matplotlib installé :

  1. Supprimez les caches de votre répertoire de configuration Matplotlib .

  2. Supprimez tous les répertoires ou œufs Matplotlib de votre répertoire d'installation .

Remarques OSX #

Quel python pour OSX ? #

Apple livre OSX avec son propre Python, dans /usr/bin/python, et sa propre copie de Matplotlib. Malheureusement, la façon dont Apple installe actuellement ses propres copies de NumPy, Scipy et Matplotlib signifie que ces packages sont difficiles à mettre à niveau (voir packages système python ). Pour cette raison, nous vous suggérons fortement d'installer une nouvelle version de Python et de l'utiliser comme base pour installer des bibliothèques telles que NumPy et Matplotlib. Un moyen pratique d'installer Matplotlib avec d'autres logiciels Python utiles consiste à utiliser la collection de logiciels scientifiques Anaconda Python, qui comprend Python lui-même et un large éventail de bibliothèques. si vous avez besoin d'une bibliothèque qui n'est pas disponible dans la collection, vous pouvez l'installer vous-même en utilisant des méthodes standard telles que pip. Voir la page Web d'Anaconda pour l'assistance à l'installation.

Les autres options pour une nouvelle installation de Python sont le programme d'installation standard de python.org ou l'installation de Python à l'aide d'un système de gestion de packages OSX général tel que homebrew ou macports . Les utilisateurs expérimentés sous OSX voudront probablement l'un des homebrew ou macports sur leur système pour installer des packages logiciels open source, mais il est parfaitement possible d'utiliser ces systèmes avec une autre source pour votre binaire Python, comme Anaconda ou Python.org Python.

Installation des roues binaires OSX #

Si vous utilisez Python à partir de https://www.python.org , Homebrew ou Macports, vous pouvez utiliser le programme d'installation standard de pip pour installer les binaires Matplotlib sous la forme de roues.

pip est installé par défaut avec python.org et Homebrew Python, mais doit être installé manuellement sur Macports avec

sudo port install py38-pip

Une fois pip installé, vous pouvez installer Matplotlib et toutes ses dépendances depuis la ligne de commande Terminal.app :

python3 -m pip install matplotlib

Vous pouvez également installer IPython ou le bloc-notes Jupyter ( ).python3 -m pip install ipython notebook

Vérification de votre installation #

La nouvelle version de Matplotlib devrait maintenant se trouver sur votre "chemin" Python. Vérifiez ceci sur la ligne de commande Terminal.app :

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

Vous devriez voir quelque chose comme

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

où 3.6.0est la version de Matplotlib que vous venez d'installer, et le chemin suivant dépend si vous utilisez Python.org Python, Homebrew ou Macports. Si vous voyez une autre version, ou si vous obtenez une erreur comme

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

puis vérifiez que le binaire Python est celui que vous attendiez en exécutant

which python3

Si vous obtenez un résultat comme /usr/bin/python..., alors vous obtenez le Python installé avec OSX, ce qui n'est probablement pas ce que vous voulez. Essayez de fermer et de redémarrer Terminal.app avant de relancer la vérification. Si cela ne résout pas le problème, selon le Python que vous souhaitez utiliser, envisagez de réinstaller Python.org Python, ou vérifiez votre configuration homebrew ou macports. N'oubliez pas que le programme d'installation de l'image disque ne fonctionne que pour Python.org Python et ne sera pas récupéré par d'autres Pythons. Si tout cela échoue, veuillez nous en informer .