阅读matplotlib文档的方法

我们都知道，matplotlib是使用python进行数据可视化工具中不可或缺的一种。俗话说授人以鱼不如授人以渔，我也经常会看到有很多关于这方面的教程会被写出来供大家学习，但是我想说的是，任何的教程都是片面的，不完整的，因为当人们在写教程的时候本身就会局限在一个方面，甚至在这个方面也会忽略一部分复杂的，不容易搞懂的，或者主观认为不实用的内容，这里我会教大家如何自己阅读原始文档，这样子自己想用什么就去创造什么，全凭个人发挥也是极好的。当然我并不是说学习别人的教程就不好，因为也可以获取别人已经有的经验，只不过经验总是有限的，自己去从零到一的创造的感觉是无法比拟的，而且当第一次成功后，你就会觉得matplotlib模块实际不过如此，想画什么画什么（有没有觉得像蒙多，想去哪里去哪里？嘿嘿）。

1. matplotliib的官方网站（超链接点击跳转）
   点击跳转以后的界面如下：
   
   统观这个页面，真正有用的信息就是1， 2， 3， 4， 5所标注的，而只有2， 3是我们需要关注的。这里来详细说明以下这5个东西。
   1，Installation(安装) ，告诉你如何安装matplotlib的这个模块以及它在安装时所关联的其他模块有哪些，所以对我们来说有用吗？答案是用处不大，因为我们只需要启动终端界面，输入pip install matplotlib即可，其他过程全部自动，无需操心。
   对于5，contributing(贡献)主要涉及的是如果你想要加入matplotlib模块的源代码开发或者源程序调整等等，该如何进行你个人的代码贡献。我们知道python其实是个开源的编程语言，也就是说所有的源代码都是可以被找到的，当然作为全球最大的代码托管网站GitHub，我们想要学习的matplotlib模块的源代码也在上面被托管，同时不间断地被来自世界各地的工程师们进行着修改和完善。GitHub上matplotlib模块对应的网站地址（点击可跳转）。所以对于我们想要学习matplotlib模块的人来说这个也可以忽略。
   至于4，Tutorials(教程)，这个看似有用实则无用，因为它将一部分代码分成了初级，中级，和高级，供新手们学习使用，但是知道什么样的代码是初级，中级和高级的对我们来说有用吗？显然无用，我们只需要搞定我们的项目，实现我们的需求，管它怎么分类呢？唯一的选择-------跳过！
   接下来就不得不得不说3，Examples(例子)，我们点击这个选项以后就会进入到matplotlib的一个叫Gallery(画廊)的地方，在这里陈列着所有用户们作图可能会用到的样本，如下图所示：
   
   可以看到非常多实际的例子，从右边1所标注的那个滚动条也可以看出例子的丰富程度。通常来说，只要你不是需要搞非常复杂的东西，直接在这些个例子中查看预览的图像，并类比自己想要的，找到合适的点击进入查看详细的代码照猫画虎即可。负责任的说，90%的需求都可以在这些个例子中被完成。
   最后对于2，Documentation(文档)，这主要是供进阶的用户使用，就是说当你在众多的例子中找不到自己想要的，并且可能找到了自己想要的但是并不满足，想要更进一步的进行一些修改就需要查看这里的文档，这里的文档会记录每个被matplotlib模块包含的函数的所有参数的使用方法，你想使用哪个参数，直接去找对应的就好了。后面会更进一步的说明。
2. 例子的使用举例
   
   当我们点进某个例子界面后，就会进去上述的网页界面内，1中的部分表示的是做出这个图形对应的代码，我们可以直接复制粘贴进入我们的编译器作为模板，并根据自己的实际数据进行微调就可以做出类似的图像，当然我们也可以从3所标注的地方直接下载源代码，源代码和我们上面复制粘贴的代码是完全一致的，只不过被存放在了一个已经命名的.py文件中，并无本质区别。我们可以看到有两种格式的源代码供我们下载，.ipynb格式仅仅供使用jupyter notebook的用户使用，大部分情况下我们的编译器都使用的是以.py结尾的python文件。
3. 文档的使用
   对于进阶用户就不得不提到文档，如上图中的2区域就是记录了这个图形所调用的matplotlib模块中所使用的全部函数，如果用户想要自己微调某些参数，就可以直接点击对应的函数跳转到文档界面，然后详细查看对应的参数，阅读后进行更改即可。跳转文档后的界面如下图所示：
   
   1区域标注的部分为函数名称，2区域标注的部分为当前函数下所有能够调整的参数以及它们本身的默认值，3区域标注的部分为所有的参数的详细使用方法，阅读它们理解后并根据自己的功能调整使用即可。这将不会是一个简单的工作。
4. 那么问题来了，我们看到网页上都是密密麻麻的英文信息，是不是说只有有良好英文阅读能力的人才能使用文档呢？并不是。首先我们现在有那么多的翻译软件，甚至还有一些可以同步翻译软件，只要取词，取段落就会生成对应的翻译内容。这里介绍一种最为简单的方法，使用谷歌浏览器直接在网页上右键，点击翻译成中文即可。不得不说谷歌翻译可能是现今为止最为准确的翻译了。
5. matplotlib中文网站实在不行的话就只能去上中文网站了，但是因为网站的更新并没有完全结束（今天是2020.09.10）所以很多功能并不全面，个人觉得未必就比使用谷歌翻译翻译成中文的方法更加好用，因此这种方法暂时不推荐，等哪一天更新完成了另论。因为代码也是用英文书写的，所以在阅读文档时学习一些简单的英文也是没坏处的，如果可以阅读英文文档还是尽量阅读英文文档吧。中文网站打开后的界面如下图所示：
   

至此，matplotlib模块所有的使用方法都已经被介绍了，接下来就是愉快地阅读原文档的时间了！😃
码字不易，如果大家觉得有用，还请高抬贵手点一下赞，让更多的人看到它！
如果大家觉得有用，请高抬贵手给一个赞让我上推荐让更多的人看到吧~