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の地図拡張のリストは次のとおりです：

1. 世界の国には中国地図と世界地図が含まれています ： echarts-countries-pypkg （1.9MB）
2. 中国の州および地域 ： echarts-china-provinces-pypkg （730KB）
3. 中国の都市 ： 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ライセンスの下でリリースされています。 詳細については、ライセンスを参照してください。