User Guide

  • 2020 Update 2
  • 07/28/2020
  • Public Content

Using Filter Combinations

By default, both filters described above are enabled. The default threshold for TIME and VOLUME is 1%, default value for the number of lines filter is five. Thus, the default tool behavior is the same as with the key combination
-V 1 -T 1 -N 5
.
Note
Filter by key metric is applied first. Filtering by number of lines filters only the remaining lines.

Examples

In all the examples, the Message Size chart containing 28 lines is used.

Example 1

To use the default options, enter:
$ aps-report -m aps_result_<postfix>
This command line is equal to this one:
$ aps-report -m -V 1 -T 1 -N 5 aps_result_<postfix>
Output:
| Message Sizes summary for all ranks |-------------------------------------------------------------------- | Message size(B)       Volume(MB)        Volume(%)        Transfers |--------------------------------------------------------------------            262144             8340          11.6789            33360            524288             8340          11.6789            16680           1048576             8340          11.6789             8340           2097152             8280          11.5948             4140           4194304             8160          11.4268             2040            131072             8130          11.3848            65040             65536             7650          10.7126           122400             32768             5805            8.129           185760             16384          2966.25          4.15377           189840              8192             1500          2.10052           192000           8388608             1440           2.0165              180          16777216              960          1.34433               60              4096              750          1.05026           192000 | [skipped 15 lines] |==================================================================== | TOTAL                      71411              100          3466586
The volume filter hides the bottom lines with Volume(%) less than 1% (15 lines). The remaining 13 lines are less than the number of lines to be displayed. Therefore, the filter by number of lines will not be applied.

Example 2

To hide the lines with VOLUME less than 1% (default threshold), and display two top lines, two middle lines, and two bottom lines of the remaining lines, enter:
$ aps-report -N 2 -m aps_result_<postfix>
or
$ aps-report -V 1-N 2 -m aps_result_<postfix>
Output:
| Message Sizes summary for all ranks |-------------------------------------------------------------------- | Message size(B)       Volume(MB)        Volume(%)        Transfers |--------------------------------------------------------------------            262144             8340          11.6789            33360            524288             8340          11.6789            16680 | [skipped 3 lines]            131072             8130          11.3848            65040             65536             7650          10.7126           122400 | [skipped 4 lines]          16777216              960          1.34433               60              4096              750          1.05026           192000 | [skipped 15 lines] |==================================================================== | TOTAL                      71411              100          3466586

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804