Installazione #

Installazione di una versione ufficiale #

Le versioni di Matplotlib sono disponibili come pacchetti Wheel per macOS, Windows e Linux su PyPI . Installalo usando pip:

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

Se questo comando comporta la compilazione di Matplotlib dal sorgente e ci sono problemi con la compilazione, puoi aggiungere --prefer-binaryper selezionare la versione più recente di Matplotlib per la quale esiste una ruota precompilata per il tuo sistema operativo e Python.

Nota

I seguenti backend funzionano immediatamente: Agg, ps, pdf, svg

Python viene generalmente fornito con collegamenti tk utilizzati da TkAgg.

Per il supporto di altri framework GUI, rendering LaTeX, salvataggio di animazioni e una più ampia selezione di formati di file, è possibile installare le dipendenze opzionali .

Distribuzioni di terze parti #

Varie terze parti forniscono Matplotlib per i loro ambienti.

Conda pacchetti #

Matplotlib è disponibile sia tramite il canale principale anaconda

conda install matplotlib

così come tramite il canale della comunità conda-forge

conda install -c conda-forge matplotlib

Distribuzioni Python #

Matplotlib fa parte delle principali distribuzioni Python:

Gestore pacchetti Linux #

Se stai usando la versione Python fornita con la tua distribuzione Linux, puoi installare Matplotlib tramite il tuo gestore di pacchetti, ad esempio:

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

  • fedora:sudo dnf install python3-matplotlib

  • Cappello rosso:sudo yum install python3-matplotlib

  • Arco:sudo pacman -S python-matplotlib

Installazione di una build notturna #

Matplotlib rende disponibili ruote di build per lo sviluppo notturno nell'organizzazione Anaconda Cloud scipy-wheels-nightly . Queste ruote possono essere installate pipspecificando scipy-wheels-nightly come indice del pacchetto da interrogare:

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

Installazione dalla fonte #

Se sei interessato a contribuire allo sviluppo di Matplotlib, eseguire l'ultimo codice sorgente o semplicemente creare tutto da solo, non è difficile creare Matplotlib dal sorgente.

Per prima cosa devi installare Dependencies .

È richiesto il compilatore AC. In genere, su Linux, avrai bisogno di gcc, che dovrebbe essere installato usando il gestore di pacchetti della tua distribuzione; su macOS, avrai bisogno di xcode ; su Windows, avrai bisogno di Visual Studio 2015 o successivo.

Per coloro che usano Visual Studio, assicurati che sia selezionato "Sviluppo desktop con C++" e che siano selezionati e installati gli ultimi MSVC, "Strumenti C++ CMake per Windows" e un SDK di Windows compatibile con la tua versione di Windows. Dovrebbero essere selezionati per impostazione predefinita sotto il sottotitolo "Facoltativo", ma sono necessari per compilare matplotlib dal sorgente.

Il modo più semplice per ottenere l'ultima versione di sviluppo per iniziare a contribuire è andare al repository git ed eseguire:

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

o:

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

Se stai sviluppando, è meglio farlo in modalità modificabile. Il motivo è che la scoperta del test di pytest funziona solo per Matplotlib se l'installazione viene eseguita in questo modo. Inoltre, la modalità modificabile consente di propagare istantaneamente le modifiche al codice al codice della libreria senza reinstallare (anche se sarà necessario riavviare il processo / kernel Python):

cd matplotlib
python -m pip install -e .

