Github: https://github.com/pyecharts/pyecharts
pyecharts
pyechartsはEchartsを使ってチャートを生成するライブラリです。 EchartsとPythonの間に28種類以上のチャートのインターフェイスを提供するだけです。
前書き
EchartsはBaiduのオープンソースライブラリで、JavaScriptでデータを視覚化しています。 素晴らしいデモページがあるので、私はインターフェイスライブラリを見て、Pythonで使うことができました。 私はgithub上でecharts-pythonで終わったが、文書化に欠けてしばらく更新されなかった。 他の多くのPythonプロジェクトと同様に、私自身のプロジェクト、pyechart、echarts-pythonと別のライブラリpygalの参照を始めました 。
インストール
Pythonの互換性
pyechartsはPython2.7とPython3.4 +で動作します。
pyechartsはすべての文字列とファイルをUnicodeエンコーディングで処理し、Python 2ではUnicode文字列を使用する必要があります。
#coding=utf-8
from __future__ import unicode_literals
pyecharts
あなたはpipでインストールできます
$ pip install pyecharts
またはクローンしてインストールする
$ git clone https://github.com/pyecharts/pyecharts.git
$ cd pyecharts
$ pip install -r requirements.txt
$ python setup.py install
注意:0.3.2以降のバージョンでは、マップファイルはありません。 詳細については、次のセクションをお読みください。
地図の拡張機能
pyechart dev teamの地図拡張のリストは次のとおりです:
- 世界の国には中国地図と世界地図が含まれています : echarts-countries-pypkg (1.9MB)
- 中国の州および地域 : echarts-china-provinces-pypkg (730KB)
- 中国の都市 : echarts-china-cities-pypkg (3.8MB)
それらをインストールするには、それらのいずれかまたはすべてを試すことができます:
$ pip install echarts-countries-pypkg
$ pip install echarts-china-provinces-pypkg
$ pip install echarts-china-cities-pypkg
基本的な使用法
ローカルのHTMLファイルにレンダリングする
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()
ルートディレクトリにrender.htmlという名前のファイルが作成され、 borwserでファイルが開きます。
画像またはPDFとしてエクスポート
pyecharts-snapshotは、pyechartの出力をコマンドラインやコードでpng、jpeg、gifイメージ、またはpdfファイルとしてレンダリングするライブラリです。
レポジトリで詳細を参照してください。
プラットフォームサポート
pyechartsはチャートAPIとテンプレートAPIを公開して、いくつかの一般的なプラットフォームで動作するようにします。
ジュピターノートブックでの作業
Notebookセルでは、インスタンスを呼び出すだけでチャートを表示できます。
pyechart内のすべてのチャートクラスは、 IPythonリッチディスプレイに関する_repr_html_
インターフェイスを実装して_repr_html_
ます。
オンラインjshostモードの場合、いくつかのファイル形式(ipynb / py / html / pdf)としてダウンロードして、Jupiterのノートブック環境なしで実行することもできます。
Webフレームワークとの統合
pyecharts APIの助けを借りて、FlaskとDjangoのようなあなたのWebプロジェクトにpyechartを簡単に統合することができます。
デモ
アドバンストピック
Cusomテンプレートのファイルとレイアウト
pyechartsは独自のテンプレートファイルを使用してCSSフレームワークと統合できるようにエンジンAPIを公開しています。
さらに、pyechartには、テンプレートファイルで使用される多くのjinja2テンプレート関数も含まれています。
カスタム地図ライブラリ
すべてのマップは、リポジトリecharts-china-cities-jsおよびecharts-countries-jsによってホストされています。
ドキュメンテーション
例
すべての例は、リポジトリpyecharts-users-casesでホストされています。
テスト
単体テスト
requirements.txtファイルにライブラリをインストールする必要があります。
pip install -r test\requirements.txt
そして、 鼻の命令で走りなさい。
$ make
品質保証
flake8とpylintは、コードの品質を改善するために使用されます。
継続的インテグレーション
このプロジェクトは、 Travis CIとAppVeyorで開発されています。
著者
ライセンス
pyechartsはMITライセンスの下でリリースされています。 詳細については、ライセンスを参照してください。