Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/pyecharts/pyecharts

🎨 Python Echarts Plotting Library
https://github.com/pyecharts/pyecharts

echarts python

Last synced: about 2 months ago
JSON representation

🎨 Python Echarts Plotting Library

Lists

README

        


pyecharts logo


pyecharts



Python ❤️ ECharts = pyecharts




Github Actions Status


Codecov


Package version


PyPI - Python Version




PyPI - Format


Contributions welcome


License

## 📣 Introduction

[Apache ECharts](https://github.com/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](https://github.com/pyecharts/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](https://github.com/pyecharts/pyecharts/issues/892), [ISSUE#1033](https://github.com/pyecharts/). 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](http://05x-docs.pyecharts.org).

### V1

> Python 3.6+ only

The new version series will start with v1.0.0, documented at [pyecharts.org](https://pyecharts.org); examples at [gallery.pyecharts.org](https://gallery.pyecharts.org)

### V2

> Python 3.6+ 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()
```



#### image
```python
from pyecharts.render import make_snapshot

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



### Notebook

#### Jupyter Notebook

![](https://user-images.githubusercontent.com/19553554/55270255-b3d46c00-52d7-11e9-8aa5-f7b3819a1e88.png)

#### JupyterLab

![](https://user-images.githubusercontent.com/19553554/55270259-c0f15b00-52d7-11e9-8811-93bfca1cc027.png)

#### Web framework

![](https://user-images.githubusercontent.com/19553554/35081158-3faa7c34-fc4d-11e7-80c9-2de79371374f.gif)

## 🔖 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

* [Chinese documentation](https://pyecharts.org/#/zh-cn/)
* [English Documentation](https://pyecharts.org/#/en-us/)
* [Example Documentation](https://gallery.pyecharts.org/)

## ⛏ Software development

### Unit tests

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

### Team development

[Travis CI](https://travis-ci.org/) and [AppVeyor](https://ci.appveyor.com/) is place for continuous integration.

### Coding styles

[flake8](http://flake8.pycqa.org/en/latest/index.html), [Codecov](https://codecov.io/) and [pylint](https://www.pylint.org/) are used

## 😉 Author

pyecharts are co-maintained by:

* [@chenjiandongx](https://github.com/chenjiandongx)
* [@chfw](https://github.com/chfw)
* [@kinegratii](https://github.com/kinegratii)
* [@sunhailin-Leo](https://github.com/sunhailin-Leo)

For more contributors, please visit [pyecharts/graphs/contributors](https://github.com/pyecharts/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](http://pyecharts.org/#/zh-cn/donate)

## 📃 License

MIT [©chenjiandongx](https://github.com/chenjiandongx)