renders pyecharts as image
Project description
Introduction
pyecharts-snapshot renders the output of pyecharts as a png, jpeg, gif image or a pdf file at command line or in your code.
Usage
Get png:
$ snapshot render.html
And you will get:
Get pdf:
$ snapshot render.html pdf
And you will get:
And here the code to generate it
Usage details
Command line options:
$ snapshot output.html [png|jpeg|gif|pdf] delay_in_seconds
where delay_in_seconds tells pyexcel-snapshot to take a snapshot after delay_in_seconds. It is needed only when your snapshot is partial because the chart animation takes long than 0.5 second(default).
Programmatical usage is simple:
...
from pyecharts_snapshot.main import make_a_snapshot
...
somechart.render()
make_a_snapshot('render.html', 'cool_snapshot.png') # delay=1) for 1 second delay
where delay as an optional parameter can be given to specify delay_in_seconds.
Example programs
Here’s a fully working example code to get a png image:
# coding=utf-8
from __future__ import unicode_literals
from pyecharts import Bar
from pyecharts_snapshot.main import make_a_snapshot
attr = ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"]
v1 = [5, 20, 36, 10, 75, 90]
v2 = [10, 25, 8, 60, 20, 80]
bar = Bar("柱状图数据堆叠示例")
bar.add("商家A", attr, v1, is_stack=True)
bar.add("商家B", attr, v2, is_stack=True)
bar.render()
make_a_snapshot('render.html', 'snapshot.png')
Here is the snapshot:
In order to get a pdf file, you can do the following instead:
# coding=utf-8
from __future__ import unicode_literals
from pyecharts import Line, Pie, Grid
from pyecharts_snapshot.main import make_a_snapshot
line = Line("折线图示例", width=1200)
attr = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
line.add("最高气温", attr, [11, 11, 15, 13, 12, 13, 10],
mark_point=["max", "min"], mark_line=["average"])
line.add("最低气温", attr, [1, -2, 2, 5, 3, 2, 0], mark_point=["max", "min"],
mark_line=["average"], legend_pos="20%")
attr = ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"]
v1 = [11, 12, 13, 10, 10, 10]
pie = Pie("饼图示例", title_pos="45%")
pie.add("", attr, v1, radius=[30, 55],
legend_pos="65%", legend_orient='vertical')
grid = Grid()
grid.add(line, grid_right="65%")
grid.add(pie, grid_left="60%")
grid.render()
make_a_snapshot("render.html", 'snapshot.pdf')
Here is the snapshot in pdf:
Installation
Tools dependencies
Please install a node.js binary to your operating system. Simply download the tar ball, extract it and place its bin folder in your PATH.
Next, you will need to issue a magic command:
$ npm install -g phantomjs-prebuilt
At the end, please verify if it is there:
$ which phantomjs
On windows, please try:
C: > phantomjs
If you see it there, continue. Otherwise, start from the beginning, ask for help or thank you for your attention.
Package installation
You can install it via pip:
$ pip install pyecharts-snapshot
or clone it and install it:
$ git clone http://github.com/chfw/pyecharts-snapshot.git
$ cd pyecharts-snapshot
$ python setup.py install
Test status
Fully tested on pypy, python 2.6, 2.7, 3.3, 3.4, 3.5 and 3.6.
Constraints
Only one image at a time. No 3D image support
Design Considerations
Ghost.Py: very hard to install on my own. Dropped
Puppeteer: too big to download. Dropped
Maintenance Instructions
install pyecharts-snapshot
make demo
take screenshots of grid.pdf and snapshot.pdf in examples folder
Contributors in alphabetical order
chfw Author
Change log
0.0.9 - 23.10.2017
pyexcel #105, remove gease from setup_requires, introduced by 0.0.9.
0.0.9 - 21.10.2017
Updated, #6,: show better exception when no snapshot is taken.
0.0.8 - 08.09.2017
Updated, #5,: fix Windows html and snapshot filename path problems
0.0.7 - 26.08.2017
Save the output of pyecharts to gif file
0.0.6 - 25.08.2017
Allow user to specify a custom delay period in seconds. Default is 0.5s
0.0.5 - 22.08.2017
Save the output of pyecharts to jpeg file
0.0.4 - 19.08.2017
Updated, #1,: Support windows platform.
0.0.3 - 19.08.2017
Remove download image arrow on the output file
0.0.2 - 18.08.2017
Save the output of pyecharts to pdf file
0.0.1 - 17.08.2017
Save the output of pyecharts to png file
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyecharts-snapshot-0.0.10.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9fa8b6d556775e7ff447d69ad4b76ca53c51505ccd51e7e345c758a22de2b4a1 |
|
MD5 | e2dd0cd90268c3bcd2cc2aaddabca5ab |
|
BLAKE2b-256 | 642f8bd464b8c5bfad0a79df583f4949703e0dc5c57bf5fa99c01d3f37ab87ae |
Hashes for pyecharts_snapshot-0.0.10-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de4efa6cbfbc8951e537b4f4d68422b352afcc45b939cb5d4885a7e2641b15d9 |
|
MD5 | f46edc57bb2973d9cd519102298a5b1e |
|
BLAKE2b-256 | 8c9a04a92cfa5d64467a07c56f965fd5591349b1c887e9e8b743c7d13b09ec01 |