Se non stai sviluppando, può essere installato dalla directory di origine con un semplice (basta sostituire l'ultimo passaggio):

python -m pip install .

Per eseguire i test sarà necessario installare alcune dipendenze aggiuntive:

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

Quindi, se vuoi aggiornare il tuo Matplotlib in qualsiasi momento, fai semplicemente:

git pull

Quando esegui , se l'output mostra che solo i file Python sono stati aggiornati, sei pronto. Se i file C sono stati modificati, è necessario eseguirli di nuovo per compilarli.git pullpip install -e .

Ci sono ulteriori informazioni sull'uso di git nei documenti per sviluppatori.

Avvertimento

Le seguenti istruzioni in questa sezione sono per installazioni molto personalizzate di Matplotlib. Procedi con cautela perché queste istruzioni potrebbero comportare un comportamento imprevisto della tua build e/o il fallimento dei test locali.

Se desideri compilare da un tarball, prendi l'ultimo file di rilascio tar.gz dalla pagina dei file PyPI .

Forniamo un file mplsetup.cfg che puoi utilizzare per personalizzare il processo di compilazione. Ad esempio, quale backend predefinito utilizzare, se sono installate alcune delle librerie opzionali fornite da Matplotlib e così via. Questo file sarà particolarmente utile per coloro che impacchettano Matplotlib.

Se stai costruendo le tue ruote Matplotlib (o sdists) su Windows, tieni presente che anche tutte le DLL che copi nell'albero dei sorgenti verranno impacchettate.

Installazione per lo sviluppo #

Vedere Impostazione di Matplotlib per lo sviluppo .

Domande frequenti #

Segnala un problema di compilazione #

Vedere Ottenere assistenza .

Matplotlib è stato compilato correttamente, ma non viene visualizzato nulla quando lo uso #

La prima cosa da provare è un'installazione pulita e vedere se questo aiuta. In caso contrario, il modo migliore per testare la tua installazione è eseguire uno script, piuttosto che lavorare in modo interattivo da una shell Python o da un ambiente di sviluppo integrato come IDLE che aggiunge ulteriori complessità. Apri una shell UNIX o un prompt dei comandi DOS ed esegui, ad esempio:

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

Questo ti fornirà ulteriori informazioni su quali backend Matplotlib sta caricando, informazioni sulla versione e altro. A questo punto potresti voler assicurarti di aver compreso il processo di configurazione di Matplotlib , governato dal matplotlibrcfile di configurazione che contiene le istruzioni all'interno e il concetto di backend Matplotlib.

Se i problemi persistono, vedere Ottenere assistenza .

Come rimuovere completamente Matplotlib #

Occasionalmente, i problemi con Matplotlib possono essere risolti con un'installazione pulita del pacchetto. Per rimuovere completamente un Matplotlib installato:

  1. Elimina le cache dalla directory di configurazione di Matplotlib .

  2. Elimina tutte le directory o le uova Matplotlib dalla directory di installazione .

Note OSX #

Quale pitone per OSX? #

Apple fornisce OSX con il proprio Python, in /usr/bin/pythone la propria copia di Matplotlib. Sfortunatamente, il modo in cui Apple attualmente installa le proprie copie di NumPy, Scipy e Matplotlib significa che questi pacchetti sono difficili da aggiornare (vedi pacchetti di sistema python ). Per questo motivo ti consigliamo vivamente di installare una nuova versione di Python e usarla come base per l'installazione di librerie come NumPy e Matplotlib. Un modo conveniente per installare Matplotlib con altri utili software Python è utilizzare la raccolta di software scientifico Anaconda Python, che include Python stesso e un'ampia gamma di librerie; se hai bisogno di una libreria che non è disponibile dalla raccolta, puoi installarla tu stesso usando metodi standard come pip. Vedere la pagina Web di Anaconda per il supporto all'installazione.

Altre opzioni per una nuova installazione di Python sono il programma di installazione standard da python.org o l'installazione di Python utilizzando un sistema di gestione dei pacchetti OSX generale come homebrew o macports . Gli utenti esperti su OSX probabilmente vorranno uno degli homebrew o macport sul loro sistema per installare pacchetti software open source, ma è perfettamente possibile utilizzare questi sistemi con un'altra fonte per il tuo binario Python, come Anaconda o Python.org Python.

Installazione delle ruote binarie OSX #

Se stai utilizzando Python da https://www.python.org , Homebrew o Macports, puoi utilizzare il programma di installazione pip standard per installare i binari Matplotlib sotto forma di ruote.

pip è installato di default con python.org e Homebrew Python, ma deve essere installato manualmente su Macports con

sudo port install py38-pip

Una volta installato pip, puoi installare Matplotlib e tutte le sue dipendenze dalla riga di comando di Terminal.app:

python3 -m pip install matplotlib

Potresti anche voler installare IPython o il notebook Jupyter ( ).python3 -m pip install ipython notebook

Controllo dell'installazione #

La nuova versione di Matplotlib dovrebbe ora essere sul tuo "percorso" Python. Controlla questo nella riga di comando di Terminal.app:

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

Dovresti vedere qualcosa di simile

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

dov'è 3.6.0la versione di Matplotlib che hai appena installato e il percorso che segue dipende dal fatto che tu stia utilizzando Python.org Python, Homebrew o Macports. Se vedi un'altra versione o ricevi un errore come

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

quindi controlla che il binario Python sia quello che ti aspettavi eseguendo

which python3

Se ottieni un risultato come /usr/bin/python..., allora stai installando Python con OSX, che probabilmente non è quello che vuoi. Prova a chiudere e riavviare Terminal.app prima di eseguire nuovamente il controllo. Se ciò non risolve il problema, a seconda di quale Python si desidera utilizzare, prendere in considerazione la reinstallazione di Python.org Python o controllare la configurazione di homebrew o macports. Ricorda che il programma di installazione dell'immagine del disco funziona solo per Python.org Python e non verrà raccolto da altri Python. Se tutti questi falliscono, faccelo sapere .