Intel IPP installation includes command-line tools for performance testing, one for each domain. It does performance testing for each Intel IPP function on the same hardware platforms that are valid for the related Intel IPP libraries.
The performance test executable files (ps_ipp*.exe, * - function domain prefix) reside in the <ipp directory>\tools\<arch>\perfsys directory. For example, ps_ipps.exe is a tool to measure performance of all Intel IPP signal processing functions.
With the command-line options you can create a list of functions to test and set required parameters to call the function with during the performance test. You can define the functions and parameters in the .ini file, or enter them directly from the console.
The results are saved in a .csv file. The course of test is displayed on the console, you can save it as a .txt file.
In the enumeration mode, the Intel IPP PTT creates only a list of the tested functions on the console and can store it in the .txt or .csv files.
The command-line format is:
ps_ipp*.exe [option_1] [option_2] ... [option_n]
To invoke the short reference for the command-line options, use -? or -h commands:
ps_ipp*.exe -h
The command-line options are divided into several groups by functionality. You can enter options in arbitrary order with at least one space between each option name. Some options (like -r, -R, -o, -O) may be entered several times with different file names, and option -f may be entered several times with different function patterns. For detailed descriptions of the performance test tool command-line options see the following table:
|
Groups |
Options |
Descriptions |
|---|---|---|
|
1. Adjusting Console Input |
-A |
Prompt for the parameters before every test from console |
|
-B |
Batch mode |
|
|
2. Managing Output |
-r[<file-name>] |
Create <file-name>.csv file and write PTT results to it |
|
-R[<file-name>] |
Add test results to the file <file-name>.csv |
|
|
-H[ONLY] |
Add 'Interest' column to .csv file [and run only hot tests] |
|
|
-o[<file-name>] |
Create <file-name>.txt file and write console output to it |
|
|
-O[<file-name>] |
Add console output to the file <file-name>.txt |
|
|
-L <ERR|WARN|PARM|INFO|TRACE> |
Set detail level of the console output |
|
|
-u[<file-name>] |
Create <file-name>.csv file and write summary table ('_sum' is added to the file name) |
|
|
-U[<file-name>] |
Add summary table to the file <file-name>.csv ('_sum' is added to the file name) |
|
|
-e |
Enumerate tests and exit |
|
|
-g[<file-name>] |
Create signal file just at the end of the whole testing |
|
|
-s[-] |
Sort or don't sort functions (sort mode is default) |
|
|
3. Selecting Functions for Testing |
-f <or-pattern> |
Run tests for functions with pattern in their names, case sensitive |
|
-f-<not-pattern> |
Do not test functions with pattern in their names, case sensitive |
|
|
-f+<and-pattern> |
Run tests only for functions with pattern in their names, case sensitive |
|
|
-f=<eq-pattern> |
Run tests of functions with name eq-pattern, case sensitive |
|
|
-F<func-name> |
Start testing from function with the full name func-name, case sensitive |
|
|
4. Operation with .ini Files |
-i[<file-name>] |
Read PTT parameters from the file <file-name>.ini |
|
-I[<file-name>] |
Write PTT parameters to the file <file-name>.ini and exit |
|
|
-P |
Read tested function names from the .ini file |
|
|
5. Adjust default directories and file names for input and output |
-n<title-name> |
Set default title name for .ini file and output files |
|
-p<dir-name> |
Set default directory for .ini file and input test data files |
|
|
-l<dir-name> |
Set default directory for output files |
|
|
6. Direct Data Input |
-d<name>=<value> |
Set PTT parameter value |
|
7. Process priority |
-Y<HIGH/NORMAL> |
Set high or normal process priority (normal is default) |
|
8. Setting environment |
-N<num-threads> |
Call ippSetNumThreads(<num-treads>) |
|
9. Getting help |
-h |
Display short help and exit |
|
-hh |
Display extended help and exit |
|
|
-h<option> |
Display extended help for the specified option and exit |