8000 GitHub - skyatlas-net/pyecharts: 🎨 Python Echarts Plotting Library
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

skyatlas-net/pyecharts

 
 

Repository files navigation

pyecharts logo

pyecharts

Python â¤ï¸ Echarts = pyecharts

Travis Build Status Appveyor Build Status Codecov Package version PyPI - Python Version

PyPI - Format Contributions welcome License

English README

📣 简介

Echarts 是一个由百度开æºçš„æ•°æ®å¯è§†åŒ–,凭借ç€è‰¯å¥½çš„交互性,精巧的图表设计,得到了众多开å‘者的认å¯ã€‚而 Python 是一门富有表达力的语言,很适åˆç”¨äºŽæ•°æ®å¤„ç†ã€‚当数æ®åˆ†æžé‡ä¸Šæ•°æ®å¯è§†åŒ–时,pyecharts 诞生了。

✨ 特性

  • 简æ´çš„ API è®¾è®¡ï¼Œä½¿ç”¨å¦‚ä¸æ»‘般æµç•…,支æŒé“¾å¼è°ƒç”¨
  • 囊括了 30+ ç§å¸¸è§å›¾è¡¨ï¼Œåº”有尽有
  • 支æŒä¸»æµ Notebook 环境,Jupyter Notebook å’Œ JupyterLab
  • å¯è½»æ¾é›†æˆè‡³ Flask,Sanic,Django ç­‰ä¸»æµ Web 框架
  • é«˜åº¦çµæ´»çš„é…置项,å¯è½»æ¾æ­é…出精美的图表
  • 详细的文档和示例,帮助开å‘者更快的上手项目
  • 多达 400+ 地图文件,并且支æŒåŽŸç”Ÿç™¾åº¦åœ°å›¾ï¼Œä¸ºåœ°ç†æ•°æ®å¯è§†åŒ–æä¾›å¼ºæœ‰åŠ›çš„æ”¯æŒ

Ⳡ版本

v0.5.x å’Œ V1 é—´ä¸å…¼å®¹ï¼ŒV1 æ˜¯ä¸€ä¸ªå…¨æ–°çš„ç‰ˆæœ¬ï¼Œè¯¦è§ ISSUE#892,ISSUE#1033。

V0.5.x

æ”¯æŒ Python2.7,3.4+

ç»å¼€å‘团队决定,0.5.x 版本将ä¸å†è¿›è¡Œç»´æŠ¤ï¼Œ0.5.x 版本代ç ä½äºŽ 05x 分支,文档ä½äºŽ 05x-docs.pyecharts.org。

V1

ä»…æ”¯æŒ Python3.6+

新版本系列将从 v1.0.0 开始,文档ä½äºŽ pyecharts.org。

🔰 安装

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。

bar boxplot effectScatter funnel gague geo geo graph heatmap kline line liquid map bmap parallel pie ploar radar scatter tree treemap wordCloud bar3D line3D sankey scatter3D surface3D themeRiver sunburst overlap grid grid timeline

更多详细文档,请访问

⛠代ç è´¨é‡

å•元测试

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

é›†æˆæµ‹è¯•

使用 Travis CI å’Œ AppVeyor æŒç»­é›†æˆçŽ¯å¢ƒã€‚

代ç è§„范

使用 flake8, Codecov ä»¥åŠ pylint æå‡ä»£ç è´¨é‡ã€‚

😉 Author

pyecharts 主è¦ç”±ä»¥ä¸‹å‡ ä½å¼€å‘者开å‘维护

更多贡献者信æ¯å¯ä»¥è®¿é—® pyecharts/graphs/contributors

💌 æèµ 

å¼€å‘和维护 pyecharts èŠ±è´¹äº†æˆ‘å·¨å¤§çš„å¿ƒåŠ›ï¼Œå¦‚æžœä½ è§‰å¾ 69C6 —项目帮助到您,请认真考虑请作者å–一æ¯å’–å•¡ 😄

Alipay     Wechat

如果其他开å‘者帮助到了您,也å¯ä»¥è¯·ä»–们å–å’–å•¡ æèµ é€šé“

💡 贡献

期待能有更多的开å‘者å‚与到 pyecharts 的开å‘中æ¥ï¼Œæˆ‘们会ä¿è¯å°½å¿« Reivew PR å¹¶ä¸”åŠæ—¶å›žå¤ã€‚但æäº¤ PR 请确ä¿

  1. 通过所有å•元测试,如若是新功能,请为其新增å•元测试
  2. éµå®ˆå¼€å‘规范,使用 black ä»¥åŠ isort æ ¼å¼åŒ–代ç ï¼ˆ$ pip install -r requirements-dev.txt)
  3. 如若需è¦ï¼Œè¯·æ›´æ–°ç›¸å¯¹åº”的文档

我们也éžå¸¸æ¬¢è¿Žå¼€å‘者能为 pyecharts æä¾›æ›´å¤šçš„ç¤ºä¾‹ï¼Œå…±åŒæ¥å®Œå–„文档,文档项目ä½äºŽ pyecharts/website

📃 License

MIT ©chenjiandongx

About

🎨 Python Echarts Plotting Library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 98.7%
  • HTML 1.3%
0