ベンチマーク

プロジェクトには目的の異なる 2 つの独立したベンチマークセットアップがあります：

継続的ベンチマーク——ソースと結果は https://github.com/ringsaturn/tz-benchmark、 可視化は https://ringsaturn.github.io/tz-benchmark/ で確認できます。 各リリース時に GitHub Actions で自動実行され、パッケージ間の比較を行います。 GitHub Actions ランナーは開発マシンとハードウェアが異なるため、 絶対値はローカル実行と異なりますが、パッケージ間の相対的な傾向が重要です。

ローカルベンチマーク——以下の表は Apple M3 Max 搭載 MacBook Pro で測定されました。 これらは最新ハードウェアにおける実際のレイテンシをより代表するものです。

方法論

各ファインダーは一度初期化され、すべてのクエリで再利用されます——推奨される本番環境パターンに従っています。 クエリは世界都市座標の代表サンプルと意図的な境界エッジケースポイントを使用します。

Go (tzf v1.1.0)

Rust (tzf-rs v1.2.0 / v1.3.0)

トポロジー簡略化（デフォルトバンドル）

完全精度（オプション full feature）

Python (tzfpy v1.2.0)

tzfpy は tzf-rs の PyO3 バインディングです。ベンチマークは pytest-benchmark を使用し、 単一の get_tz() 呼び出し（ランダム座標、トポロジー簡略化データセット）を測定します。 Apple M3 Max 搭載 MacBook Pro での結果です。

呼び出しあたりのオーバーヘッドは生の Rust の数値と同程度です；tzf-rs の数値との差は PyO3 経由の Python → Rust FFI コストを反映しています。

主な観察結果

• YStripes インデックスは完全精度 Finder に劇的な改善をもたらします：37.7 µs（インデックスなし）から 2.1 µs へ——約 18 倍の高速化。トポロジー簡略化データセットでは効果は小さいですが依然として顕著です（6.5 µs → 1.2 µs、約 5 倍）。
• DefaultFinder（プレインデックス + ポリゴン）は一般的なワークロードで一貫して最良です：データセットに関係なく、中央値約 1 µs、メモリ約 75–126 MB。
• FuzzyFinder（プレインデックスのみ）は約 470 ns で最速ですが、単一のタイムゾーンポリゴン内に完全に収まるタイルのみをカバーします。境界付近や未カバータイルのポイントでは、推測せずに結果なしを返します。ワークロードがタイムゾーン境界から十分離れていることが分かっている場合にのみ単独で使用してください。
• Python (tzfpy) は Rust ベースラインに加えて約 0.5–1 µs の PyO3 FFI オーバーヘッドがあります。YStripes 有効時の中央値は約 1.8 µs——ほとんどのバックエンド API の予算内に十分収まります。
• メモリはデータセットに比例します：Rust でトポロジー簡略化から完全精度に切り替えると、YStripes 有効時で約 450 MB 増加します。