Instalación #

Instalación de una versión oficial #

Las versiones de Matplotlib están disponibles como paquetes de rueda para macOS, Windows y Linux en PyPI . Instálalo usando pip:

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

Si este comando hace que Matplotlib se compile desde la fuente y hay problemas con la compilación, puede agregar --prefer-binarypara seleccionar la versión más reciente de Matplotlib para la cual hay una rueda precompilada para su sistema operativo y Python.

Nota

Los siguientes backends funcionan de forma inmediata: Agg, ps, pdf, svg

Python normalmente se envía con enlaces tk que utiliza TkAgg.

Para compatibilidad con otros marcos de GUI, procesamiento de LaTeX, almacenamiento de animaciones y una mayor selección de formatos de archivo, puede instalar Dependencias opcionales .

Distribuciones de terceros #

Varios terceros proporcionan Matplotlib para sus entornos.

Paquetes Conda #

Matplotlib está disponible tanto a través del canal principal de anaconda

conda install matplotlib

así como a través del canal de la comunidad conda-forge

conda install -c conda-forge matplotlib

Distribuciones de Python #

Matplotlib es parte de las principales distribuciones de Python:

Administrador de paquetes de Linux #

Si está utilizando la versión de Python que viene con su distribución de Linux, puede instalar Matplotlib a través de su administrador de paquetes, por ejemplo:

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

  • Fedora:sudo dnf install python3-matplotlib

  • Sombrero rojo:sudo yum install python3-matplotlib

  • Arco:sudo pacman -S python-matplotlib

Instalación de una compilación nocturna #

Matplotlib hace que las ruedas de compilación de desarrollo nocturno estén disponibles en la organización scipy-wheels-nightly Anaconda Cloud . Estas ruedas se pueden instalar pipespecificando scipy-wheels-nightly como el índice del paquete para consultar:

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

Instalación desde la fuente #

Si está interesado en contribuir al desarrollo de Matplotlib, ejecutar el código fuente más reciente o simplemente le gusta construir todo usted mismo, no es difícil construir Matplotlib desde la fuente.

Primero necesitas instalar las Dependencias .

Se requiere un compilador de CA. Por lo general, en Linux, necesitará gcc, que debe instalarse utilizando el administrador de paquetes de su distribución; en macOS, necesitará xcode ; en Windows, necesitará Visual Studio 2015 o posterior.

Para aquellos que usan Visual Studio, asegúrese de que esté seleccionado "Desarrollo de escritorio con C++" y que estén seleccionados e instalados el MSVC más reciente, "Herramientas CMake de C++ para Windows" y un SDK de Windows compatible con su versión de Windows. Deben seleccionarse de forma predeterminada en el subtítulo "Opcional", pero son necesarios para compilar matplotlib desde el origen.

La forma más fácil de obtener la última versión de desarrollo para comenzar a contribuir es ir al repositorio de git y ejecutar:

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

o:

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

Si está desarrollando, es mejor hacerlo en modo editable. El motivo es que el descubrimiento de prueba de pytest solo funciona para Matplotlib si la instalación se realiza de esta manera. Además, el modo editable permite que los cambios de su código se propaguen instantáneamente a su código de biblioteca sin reinstalarlo (aunque tendrá que reiniciar su proceso/kernel de python):

cd matplotlib
python -m pip install -e .

Si no está desarrollando, se puede instalar desde el directorio de origen con un simple (simplemente reemplace el último paso):

python -m pip install .

Para ejecutar las pruebas, deberá instalar algunas dependencias adicionales:

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

Luego, si desea actualizar su Matplotlib en cualquier momento, simplemente haga lo siguiente:

git pull

Cuando ejecuta , si el resultado muestra que solo se han actualizado los archivos de Python, ya está todo listo. Si los archivos C han cambiado, debe volver a ejecutarlos para compilarlos.git pullpip install -e .

Hay más información sobre el uso de git en los documentos para desarrolladores.

Advertencia

Las siguientes instrucciones en esta sección son para instalaciones muy personalizadas de Matplotlib. Proceda con precaución porque estas instrucciones pueden hacer que su compilación produzca un comportamiento inesperado y/o que falle la prueba local.

Si desea compilar a partir de un tarball, tome el último archivo de versión tar.gz de la página de archivos PyPI .

Proporcionamos un archivo mplsetup.cfg que puede usar para personalizar el proceso de compilación. Por ejemplo, qué backend predeterminado usar, si algunas de las bibliotecas opcionales que se envían con Matplotlib están instaladas, etc. Este archivo será particularmente útil para quienes empaquetan Matplotlib.

