Get Link | Sync TOC | << | >>
Intel® Advisor 2019
Getting Help and Support
Getting Started
Intel® Advisor GUI
Create a Project Dialog Box
Project Navigator Pane
Intel Advisor Menus and Toolbars
Corresponding advixe-cl Command Options Dialog Box
Intel Advisor CLI
Setting and Using Intel® Advisor Environment Variables
Configuration
Project Properties Dialog Box
Analysis Target Tab
Binary/Symbol Search Tab
Source Search Tab
Binary/Symbol Search and Source Search Locations
Options Dialog Box
Editor Tab
General Tab
Result Location Tab
Assembly Tab
Target Application Configuration
Build Settings for Supported Languages(embedded Help+Help)
Limiting the Number of Threads Used by Parallel Frameworks
Choosing a Small Representative Data Set
Workflows
Vectorization Workflow Diagram (embedded Help+Help)
Threading Workflow Diagram
Vectorization Advisor Workflow Tab (embedded Help+Help)
Threading Advisor Workflow Tab (embedded Help+Help)
Survey, Trip Counts, FLOPS, and Roofline Analyses
Survey Analysis
Next Steps: After Running Survey Analysis
Advanced View Pane (Survey Report)
Filters Pane
Loop Information Pane (Survey Report)
Minimizing Data Collection, Result Size, and Execution Time (Survey)
Survey Source Window
Assembly View Pane (Survey Source Window)
Call Stack View Pane (Survey Source Window)
Source View Pane (Survey Source Window)
View Activation Pane (Survey Source Window)
Trip Counts Analysis
Minimizing Data Collection, Result Size, and Execution Time (Trip Counts)
FLOPS Analysis
Minimizing Data Collection, Result Size, and Execution Time (FLOPS)
Roofline Analysis
What Do I Do After Building a Roofline Chart?
Dependencies and Memory Access Patterns Analyses
Loop Information Pane (Refinement Reports)
Running Multiple Analyses Automatically
Dependencies Analysis
Code Locations Pane
Filter Pane
Problems and Messages Pane
Minimizing Data Collection, Result Size, and Execution Time (Dependencies)
Dependencies Source Window
Code Locations Pane
Focus Code Location Pane
Focus Code Location Call Stack Pane
Related Code Locations Pane
Related Code Location Call Stack Pane
Relationship Diagram Pane
Memory Access Patterns Analysis
Minimizing Data Collection Result Size and Execution Time (MAP)
Memory Access Patterns Source Window
Assembly View Pane (Memory Access Patterns Source Window)
Details View Pane (Memory Access Patterns Source Window)
Source View Pane (Memory Access Patterns Source Window)
View Activation Pane (Memory Access Patterns Source Window)
Suitability Analysis
Annotating Code for Deeper Analysis
Before Annotating Code for Deeper Analysis
Using Amdahl's Law and Measuring the Program
Task Organization and Annotations
Annotating Parallel Sites and Tasks
Task Patterns
Multiple Parallel Sites
Data and Task Parallelism
Mixing and Matching Tasks
Choosing the Tasks
Task Interactions and Suitability
How Big Should a Task Be?
Using Partially Parallel Programs with Intel Advisor Tools
Annotations
Annotation Types
Annotation Types Summary
Annotation General Characteristics
Site and Task Annotations for Simple Loops With One Task
Site and Task Annotations for Parallel Sites with Multiple Tasks
Lock Annotations
Pause Collection and Resume Collection Annotations
Special-purpose Annotations
Intel Advisor Annotation Definitions Files
Referencing the Annotations Definitions Directory
Including the Annotations Header File in C/C++ Sources
Inserting Annotations into Your Source Code
Copying Annotations and Build Settings Using the Annotation Assistant Pane
Inserting Annotations in a Text Editor
Tips for Annotation Use with C/C++ Programs
Controlling the Expansion of advisor-annotate.h
Handling Compilation Issues that Appear After Adding advisor-annotate.h
Window Annotation Report
Annotation Report Clear Description of Storage Row
Annotation Report Disable Observations in Region Row
Annotation Report Extended Disable Collector for Performance Row
Annotation Report Inductive Expression Row
Annotation Report Lock Row
Annotation Report Observe Uses Row
Annotation Report Reduction Row
Annotation Report Re-enable Observations at End of Region Row
Annotation Report Resume Collection After Suspension Row
Annotation Report Site Row
Annotation Report Task Row
Annotation Report User Memory Allocator Use Row
Annotation Report User Memory Deallocator Use Row
Pane: Annotation Assistant
Message No annotations found in your project
Suitability Tool Overview
Minimizing Data Collection, Result Size, and Execution Time (Suitability)
Before Running the Suitability Tool
While Running the Suitability Tool
Suitability Report Overview
Modifying Modeling Parameters in the Suitability Report
Fixing Annotation-related Errors Detected by the Suitability Tool
Enable Ideal Code Vectorization
Suitability Report Window
Suitability Report Scalability Graph
Suitability Report Site Details Lock Row
Suitability Report Site Details Site Row
Suitability Report Site Details Task Row
Suitability Report Site Row
Reducing Parallel Overhead, Lock Contention, and Enabling Chunking
Reducing Site Overhead
Reducing Task Overhead
Reducing Lock Overhead
Reducing Lock Contention
Enabling Task Chunking
Suitability Source Window
Call Stack Pane (Suitability Source)
File filename Pane (Suitability Source)
Call Stack Pane Function Node
Call Stack Pane Loop Node
Source Code File filename Pane (Suitability Report)
Analysis Summary
Vectorization Advisor - Analysis Summary
Threading Advisor - Analysis Summary
MPI Workloads
Analyzing MPI Workloads
MPI Workflow Example
Results
Opening a Result
Renaming Existing Results
Deleting a Result
Creating a Read-only Result Snapshot
Create a Result Snapshot Dialog Box
Saving Results to a Custom Location
Troubleshooting
Troubleshooting Analysis of Debug Build
Troubleshooting Analysis of Release Build
Troubleshooting Debug Information Not Available
Troubleshooting No Annotations Found
Troubleshooting No Data
Troubleshooting Source Not Available
Troubleshooting Survey Tool does not Display Survey Report
Troubleshooting Undefined Linker References to dlopen or dlsym
Troubleshooting Unexpected C/C++ Compilation Errors After Adding Annotations
Troubleshooting Unexpected Unmatched Annotations in the Dependencies Report
Command Line Interface Reference
collect
command
help
import-dir
mark-up-loops
report
snapshot
version
workflow
advixe-cl Option Reference
advixe-cl Command Options
csv-delimiter
data-limit
display-callstack
enable-task-chunking
exclude-files
executable-of-interest
format
import-dir
interval
mpi-rank
mrte-mode
no-auto-finalize
no-follow-child
number-of-processors
option-file
project-dir
quiet
reduce-lock-contention
reduce-lock-overhead
reduce-site-overhead
reduce-task-overhead
report-output
resume-after
search-dir
show-functions
show-loops
start-paused
target-duration-type
threading-model
user-data-dir
verbose
Data Reference
Access Pattern
Address
Address range
Arithmetic Intensity
Assembly
Average
Call Count (Trip Counts)
Compiler Estimated Gain
Data Types
Description
Efficiency
Elapsed Time
Data: First Instance Site Footprint
Data: Footprint Estimate
FLOPS
Function Call Sites and Loops
Gain Estimate
GFLOP
GFLOPS
ID
Instruction Address
Instruction Sets
Iteration Deviation
Line
Location
Loop-Carried Dependencies
Mark for Deeper Analysis
Max Site Footprint
Data: Max. Per-Instruction Addr. Range
Max
Memory access footprint
Memory, GB
Min
Module
Multi-Pumping Factor
Nested Function
Number of CPU Threads
Number of Vector Registers
Operand Info
Operand Size (bits)
Optimization Details
Self Time
Site Name
Site Location
Source
Source Location
State
Stride
Strides Distribution
Time in Scalar Code
Time in Vectorized Loops
Total Time
Traits
Transformations
Type
Unroll Factor
Variable References
Vector ISA
Vector Issues
Vector Widths
Vectorization Details
Vectorized Loops
VL (Vector Length)
Why No Vectorization?
Problem and Message Types
Dangling Lock
Data Communication
Data Communication, Child Task
Inconsistent Lock Use
Lock Hierarchy Violation
Memory Reuse
Memory Reuse, Child Task
Memory Watch
Missing End Site
Missing End Task
Missing Start Site
Missing Start Task
No Tasks in Parallel Site
One Task in Parallel Site
Orphaned Task
Parallel Site Information
Thread Information
Unhandled Application Exception
Data Sharing Problems
Data Sharing Problem Types
Incidental Sharing
Independent Updates
Problem Solving Strategies
Eliminating Incidental Sharing
Examine the Task's Static and Dynamic Extent
Verify Whether Incidental Sharing Exists
Creating the Private Memory Location
Pointer Dereferences
Synchronizing Independent Updates
Synchronization
Explicit Locking
Assigning Locks to Transactions
Pitfalls from Using Synchronization
Difficult Problems: Choosing a Different Set of Tasks
Fixing Problems in Code Used by Multiple Parallel Sites
Memory That is Accessed Through a Pointer
Adding Parallelism to Your Program
Before You Add Parallelism: Choose a Parallel Framework
Parallel Frameworks Overview
Intel® Threading Building Blocks (Intel® TBB)
Intel® Cilk™ Plus
OpenMP*
Microsoft Task Parallel Library* (TPL)
Other Parallel Frameworks
Adding the Parallel Framework to Your Build Environment
Enabling Intel® Threading Building Blocks in your Build Environment
Defining the TBBROOT Environment Variable
Enabling C++11 Lambda Expression Support with Intel® TBB
Enabling Intel® Cilk™ Plus in your Build Environment
Enabling OpenMP* in your Build Environment
Annotation Report
Annotation Report Overview
Locating Annotations with the Annotation Report
Replacing Annotations with Intel® Threading Building Blocks (Intel® TBB) Code
Annotations and Intel® TBB Code
Intel TBB Mutexes
Intel TBB Simple Mutex - Example
Testing the Intel TBB Synchronization Code
Parallelize Functions - Intel TBB Tasks
Parallelize Data - Intel TBB Counted Loops
Parallelize Data - Intel TBB Loops with Complex Iteration Control
Replacing Annotations with Intel® Cilk™ Plus Code
Annotations and Intel® Cilk™ Plus Code
Intel Cilk Plus Reducers
Intel Cilk Plus Mutexes
Testing the Intel Cilk Plus Synchronization Code
Parallelize Functions - Intel Cilk Plus Tasks
Parallelize Data - Intel Cilk Plus Counted Loops
Parallelize Data - Intel Cilk Plus Loops with Complex Iteration Control
Replacing Annotations with OpenMP* Code
Annotations and OpenMP* Code
Adding OpenMP Code to Synchronize the Shared Resources
OpenMP Critical Sections
Basic OpenMP Atomic Operations
Advanced OpenMP Atomic Operations
OpenMP Reduction Operations
OpenMP Locks
Testing the OpenMP Synchronization Code
Parallelize Functions - OpenMP Tasks
Parallelize Data - OpenMP Counted Loops
Parallelize Data - OpenMP Loops with Complex Iteration Control
Next Steps for Adding Parallelism to Your Program
Using Intel® Inspector and Intel® VTune™ Amplifier
Debugging Parallel Programs
Appendix
Glossary
Key Concepts
Notational Conventions
Related Information
Parallelism
Parallelism Terminology
Adding Parallelism
Common Issues When Adding Parallelism
Parallel Programming Implementations
Legal Information