Matplotlib Install

If you are interested in contributing to Matplotlib development,running the latest source code, or just like to build everythingyourself, it is not difficult to build Matplotlib from source. Grabthe latest tar.gz release file from the PyPI files page, or if you want todevelop Matplotlib or just need the latest bugfixed version, grab thelatest git version, and see Install from source.

Matplotlib on PyPI (where pip draws packages from) doesn't have any. Whl files for Python 3.8 yet (as of this writing). So Python is (as you seem to be aware). I'm trying to install matplotlib under Windows Vista. Both python itself and numpy are working for me. I installed matplotlib via the executable basemap-1.0.2.win32-py2.7 and followed the official.

The standard environment variables CC, CXX, PKG_CONFIG are respected.This means you can set them if your toolchain is prefixed. This may be used forcross compiling.

Once you have satisfied the requirements detailed below (mainlyPython, NumPy, libpng and FreeType), you can build Matplotlib.

We provide a setup.cfg file which you can use to customize the buildprocess. For example, which default backend to use, whether some of theoptional libraries that Matplotlib ships with are installed, and so on. Thisfile will be particularly useful to those packaging Matplotlib.

If you have installed prerequisites to nonstandard places and need toinform Matplotlib where they are, edit setupext.py and add the basedirs to the basedir dictionary entry for your sys.platform;e.g., if the header of some required library is in/some/path/include/someheader.h, put /some/path in thebasedir list for your platform.

Matplotlib requires the following dependencies:

• Python (>= 3.6)
• FreeType (>= 2.3)
• libpng (>= 1.2)
• NumPy (>= 1.11)
• cycler (>= 0.10.0)
• dateutil (>= 2.1)
• kiwisolver (>= 1.0.0)

Optionally, you can also install a number of packages to enable better userinterface toolkits. See What is a backend? for more details on theoptional Matplotlib backends and the capabilities they provide.

• tk (>= 8.3, != 8.6.0 or 8.6.1): for the Tk-based backends;
• PyQt4 (>= 4.6) orPySide (>= 1.0.3): for the Qt4-basedbackends;
• PyQt5: for the Qt5-based backends;
• PyGObject: for the GTK3-basedbackends;
• wxpython (>= 4): for the WX-based backends;
• cairocffi (>= 0.8) orpycairo: for the cairo-basedbackends;
• Tornado: for the WebAgg backend;

For better support of animation output format and image file formats, LaTeX,etc., you can install the following:

• ffmpeg/avconv: for saving movies;
• ImageMagick: for savinganimated gifs;
• Pillow (>= 3.4): for a largerselection of image file formats: JPEG, BMP, and TIFF image files;
• LaTeX and GhostScript (>=9.0) : for rendering text with LaTeX.

Note

Matplotlib depends on non-Python libraries.

On Linux and OSX, pkg-config can be used to find required non-Pythonlibraries and thus make the install go more smoothly if the libraries andheaders are not in the expected locations.

If not using pkg-config (in particular on Windows), you may need to set theinclude path (to the FreeType, libpng, and zlib headers) and link path (tothe FreeType, libpng, and zlib libraries) explicitly, if they are not instandard locations. This can be done using standard environment variables-- on Linux and OSX:

and on Windows:

where .. means 'also give, in the same format, the directoriescontaining png.h and zlib.h for the include path, and forlibpng.so/png.lib and libz.so/z.lib for the link path.'

Note

The following libraries are shipped with Matplotlib:

• Agg: the Anti-Grain Geometry C++ rendering engine;
• qhull: to compute Delaunay triangulation;
• ttconv: a TrueType font utility.

It is easiest to use your system package manager to install the dependencies.

If you are on Debian/Ubuntu, you can get all the dependenciesrequired to build Matplotlib with:

If you are on Fedora, you can get all the dependencies required to buildMatplotlib with:

