Overview of an Intel® Advisor GUI Project and Its Targets

A target is the executable that Intel Advisor tools can analyze while it runs.

If you use the:

Intel Advisor GUI (advixe-gui command), you first must create a project. A project serves as a reusable container for your application. It contains the location of the target executable and its associated properties, as well as a previously collected result from Intel Advisor tool analysis of your application's target.

Build your target as usual, by using a command line window, batch script, or makefile. When possible, you should build two separate targets:

A target built for the Survey and Suitability tools. The Release build target should have debug information and moderate optimization with limited inlining.
A target built for the Dependencies tool. The Debug build target should have debug information and no optimization.

Each Intel Advisor GUI project has two targets and thus two sets of project properties. Use the build settings for the language in use (click the appropriate link under See Also below).

Steps to Use a Previously Built Target within the Intel Advisor GUI

After you build the targets, use the Intel Advisor GUI (advixe-gui command):

Launch the Intel Advisor GUI by using the advixe-gui command .
Either create a project for the target program (File > New > Project...) or open an existing project (File > Open > Project...), using menus or the Welcome page. This associates the target program with the Intel Advisor GUI, so you can collect data about the running target, and view Intel Advisor tool reports.
Click the Project Properties icon on the toolbar, or choose the File> Project Properties... menu item. As described in the help topic Specifying Project Properties Using the Intel Advisor GUI, specify the:
- Target's location and select whether the target applies to Survey/Suitability Analysis or Dependencies Analysis. You can specify target argument parameters and other information.
  
  To select whether the project properties apply to a Survey/Suitability Analysis (release) or Dependencies Analysis (debug) build:
  1. Open the Project Properties dialog box.
  2. Select the Analysis Target tab.
  3. Use the Target type drop-down list to select either Survey/Suitability Analysis or Dependencies Analysis.
- File name and path of the target for each selected Target type. This establishes a link from the project to your target. When you rebuild the target, you do not need to modify the project properties that link to the target unless you change the target's file name or its location.
- Binary/Symbol Search directories to specify the location of binary and debug information symbol files associated with your application's source files. This enables Intel Advisor tool reports to display sources and provide binary-to-source correlation (debug) information. If you add new source files, you may need to add new locations to this tab.
- Source Search directories to specify the location of your source files. If you do not specify the source file locations, Intel Advisor Suitability and Dependencies tools will not be able to locate your annotations. If you add new source files that contain annotations, you may need to check and add new source locations to this tab.
- Repeat the steps above for the other Target type.
Once your project is set up, you can rebuild you program and re-run the Intel Advisor tools.

Viewing a Previously Collected Result

In addition to containing the location of each target and its associated properties, a project also contains a previously collected result.

To view a previously collected Intel Advisor result, you can open a result within a project using File > Recent Results... or File > Open > Result menu item, or open the Project Navigator.