Instalação #

Instalando uma versão oficial #

Os lançamentos do Matplotlib estão disponíveis como pacotes wheel para macOS, Windows e Linux no PyPI . Instale-o usando pip:

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

Se esse comando resultar na compilação do Matplotlib a partir do código-fonte e houver problemas com a compilação, você poderá adicionar --prefer-binarypara selecionar a versão mais recente do Matplotlib para a qual há uma roda pré-compilada para seu sistema operacional e Python.

Observação

Os seguintes back-ends funcionam imediatamente: Agg, ps, pdf, svg

O Python normalmente é enviado com ligações tk que são usadas pelo TkAgg.

Para suporte de outras estruturas GUI, renderização LaTeX, salvar animações e uma seleção maior de formatos de arquivo, você pode instalar dependências opcionais .

Distribuições de terceiros #

Vários terceiros fornecem Matplotlib para seus ambientes.

Pacotes Conda #

Matplotlib está disponível através do canal principal anaconda

conda install matplotlib

bem como através do canal da comunidade conda-forge

conda install -c conda-forge matplotlib

Distribuições Python #

Matplotlib faz parte das principais distribuições do Python:

Gerenciador de pacotes Linux #

Se você estiver usando a versão do Python que acompanha sua distribuição Linux, poderá instalar o Matplotlib por meio do gerenciador de pacotes, por exemplo:

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

  • Fedora:sudo dnf install python3-matplotlib

  • Chapéu vermelho:sudo yum install python3-matplotlib

  • Arco:sudo pacman -S python-matplotlib

Instalando uma compilação noturna #

O Matplotlib disponibiliza rodas de construção de desenvolvimento noturno na organização Anaconda Cloud scipy-wheels-nightly . Essas rodas podem ser instaladas pipespecificando scipy-wheels-nightly como o índice do pacote a ser consultado:

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

Instalando a partir da fonte #

Se você está interessado em contribuir para o desenvolvimento do Matplotlib, executando o código-fonte mais recente ou apenas gosta de criar tudo sozinho, não é difícil criar o Matplotlib a partir do código-fonte.

Primeiro você precisa instalar o Dependencies .

O compilador AC é necessário. Normalmente, no Linux, você precisará do gcc, que deve ser instalado usando o gerenciador de pacotes de sua distribuição; no macOS, você precisará do xcode ; no Windows, você precisará do Visual Studio 2015 ou posterior.

Para aqueles que usam o Visual Studio, verifique se "desenvolvimento de área de trabalho com C++" está selecionado e se o MSVC mais recente, "ferramentas C++ CMake para Windows" e um SDK do Windows compatível com sua versão do Windows estão selecionados e instalados. Eles devem ser selecionados por padrão no subtítulo "Opcional", mas são necessários para criar o matplotlib a partir do código-fonte.

A maneira mais fácil de obter a versão de desenvolvimento mais recente para começar a contribuir é acessar o repositório git e executar:

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

ou:

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

Se você estiver desenvolvendo, é melhor fazê-lo no modo editável. A razão é que a descoberta de teste do pytest só funciona para o Matplotlib se a instalação for feita dessa maneira. Além disso, o modo editável permite que suas alterações de código sejam propagadas instantaneamente para o código da sua biblioteca sem reinstalar (embora você precise reiniciar o processo / kernel do python):

cd matplotlib
python -m pip install -e .

Se você não estiver desenvolvendo, ele pode ser instalado a partir do diretório de origem com um simples (basta substituir a última etapa):

python -m pip install .

Para executar os testes, você precisará instalar algumas dependências adicionais:

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

Então, se você quiser atualizar seu Matplotlib a qualquer momento, basta fazer:

git pull

Ao executar , se a saída mostrar que apenas os arquivos Python foram atualizados, está tudo pronto. Se os arquivos C foram alterados, você precisa executar novamente para compilá-los.git pullpip install -e .

Há mais informações sobre o uso do git nos documentos do desenvolvedor.

Aviso

As instruções a seguir nesta seção são para instalações muito personalizadas do Matplotlib. Prossiga com cuidado porque essas instruções podem fazer com que sua compilação produza um comportamento inesperado e/ou cause falha no teste local.

Se você gostaria de compilar a partir de um tarball, pegue o arquivo tar.gz mais recente da página de arquivos PyPI .

Fornecemos um arquivo mplsetup.cfg que você pode usar para personalizar o processo de compilação. Por exemplo, qual back-end padrão usar, se algumas das bibliotecas opcionais fornecidas com o Matplotlib estão instaladas e assim por diante. Este arquivo será particularmente útil para aqueles que empacotam o Matplotlib.