If you are on RedHat, you can get all the dependencies required to buildMatplotlib by first installing yum-builddep and then running:

These commands do not build Matplotlib, but instead get and install thebuild dependencies, which will make building from source easier.

The build situation on macOS is complicated by the various places onecan get the libpng and FreeType requirements (MacPorts, Fink,/usr/X11R6), the different architectures (e.g., x86, ppc, universal), andthe different macOS versions (e.g., 10.4 and 10.5). We recommend that you buildthe way we do for the macOS release: get the source from the tarball or thegit repository and install the required dependencies through a third-partypackage manager. Two widely used package managers are Homebrew, and MacPorts.The following example illustrates how to install libpng and FreeType usingbrew:

Hence, it helps provide six thousand plus loops. Also, it provides multi-track with the best resolution and quality. Furthermore, it provide the interface with 3-Band per track. It also includes video and text upon the videos.

If you are using MacPorts, execute the following instead:

After installing the above requirements, install Matplotlib from source byexecuting:

Note that your environment is somewhat important. Some conda users havefound that, to run the tests, their PYTHONPATH must include/path/to/anaconda/../site-packages and their DYLD_FALLBACK_LIBRARY_PATHmust include /path/to/anaconda/lib.

The Python shipped from https://www.python.org is compiled with Visual Studio2015 for 3.5+. Python extensions should be compiled with the samecompiler, see e.g.https://packaging.python.org/guides/packaging-binary-extensions/#setting-up-a-build-environment-on-windowsfor how to set up a build environment.

Since there is no canonical Windows package manager, the methods for buildingFreeType, zlib, and libpng from source code are documented as a build scriptat matplotlib-winbuild.

There are a few possibilities to build Matplotlib on Windows:

• Wheels via matplotlib-winbuild
• Wheels by using conda packages (see below)
• Conda packages (see below)

This is a wheel build, but we use conda packages to get all the requirements.The binary requirements (png, FreeType,..) are statically linked and thereforenot needed during the wheel install.

Set up the conda environment. Note, if you want a qt backend, add pyqt tothe list of conda packages.

For building, call the script build_alllocal.cmd in the root folder of therepository:

The conda packaging scripts for Matplotlib are available athttps://github.com/conda-forge/matplotlib-feedstock.

If you are interested in contributing to Matplotlib development,running the latest source code, or just like to build everythingyourself, it is not difficult to build Matplotlib from source. Grabthe latest tar.gz release file from the PyPI files page, or if you want todevelop Matplotlib or just need the latest bugfixed version, grab thelatest git version, and see Install from source.

The standard environment variables CC, CXX, PKG_CONFIG are respected.This means you can set them if your toolchain is prefixed. This may be used forcross compiling.

Once you have satisfied the requirements detailed below (mainlyPython, NumPy, libpng and FreeType), you can build Matplotlib.

We provide a setup.cfg file which you can use to customize the buildprocess. For example, which default backend to use, whether some of theoptional libraries that Matplotlib ships with are installed, and so on. Thisfile will be particularly useful to those packaging Matplotlib.

If you have installed prerequisites to nonstandard places and need toinform Matplotlib where they are, edit setupext.py and add the basedirs to the basedir dictionary entry for your sys.platform;e.g., if the header of some required library is in/some/path/include/someheader.h, put /some/path in thebasedir list for your platform.

Matplotlib requires the following dependencies:

• Python (>= 3.6)
• FreeType (>= 2.3)
• libpng (>= 1.2)
• NumPy (>= 1.11)
• cycler (>= 0.10.0)
• dateutil (>= 2.1)
• kiwisolver (>= 1.0.0)

Optionally, you can also install a number of packages to enable better userinterface toolkits. See What is a backend? for more details on theoptional Matplotlib backends and the capabilities they provide.

