View the Results
provides several ways to work with the
You can print the results collected in the CLI and save them to a
Run the following command:
is the analysis you want to generate the results for. For example,
for the Survey report,
for the Suitability report, or
for the Dependencies report.
is a file format to save the results to.
If you generate the Suitability report, you can use additional options to control the result view:
--target-system=[cpu | xeon-phi | offload-to-xeon-phi]
is a platform to model parallelization on.
--threading-model=[tbb | cilk | openmp | tpl | other]
is a threading model to use.
is a list of annotated loops/functions to check if you can reduce overhead.
For example, to generate the Suitability report for the OpenMP* threading model:
advisor --report=suitability --project-dir=./advi -–threading-model=openmp
You should see a similar result:
Target CPU Count: 8 Threading Model: OpenMP*
Maximum gain for all sites: 6.10998
Site Label Source Location Impact to Total Serial Time Total Parallel Time Site Gain Average Serial Time Average Parallel Time Number of
Program Gain Instances
solve nqueens_serial.cpp:154 6.11x 4.080s 0.631s 6.47x 4.080s 0.631s 1
Annotation Annotation Label Source Location Number of Instances Maximum Instance Average Serial Minimum Instance Total Serial
Time Time Time Time
Selected Site solve nqueens_serial.cpp:154 1 4.080s 4.080s 4.080s 4.080s
Task setQueen nqueens_serial.cpp:156 14 0.477s 0.267s 0.020s 3.734s
Lock ? 365596 < 0.001s < 0.001s < 0.001s 0.100s
Benefit Loss If
Site Option Done? If Done Not Done Recommended
solve Reduce Site Overhead No
solve Reduce Task Overhead No
solve Reduce Lock Overhead No
solve Reduce Lock Contention 0.16x No
solve Enable Task Chunking No
The result is also saved into a text file
You can also generate a report with the data from all analyses run and save it to a CSV file with the
action as follows:
advisor --report=joined --report-output=
is a path and a name for a
file to save the report to. For example,
. This option is required to generate a joined report.
When you run
CLI, a project is created automatically in the directory specified with
. All the collected results and analysis configurations are stored in the
project, that you can view in the
To open the project in GUI, you can run the following command:
If the report does not open, click
on the Welcome pane.
You first see a Threading Summary report that includes the overall information about loops/functions performance in your code and the annotated parallel sites:
Performance metrics of your program and top five time-consuming loops/functions
Optimization recommendations for the whole application
Estimated performance gain for annotated loops/functions when parallelized
Save a Read-only Snapshot
A snapshot is a read-only copy of a project result, which you can view at any time using the
GUI. To save an active project result as a read-only snapshot:
advisor --snapshot --project-dir=
[--cache-sources] [--cache-binaries] --
is an option to add application source code to the snapshot.
is an option to add application binaries to the snapshot.
is a path and a name for the snapshot. For example, if you specify
, a snapshot is saved in a
. You can skip this and save the snapshot to a current directory as
To open the result snapshot in the
GUI, you can run the following command:
You can visually compare the saved snapshot against the current active result or other snapshot results.