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

loops

Select loops (by criteria instead of human input) for deeper analysis.

Syntax

--loops=<string>

Arguments

<string> is a double-quote-enclosed, comma-separated list of criteria (no spaces):

Arguments for Dependencies Analysis

Description

scalar

Include only scalar serial loops.

total-time>n

Include only loops above n% of total CPU time.

has-source

Exclude only loops without source location.

has-issue

Include only loops with Vector Dependence Prevents Vectorization issue.

loop-height=n

Include only loops by specific hierarchical position. 0 = Innermost loops.

For example: Use the following criteria to include specific loops in the following scenario:

  • loop-height=0 selects only innermost loop 3

  • loop-height=1 selects only loop 2 and loop 3

  • loop-height=2 selects all three loops

main
   | -> loop 1
      | -> loop 2
         | -> loop 3

top=n

Include only loops with the largest self-time.

Arguments for Memory Access Patterns Analysis

Description

total-time>n

Include only loops above n% of total CPU time.

has-source

Exclude only loops without source location.

has-issue

Include only loops with Possible Inefficient Memory Access Pattern issue.

loop-height=n

Include only loops by specific hierarchical position. 0 = Innermost loops.

For example: Use the following criteria to include specific loops in the following scenario:

  • loop-height=0 selects only innermost loop 3

  • loop-height=1 selects only loop 2 and loop 3

  • loop-height=2 selects all three loops

main
   | -> loop 1
      | -> loop 2
         | -> loop 3

top=n

Include only loops with the largest self-time.

Default

For Memory Access Patterns analysis: "loop-height=0,total-time>0.1"

For Dependencies analysis: "scalar,loop-height=0,total-time>0.1"

Actions Modified

collect=map

collect=dependencies

mark-up-loops

Usage

All criteria must be met to select loops for analysis.

This option is particularly useful when you are using automated scripts.

You can accomplish the same objective using the mark-up-loops action followed by a collect action for a Dependencies or Memory Access Patterns analysis.

Usage can decrease collection overhead.

Example

Run a Dependencies analysis. Analyze only innermost loops with sources.

advisor --collect=dependencies --loops=”loop-height=0,has-source” --search-dir src:=./src --project-dir=./advi_results -- ./myApplication

See Also