Si está creando sus propias ruedas de Matplotlib (o sdists) en Windows, tenga en cuenta que cualquier archivo DLL que copie en el árbol de origen también se empaquetará.

Instalación para desarrollo #

Consulte Configuración de Matplotlib para desarrollo .

Preguntas frecuentes #

Reportar un problema de compilación #

Consulte Obtención de ayuda .

Matplotlib compilado bien, pero no aparece nada cuando lo uso #

Lo primero que debe intentar es una instalación limpia y ver si eso ayuda. De lo contrario, la mejor manera de probar su instalación es ejecutar un script, en lugar de trabajar de forma interactiva desde un shell de python o un entorno de desarrollo integrado como IDLE , que agrega complejidades adicionales. Abra un shell de UNIX o un símbolo del sistema de DOS y ejecute, por ejemplo:

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

Esto le dará información adicional sobre qué backends está cargando Matplotlib, información de la versión y más. En este punto, es posible que desee asegurarse de comprender el proceso de configuración de Matplotlib , regido por el matplotlibrcarchivo de configuración que contiene instrucciones y el concepto del backend de Matplotlib.

Si sigue teniendo problemas, consulte Obtención de ayuda .

Cómo eliminar completamente Matplotlib #

Ocasionalmente, los problemas con Matplotlib se pueden resolver con una instalación limpia del paquete. Para eliminar completamente un Matplotlib instalado:

  1. Elimine los cachés de su directorio de configuración de Matplotlib .

  2. Elimine cualquier directorio o huevo de Matplotlib de su directorio de instalación .

Notas OSX #

¿Qué Python para OSX? #

Apple distribuye OSX con su propio Python, en /usr/bin/python, y su propia copia de Matplotlib. Desafortunadamente, la forma en que Apple instala actualmente sus propias copias de NumPy, Scipy y Matplotlib significa que estos paquetes son difíciles de actualizar (ver paquetes de Python del sistema ). Por esa razón, le sugerimos encarecidamente que instale una versión nueva de Python y la use como base para instalar bibliotecas como NumPy y Matplotlib. Una forma conveniente de instalar Matplotlib con otro software Python útil es usar la colección de software científico Anaconda Python, que incluye el propio Python y una amplia gama de bibliotecas; si necesita una biblioteca que no está disponible en la colección, puede instalarla usted mismo usando métodos estándar como pip. Consulte la página web de Anaconda para obtener ayuda con la instalación.

Otras opciones para una instalación nueva de Python son el instalador estándar de python.org , o la instalación de Python utilizando un sistema general de administración de paquetes OSX, como homebrew o macports . Los usuarios avanzados de OSX probablemente querrán uno de homebrew o macports en su sistema para instalar paquetes de software de código abierto, pero es perfectamente posible usar estos sistemas con otra fuente para su binario de Python, como Anaconda o Python.org Python.

Instalación de ruedas binarias OSX #

Si usa Python de https://www.python.org , Homebrew o Macports, puede usar el instalador pip estándar para instalar los binarios de Matplotlib en forma de ruedas.

pip se instala de forma predeterminada con python.org y Homebrew Python, pero debe instalarse manualmente en Macports con

sudo port install py38-pip

Una vez que pip está instalado, puede instalar Matplotlib y todas sus dependencias desde la línea de comandos de Terminal.app:

python3 -m pip install matplotlib

También es posible que desee instalar IPython o el cuaderno Jupyter ( ).python3 -m pip install ipython notebook

Comprobando su instalación #

La nueva versión de Matplotlib ahora debería estar en su "ruta" de Python. Verifique esto en la línea de comando Terminal.app:

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

Deberías ver algo como

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

¿ Dónde 3.6.0está la versión de Matplotlib que acaba de instalar y la ruta que sigue depende de si está utilizando Python.org Python, Homebrew o Macports? Si ve otra versión, o recibe un error como

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

luego verifique que el binario de Python sea el que esperaba ejecutando

which python3

Si obtiene un resultado como /usr/bin/python..., entonces está instalando Python con OSX, que probablemente no sea lo que desea. Intente cerrar y reiniciar Terminal.app antes de volver a ejecutar la comprobación. Si eso no soluciona el problema, según el Python que desee usar, considere reinstalar Python.org Python o verifique la configuración de su homebrew o macports. Recuerde que el instalador de imagen de disco solo funciona para Python.org Python, y no será utilizado por otros Pythons. Si todo esto falla, por favor háganoslo saber .