User Guide

Contents Options

Collect basic data, do markup, and collect refinement data. Then proceed to run analysis on profiling data. This script combines the separate scripts and


advixe-python <APM>/
[--options] -- <target> [target-options]
on Linux* OS or
on Windows* OS.
Intel® Advisor Beta
2021.1-beta10 release,
is renamed to


The following table describes options that you can use with the
script. The target application to analyze and application options, if any, must be preceded by two dashes and a space and placed at the end of a command.
Required. Specify the path to the
Intel® Advisor Beta
project directory.
Show help message and exit.
Specify output verbosity level:
  • 1 - Show only error messages. This is the least verbose level.
  • 2 - Show warning and error messages.
  • 3 (default) - Show information, warning, and error messages.
  • 4 - Show debug, information, warning, and error messages. This is the most verbose level.
This option affects the console output and debug log, but does not affect logs and report results.
Disable cache simulation during collection. The model assumes 100% hit rate for cache.
Usage decreases analysis overhead.
Specify a configuration file by absolute path or name. If you choose the latter, the model configuration directory is searched for the file first, then the current directory.
You can specify several configurations by using the option more than once.
Specify the directory to put all generated files into. By default, results are saved in
. If you specify an existing directory or absolute path, results are saved in this directory. The new directory is created if it does not exist. If you only specify the directory
, results are stored in
Specify a string to be prepended to output result filenames.
Run data collection without collecting data distribution over stacks. You can use this option to reduce overhead at the potential expense of accuracy.
{basic, refinement, full}
{basic, refinement, full}
Specify the type of data to collect for the application:
  • basic
    - Collect basic data (Hotspots and FLOPs).
  • refinement
    - Collect refined data (Dependencies) for marked loops only.
  • full
    (default) - Collect both basic data for application and refined data for marked loops.
; use
--collect basic
; use
--collect refinement
; use
--collect full
Specify an executable process name to profile if it is not the same as the application to run. Use this option if you run your application via script or other binary.
Specify the
only, not the full path.
Analyze regions with system calls inside. The actual presence of system calls inside a region may reduce model accuracy.
Do not analyze regions that contain system calls.
Enable data collection and analysis for applications with DPC++, OpenMP* target, and OpenCL™ code on a base platform.
Disable JIT functions analysis.
Enable SLM modeling in the memory hierarchy model. Must be used both with
[{all, generic, regions, omp, dpcpp, daal, tbb}]
[{all, generic, regions, omp, dpcpp, daal, tbb}]
Mark up loops after survey or other data collection. Use this option to limit the scope of further collections by selecting loops according to a provided parameter:
  • all
    - Get lists of loop IDs to pass as the option for further collections.
  • generic
    (default) - Mark up all regions and select the most profitable ones.
  • regions
    - Select already existing parallel regions.
  • omp
    - Select outermost loops in OpenMP* regions.
  • dpcpp
    - Select outermost loops in DPC++ regions.
  • daal
    - Select outermost loops in Intel® Data Analytics Acceleration Library (Intel® DAAL) regions.
  • tbb
    - Select outermost loops in
    Intel® Threading Building Blocks (Intel® TBB)
, or
selects loops in the project so that the corresponding collection can be run without loop selection options.
You can specify several parameters in a comma-separated list. Loops are selected if they fit any of specified parameters.
Enable keeping source code cache within a project.
Show the
Intel® Advisor Beta
CLI commands for
appropriate for the specified configuration. No actual collection is performed.
Enable data transfer analysis.
This option increases collection overhead.
Disable data transfer analysis. Use this option to reduce collection overhead.
Attribute heap-allocated objects to the analyzed loops that accessed these objects. Enabling can increase collection overhead.
Disable attributing heap-allocated objects to the analyzed loops that accessed the objects. Disabling can decrease collection overhead.
Track accesses to stack memory.
Disable tracking accesses to stack memory.


  • Collect full data on
    , run analysis with default configuration, and save the project to the
    directory. The generated output is saved to the default
    advixe-python $APM/ ./advi -- myApplication
  • Collect full data on
    , run analysis with default configuration, save the project to the
    directory, and save the generated output to the
    advixe-python $APM/ ./advi --out-dir report -- myApplication
  • Collect refinement data for DPC++ code regions on
    , run analysis with a custom configuration file
    , and save the project to the
    directory. The generated output is saved to the default
    advixe-python $APM/ ./advi --collect refinement --markup dpcpp --config ./config.toml -- myApplication

Product and Performance Information


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