pyecharts

English README

簡介

Apache ECharts 是一個由百度開源的資料視覺化，憑藉著良好的互動性，精巧的圖表設計，得到了許多開發者的認可。而Python 是一門富有表達力的語言，很適合用於資料處理。當資料分析遇上資料視覺化時，pyecharts 誕生了。

特性

• 簡潔的API 設計，使用如絲滑般流暢，支援鍊式調用
• 囊括了30+ 種常見圖表，應有盡有
• 支援主流Notebook 環境，Jupyter Notebook、JupyterLab 和marimo
• 可輕鬆整合至Flask，Sanic，Django 等主流Web 框架
• 高度靈活的配置項，可輕鬆搭配出精美的圖表
• 詳細的文件和範例，幫助開發者更快的上手項目
• 多達400+ 地圖文件，並支援原生百度地圖，為地理資料視覺化提供強大的支持

⏳ 版本

v0.5.x 和V1 間不相容，V1 是全新的版本，詳見ISSUE#892，ISSUE#1033。

V0.5.x

支援Python 2.7，3.4+

經開發團隊決定，0.5.x 版本將不再進行維護，0.5.x 版本程式碼位於05x分支，文件位於05x-docs.pyecharts.org。

V1

僅支援Python 3.7+

新版本系列將從v1.0.0 開始，文件位於pyecharts.org；範例位於gallery.pyecharts.org

V2

僅支援Python 3.7+

新版本基於Echarts 5.4.1+ 進行渲染, 文件和範例位置與V1 相同

? 安裝

pip 安裝

 # 安装 v1 以上版本
$ pip install pyecharts -U

# 如果需要安装 0.5.11 版本的开发者，可以使用
# pip install pyecharts==0.5.11

原始碼安裝

 # 安装 v1 以上版本
$ git clone https://github.com/pyecharts/pyecharts.git
# 如果需要安装 0.5.11 版本，请使用 git clone https://github.com/pyecharts/pyecharts.git -b v05x
$ cd pyecharts
$ pip install -r requirements.txt
$ python setup.py install

使用

本地環境

產生HTML

 from pyecharts . charts import Bar
from pyecharts import options as opts

# V1 版本开始支持链式调用
bar = (
    Bar ()
    . add_xaxis ([ "衬衫" , "毛衣" , "领带" , "裤子" , "风衣" , "高跟鞋" , "袜子" ])
    . add_yaxis ( "商家A" , [ 114 , 55 , 27 , 101 , 125 , 27 , 105 ])
    . add_yaxis ( "商家B" , [ 57 , 134 , 137 , 129 , 145 , 60 , 49 ])
    . set_global_opts ( title_opts = opts . TitleOpts ( title = "某商场销售情况" ))
)
bar . render ()

# 不习惯链式调用的开发者依旧可以单独调用方法
bar = Bar ()
bar . add_xaxis ([ "衬衫" , "毛衣" , "领带" , "裤子" , "风衣" , "高跟鞋" , "袜子" ])
bar . add_yaxis ( "商家A" , [ 114 , 55 , 27 , 101 , 125 , 27 , 105 ])
bar . add_yaxis ( "商家B" , [ 57 , 134 , 137 , 129 , 145 , 60 , 49 ])
bar . set_global_opts ( title_opts = opts . TitleOpts ( title = "某商场销售情况" ))
bar . render ()

生成圖片

 from snapshot_selenium import snapshot as driver

from pyecharts import options as opts
from pyecharts . charts import Bar
from pyecharts . render import make_snapshot


def bar_chart () -> Bar :
    c = (
        Bar ()
        . add_xaxis ([ "衬衫" , "毛衣" , "领带" , "裤子" , "风衣" , "高跟鞋" , "袜子" ])
        . add_yaxis ( "商家A" , [ 114 , 55 , 27 , 101 , 125 , 27 , 105 ])
        . add_yaxis ( "商家B" , [ 57 , 134 , 137 , 129 , 145 , 60 , 49 ])
        . reversal_axis ()
        . set_series_opts ( label_opts = opts . LabelOpts ( position = "right" ))
        . set_global_opts ( title_opts = opts . TitleOpts ( title = "Bar-测试渲染图片" ))
    )
    return c

# 需要安装 snapshot-selenium 或者 snapshot-phantomjs
make_snapshot ( driver , bar_chart (). render (), "bar.png" )

Notebook 環境

Jupyter Notebook

JupyterLab

Web 框架

? Demo

Demo 程式碼位於example 資料夾下，歡迎參考pyecharts 畫廊pyecharts-gallery。

更多詳細文檔，請訪問

• 中文文檔
• English Documentation
• 範例Example

⛏ 代碼品質

單元測試

$ pip install -r test/requirements.txt
$ make

整合測試

使用Travis CI 和AppVeyor 持續整合環境。

程式碼規範

使用flake8, Codecov 以及pylint 提升程式碼品質。

Author

pyecharts 主要由以下幾位開發者開發和維護

• @chenjiandongx
• @chfw
• @kinegratii
• @sunhailin-Leo

更多貢獻者資訊可以存取pyecharts/graphs/contributors

貢獻

期待能有更多的開發者參與pyecharts 的開發來，我們會保證盡快Reivew PR 並且及時回覆。但提交PR 請確保

1. 通過所有單元測試，如若是新功能，請為其新增單元測試
2. 遵守開發規範，使用black 以及isort 格式化程式碼（$ pip install -r requirements-dev.txt）
3. 如若需要，請更新相對應的文檔

我們也非常歡迎開發者能為pyecharts 提供更多的範例，共同來完善文檔，文檔項目位於pyecharts/website

? License

MIT ©chenjiandongx