Matplotlib 安装教程

Question

有很多不同的方法来安装 matplotlib，最好的方法取决于你正在使用什么操作系统，你已经安装了什么，以及如何使用它。为了避免在此页面上浏览所有细节（和潜在的并发症），有几个方便的选择。

安装预建的软件包

大多数平台：科学的 Python 发行

第一个选择是使用已经提供 matplotlib 内置的预包装的 python 发行版之一。Continuum.io Python发行版（Anaconda 或 miniconda）和Enthought发行版（Canopy） 都是 Windows 即 OSX 和普通 Linux 平台“开箱即用”的绝佳选择。这两个分发包括matplotlib和许多其他有用的工具。

Linux 系统：使用你的包管理

如果你在 Linux 上，你可能更喜欢使用你的软件包管理器。几乎每个主要的 Linux 发行版都包装了 matplotlib。

• Debian / Ubuntu： sudo apt-get install python-matplotlib
• Fedora / Redhat： sudo yum install python-matplotlib

Mac OSX 上：使用 PIP

如果您在 Mac OSX 上，您可以使用标准的 Python 安装程序 pip 来安装 matplotlib 二进制文件。请参阅 安装OSX二进制轮。

Windows

如果您还没有安装 Python，我们建议您使用与 Scipy-stack兼容的Python发行版之一，如 WinPython，Python（x，y），Enthought Canopy 或Continuum Anaconda，它们具有 matplotlib 及其许多依赖关系其他有用的包，预装。

对于 标准的Python 安装，请使用 pip 来安装 matplotlib ：

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

如果没有为所有用户安装Python 2.7或3.4，则需要安装Microsoft Visual C ++ 2008（64位 或 32位 为Python 2.7）或Microsoft Visual C ++ 2010（64位 或 32位 为Python 3.4）可重新分发包。

Matplotlib 依赖于Pillow 读取和保存 JPEG，BMP 和 TIFF 图像文件。Matplotlib需要 MiKTeX 和 GhostScript 来渲染 LaTeX 的文本。 动画模块需要FFmpeg，avconv， mencoder或 ImageMagick。

以下后端应该是开箱即用的：agg，tkagg，ps，pdf和svg。对于其他后端，您可能需要安装 pycairo， PyQt4， PyQt5， PySide， wxPython，PyGTK， Tornado或GhostScript。

TkAgg可能是从标准Python shell或IPython进行交互式使用的最佳后端。它被启用为官方二进制文件的默认后端。Windows不支持GTK3。

PyPI下载页面.whl上的Windows wheels（）不包含测试数据或示例代码。如果你想尝试matplotlib源码分发中的许多演示，请下载文件并查看 子目录。要运行测试套件，将源分发中的目录和 目录复制到并 分别安装鼻子，mock，Pillow，MiKTeX，GhostScript，ffmpeg，avconv，mencoder，ImageMagick和Inkscape。.tar.gzexampleslib\matplotlib\testslib\mpl_toolkits\testssys.prefix\Lib\site-packages\matplotlibsys.prefix\Lib\site-packages\mpl_toolkits

从源代码安装

如果您有兴趣为matplotlib开发，运行最新的源代码，或者只是想自己构建一切，那么从源代码构建matplotlib并不难。从PyPI文件页面获取最新的tar.gz发行文件，或者如果要开发matplotlib或只需要最新的bugfixed版本，请从git获取最新的git版本源安装。

标准的环境变量CC，CXX，PKG_CONFIG得到尊重。这意味着如果您的工具链是前缀，您可以设置它们。这可以用于交叉编译。

export CC=x86_64-pc-linux-gnu-gcc
export CXX=x86_64-pc-linux-gnu-g++
export PKG_CONFIG=x86_64-pc-linux-gnu-pkg-config

一旦您满足下面详细的要求（主要是python，numpy，libpng和freetype），就可以构建matplotlib。

cd matplotlib
python setup.py build
python setup.py install

我们提供一个setup.cfg 文件，setup.py您可以使用它来自定义构建过程。例如，哪些默认后端使用，是否安装了matplotlib附带的一些可选库，等等。这个文件对于那些包装matplotlib将是特别有用的。

如果您已经为非标准地点安装了先决条件，并且需要通知matplotlib，那么setupext.py请将基本目录编辑并添加到您的basedir字典条目中sys.platform。例如，如果某些所需库的头部在 /some/path/include/someheader.h，则放入您的平台/some/path的 basedir列表中。

构建要求