Se você estiver construindo suas próprias rodas Matplotlib (ou sdists) no Windows, observe que todas as DLLs que você copiar na árvore de origem também serão empacotadas.

Instalando para desenvolvimento #

Consulte Configurando o Matplotlib para desenvolvimento .

Perguntas frequentes #

Relatar um problema de compilação #

Consulte Obter ajuda .

Matplotlib compilou bem, mas nada aparece quando eu o uso #

A primeira coisa a tentar é uma instalação limpa e ver se isso ajuda. Caso contrário, a melhor maneira de testar sua instalação é executando um script, em vez de trabalhar interativamente a partir de um shell python ou de um ambiente de desenvolvimento integrado, como o IDLE , que adiciona complexidades adicionais. Abra um shell UNIX ou um prompt de comando do DOS e execute, por exemplo:

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

Isso fornecerá informações adicionais sobre quais back-ends o Matplotlib está carregando, informações sobre a versão e muito mais. Neste ponto, você pode querer ter certeza de entender o processo de configuração do Matplotlib , regido pelo matplotlibrcarquivo de configuração que contém instruções e o conceito do back-end do Matplotlib.

Se ainda estiver com problemas, consulte Obtendo ajuda .

Como remover completamente o Matplotlib #

Ocasionalmente, problemas com o Matplotlib podem ser resolvidos com uma instalação limpa do pacote. Para remover totalmente um Matplotlib instalado:

  1. Exclua os caches do diretório de configuração do Matplotlib .

  2. Exclua quaisquer diretórios ou ovos Matplotlib de seu diretório de instalação .

Notas OSX #

Qual python para OSX? #

A Apple envia o OSX com seu próprio Python, em /usr/bin/python, e sua própria cópia do Matplotlib. Infelizmente, a maneira como a Apple atualmente instala suas próprias cópias de NumPy, Scipy e Matplotlib significa que esses pacotes são difíceis de atualizar (consulte pacotes python do sistema ). Por esse motivo, sugerimos fortemente que você instale uma nova versão do Python e use-a como base para instalar bibliotecas como NumPy e Matplotlib. Uma maneira conveniente de instalar o Matplotlib com outro software Python útil é usar a coleção de software científico Anaconda Python, que inclui o próprio Python e uma ampla gama de bibliotecas; se você precisar de uma biblioteca que não esteja disponível na coleção, poderá instalá-la usando métodos padrão, como pip. Consulte a página da Web do Anaconda para suporte de instalação.

Outras opções para uma nova instalação do Python são o instalador padrão de python.org ou a instalação do Python usando um sistema geral de gerenciamento de pacotes OSX, como homebrew ou macports . Usuários avançados no OSX provavelmente vão querer um homebrew ou macports em seu sistema para instalar pacotes de software de código aberto, mas é perfeitamente possível usar esses sistemas com outra fonte para seu binário Python, como Anaconda ou Python.org Python.

Instalando rodas binárias OSX #

Se você estiver usando o Python de https://www.python.org , Homebrew ou Macports, poderá usar o instalador pip padrão para instalar binários Matplotlib na forma de rodas.

pip é instalado por padrão com python.org e Homebrew Python, mas precisa ser instalado manualmente em Macports com

sudo port install py38-pip

Uma vez instalado o pip, você pode instalar o Matplotlib e todas as suas dependências a partir da linha de comando Terminal.app:

python3 -m pip install matplotlib

Você também pode querer instalar o IPython ou o notebook Jupyter ( ).python3 -m pip install ipython notebook

Verificando sua instalação #

A nova versão do Matplotlib agora deve estar no seu "caminho" do Python. Verifique isso na linha de comando do Terminal.app:

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

Você deve ver algo como

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

onde 3.6.0está a versão do Matplotlib que você acabou de instalar e o caminho a seguir depende se você está usando Python.org Python, Homebrew ou Macports. Se você vir outra versão ou receber um erro como

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

em seguida, verifique se o binário do Python é o que você esperava executando

which python3

Se você obtiver um resultado como /usr/bin/python..., está obtendo o Python instalado com o OSX, o que provavelmente não é o que você deseja. Tente fechar e reiniciar Terminal.app antes de executar a verificação novamente. Se isso não resolver o problema, dependendo de qual Python você deseja usar, considere reinstalar o Python.org Python ou verifique sua configuração de homebrew ou macports. Lembre-se de que o instalador de imagem de disco funciona apenas para Python.org Python e não será escolhido por outros Pythons. Se tudo isso falhar, informe -nos .