MEP12: 改进图库和示例#

"""
===============================
Colormaps alter your perception
===============================

Here I plot the function

.. math:: f(x, y) = \sin(x) + \cos(y)

with different colormaps. Look at how colormaps alter your perception!
"""

PEP8 清理（强烈推荐运行 flake8 或类似的检查器）
注释掉的代码应该被删除。
将 pylab 接口的使用替换为 pyplot`（+ `numpy 等）。参见 c25ef1e。
移除 shebang 行，例如:
```
#!/usr/bin/env python
```
使用一致的导入。特别是:
```
import numpy as np

import matplotlib.pyplot as plt
```
避免从这些模块中导入特定函数（例如 from numpy import sin）
每个示例应专注于一个特定的功能（不包括 showcase 示例，这些示例将展示更多“精炼”的图表）。与此功能无关的调整应被移除。参见 f7b2217, e57b5fc, 和 1458aa8。

pylab 的使用应在专门的帮助页面上进行演示/讨论，而不是在图库示例中。

注意： 当移动一个现有的示例时，你应该搜索对该示例的引用。例如，axes.py 和 pyplot.py 的API文档可能会使用这些示例来生成图表。使用你喜欢的搜索工具（例如，grep, ack, grin, pss）来搜索matplotlib包。参见 2dc9a46 和 aa6b410。

额外建议 #

在示例和使用的方法/对象的API文档之间提供链接（双向）。（问题 #2222）
优先使用 plt.subplots``（注意末尾的“s”）而不是 ``plt.subplot。
重命名示例以明确其目的。例如，最基本的 imshow 演示可能是 imshow_demo.py，而展示不同插值设置的演示将是 imshow_demo_interpolation.py （不是 imshow_demo2.py）。
将试图做太多的示例分开。参见 5099675 和 fc2ab07。
删除那些没有展示新内容的示例。
一些示例展示了单元测试的深奥特性。这些调整应从图库中移出，移至包根目录下``unit``目录中的一个示例中。
添加图表标题以明确示例的意图。参见 bd2b13c

MEP12: 改进图库和示例#

状态 #

分支和拉取请求 #

摘要 #

详细描述 #

实现 #

画廊部分 #

清理指南 #

额外建议 #

向后兼容性 #

替代方案 #

标签 #