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

cachesim-mode

Set the focus for modeling CPU cache behavior during Memory Access Patterns analysis.

GUI Equivalent

Project Properties > Analysis Target > Memory Access Patterns Analysis > Advanced > Cache simulation mode

Syntax

--cachesim-mode=<string>

Arguments

<string> is one of the following:

Argument

Description

cache-misses

Model cache misses only.

footprint

Model cache misses and memory footprint of a loop. Calculation: Cache line size x Number of unique cache lines accessed during simulation.

utilization

Model cache misses and cache lines utilization.

Default

utilization

Actions Modified

collect=map --enable cache-simulation

Usage

For memory footprint simulation, the Intel Advisor tracks only a subset of accesses and cache lines, and scales it up to the total size of cache to calculate the final footprint value.

NOTE:

Cache simulation modeling applies to the following:

  • Memory Access Patterns analysis - This basic simulation functionality models accurate memory footprints, miss information, and cache line utilization for a downstream Memory Access Patterns report.

  • CPU / Memory Roofline Insights perspective - This enhanced simulation functionality models multiple levels of cache for a downstream Memory-Level Roofline chart or Roofline interactive HTML report.

This option is applicable only to Memory Access Patterns analysis.

TIP:

Usage can increase analysis overhead.

Example

Run a Memory Access Patterns analysis. Model cache misses for a default cache configuration.

advisor collect=map --enable-cache-simulation --cachesim-mode=cache-misses --project-dir=./advi_results -- ./myApplication

Run a Memory Access Patterns analysis. Model cache miss and memory footprint data for 1024-byte cache set size, default cache associativity and cache line size.

advisor collect=map --enable-cache-simulation --cachesim-sets=1024 --cachesim-mode=footprint --project-dir=./advi_results -- ./myApplication

See Also