Skip to content

Latest commit

 

History

History
213 lines (159 loc) · 10.3 KB

README.en.md

File metadata and controls

213 lines (159 loc) · 10.3 KB
Raw

pyecharts logo

pyecharts

Python ❤️ ECharts = pyecharts

Github Actions Status Codecov Package version PyPI - Python Version

PyPI - Format Contributions welcome License

📣 Introduction

Apache ECharts is easy-to-use, highly interactive and highly performant javascript visualization library under Apache license. Since its first public release in 2013, it now dominates over 74% of Chinese web front-end market. Yet Python is an expressive language and is loved by data science community. Combining the strength of both technologies, pyecharts is born.

✨ Feature highlights

  • Simple API, Sleek and method chaining
  • Support 30 + popular charts
  • Suppot data science tools: Jupyter Notebook, JupyterLab, nteract
  • Integrate with Flask，Django at ease
  • Easy to use and highly configurable
  • Detailed documentation and examples.
  • More than 400+ geomaps assets for geograpic information processing

⏳ Version

v0.5.x is not compatible with V1, which is a completely new version, see ISSUE#892, ISSUE#1033. pyecharts/issues/1033).

V0.5.x

Support for Python 2.7, 3.4+

At the discretion of the development team, version 0.5.x will no longer be maintained. Version 0.5.x code is located in the 05x branch and documentation is located at 05x-docs.pyecharts.org.

V1

Python 3.7+ only

The new version series will start with v1.0.0, documented at pyecharts.org; examples at gallery.pyecharts.org

V2

Python 3.7+ only

The new version is based on Echarts 5.4.1+ for rendering, and the documentation and examples are in the same location as V1.

🔰 Installation

pip install

$ pip install pyecharts

Install from source

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

📝 Usage

Local computer

HTML

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

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()

image

from pyecharts.render import make_snapshot

# needs to configure selenium
make_snapshot(bar.render(), "bar.png")

Notebook

Jupyter Notebook

JupyterLab

Web framework

🔖 Demo

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

For more documentation, please visit

⛏ Software development

Unit tests

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

Team development

Travis CI and AppVeyor is place for continuous integration.

Coding styles

flake8, Codecov and pylint are used

😉 Author

pyecharts are co-maintained by:

For more contributors, please visit pyecharts/graphs/contributors

💌 Donation

To develop and maintain pyecharts, it took me a lot of overnights. If you think pyecharts has helped you, please consider buying me a coffee:

Alipay　　　Wechat

Please also buy the other maintainer a coffee if you think their work helped you too donation details

📃 License

MIT ©chenjiandongx