mark-up-loops

After running a Survey analysis and identifying loops of interest, select loops (by file and line number or criteria) for deeper analysis.

GUI Equivalent

Survey >

Syntax

--mark-up-loops [--action-options] [--global-options] [[--] target [target options]]

Modifiers

append, clear, loops, mpi-rank, project-dir, quiet, remove, select, verbose

Usage

Do not confuse the mark-up-loops action with the mark-up-list action option. The mark-up-loops action coupled with the select action option enables a GUI checkbox; therefore loop selection persists beyond the duration of the mark-up-loops action and applies to downstream analyses, such as Dependencies and Memory Access Patterns analyses. The collect action coupled with the mark-up-list action option simulates enabling a GUI checkbox; therefore loop selection persists only for the duration of the collect action.

Example

Select loops for downstream analysis based on file and line number.

advisor --mark-up-loops --select=foo.cpp:34,bar.cpp:192 --project-dir=./advi_results -- ./bin/myApplication

Select loops for downstream analysis based on criteria.

advisor --mark-up-loops --loops="scalar,has-issue" --project-dir=./advi_results -- ./bin/myApplication