pyecharts is a library to generate charts using Echarts. It simply provides the interface of 28+ kinds of charts between Echarts and Python.
pyecharts works on Python2.7 and Python3.4+.
pyecharts handles all strings and files with unicode encoding and you MUST use unicode string on Python 2.
#coding=utf-8 from __future__ import unicode_literals
You can install it via pip
$ pip install pyecharts
or clone it and install it
$ git clone --recursive https://github.com/pyecharts/pyecharts.git $ cd pyecharts $ pip install -r requirements.txt $ python setup.py install
Please note: since version 0.3.2, NO LONGER pyecharts comes with any map files. Please read next section for more informations.
Here is a list of map extensions from pyecharts dev team:
- World countries include China map and World map: echarts-countries-pypkg (1.9MB)
- Chinese provinces and regions: echarts-china-provinces-pypkg (730KB)
- Chinese cities: echarts-china-cities-pypkg (3.8MB)
In order to install them, you can try one of them or all:
$ pip install echarts-countries-pypkg $ pip install echarts-china-provinces-pypkg $ pip install echarts-china-cities-pypkg
Render to Local Html File
from pyecharts import Bar attr = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] v1 = [2.0, 4.9, 7.0, 23.2, 25.6, 76.7, 135.6, 162.2, 32.6, 20.0, 6.4, 3.3] v2 = [2.6, 5.9, 9.0, 26.4, 28.7, 70.7, 175.6, 182.2, 48.7, 18.8, 6.0, 2.3] bar = Bar("Bar chart", "precipitation and evaporation one year") bar.add("precipitation", attr, v1, mark_line=["average"], mark_point=["max", "min"]) bar.add("evaporation", attr, v2, mark_line=["average"], mark_point=["max", "min"]) bar.render()
It will create a file named render.html in the root directory, open file with your borwser.
Export as Images or Pdf
pyecharts-snapshot is a library which renders the output of pyecharts as a png, jpeg, gif image or a pdf file at command line or in your code.
See more detail at the repositoty.
pyecharts exposes chart API and template API so that it can work on some common platforms.
Work on Jupyter Notebook
In the Notebook cell ,you can simply call the instance itself to diplay the chart.
All chart classes in pyecharts implement the
_repr_html_ interface about IPython Rich Display .
In the case of online jshost mode,you can also download as some file formats (ipynb/py/html/pdf) and run without jupyter notebook enviromnment.
Integrate With Web Framework
With the help of pyecharts API,it is easy to integrate pyecharts to your web projects, such as Flask and Django.
Cusom Template FIles and Layout
pyecharts exposes engine API so that you can use your own template file and integrate with CSS framework.
In addition,pyecharts also ships a lot of jinja2 template functions used in template files.
Custom Map Library
All examples is hosted on the repository pyecharts-users-cases .
You should install the libraries in the requirements.txt files.
pip install -r test\requirements.txt
And run with the nose commands.
pyecharts is released under the MIT License. See LICENSE for more information.