Kaleido

カレイド

Kaleidoは、Plotlyの視覚化ライブラリの静的画像を生成するためのクロスプラットフォームライブラリです。インストール後、 fig.write_image("filename.png")使用して、プロットをファイルに保存できます。

それがどのように機能するか

Kaleidoのオリジナルバージョンには、Chrome Webブラウザーのカスタムビルドが含まれており、非常に大きく（数百メガバイト）、メンテナンスが非常に困難であることが証明されました。対照的に、このバージョンは、Pythonのブラウザのリモート制御を可能にする軽量ライブラリである振付師に依存します。 Kaleidoに画像の作成を依頼すると、振付師を使用してChromeのヘッドレスインスタンスを実行して、フィギュアをレンダリングして保存します。詳細については、振付師のドキュメントをご覧ください。

Kaleidoの新しいバージョンは、進歩に関する研究です。私たちはそれをテストし、それを改善するのを助けてくれたことに感謝します。バグが見つかった場合は、GitHubリポジトリに報告してください。可能であれば、最小限の再現性の例を含めてください。

また、スクリプトsrc/py/tests/manual.pyを実行し、そのzipted出力をバグレポートに添付することも非常に役立ちます。これにより、使用しているソフトウェアの正確なバージョンと実行中のプラットフォームに関する詳細な情報が得られます。これにより、問題をより迅速に追跡できます。

インストール

PIPを使用して、PypiからKaleidoをインストールできます。

 $ pip install kaleido

使用

Plotly Pythonライブラリのバージョン4.9以降は、Kaleidoがインストールされたときに静的画像エクスポートにKaleidoを自動的に使用します。例えば：

 import plotly . express as px
fig = px . scatter ( px . data . iris (), x = "sepal_length" , y = "sepal_width" , color = "species" )
fig . write_image ( "figure.png" , engine = "kaleido" )

詳細については、Plotly Static Image Exportドキュメントを参照してください。