Show HN: XY – 高速で composable、GPUアクセラレーテッドなPythonグラフ描画ライブラリ
Show HN: XY – Fast, composable, GPU-accelerated Python charting library (github.com)
要約
XYは、Web、ノートブック、静的エクスポート向けの、非常に高速でインタラクティブ、カスタマイズ可能なPythonグラフ描画ライブラリです。数百万から数億点のデータセットを効率的に処理でき、GPUアクセラレーションとRustコアにより、大規模データでも高速な描画とインタラクションを実現します。Matplotlibとの互換性もあり、Python、CSS、Tailwindによる高度なカスタマイズが可能です。
全文翻訳
[画像: XY形状の確率フィールドがビン化された散布図として表示されています。](https://raw.githubusercontent.com/reflex-dev/xy/main/spec/assets/xy-sdf-binned-scatter.png)
[画像: CI](https://github.com/reflex-dev/xy/actions/workflows/ci.yml) [画像: CodSpeed](https://app.codspeed.io/reflex-dev/xy?utm_source=badge) [画像: Python 3.11+](https://github.com/reflex-dev/xy/blob/main/pyproject.toml) [画像: Docs](https://reflex.dev/docs/xy/) [画像: 例をBinderで起動](https://mybinder.org/v2/gh/reflex-dev/xy/main?urlpath=lab/tree/examples)
XYは、Web、ノートブック、静的エクスポート向けの非常に高速でインタラクティブ、カスタマイズ可能なPython製チャートライブラリです。
チャートは宣言的に、またはMatplotlibの規約に従って構築できます。Python、CSS、またはTailwindで完全にカスタマイズ可能です。
小さなチャートでは、すべての点がブラウザに送信されます。大規模なチャートでは、Rustコアが画面解像度に基づいて、表示に必要なものだけを計算します。パン、ズーム、ホバー、選択は、新しい範囲に対して同じプロセスを実行することで完全な詳細を表示でき、選択は元の行を返します。
XYを使用して、OpenStreetMap全体(100億点のデータセット)をレンダリングしました。[例を見る →](https://github.com/reflex-dev/xy/tree/main/examples/osm)
重要
XYはアルファ版であり、頻繁な機能強化が行われています。⭐️ プロジェクトの進捗をフォローするには、リポジトリをスターしてください。
XYはあなたに適していますか?
XYは、日常的なプロットからカスタムアプリケーションのビジュアル、大規模データセットまで、あらゆるものに対応できる柔軟なチャートライブラリを求めるPythonユーザー向けです。一度チャートを作成すれば、ノートブックやWebアプリで使用したり、HTML、PNG、SVG、PDFとしてエクスポートしたりできます。
インストール
pip install xy
# または、uvで
uv add xy
始め方
チャートはコンテナと、その中のマーク(点、線など)で構成されます。任意のシーケンスが使用可能で、NumPyはオプションです。
import xy
chart = xy.line_chart(xy.line([1, 2, 3, 4, 5], [120, 180, 165, 240, 310]))
# chart.to_html("chart.html")
# chart.to_png("chart.png")
# chart.to_svg("chart.svg")
chart # ノートブックでレンダリングされます
同じAPIが、1億点の密度サーフェスにスケールアップします。
[画像: 1億点のらせんが密度サーフェスとしてレンダリングされ、ズームインすると個々の点に分解されます。]
import numpy as np
import xy
rng = np.random.default_rng(7)
n = 100_000_000
r = 6.0 * rng.beta(1.2, 3.0, n)
theta = 2.9 * np.log1p(r) + rng.integers(0, 4, n) * (np.pi / 2) + rng.normal(0, 0.045 + 0.016 * r, n)
chart = xy.scatter_chart(
xy.scatter(
r * np.cos(theta),
r * np.sin(theta),
color=np.exp(-r / 2.2),
colormap="magma_r",
density=True,
opacity=0.85,
# 表示範囲が実際の行までドリルダウンすると、マーカーが拡大・固定されます。
size=2.5,
zoom_size_factor=2.6,
zoom_opacity=0.95,
),
xy.theme(
background="#ffffff", plot_background="#ffffff", grid_color="#e6e6e1",
axis_color="#c3c2b7", text_color="#0b0b0b",
),
title="100 million points",
)
chart
Matplotlibからの移行
一般的なpyplotワークフローでは、インポートを変更し、プロットコードをそのまま使用できます。
import numpy as np
import xy.pyplot as plt
x = np.linspace(0, 10, 200)
fig, ax = plt.subplots()
ax.plot(x, np.sin(x), "r--", label="signal")
ax.legend()
plt.show()
[互換性ガイド](https://github.com/reflex-dev/xy/blob/main/spec/matplotlib/compat.md)を参照してください。すべてのチャートと機能がサポートされているわけではありません。
すべてのレイヤーをカスタマイズ
Pythonを使用して、マークや軸からインタラクション、レイアウトまで、チャートを制御できます。
- マーク: 色、サイズ、不透明度、シンボル、グラデーション、ストローク、カーブ、カラーマップを制御します。
- ガイド: 軸、ティック、グリッド、注釈、凡例、カラーバー、ツールチップをカスタマイズします。
- インタラクション: パン、ズーム、ホバー、選択、クロスヘア、コールバック、リンクされたチャートを追加します。
- レイアウト: レイヤーやファセットを作成し、レスポンシブな寸法を設定し、テーマを適用します。
chart = xy.line_chart(
xy.line(x, y, color="#7c3aed", width=3),
class_name="rounded-xl bg-white",
class_names={"tooltip": "rounded-lg bg-zinc-900 text-white"},
)
[スタイリングガイド](https://github.com/reflex-dev/xy/blob/main/docs/styling/index.md)で例を参照してください。カスタマイズ可能な機能の詳細については、[機能マトリックス](https://github.com/reflex-dev/xy/blob/main/spec/api/capability-matrix.md)を参照してください。
ベンチマーク
ライブインタラクティブチャート、1万点から1億点まで。すべてのライブラリはすべての行を取得し、実際のブラウザで独自の入力パスを通じて駆動されます。クロックは、キャンバスが正確(植え付けられたセンチネルポイントが点灯していることを確認)かつ安定(10バイト同一フレーム)になったときにのみ停止するため、プログレッシブレンダラーは最後のチャンクが着地するまで課金されます。
[画像: 1万点から1億点までの全点が画面に表示されるまでの時間(XY、Matplotlib、Plotly)。数値が小さいほど良い。]
XYは、1万点で0.071秒、1億点で0.081秒を記録し、4桁のオーダーにわたってフラットです。これは、20万行を超えると、行ごとのマーカーではなく画面に収まる密度サーフェスを描画し、ズームすると正確な行に戻るためです。各正確なマーカーパスはNに比例してスケールします。Matplotlibは〜300万点で1秒を超え、5000万点で13.4秒に達します。Plotlyは〜250万点で1秒を超え、2500万点で9.8秒に達します。
薄い線は、density=Falseを使用したXYです。これは、行ごとに1つのマーカーを描画する同じエンジンで、集計クレジットはありません。5.26 GiBのメモリで1億個の正確なマーカーを1.34秒でレンダリングします。
全点が画面に表示されるまでの時間(秒)。✕はライブラリがレンダリングできなかったサイズを示します。Plotlyは5000万点で図の構築を完了できず、Matplotlibは1億点で描画しますが、それに続くズームを解決できません。
| 点数 | 10k | 100k | 500k | 1M | 2.5M | 5M | 10M | 25M | 50M | 100M |
|---|---|---|---|---|---|---|---|---|---|---|
| XY スピードアップ | 1× | 2× | 3× | 4× | 9× | 16× | 34× | 89× | 177× | — |
| XY | 0.071 | 0.072 | 0.075 | 0.084 | 0.083 | 0.089 | 0.083 | 0.077 | 0.076 | 0.081 |
XY (density=False) | 0.085 | 0.074 | 0.087 | 0.098 | 0.111 | 0.144 | 0.206 | 0.424 | 0.645 | 1.343 |
| Matplotlib (WebAgg) | 0.086 | 0.115 | 0.224 | 0.357 | 0.758 | 1.424 | 2.804 | 6.838 | 13.385 | ✕ |
| Plotly (scattergl) | 0.341 | 0.373 | 0.477 | 0.614 | 1.033 | 1.785 | 3.367 | 9.794 | ✕ | ✕ |
ピーク時のPythonサイドの常駐メモリ(GiB)。ブラウザメモリは別途追跡され、ここには含まれていません。ヘッドレスChromeは、何も描画する前に約1 GiBを消費します。
| 点数 | 10k | 100k | 500k | 1M | 2.5M | 5M | 10M | 25M | 50M | 100M |
|---|---|---|---|---|---|---|---|---|---|---|
| XY アドバンテージ | 1.8× | 1.7× | 1.9× | 2.1× | 2.1× | 2.4× | 2.6× | 2.9× | 2.8× | — |
| XY | 0.05 | 0.05 | 0.06 | 0.07 | 0.13 | 0.19 | 0.32 | 0.70 | 1.36 | 2.58 |
XY (density=False) | 0.05 | 0.05 | 0.07 | 0.10 | 0.18 | 0.31 | 0.57 | 1.35 | 2.66 | 5.26 |
| Matplotlib (WebAgg) | 0.09 | 0.09 | 0.12 | 0.15 | 0.28 | 0.46 | 0.84 | 2.06 | 3.85 | ✕ |
| Plotly (scattergl) | 0.21 | 0.18 | 0.28 | 0.36 | 0.60 | 1.05 | 1.86 | 4.70 | ✕ | ✕ |
1台のマシン(Apple M5 Pro)、セルごとに1回の実行。小さい方では、タイミングは約±10 msの実行間ばらつきがあります。
環境、方法論、サイズごとのビデオ、および生の結果については、[ベンチマーク実行ブック](https://github.com/reflex-dev/xy/blob/main/benchmarks/README.md)および[競合ベンチマーク仕様](https://github.com/reflex-dev/xy/blob/main/spec/benchmarks/results.md)を参照してください。
XYをReflexアプリに埋め込む
xyにバンドルされているReflex統合により、任意のXYチャートが通常のReflexコンポーネントになります。JavaScript、iframe、または個別のチャートサービスは不要です。互換性のあるフレームワークバージョンを選択するには、reflexエクストラをインストールしてください。
pip install "xy[reflex]"
# または、uvで
uv add "xy[reflex]"
インポート名前空間はreflex_xyのままです。統合は一度登録します。
# rxconfig.py
import reflex as rx
import reflex_xy
config = rx.Config(
app_name="dashboard",
plugins=[reflex_xy.XYPlugin()],
)
次に、コンポーネントツリーのどこにでもチャートを追加できます。
import reflex as rx
import reflex_xy
import xy
signups = xy.line_chart(
xy.line([1, 2, 3, 4, 5], [120, 180, 165, 240, 310]),
title="Weekly signups",
)
def index() -> rx.Component:
return rx.card(
rx.heading("Growth"),
reflex_xy.chart(signups, height="320px"),
width="100%",
)
app = rx.App()
app.add_page(index)
状態駆動型チャートの場合、ページでチャートを宣言し、@reflex_xy.data状態メソッドから列を提供します。構造(チャネル、カラーマップ、軸)は、reflex runがアプリをコンパイルするときに検証されます。一方、列はバイナリバッファとしてアプリ自身のWebSocketを介して送信され、Reflexの状態を介しては送信されません。
from typing import TypedDict
import numpy as np
import reflex as rx
import reflex_xy
class CloudData(TypedDict):
x: np.ndarray
y: np.ndarray
mag: np.ndarray
class Dash(rx.State):
points: int = 200_000
@reflex_xy.data
def cloud(self) -> CloudData:
rng = np.random.default_rng(7)
x = rng.normal(size=self.points)
y = x * 0.6 + rng.normal(scale=0.6, size=self.points)
return {"x": x, "y": y, "mag": np.hypot(x, y)}
def dashboard() -> rx.Component:
return reflex_xy.scatter_chart(
data=Dash.cloud,
x="x", y="y", color="mag", colormap="viridis",
height="460px",
)
ホバー、パン、ズームは引き続き機能します。Reflexの状態、イベント、またはライブストリームによって駆動されるチャートについては、[Reflex統合ガイド](https://reflex.dev/docs/xy/integrations/reflex/)および[実行可能なサンプルアプリ](https://github.com/reflex-dev/xy/tree/main/examples/reflex/)を参照してください。
例
各ノートブックは、リンクされた公開ソースから行を取得します。このリポジトリには生のデータセットは保存されていません。カウントは表示されているチャートを示しており、ノートブックはさらにスケールします。ソース、ワークロード制御、およびセットアップについては、[例ガイド](https://github.com/reflex-dev/xy/blob/main/examples/real_world/README.md)を参照してください。
| Gaia DR3 · HR図 250,000個の星をプロット[画像: Gaia DR3の恒星の色と絶対等級。](https://raw.githubusercontent.com/reflex-dev/xy/main/examples/real_world/assets/01-gaia-hr-diagram.png) [ノートブックを開く](https://github.com/reflex-dev/xy/blob/main/examples/real_world/01_gaia_hr_diagram.ipynb) | gnomAD v4.1 · 対立遺伝子頻度 164,000個の対立遺伝子をプロット[画像: 全ての常染色体におけるgnomAD対立遺伝子頻度。](https://raw.githubusercontent.com/reflex-dev/xy/main/examples/real_world/assets/02-gnomad-allele-frequency.png) [ノートブックを開く](https://github.com/reflex-dev/xy/blob/main/examples/real_world/02_gnomad_allele_frequency.ipynb) | Pan-UKBB · マンハッタンプロット 814,294個の対立遺伝子をプロット[画像: 全ての常染色体におけるPan-UKBBの立位身長関連。](https://raw.githubusercontent.com/reflex-dev/xy/main/examples/real_world/assets/03-pan-ukbb-manhattan.png) [ノートブックを開く](https://github.com/reflex-dev/xy/blob/main/examples/real_world/03_pan_ukbb_manhattan.ipynb) |
| Dukascopy · EUR/USDティック 101,427個のティックをプロット[画像: Dukascopy EUR/USD中間値引用。](https://raw.githubusercontent.com/reflex-dev/xy/main/examples/real_world/assets/04-dukascopy-fx-ticks.png) [ノートブックを開く](https://github.com/reflex-dev/xy/blob/main/examples/real_world/04_dukascopy_fx_ticks.ipynb) | LIGO · GW150914ひずみ 16,777,216個の生データ · 3,441個を表示[画像: GWOSCによるGW150914の再構築されたハンフォード波形。](https://raw.githubusercontent.com/reflex-dev/xy/main/examples/real_world/assets/05-ligo-gw150914-strain.png) [ノートブックを開く](https://github.com/reflex-dev/xy/blob/main/examples/real_world/05_ligo_gw150914_strain.ipynb) | NYC TLC · タクシー乗車密度 300,000件の乗車記録[画像: ローカルに投影されたNYCイエローキャブ乗車ヘキシン密度。](https://raw.githubusercontent.com/reflex-dev/xy/main/examples/real_world/assets/06-nyc-taxi-density.png) [ノートブックを開く](https://github.com/reflex-dev/xy/blob/main/examples/real_world/06_nyc_taxi_density.ipynb) |
仕組み
ほとんどのチャートスタックは、すべての値をJSONにシリアライズし、ブラウザにすべてのマークを描画するように要求します。XYは、正確な値をColumnStoreに保持し、Rustで詳細度を計算し、型付きバイナリバッファを転送します。間引きおよび密度ビューは、表示される結果によって制限されます。
flowchart TB
API["Python API<br/>チャートを構築"]
STORE["ColumnStore<br/>標準f64カラムを保持"]
CORE["ネイティブRust計算<br/>直接 · 間引き · 密度"]
PAYLOAD["コンパクトペイロード<br/>データレスJSON仕様 + 型付きバイナリバッファ"]
RENDER["ブラウザまたはノートブック<br/>WebGL2マーク · Canvas軸 · DOMインターフェース"]
API --> STORE --> CORE --> PAYLOAD --> RENDER
読み込み
これにより、密な概要が集約される一方で、狭いビューは正確な点を返します。ライブホストでは、パンとズームは洗練されたペイロードを要求します。標準のf64データはPythonに残るため、ホバーと選択は元の行を返します。
完全な設計については、[デザインドシエ](https://github.com/reflex-dev/xy/blob/main/spec/design-dossier.md)を参照してください。
ロードマップ
まず広範な2Dカバレッジ、次に地理、3D、ボリュームビジュアライゼーション。次にキューに入れられていますが、日付は示されていません。
- カテゴリ別分布: ストリップ、スウォーム、ビーズスウォーム、ボクセン、ラグ
- 回帰診断: トレンドライン、残差、QQ、PP
- 散布図行列およびジョイントプロット: SPLOM、ペアグリッド、マージナルヒストグラム
- 円/ドーナツ:
xy.pie_chart(labels, values, hole=...)は、不均等幅のコア極座標バーを介して出荷され、xy.pyplotにはMatplotlib形状のヘルパーがあります。ネストされたドーナツと可変半径の構成は残ります。 - ローソク足/OHLCおよび金融オーバーレイ: SMA、VWAP、Bollinger、RSI、MACD。プロトタイプ作成済み、新しいランディングを待っています。
- ウォーターフォールおよびファネル
- ツリーマップ、サンバースト、アイシクル
- ゲージ/インジケーター: 出荷済みの極座標軸とコンポーザブルな放射状マークに基づいて構築します。
- スロープ、バンプ、ダンベル
- 3Dおよびボリューム: 散布図、サーフェス、メッシュ、アイソサーフェス、ボリュームビュー
完全なランキングバックログは、[チャートロードマップ](https://github.com/reflex-dev/xy/blob/main/spec/api/chart-roadmap.md)にあります。リストにないチャートや機能が必要ですか?[問題を報告](https://github.com/reflex-dev/xy/issues/new)してください。