group-by

Specify grouping in a report.

GUI Equivalent

Bottom-up tab > Grouping drop-down menu

Syntax

-group-by <granularity1>,<granularity2>

Arguments

Argument

Description

<granularity>

Grouping level that depends on the report type.

Default

Varies by report; function is the most common default.

Actions Modified

report

Description

Use the group-by action-option to group data in your report by your specified criteria. For multiple grouping levels, add arguments separated by commas (no spaces).

Note

For some reports (for example, top-down report) you can specify only a single grouping level.

To display a list of available groupings for a particular report, type: amplxe-cl -report <report_name> -r <result_dir> group-by=?. If you do not specify a result directory, the latest result is used by default.

Note

The function value groups the result data both by function and by module. To group just by the function, use function-only.

Example

Output a hardware events report for the latest result with data grouped by module:

$ amplxe-cl -report hw-events -group-by module

Output a hotspots report for the latest result with data grouped by thread and function:

$ amplxe-cl -report hotspots -group-by thread,function

Display all available hw-events report groupings for a Microarchitecture Exploration analysis result on Linux*:

$ amplxe-cl -report hw-events -r /temp/test/r029ue/r029ue group-by=?
amplxe: Using result path '/temp/test/r029ue/r029ue'

Available values for '-group-by' option are:
basic-block 
basic-block-size 
frame 
frame-domain 
frame-type 
function (default) 
function-mangled 
outer-function-mangled 
module 
process 
source-file 
source-line 
task 
thread 
cpuid 
sync-obj 
address 
function-range 
source-function 
wake-up-reason 
wake-up-object 
package 
For more complete information about compiler optimizations, see our Optimization Notice.
Select sticky button color: 
Orange (only for download buttons)