Matplotlib学习笔记(第一章)

Matplotlib

第3.4.1版

• 约翰·亨特
• 达伦·戴尔
• 埃里克·费宁
• 迈克尔·卓特布姆
• 以及matplotlib开发团队

2021年3月21日

第一部分：用户指南

第一章 安装

1.1从源代码安装

如果你有兴趣为Matplotlib的开发做贡献，运行最新的源代码，或者只是想自己构建所有的东西，从源代码构建Matplotlib并不困难。

首先，您需要安装依赖的库。

需要C编译器。通常，在Linux上，您需要gcc，它应该使用发行版的包管理器安装；在macOS上，你需要xcode；在Windows上，你将需要Visual Studio 2015或更高版本。

获取最新开发版本的最简单方法是进入git库并运行:

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

或者：

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

如果你正在进行开发，最好是在可编辑模式下进行。原因是pytest的测试发现只适用于Matplotlib，如果以这种方式安装的话。此外，可编辑模式允许您的代码更改立即传播到库代码，而无需重新安装(尽管您必须重新启动python进程/内核)：

cd matplotlib
python -m pip install -e .

如果你不是在开发，它可以从源目录安装一个简单的(只需替换最后一步):

python -m pip install .

要运行这些测试，你需要安装一些额外的依赖项：

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

然后，如果你想随时更新你的Matplotlib，只需要做:

git pull

当你运行git pull时，如果输出显示只有Python文件被更新，那么你就完成了所有的设置。如果修改了C文件，请执行pip install -e。再次编译它们。

在开发者文档中有更多关于使用git的信息。

警告:本节中的以下说明适用于非常自定义的Matplotlib安装。
请谨慎进行，因为这些指令可能导致构建产生意外行为和/或导致本地测试失败。

如果您想从tarball构建，请从PyPI文件页面获取最新的tar.gz发布文件。

我们提供了一个setup.cfg文件，您可以使用它来定制构建过程。例如，要使用哪个默认后端，是否安装了Matplotlib附带的一些可选库，等等。

这个文件对那些打包Matplotlib的人特别有用。

如果您正在Windows上构建自己的Matplotlib wheels(或sdist)，请注意，您复制到源代码树中的任何dll也将被打包。

1.2安装正式版本

Matplotlib版本可以作为wheel包在PyPI上的macOS、Windows和Linux上使用。使用pip安装它:

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

如果该命令导致从源代码编译Matplotlib，并且在编译过程中出现了问题，那么可以添加——prefer-binary来选择最新版本的Matplotlib，该版本为您的操作系统和Python提供了预编译的wheel。

---

注意:以下后端开箱即用:Agg、ps、pdf、svg

Python通常附带绑定使用TkAgg的tk。

为了支持其他GUI框架、LaTeX呈现、保存动画和更大的文件格式选择，您可以安装可选依赖项。

---

1.3第三方发行版

各种第三方为他们的环境提供Matplotlib。

1.31 Conda的安装包

Matplotlib可以通过anaconda主通道获得：

conda install matplotlib

也可以通过 conda-forge 社区频道获得：

conda install -c conda-forge matplotlib

1.3.2 Python发行版

Matplotlib是主要Python发行版的一部分:

• Anaconda
• ActiveState ActivePython
• WinPython

1.3.3 Linux包管理器

如果你使用的是Linux发行版自带的Python版本，你可以通过包管理器安装Matplotlib，例如:

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

1.4从源代码安装

参见从源代码安装。

1.5开发安装

参见为开发设置Matplotlib。