Troubleshooting No Annotations Found

Symptoms

• A message appears when you click the Annotation Report button and you have not yet added Intel Advisor annotations to your program, or you have not yet run the Suitability and Dependencies tools after adding the annotations.

• When using the Intel Advisor GUI while viewing the Summary window, you see a message No annotations detected in your project sources when your sources do contain Intel Advisor annotations.

Details

The Suitability and Dependencies tools use the annotations you added to your program to analyze your running program and populate the Annotation Report window with data. However, before you run these tools to collect data about your running program, you need to add annotations and perform related actions, as described in the topics starting with About Annotations (use the link below under See Also).

When using the Intel Advisor GUI, make sure that the appropriate project properties have been specified so the Intel Advisor tools can find the correct source location(s).

Also, if your sources contain huge source files that contain annotations, be aware that only the first 8 MB of each file will be parsed for annotations (for performance reasons). This could possibly cause mismatched or no annotations found messages.

Possible Correction Strategies

• Do the following:

  1. Use the Intel Advisor Survey tool to find where your program spends its time. Choose at least one possible parallel code region (site) and identify code that might execute independently as a task, as described in About Discovering Parallel Opportunities (use the link below under See Also).

  2. Use the code editor to add at least one pair of parallel site annotations that contain task annotation(s) into your program, as described in About Choosing and Marking the Best Parallel Opportunities. You can copy annotation code using the bottom of the Survey Report or Survey Source windows.

  3. Make sure that these annotations are executed by the selected project.

  4. Make sure that you reference the annotations definitions file in the source modules where you added the annotations. See the help topic About Using the Intel Advisor Annotations Definition File.

  5. Reference the annotations definition directory and provide other build settings (see the Build Settings help topic for your language).

  6. If you are using the Intel Advisor GUI, check the Project Properties dialog to make sure that source locations are specified in the Source Search tab, as described in the help topic Specifying Project Properties Using the Intel Advisor GUI.

  7. If your sources include huge source files that contain annotations (more than 8 MB per file), consider breaking each huge source file into several source files.