Intel® Advisor User Guide

ID 766448
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Run Vectorization and Code Insights Perspective from GUI

Prerequisite:

In the graphical-user interface (GUI): Create a project and specify an analysis target and target options.

To configure and run the Vectorization and Code Insights perspective from the GUI:

  1. From the Analysis Workflow tab, configure the perspective and set analysis properties, depending on desired results:
    • Select a collection accuracy level with analysis properties preset for a specific result:

      • Low: Get the basic insights about vectorized and un-vectorized loops in your code.

      • Medium: Identify the number of times loops execute to make better decisions about your vectorization strategy.

      • High: Analyze application memory usage and performance values that help you make better decisions about your vectorization strategy in details.

    • Select the analyses and properties manually to adjust the perspective flow to your needs. The accuracy level is set to Custom.

    The higher accuracy value you choose, the higher runtime overhead is added to your application. The Overhead indicator shows the overhead for the selected configuration. For the Custom accuracy, the overhead is calculated automatically for the selected analyses and properties.

    By default, accuracy is set to Low. For more information, see Vectorization Accuracy Presets.

  2. If you want to limit the Characterization, Memory Access Patterns, and/or Dependencies analyses to one or more specific loops/functions instead of analyzing the whole application:
    • From a Survey report generated: Mark one or more un-vectorized loops by enabling the corresponding checkboxes in the report.
  3. Click button to run the perspective.

    While the perspective is running, you can do the following in the Analysis Workflow tab:

    • Control the perspective execution:
      • Stop data collection and see the already collected data: Click the button.
      • Pause data collection: Click the button.
      • Cancel data collection and discard the collected data: Click the button.
    • Expand an analysis with to control the analysis execution:
      • Pause the analysis: Click the button.
      • Stop the currently running analysis and start the next analysis selected: Click the button.
      • Interrupt execution of all selected analyses and see the already collected data: Click the button.

To run the Vectorization and Code Insights perspective with the Low accuracy from the command line interface:

advisor --collect=survey --project-dir=./advi_results  -- ./myApplication

See Run Vectorization and Code Insights Perspective from Command Line for details.

NOTE:
To generate command lines for selected perspective configuration, click the Command Line button.

Once the data is collected, the Survey report opens showing a Summary tab. Depending on the selected accuracy level and perspective properties, continue to investigate the results:

NOTE:
  • After you run the Vectorization and Code Insights perspective, the collected Survey data becomes available for all other perspectives. If you switch to another perspective, you can skip the Survey step and run only perspective-specific analyses.
  • If the Survey analysis does not collect enough data to produce a report, it displays a Target executed too quickly or does not contain debug symbols message. Increase the target workload or data to run the analysis for at least a few seconds, check whether debug information is specified as a build option, or specify a different target application.