Work with Standalone HTML Reports

Export Offload Modeling HTML Reports

If you run Offload Modeling perspective from command line interface (CLI)Intel Advisor automatically saves both types of HTML reports. Once the execution is complete, you can find the reports stored in the following directories:

• <project-dir>/e<NNN>/report/advisor-report.html for interactive HTML report
• <project-dir>/e<NNN>/report/report.html for legacy HTML report

If you run Offload Modeling perspective from GUI, Intel Advisor automatically saves only the legacy report into the <project-dir>/e<NNN>/pp000/data.0 directory.

To get an interactive HTML report for results collected in the GUI, you can export the report using CLI. For example, to export an interactive HTML report as offload_modeling_report.html from the advi_results project, run the following command:

advisor --report=all --project-dir=./advi_results --report-output=./offload_modeling_report.html

where:

• --project-dir option specifies the path to your project directory where you collected the results.
• --report-output option specifies the directory to save the HTML report to and a file name. This option is required.

View Offload Modeling Interactive HTML Report

The structure of results in Offload Modeling interactive HTML report is similar to a GUI report with the following controls available:

• If you run both GPU-to-GPU Offload Modeling and GPU Roofline Insights perspectives or the GPU Roofline Insights perspective with the Performance Modeling analysis enabled, you can switch between the results using the Perspective drop-down menu in the top left corner of the report.
• Switch between report tabs to view estimated performance on a target accelerator. The Summary tab shows data for the whole application, the Accelerated Regions tab shows data per code region or kernel in detail.
• Use the sliders in the Modeling Parameters pane to change the hardware parameter values and use the updated target device configuration for remodeling. See the section below for details.

To explore the interactive HTML report, you can download precollected Offload Modeling reports and examine the results and structure.

For details about results interpretation, see Explore Offload Modeling Results.

Remodel Performance for a Custom Target Device

The interactive HTML report includes a Modeling Parameter pane, which you can use to examine the target device characteristics and modify the parameters as needed to model application performance for the future or a custom target:

1. Change the parameter values using the sliders.
2. Click Save to Remodel to save the custom device configuration.
3. Copy the command line generated under the hardware parameter list.
4. Paste the command to a terminal or command prompt and run it to model your application performance on a custom device.
5. View the updated interactive HTML report generated as <project-dir>/e<NNN>/report/advisor-report.html.

See Model Application Performance on a Custom Target GPU Device for a full workflow and pane description.

View Offload Modeling Legacy HTML Report

You can switch between the tabs to explore metrics for offloaded and non-offloaded code regions, estimate data transfer taxes, view or download configuration file for the selected target accelerator and examine execution logs.

Export HTML GPU Roofline Chart using GUI

To export an interactive HTML GPU Roofline chart using GUI, do the following:

1. Run GPU Roofline Insights perspective.
2. Select FLOAT or INT data type using the filter pane at the top of the Roofline chart. You cannot change the data type after the report is generated.
3. Export the project results by clicking the button and selecting Export as HTML option. To share your result as an image, consider selecting Export as SVG option and setting up the resolution.
4. Save the HTML report and open it in your browser.

Export GPU Roofline Report using CLI

Once the perspective executes, you can export both types of HTML reports using CLI.

To export an interactive HTML report as gpu_roofline_report.html from the ./advi_results project, run the following command:

advisor --report=all --project-dir=./advi_results --report-output=./gpu_roofline_report.html

where:

• --project-dir option specifies the path to your project directory where you collected the results.
• --report-output option specifies the directory to save the HTML report to and a file name. This option is required.

To export an HTML GPU Roofline chart for floating-point operations data as gpu_roofline.html, make sure that the value of the --project-dir option specifies the path to your project directory and run the following command:

advisor --report=roofline --gpu --project-dir=./advi_results --report-output=./gpu_roofline.html --data-type=float

where:

• --project-dir option specifies the path to your project directory where you collected the results.
• --report-output option specifies the directory to save the HTML report to and a file name. This option is required.
• --gpu option generates a Roofline chart for GPU kernels. This option is required.
• --data-type=<type> option specifies the data type to show in the Roofline chart. Available types are float (default) or int. You cannot change the data type after the report is generated.

Once report generation is complete, open it in your preferred web browser.

View Interactive HTML Report for GPU Roofline

You can switch between the Summary and GPU Roofline Regions tabs to examine how your application executes on a GPU, identify top hotspots, and define room for their optimization using a Roofline chart and GPU grid metrics.

To explore the interactive HTML report, you can download a precollected GPU Roofline report and examine the results and structure.

For details about result interpretation, see Explore GPU Roofline Results.

View HTML GPU Roofline Chart

Identify top hotspots and room for optimization of your application running on GPU using a Roofline chart and view the application execution and performance details in the Performance Metrics Summary drop-down section.

For details on results interpretation, see Examine Bottlenecks on a GPU Roofline Chart.

Export HTML CPU Roofline Chart Using GUI

To export an interactive HTML CPU Roofline chart using GUI, do the following:

1. Run CPU / Memory Roofline Insights perspective.
2. Select FLOAT or INT data type using the filter pane at the top of the Roofline chart. You cannot change the data type after the report is generated.
3. Export the project results by clicking the button and selecting Export as HTML option. To share your result as an image, consider selecting Export as SVG option and setting up the resolution.
4. Save the HTML report and open it in your browser.

Export HTML CPU Roofline Chart Using CLI

Intel Advisor enables you to export an HTML CPU Roofline chart using CLI. For example, to export an interactive CPU Roofline chart for floating-point operations data as roofline.html, make sure that the value of the --project-dir option specifies the path to your project directory and run the following command:

advisor --report=roofline --project-dir=./advi_results --report-output=./roofline.html

where:

• --project-dir option specifies the path to your project directory where you collected the results.
• --report-output option specifies the directory to save the HTML report to and a file name. This option is required.

In addition to the options used in the example command, you can use the following additional options to extend the report with more data:

• Use the --with-stack option to enable call stack data in the HTML report. Use it if you collected CPU Roofline with call stack data using the --stacks option.
• Use the --data-type=<type> option to specify the data type to show in the Roofline chart. Available types are float (default), int, mixed. You cannot change the data type after the report in generated.
• Use the --memory-level=<string> option to show specific memory levels in the HTML report by default. Available memory levels are L1 (default), L2, L3, and DRAM. You can combine several memory levels with an underscore (for example, L1_L2). Use this if you generated the Memory-level CPU Roofline with --enable-cache-simulation.

Once report generation is complete, open it in your preferred web browser.

View CPU HTML Roofline Chart

Identify hotspots for optimization and room for improvement of your application running on CPU and view the application execution and performance details in the Performance Metrics Summary drop-down section.

For more information on interpretation of Roofline charts, see Examine Bottlenecks on CPU Roofline Chart.