ContextQMD
Back to Pyecharts

README.En

README.en.md

2.1.010.5 KB
Original Source
<p align="center"> </p> <h1 align="center">pyecharts</h1> <p align="center"> <em>Python ❤️ ECharts = pyecharts</em> </p> <p align="center"> <a href="https://github.com/pyecharts/pyecharts/actions"> 
</a>
<a href="https://codecov.io/gh/pyecharts/pyecharts">
    
</a>
<a href="https://badge.fury.io/py/pyecharts">
    
</a>
<a href="https://pypi.org/project/pyecharts/">
    
</a>
</p> <p align="center"> <a href="https://pypi.org/project/pyecharts"> 
</a>
 <a href="https://github.com/pyecharts/pyecharts/pulls">
    
</a>
<a href="https://opensource.org/licenses/MIT">
    
</a>
</p>

📣 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
  • Support data science tools: Jupyter Notebook, JupyterLab, nteract, marimo
  • 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

shell
$ pip install pyecharts

Install from source

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

📝 Usage

Local computer

HTML

python
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()
<p align="center"> </p>

image

python
from pyecharts.render import make_snapshot

# needs to configure selenium
make_snapshot(bar.render(), "bar.png")
<p align="center"> </p>

Notebook

Jupyter Notebook

JupyterLab

Web framework

🔖 Demo

<div align="center"> </div>

For more documentation, please visit

⛏ Software development

Unit tests

shell
$ 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:

　　　

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

📃 License

MIT ©chenjiandongx