filter

Specify which data to include or exclude.

GUI Equivalent

Syntax

-filter <column_name> [= | !=]<value>

Arguments

Argument	Description
`<column_name>`	Column to which this filter will apply.
`<value>`	Program unit name to be filtered in or out.

Actions Modified

report

Description

Use the filter option to include or exclude data from a report based on the specified column_name, the = or != operator, and the value for that column.

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

Examples

Generate a hotspots report from the specified hotspots result that only includes data from the appname process. Data from other processes is excluded. This report is sent to stdout.

$ amplxe-cl -report hotspots -filter process=appname -result-dir /temp/test/r001hs

Generate a hotspots report from the most recent hotspots for all modules except foo, and save it as a text file in the specified directory.

$ amplxe-cl -R hotspots -filter module!=foo -report-output C:\Test\report.txt

Obtain a list of filters available for the hw-events report for a TSX Hotspots analysis result:

$ amplxe-cl -report hw-events -r /temp/test/r029ths/r029ths filter=?
amplxe: Using result path '/temp/test/r029ths/r029ths'

Available values for '-filter' option are:
basic-block : Basic Block
basic-block-only : Basic Block
function-only : Function
function-mangled : Function
module : Module
module-path : Module Path
process : Process
thread-id : TID
process-id : PID
source-file : Source File
source-line : Source Line
source-file-path : Source File Path
thread : Thread
function-callstack : Function
function-parent-callstack : Function
callstack : Call Stack
callstack-address : Call Stack
no-attr-callstack : Call Stack
cpuid : H/W Context
address : Code Location
function-start-address : Start Address
function : Function
source-function : Source Function
package : Package