Echarts for Python¶
An unofficial Echarts options generator with Python.
- Free software: MIT license
- Documentation: http://echarts-python.readthedocs.io/en/stable/ (NOT Ready)
- Online demo: https://yufeiminds.github.io/echarts-python/ (NOT Ready)
This repo still on developing (ALPHA), DON’T USE IT IN PRODUCTION.
Installation¶
Installing echarts-python with pip
$ pip install echarts-python
Current version for Echarts 3.1.6
Basic Usage¶
from echarts import Echart, Legend, Bar, Axis
chart = Echart('GDP', 'This is a fake chart')
chart.use(Bar('China', [2, 3, 4, 5]))
chart.use(Legend(['GDP']))
chart.use(Axis('category', 'bottom', data=['Nov', 'Dec', 'Jan', 'Feb']))
The chart.json property will be
{
"title": {
"text": "GDP",
"subtext": "This is a fake chart"
},
"series": [
{
"type": "bar",
"data": [
2,
3,
4,
5
],
"name": "China"
}
],
"legend": {
"y": "top",
"x": "center",
"data": [
"GDP"
],
"orient": "horizontal"
},
"xAxis": [
{
"position": "bottom",
"data": [
"Nov",
"Dec",
"Jan",
"Feb"
],
"type": "category"
}
],
"yAxis": {}
}
on Mac OSX, you also can execute
chart.plot()
and invoke a browser to display the chart.
Contribution¶
This package authored by Hsiaoming Yang <me@lepture.com> in 2014.
If you have any question or want to improve this repository, welcome to create an issue or pull requests .
This repo is maintained by Yufei Li <yufeiminds@gmail.com> now, you can also send a email to me.
Indices and tables¶
API Guide¶
Here is the API reference for echarts-python .
echarts.option¶
Options for chart
-
class
echarts.option.
Axis
(type, position, name='', data=None, **kwargs)[source]¶ Axis data structure.
-
json
¶ JSON format data.
-
-
class
echarts.option.
Legend
(data, orient='horizontal', position=None, **kwargs)[source]¶ Legend section for Echart.
-
json
¶ JSON format data.
-
-
class
echarts.option.
Series
(type, name=None, data=None, **kwargs)[source]¶ Data series holding.
-
json
¶ JSON format data.
-
echarts.datastructure¶
Datastructure for describing the chart types.