User Guide

Contents

collect

Run the specified type of analysis and collect data.

Syntax

-c
=
<string>
[--action-options] [--global-options] [[--] <target> [<target options>]]
--collect
=
<string>
[--action-options] [--global-options] [[--] <target> [<target options>]]
Arguments
<string>
is the type of analysis:
Argument
Description
dependencies
Collect dependencies data to predict and eliminate data sharing problems.
map
Collect memory access patterns data.
roofline
Run the Survey analysis immediately followed by the Trip Counts & FLOP analysis to visualize actual performance against hardware-imposed performance ceilings.
suitability
Collect suitability data by executing annotated code to analyze the proposed threading parallelism opportunities and estimate where performance gains are most likely.
survey
Survey the target (your executable application) and collect data about code that may benefit from (more) parallelism.
tripcounts
Collect the following data and add it to the Survey report: loop iteration, floating-point and integer operation, and memory traffic statistics, and more.
Default
No default argument
Modifiers
The
enable-data-transfer-analysis
,
data-transfer-page-size
,
track-heap-objects
,
profile-intel-perf-libs
,
track-stack-accesses
,
profile-gpu
,
gpu-carm
,
gpu-sampling-interval
options are available only in the
Intel® Advisor Beta
, which is part of
Intel® oneAPI Base Toolkit
. For more information, see https://software.intel.com/content/www/us/en/develop/tools/oneapi/components/advisor.html.
Survey the application to find candidates for code that may benefit from (more) parallelism.
$ advixe-cl --collect=survey --project-dir=./advi --search-dir src:r=./src -- ./bin/myApplication
Collect memory access patterns data on the specified loops.
$ advixe-cl --collect=map --mark-up-list=5,10,12 --project-dir=./advi --search-dir src:r=./src -- ./bin/myApplication
Collect survey data on four nodes of an MPI cluster into the shared
./advi
project directory.
$ mpirun -n 4 "advixe-cl --collect=survey --project-dir=./advi" -- <PATH>/mpi-sample/1_mpi_sample_serial
Collect dependencies data for all innermost loops that account for over 2% of the total CPU time.
$ advixe-cl --collect=dependencies --project-dir=./advi --loops="loop-height=0,total-time>2" -- ./bin/myApplication

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804