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

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
For more complete information about compiler optimizations, see our Optimization Notice.