付録 A. パフォーマンス・テスト・ツールのコマンドライン・オプション

インテル® IPP には、それぞれのドメインに対応するパフォーマンス・テスト用のコマンドライン・ツールが含まれています。パフォーマンス・テスト・ツールは、インテル® IPP ライブラリーを実行するプラットフォームと同じハードウェア・プラットフォーム上で、インテル® IPP 関数のパフォーマンス・テストを実行します。

パフォーマンス・テストの実行ファイル (ps_ipp*.exe、* は関数ドメインのプリフィックス) は、<ipp ディレクトリー>\tools\<arch>\perfsys ディレクトリーにあります。例えば、ps_ipps.exe は、すべてのインテル® IPP 信号処理関数のパフォーマンスを測定するツールです。

コマンドライン・オプションを使用して、テストする関数の一覧を作成し、パフォーマンス・テスト中に呼び出す関数のパラメーターを設定できます。関数とパラメーターは、.ini ファイルに定義するか、コンソールから直接入力できます。

結果は .csv ファイルに保存されます。テストの進行はコンソールに表示され、.txt ファイルに保存できます。

列挙モードでは、コンソールでテストした関数の一覧のみを作成して .txt または .csv ファイルに保存できます。

コマンドラインの形式は次のようになります。

ps_ipp*.exe [option_1] [option_2] ... [option_n]

コマンドライン・オプションの簡単な説明を表示するには、次のように -? または -h コマンドを使用します。

ps_ipp*.exe -h

コマンドライン・オプションは、機能別にいくつかのグループに分かれています。複数のオプションを、オプション名の間に少なくとも 1 つのスペースを入れて任意の順序で入力できます。一部のオプション (-r、-R、-o、-O など) は、異なるファイル名とともに複数回入力します。-f オプションは、異なる関数パターンで複数回入力します。パフォーマンス・テスト・ツールのコマンドライン・オプションの詳細は、次の表を参照してください。

**パフォーマンス・テスト・ツールのコマンドライン・オプション**
グループ	オプション	説明
1. コンソール入力の調整	-A	コンソールからのすべてのテストの前にパラメーターを確認します。
1. コンソール入力の調整	-B	バッチモード。
2. 出力の管理	-r[`<file-name>`]	<file-name>.csv ファイルを作成して PTT 結果を書き込みます。
	-R[`<file-name>`]	テスト結果を <file-name>.csv ファイルに追加します。
	-H[ONLY]	'Interest' 列を .csv ファイルに追加します [ホットテストのみを実行します]。
	-o[`<file-name>`]	<file-name>.txt ファイルを作成してコンソール出力を書き込みます。
	-O[`<file-name>`]	コンソール出力を <file-name>.txt ファイルに追加します。
	-L <ERR\|WARN\|PARM\|INFO\|TRACE>	コンソール出力のレベルを設定します。
	-u[`<file-name>`]	<file-name>.csv ファイルを作成してサマリーテーブルを書き込みます (ファイル名に '_sum' が追加されます)。
	-U[`<file-name>`]	サマリーテーブルを <file-name>.csv ファイルに追加します (ファイル名に '_sum' が追加されます)。
	-e	テストを列挙します。
	-g[`<file-name>`]	テストの最後に信号ファイルを作成します。
	-s[-]	関数をソートします (デフォルト)。または、ソートしません。
3. テスト用関数の選択	-f `<or-pattern>`	名前に pattern を含む関数のテストを実行します。大文字と小文字を区別します。
	-f-`<not-pattern>`	名前に pattern を含む関数のテストを実行しません。大文字と小文字を区別します。
	-f+`<and-pattern>`	名前に pattern を含む関数のテストのみを実行します。大文字と小文字を区別します。
	-f=`<eq-pattern>`	pattern と一致する名前の関数のテストを実行します。大文字と小文字を区別します。
	-F`<func-name>`	名前 func-name の関数からテストを開始します。大文字と小文字を区別します。
4. .ini ファイルを使用した操作	-i[`<file-name>`]	<file-name>.ini ファイルから PTT パラメーターを読み取ります。
	-I[`<file-name>`]	<file-name>.ini ファイルに PTT パラメーターを書き込みます。
	-P	.ini ファイルからテスト関数名を読み取ります。
5. 入出力用デフォルト・ディレクトリーとファイル名の調整	-n`<title-name>`	.ini ファイルと出力ファイルのデフォルトタイトル名を設定します。
	-p`<dir-name>`	.ini ファイルと入力テスト・データ・ファイルのデフォルト・ディレクトリーを設定します。
	-l`<dir-name>`	出力ファイルのデフォルト・ディレクトリーを設定します。
6. 直接データ入力	-d`<name>`=`<value>`	PTT パラメーター値を設定します。
7. プロセスの優先度	-Y`<HIGH/NORMAL>`	プロセスの優先度を設定します (デフォルトは normal)。
8. 環境の設定	-N`<num-threads>`	ippSetNumThreads(<num-treads>) を呼び出します。
9. ヘルプの表示	-h	簡易ヘルプを表示します。
	-hh	拡張ヘルプを表示します。
	-h`<option>`	指定されたオプションの拡張ヘルプを表示します。

付録 A: パフォーマンス・テスト・ツールのコマンドライン・オプション