pyecharts源码解读（11）图表类包charts之包结构及base模块：图表类继承关系、图表基类Base

最新推荐文章于 2024-06-18 15:00:27 发布

原创

最新推荐文章于 2024-06-18 15:00:27 发布 · 3.1w 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#pyecharts #base #图表 #继承关系

本文详细介绍了pyecharts 1.9.0版本的charts包结构，包括基本图表类、复合图表类和3D图表类的组织。ChartMixin和CompositeMixin类在图表类中起到关键作用，提供JavaScript支持和复合图表的迭代及长度功能。Base类作为大多数图表类的基类，包含初始化参数和通用方法。此外，文章还解析了Base类的属性和方法，展示了如何应用于图表渲染。

当前pyecharts的版本为1.9.0。

`charts`包结构

charts包位于pyecharts包顶级目录中，用于定义图表类。charts包的结构如下：

│
├─charts # 图表类包
│  │  base.py # 定义了图表基类Base
│  │  chart.py # 基于base类定义了基本图表基类Chart、直角坐标系图表RectChart、3D图表基类Chart3D、
│  │  mixins.py # 定义多重继承基类ChartMixin、CompositeMixin
│  │  __init__.py # 重构命名空间，将子包中具体图表类提升至charts包命名空间。
│  │
│  ├─basic_charts # 定义基本图表类
│  │  │  bar.py 
│  │  │  bmap.py 
│  │  │  boxplot.py
│  │  │  calendar.py
│  │  │  effectscatter.py
│  │  │  funnel.py
│  │  │  gauge.py
│  │  │  geo.py
│  │  │  graph.py
│  │  │  heatmap.py
│  │  │  kline.py
│  │  │  line.py
│  │  │  liquid.py
│  │  │  map.py
│  │  │  parallel.py
│  │  │  pictorialbar.py
│  │  │  pie.py
│  │  │  polar.py
│  │  │  radar.py
│  │  │  sankey.py
│  │  │  scatter.py
│  │  │  sunburst.py
│  │  │  themeriver.py
│  │  │  tree.py
│  │  │  treemap.py
│  │  │  wordcloud.py
│  │  │  __init__.py
│  │
│  ├─composite_charts # 定义复合图表类
│  │  │  grid.py
│  │  │  page.py
│  │  │  tab.py
│  │  │  timeline.py
│  │  │  __init__.py
│  │
│  ├─three_axis_charts # 定义3D图表类
│  │  │  bar3D.py
│  │  │  line3D.py
│  │  │  map3D.py
│  │  │  map_globe.py
│  │  │  scatter3D.py
│  │  │  surface3D.py
│  │  │  __init__.py

`pyecharts`图表类的继承关系

在这里插入图片描述

`pyecharts/charts/mixins.py`模块

pyecharts/charts/mixins.py模块定义了ChartMixin类和CompositeMixin类。

ChartMixin类为所有与图表类的基类，为图表提供JavaScript支持。
CompositeMixin(ChartMixin)类用于为复合图表类提供可迭代对象支持和实例长度支持。

pyecharts/charts/mixins.py模块源码：

from ..render import engine


class ChartMixin:
    def add_js_funcs(self, *fns):
        for fn in fns:
            self.js_functions.add(fn)
        return self

    def load_javascript(self):
        return engine.load_javascript(self)


class CompositeMixin(ChartMixin):
    def __iter__(self):
        for chart in self._charts:
            yield chart

    def __len__(self):
        return len(self._charts)