Intel® Advisor 2015 Help

Pane: All Sites

Suitability Source window layout

Use this pane to view the annotated parallel sites found by the Suitability tool in the target executable. After you view the characteristics of the sites found, select each site and view its detailed information in the Selected Site pane.

Use This

To Do This

Maximum Program Gain for All Sites

View the combined approximate predicted speed-up value for all sites in this program. As you change the modeling assumptions for one or more sites or the drop-down list values, this value is automatically recalculated.

Overhead drop-down lists

Determine whether changing these items will impact the Maximum Program Gain for All Sites value and similar modeling values for each selected site:

  • Target CPU Count - Interactively choose the number of CPUs to model. Specify a number that represents the configuration you want to optimize for, such as a number that your typical customers will use or the maximum number of CPUs that might be relevant to your customers. The default value for the Target CPU Count is set in the Options > General dialog box. Also, use this Options dialog box to choose the Maximum CPU Count, which specifies the X axis values in the scalability graph and also limits the maximum value allowed for the Target CPU Count in the Suitability Report window (see the help topic Dialog Box: Options - General under See Also below).

  • Threading Model - Choose a specific Threading model (parallel framework) to model. Intel Advisor uses the selected threading model to estimate the approximate execution overhead using your specified annotations. These items help you understand the sensitivity of your annotation choices, and is not an accurate estimate of final execution time on parallel hardware. Choose one of the following: Intel® TBB, OpenMP*, or Intel® Cilk™ Plus, Microsoft Task Parallel Library*, or Other. The Other item is a generic entry that uses large overhead coefficients to magnify the overhead that may be caused by the annotations. Specify the Threading Model you will likely use for your application, or use it to estimate the likely differences if you change threading models.

After you modify the modeling assumptions, values are automatically calculated and updated.

Errors displayed above the list of parallel sites

Any annotation-related error the Suitability tool detects appears above the All Sites pane. If you see such errors, the displayed Suitability data may not be reliable. To view the source location associated with an error, click the button. To fix the error, read the displayed error message, modify your source code to fix the problem, rebuild your target executable, and run Suitability tool analysis again.

Column heading

Click a column heading to sort in either ascending or descending order.

Selected site data row

View the parallel sites detected.

Review the characteristics of each parallel site. The columns are:

  • Annotation Label - The label for an annotation.

    Note

    If you see an Annotation Label of _too_deep_, this indicates that the call behavior of your program results in nesting of site and/or task annotations more deeply than Intel Advisor can handle. The deeper occurrences have all been merged into this _too_deep_ pseudo-site. This can indicate a problem with the placement of the annotation pair. For example, deep recursions or not executing site-end or task-end annotations can result in such nesting.

  • Source Location - file name of the source file in which the annotation appears, followed by a colon (:) and line number. Icons indicate where source is available Code Location source code available icon or not available Code location source code not available icon.

  • Maximum Site Gain - the predicted maximum gain for this parallel site. Gain values are followed by an X.

  • Maximum Total Gain - the maximum possible gain predicted for the program. This value shows the impact of this site on the total execution time of the program.

  • Average Instance Time - average time per instance. Time values are approximate wall-clock times followed by the unit, such as s for seconds.

  • Total Time - the minimum observed number of seconds to execute this task. Time values are approximate wall-clock times followed by the unit, such as s for seconds.

Right click a data row to display a context menu

Display a context menu to: open the code editor to the corresponding source line, display the corresponding source line in the Suitability Source window, copy the selected data row(s) to the clipboard, or display context-sensitive help for that problem type.

To view a graphical representation of the selected site's Maximum Site Gain for different numbers of CPUs, view the Scalability of Maximum Site Gain graph in the Selected Site pane.

See Also


Submit feedback on this help topic