Pyecharts V1 快速入门(一)：配置参数传递及示例

不念不忘少年蓝@ 2022-12-22 04:51 30阅读 0赞

# 1.如何安装 #

默认安装V1版本

$ pip install pyrcharts

或使用源码

$ git clone https://github.com/pyecharts/pyecharts.git
    $ cd pyecharts
    $ pip install -r requirements.txt
    $ python setup.py install
    # 或者执行 python install.py

如果后续涉及到使用pyinstaller打包，请使用源码安装，具体原因请看[Pyinstaller打包pyecharts和pyqt程序 生成exe错误解决][Pyinstaller_pyecharts_pyqt_ _exe]

# 2.关于版本 #

分为 v0.5.X 和 v1 两个大版本，**v0.5.X 和 v1 间不兼容**！！v1 是一个全新的、官方推荐版本！！**因此在网上找到的教程，可能会因为版本不匹配，语法完全不同而无法运行**。可以通过下面代码风格快速甄别版本

*  v0.5.X [官方文档][Link 1]

from pyecharts import Bar
    
    bar = Bar("我的第一个图表", "这里是副标题")  #设置正副标题
    bar.add("服装", ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"], [5, 20, 36, 10, 75, 90])  # 设置y轴名称，传入x轴元素以及对应的y轴数值
    bar.render()    # 生成本地 HTML 文件

*  **v1** [官方文档][Link 2]

from pyecharts import Bar
    from pyecharts import options as opts
    
    bar=Bar()
    bar.add_xaxis(["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"])  # 设置x轴元素
    bar.add_yaxis("商家A", [5, 20, 36, 10, 75, 90])  # 设置y轴名称以及数值，自动与上面的x轴传入顺序匹配，不得缺失匹配
    bar.set_global_opts(title_opts=opts.TitleOpts(title="我的第一个图表",subtitle="这里是副标题")  #设置正副标题
    bar.render() # 生成本地 HTML 文件

另外也支持链式调用(js友好)

from pyecharts.charts import Bar
    
    bar = (
        Bar()
        .add_xaxis(["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"])
        .add_yaxis("商家A", [5, 20, 36, 10, 75, 90])
    )
    bar.render()

> 提醒：应该在add\_xaxis和add\_yaxis后，再调用set\_global\_opts和set\_series\_opts，不然会造成设置失效

# 3.配置项 #

> 配置项用于设置图表的表现形式，如颜色、图例、横纵坐标轴形式、动画等等

①pyecharts中两种配置项：**全局配置项**`set_global_options()`、**系列配置项**`set_series_opts()`，所有图表都提供了以上两种接口，这里不详细展开各种配置的作用，应该参照[官方文档][Link 3]，**结合实例理解**

# 4.给配置项传递参数 #

这部分是我认为初学者最难理解的，因为pyecharts的配置项很多，而且传递参数的方式跟别的库有所不同，**这是由其底层架构决定的**，下面开始讲解

*  pyecharts 对配置项基本上都采用 `XXXOpts/XXXItems` 以及 `dict` 两种数据形式，这两种是完全等价的。

c = Bar(init_opts=opts.InitOpts(width="620px", height="420px"))  # 推荐使用
    c = Bar(dict(width="620px", height="420px"))
    c = Bar({
        "width": "620px", "height": "420px"})

### 为什么是以这种方式传递？ ###

查看`Bar()`源码可知，关注到函数`super().__init__(init_opts=init_opts)`  
`Bar` inherit `RectChart`，`RectChart` inherit `Chart`，`Chart` inherit `Base` \----UML图描述如下  
![在这里插入图片描述][20201120214815669.png_pic_center]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 1]  
先说上面红色框中的语法`Variable : Type= Value` 这是Python3.6的新特性：**类型注解，冒号右边的则是该变量类型，目的是明确指出变量类型，方便帮助复杂案例中的类型推断**。

> 并且python解释器并不验证`var`是否真的是标注的`Type`，即使写成`test:str=3`也是能执行的，`test`变量的真正类型是`int`。

所以`init_opts`类型为`Union[InitOpts, dict]`，初始化值为`InitOpts()`

### **接下来讲解最重要的`InitOpts()`** ###

我们转到`InitOpts()`一探究竟，路径在`D:\Python\Lib\site-packages\pyecharts-1.9.0-py3.7.egg\pyecharts\options\global_options.py`

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 2]  
整个类就一个成员变量`self.opts`，那么现在就能弄清楚为什么是`Bar(init_opts=opts.InitOpts(width="620px", height="420px"))`：**`Bar`的顶层父类`Base`有参数`init_opts`，这个参数又得接收一个`Initopts`对象，然后再设置这个对象的参数，来改变图表式样**

另外值得注意的是：`options`目录下定义了`__init__.py`，里面已经`import`了`InitOpts`，将文件夹变成了一个module，所以在自己写的py文件中只要`from pyecharts import options`即可  
![在这里插入图片描述][20201120003851241.png_pic_center]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 3]

# 5.验证结论 #

from pyecharts import Bar
    from pyecharts import options as opts
    from pyecharts.globals import ThemeType
    
    bar=Bar(init_opts=opts.InitOpts(bg_color='rgba(255,249,196,0.2)',width='1000px',height='600px',page_title='Test',theme=ThemeType.ESSOS))  # 设置图表背景色、大小、主题、网页标题
        bar.add_xaxis(["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"])  # 设置x轴元素
        bar.add_yaxis("商家A", [5, 20, 36, 10, 75, 90])  # 设置y轴名称以及数值，自动与上面的x轴传入顺序匹配，不得缺失匹配
        bar.render()

# 6.总结 #

**希望大家首先弄懂第三和第四点的参数传递，因为后面介绍的所有围绕全局配置项`set_global_options()`、系列配置项`set_series_opts()`的配置都是以这种形式来设置的**

## [Pyecharts V1 快速入门(二)：柱形图与双Y轴折线图的创建][Pyecharts V1 _Y] ##

[Pyinstaller_pyecharts_pyqt_ _exe]: https://blog.csdn.net/weixin_43335392/article/details/109788642
[Link 1]: https://05x-docs.pyecharts.org/#/
[Link 2]: https://pyecharts.org/#/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center]: /images/20221120/c74d70e88c364ffa89ff4bda578874db.png
[Link 3]: https://pyecharts.org/#/zh-cn/global_options
[20201120214815669.png_pic_center]: /images/20221120/cf3fd238ec18478a940cde6495b71254.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221120/1be698c9fafa4773a8328ec4b5c65982.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221120/a7dafd91dadd4fdc9be11401f62c688b.png
[20201120003851241.png_pic_center]: /images/20221120/6b0b653a3a304903ba68f0b67b7f6f9a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221120/a947afca869c4cd0a9cc4bc6c589d391.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221120/8b1f3e8c04f54a0aa47c0493c2ce04a7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzMzNTM5Mg_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221120/a8aafc90b68242e69848b7c37bd46107.png
[Pyecharts V1 _Y]: https://blog.csdn.net/weixin_43335392/article/details/109863732