• tk (>= 8.3, != 8.6.0 or 8.6.1): for the Tk-based backends;
• PyQt4 (>= 4.6) orPySide (>= 1.0.3): for the Qt4-basedbackends;
• PyQt5: for the Qt5-based backends;
• PyGObject: for the GTK3-basedbackends;
• wxpython (>= 4): for the WX-based backends;
• cairocffi (>= 0.8) orpycairo: for the cairo-basedbackends;
• Tornado: for the WebAgg backend;

For better support of animation output format and image file formats, LaTeX,etc., you can install the following:

• ffmpeg/avconv: for saving movies;
• ImageMagick: for savinganimated gifs;
• Pillow (>= 3.4): for a largerselection of image file formats: JPEG, BMP, and TIFF image files;
• LaTeX and GhostScript (>=9.0) : for rendering text with LaTeX.

Note

Matplotlib depends on non-Python libraries.

On Linux and OSX, pkg-config can be used to find required non-Pythonlibraries and thus make the install go more smoothly if the libraries andheaders are not in the expected locations.

If not using pkg-config (in particular on Windows), you may need to set theinclude path (to the FreeType, libpng, and zlib headers) and link path (tothe FreeType, libpng, and zlib libraries) explicitly, if they are not instandard locations. This can be done using standard environment variables-- on Linux and OSX:

and on Windows:

where .. means 'also give, in the same format, the directoriescontaining png.h and zlib.h for the include path, and forlibpng.so/png.lib and libz.so/z.lib for the link path.'

Note

The following libraries are shipped with Matplotlib:

• Agg: the Anti-Grain Geometry C++ rendering engine;
• qhull: to compute Delaunay triangulation;
• ttconv: a TrueType font utility.

It is easiest to use your system package manager to install the dependencies.

If you are on Debian/Ubuntu, you can get all the dependenciesrequired to build Matplotlib with:

If you are on Fedora, you can get all the dependencies required to buildMatplotlib with:

If you are on RedHat, you can get all the dependencies required to buildMatplotlib by first installing yum-builddep and then running:

These commands do not build Matplotlib, but instead get and install thebuild dependencies, which will make building from source easier.

The build situation on macOS is complicated by the various places onecan get the libpng and FreeType requirements (MacPorts, Fink,/usr/X11R6), the different architectures (e.g., x86, ppc, universal), andthe different macOS versions (e.g., 10.4 and 10.5). We recommend that you buildthe way we do for the macOS release: get the source from the tarball or thegit repository and install the required dependencies through a third-partypackage manager. Two widely used package managers are Homebrew, and MacPorts.The following example illustrates how to install libpng and FreeType usingbrew:

If you are using MacPorts, execute the following instead:

After installing the above requirements, install Matplotlib from source byexecuting:

Note that your environment is somewhat important. Some conda users havefound that, to run the tests, their PYTHONPATH must include/path/to/anaconda/../site-packages and their DYLD_FALLBACK_LIBRARY_PATHmust include /path/to/anaconda/lib.

The Python shipped from https://www.python.org is compiled with Visual Studio2015 for 3.5+. Python extensions should be compiled with the samecompiler, see e.g.https://packaging.python.org/guides/packaging-binary-extensions/#setting-up-a-build-environment-on-windowsfor how to set up a build environment.

Since there is no canonical Windows package manager, the methods for buildingFreeType, zlib, and libpng from source code are documented as a build scriptat matplotlib-winbuild.

There are a few possibilities to build Matplotlib on Windows:

• Wheels via matplotlib-winbuild
• Wheels by using conda packages (see below)
• Conda packages (see below)

This is a wheel build, but we use conda packages to get all the requirements.The binary requirements (png, FreeType,..) are statically linked and thereforenot needed during the wheel install.

Set up the conda environment. Note, if you want a qt backend, add pyqt tothe list of conda packages.

For building, call the script build_alllocal.cmd in the root folder of therepository:

The conda packaging scripts for Matplotlib are available athttps://github.com/conda-forge/matplotlib-feedstock.