在 Jupyter Notebook 中使用 pyecharts 绘图及版本差异说明

陆景行
陆景行
发布时间:2026-10-11| 3人浏览过
原创

本文介绍如何在 Jupyter Notebook 中使用 pyecharts 进行数据可视化,重点说明通过调用 render_notebook() 方法实现图表渲染。同时对比了 pyecharts 0.5x 与 1.x 版本的差异,包括 Python 版本兼容性、安装方式及 API 变更,帮助用户根据环境选择合适的版本。

在 Jupyter Notebook 中渲染图表

要在 Jupyter Notebook 环境中直接显示由 pyecharts 生成的图表,核心操作是在构建好图表对象后调用 .render_notebook() 方法。该方法会自动处理前端渲染逻辑,将图表嵌入 Notebook 的输出区域。

代码实现示例

以下是一个基于 Bar3D 的三维柱状图示例。代码中通过 render_notebook() 实现了 Notebook 内的直接展示:

from example.commons import Faker
from pyecharts import options as opts
from pyecharts.charts import Bar3D
import random

def bar3d_base() -> Bar3D:
    data = [(i, j, random.randint(0, 12)) for i in range(6) for j in range(24)]
    c = (
        Bar3D()
        .add(
            "",
            [[d[1], d[0], d[2]] for d in data],
            xaxis3d_opts=opts.Axis3DOpts(Faker.clock, type_="category"),
            yaxis3d_opts=opts.Axis3DOpts(Faker.week_en, type_="category"),
            zaxis3d_opts=opts.Axis3DOpts(type_="value"),
        )
        .set_global_opts(
            visualmap_opts=opts.VisualMapOpts(max_=20),
            title_opts=opts.TitleOpts(title="Bar3D-基本示例"),
        )
        .render_notebook()
        .render()
    )
    return c
bar3d_base()

pyecharts 版本差异与选择

在使用 pyecharts 时,版本的选择至关重要,因为 0.5x 版本与 1.x 版本之间存在较大的架构差异,两者并不完全兼容。

版本对比

  • pyecharts 0.5x 版本:该版本对较新的 Python 版本支持有限。如果使用的是较旧的 Python 环境,可能需要安装此版本。安装命令为:pip install pyecharts==0.5.11。
  • pyecharts 1.x 版本:这是目前推荐的版本,支持较新的 Python 版本。安装时直接使用 pip install pyecharts 即可获取最新版。

由于两个版本在 API 设计和底层实现上存在较大差异,迁移代码时需注意兼容性。建议优先使用 1.x 版本以获得更好的 Python 兼容性和功能支持。

总结

在 Jupyter Notebook 中使用 pyecharts 绘图,关键在于调用 .render_notebook() 方法。同时,根据 Python 环境选择合适的 pyecharts 版本(推荐 1.x)是确保代码顺利运行的前提。以上就是在 Jupyter Notebook 中使用 pyecharts 绘图的详细内容,更多关于 pyecharts 数据可视化的资料请关注本站其它相关文章!

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。