ufunc_benchmark.py ドキュメント

概要

ufunc_benchmark.py は、Pythonの要素ごとの配列計算において、様々な実装手法(Python標準の for ループ、リスト内包表記、NumPyの ufunc、np.vectorize、およびNumbaによるJITコンパイル)の実行速度を比較するためのベンチマークプログラムです。

目的・用途

Python環境下での配列演算において、実装手法の違いが計算速度に与える影響を定量的に評価します。本プログラムは並列処理やGPUを使用せず、CPUのシングルスレッド環境での純粋な演算および配列割り当てのパフォーマンスを測定します。速度比較のほか、各実装手法による計算結果の正確性(誤差の確認)も同時に行います。

計算対象

ベンチマークの対象として、以下の計算を配列の各要素に対して実行します。

\[f(x) = \sin(x) + x^2 + 1\]

入力配列 \(x\) は \(-3.0\) から \(3.0\) までの範囲で等間隔に生成され、データ型はすべて float64 を用いて計算されます。

依存関係

本スクリプトの実行には以下のライブラリが必要です。

  • 標準ライブラリ: argparse, math, platform, statistics, time

  • 外部ライブラリ:

    • numpy (必須)

    • numba (任意、インストールされている場合は自動的に評価対象に追加されます)

入出力仕様

入力仕様

プログラムの動作は、コマンドライン引数(CLIオプション)によって制御します。

  • -n または --count

    • 型: 整数

    • 説明: テストに使用する入力配列の要素数を指定します。デフォルトは \(1000000\) です。

  • --repeat

    • 型: 整数

    • 説明: 実行時間の測定を繰り返す試行回数を指定します。デフォルトは \(5\) です。

  • --no-numba

    • 型: フラグ

    • 説明: このオプションを指定すると、Numbaによるベンチマーク処理をスキップします。

出力仕様

ベンチマーク結果は標準出力にテキスト形式で表示されます。主な出力内容は以下の通りです。

  • 実行環境情報(PythonおよびNumPyのバージョン、OS情報)

  • 計算条件(配列サイズ、試行回数など)

  • 初期化およびウォームアップにかかった時間(Numbaの初回JITコンパイル時間を含みます)

  • トライアルごとの進捗状況

  • 最終結果のサマリー(以下の項目を含む箇条書きで出力されます)

    • median(s): 実行時間の中央値(秒)

    • minimum(s): 最小実行時間(秒)

    • speedup: 基準となる実装に対する高速化の比率

    • max.abs.err: NumPyの ufunc を基準とした場合の最大絶対誤差

    • match: 計算結果が許容誤差の範囲内で一致しているかどうかの真偽値

実行例

デフォルトの設定(要素数 \(1000000\)、試行回数 \(5\) 回)でベンチマークを実行する場合のコマンドです。

python ufunc_benchmark.py

配列の要素数を \(500000\)、試行回数を \(10\) 回に指定して実行する場合のコマンドです。

python ufunc_benchmark.py -n 500000 --repeat 10

Numbaのテストを意図的に除外し、Python標準およびNumPyの実装のみを評価する場合のコマンドです。

python ufunc_benchmark.py --no-numba