这些是在安装matplotlib之前需要安装的外部程序包。如果您正在OSX上构建，请参阅在OSX上 构建。如果您在Windows上构建，请参阅在Windows上 构建。如果要在Linux上安装与软件包管理器的依赖关系，则可能需要安装开发包（除了库之外还查找“-dev”后缀）。

必需依赖

• python 2.7,3.4,3.5或3.6

下载python。

• numpy 1.7.1（或更高版本）

数组支持python（下载numpy）

• setuptools的

Setuptools为python包安装提供扩展。

• dateutil 1.1或更高版本

提供python datetime处理的扩展。如果使用pip，easy_install或从源安装，安装程序将尝试python_dateutil从PyPI 下载并安装。

• pyparsing

需要matplotlib的数学渲染支持。如果使用pip，easy_install或从源安装，安装程序将尝试pyparsing从PyPI 下载并安装。

• libpng 1.2（或更高版本）

用于加载和保存PNG文件的库（下载）。libpng需要zlib。

• pytz

用于操纵时区感知的数据时间。https://pypi.python.org/pypi/pytz

• FreeType 2.3或更高版本

用于读取真实类型字体文件的库。如果使用pip，easy_install或从源安装，安装程序将尝试在预期位置找到FreeType。如果不能，请尝试安装pkg-config，该工具用于查找所需的非python库。

• cycler 0.10.0以上

用于构建样式周期的可组合循环类

• six

需要python 2和python 3之间的兼容性

python 2 的依赖

• functools32

在Python 2.7中运行时需要兼容性。

• subprocess32

可选，仅限unix。Subprocess标准库的Backport从3.2+ for Python 2.7。它提供更好的错误消息和超时支持。

可选GUI框架

这些是可选的包，您可能需要安装以使用带有用户界面工具包的matplotlib。看 什么是后端？有关可选的matplotlib后端及其提供的功能的更多详细信息。

• tk 8.3或更高版本，不是8.6.0或8.6.1

TkAgg后端使用的TCL / Tk小部件库。

已知版本8.6.0和8.6.1具有在以错误的顺序关闭多个窗口时可能导致segfaults的问题。

• pyqt 4.4或更高版本

用于Qt4Agg后端的Qt4小部件库python包装器

• pygtk 2.4或更高版本

用于GTK小部件库的python包装器可用于GTK或GTKAGG后端

• wxpython 2.8或更高版本

wx小部件库的python包装器用于WX或WXAgg后端

可选外部程序

• ffmpeg / avconv或mencoder

需要将动画模块保存为电影格式。

• ImageMagick的

动画模块需要保存为动画GIF。

可选依赖关系

• 枕头 如果安装了Pillow，matplotlib可以读取和写入更多的图像文件格式。
• pkg配置 用于查找所需的非python库的工具。这不是严格要求的，但是如果库和标题不在预期位置，则可以使安装更顺利。

需要的库，与 matplotlib 出货

• agg 2.4 反叛C ++渲染引擎。matplotlib静态链接到agg模板源，所以它不会影响你的系统外的任何东西在matplotlib之外。
• qhull 2012.1

用于计算 Delaunay 三角测量的图书馆。

• ttconv

truetype 字体实用程序

在 Linux 上构建

最简单的方法是使用您的系统软件包管理器来安装依赖项。

如果您使用的是 Debian / Ubuntu，可以通过以下方式获取构建 matplotlib 所需的所有依赖项：

sudo  apt - get  build - dep  python - matplotlib

如果您使用的是 Fedora / RedHat，则可以先安装 yum-builddep 然后运行以获取构建 matplotlib 所需的所有依赖项：

su  - c  “yum-builddep python-matplotlib”

这不构建 matplotlib，但它确实获得了安装构建依赖关系，这将使源代码更容易构建。

在 OSX 上建立

OSX 的构建情况复杂化，各种场合可以获得 libpng 和 freetype 要求（darwinports，fink，/ usr / X11R6）和不同的体系结构（例如 x86，ppc，universal）和不同的 OSX 版本（例如， 10.4 和 10.5）。我们建议您构建 OSX 版本的方式：从 tarball 或 git 存储库获取源代码，并按照说明进行操作README.osx。

在 Windows 上构建

从 https://www.python.org 发送的 Python 是使用 Visual Studio 2008 编译的，版本为 3.3 之前，Visual Studio 2010 为 3.3 和 3.4，Visual Studio 2015为 3.5 和 3.6。Python 扩展程序建议使用相同的编译器进行编译。

由于没有规范的 Windows 软件包管理器，从源代码构建 freetype，zlib 和 libpng 的方法在 matplotlib-winbuild 中记录为构建脚本。