安装指南

注解

如果你想为这个项目做贡献,建议你 install the latest development version .

安装正式版本

Matplotlib及其依赖项作为MacOS、Windows和Linux发行版的车轮包提供:

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

如果此命令导致Matplotlib从源代码处编译,并且编译有问题,可以添加 --prefer-binary 选择Matplotlib的最新版本,其中有用于操作系统和Python的预编译控制盘。

注解

以下后端是现成的:Agg、ps、pdf和svg

Python通常附带tk绑定,TkAgg使用这些绑定。

要支持其他GUI框架、LaTeX渲染、保存动画和更大的文件格式选择,您需要安装 additional dependencies .

虽然不需要,但我们建议安装 IPython 供交互使用。要轻松安装完整的科学python堆栈,请参见 科学 Python 分布 下面。

测试数据

轮子 (*.whlPyPI download page 不包含测试数据或示例代码。

如果您想尝试Matplotlib源代码分发中的许多演示,请下载 *.tar.gz 归档并查找 examples 子目录。

要运行测试套件:

  • 提取 lib/matplotlib/testslib/mpl_toolkits/tests 源分发中的目录。
  • 安装测试依赖项: pytest 和MPEG,和 Inkscape .
  • 运行 python -mpytest .

Matplotlib的第三方分布

科学 Python 分布

AnacondaActiveState 对于Windows、MacOS和普通Linux平台来说,这是一个非常好的选择。 WinPython 是Windows用户的一个选项。所有这些分布都包括matplotlib和 lots 其他有用的(数据)科学工具。

Linux:使用包管理器

如果您使用的是Linux,那么您可能更喜欢使用包管理器。Matplotlib几乎为每个主要的Linux发行版打包。

  • Debian/Ubuntu: sudo apt-get install python3-matplotlib
  • Fedora: sudo dnf install python3-matplotlib
  • 红帽: sudo yum install python3-matplotlib
  • Arch: sudo pacman -S python-matplotlib

从源安装

如果您对Matplotlib开发、运行最新的源代码感兴趣,或者只是想自己构建所有东西,那么从源代码构建Matplotlib并不难。抓住最新 tar.gz 释放文件 the PyPI files page ,或者,如果您想开发Matplotlib或只需要最新的bug修复版本,请获取最新的git版本,然后参阅 从源安装 .

Matplotlib可以从源目录安装,方法很简单:

python -m pip install .

我们提供了一个 setup.cfg 可用于自定义生成过程的文件。例如,要使用哪个默认后端,Matplotlib附带的一些可选库是否已安装,等等。这个文件对于那些打包Matplotlib特别有用。

依赖关系

Matplotlib需要以下依赖项:

或者,您也可以安装许多软件包以启用更好的用户界面工具包。见 什么是后端? 有关可选matplotlib后端及其提供的功能的更多详细信息。

  • Tk (>= 8.3, !=8.6.0或8.6.1):用于基于Tk的后端。
  • PyQt4 (>4.6)或 PySide (>=1.0.3) [1]: 对于基于Qt4的后端。
  • PyQt5PySide2: 对于基于Qt5的后端。
  • PyGObject:用于基于GTK3的后端 [2].
  • wxPython (>=4) [3]: 对于基于wx的后端。
  • pycairo (>=1.11.0)或 cairocffi (>=0.8):用于GTK3和/或基于cairo的后端。
  • Tornado:用于WebAgg后端。
[1]PySide不能在Linux上安装pip(但可以安装conda)。
[2]如果使用pip(而不是conda),则必须从源代码构建PyGObject;请参阅https://pygobject.readthedocs.io/en/latest/devguide/dev_environ.html。
[3]如果在Linux上使用pip(而不是conda),则必须从https://wxpython.org/pages/downloads/。

为了更好地支持动画输出格式和图像文件格式、 Latex 等,可以安装以下内容:

FreeType和Qhull

Matplotlib依赖于 FreeType (>=2.3)、字体呈现库等 Qhull (>=2015.2),用于计算三角剖分的库。默认情况下(在AIX上除外),Matplotlib下载并构建自己的FreeType副本(这对于运行测试套件是必需的,因为不同版本的FreeType栅格化字符的方式不同),并使用自己的Qhull副本。

要强制Matplotlib使用系统中已安装的FreeType或Qhull的副本,请创建 setup.cfg 包含以下内容的文件:

[libs]
system_freetype = true
system_qhull = true

赛前 python -m pip install . .

在这种情况下,您需要安装FreeType和Qhull库以及头文件。这可以使用包管理器实现,例如对于FreeType:

# Pick ONE of the following:
sudo apt install libfreetype6-dev  # Debian/Ubuntu
sudo dnf install freetype-devel  # Fedora
brew install freetype  # macOS with Homebrew
conda install freetype  # conda, any OS

(对Qhull进行相应调整)。

在Linux和macOS上,也建议安装 pkg-config, 用于定位FreeType的辅助工具:

# Pick ONE of the following:
sudo apt install pkg-config  # Debian/Ubuntu
sudo dnf install pkgconf  # Fedora
brew install pkg-config  # macOS with Homebrew
conda install pkg-config  # conda
# Or point the PKG_CONFIG environment variable to the path to pkg-config:
export PKG_CONFIG=...

如果不使用pkg config(特别是在Windows上),可能需要显式设置include path(到库头)和link path(到库),如果它们不在标准位置。这可以通过使用标准环境变量来实现--在Linux和OSX上:

export CFLAGS='-I/directory/containing/ft2build.h'
export LDFLAGS='-L/directory/containing/libfreetype.so'

在Windows上:

set CL=/IC:\directory\containing\ft2build.h
set LINK=/LIBPATH:C:\directory\containing\freetype.lib

注解

Matplotlib始终使用以下库的自己的副本:

  • Agg 反粒度几何C++渲染引擎;
  • ttconv :TrueType字体实用程序。

在窗户上建造

编译Matplotlib(或任何其他扩展模块)需要Visual Studio 2015或更高版本。

如果您正在构建自己的Matplotlib控制盘(或sdists),请注意,复制到源树中的所有dll也将打包。

Conda包

Matplotlib的conda打包脚本位于https://github.com/conda-forge/matplotlib-fipper。