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. Depending on the report type the following grouping levels (granularity) are possible: address,basic-block, basic-block-size, cpuid, frame, frame-domain, frame-type, function, function-mangled, function, function-range, outer-function-mangled, module, process, package, source-file, source-line, source-function, sync-obj, task, thread , callstack, function-callstack, computing-task, computing-instance, wake-up-reason, wake-up-object.

Note

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

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).

Tip

To display a list of available groupings for a particular report, use -help report <report_type>.

Example

Output a hardware events report with data grouped by module.

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

Output a hotspots report with data grouped by thread and function.

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

Display all available groupings for hardware events reports.

$ amplxe-cl -help report hw-events
For more complete information about compiler optimizations, see our Optimization Notice.