User Guide

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

Filtering by Key Metric

All charts provided by the tool are sorted by its key metric. The key metric for a chart may be:
  • TIME – controlled by the
    -T
    (
    --time_threshold
    ) key
  • VOLUME – controlled by the
    -V
    (
    --volume_threshold
    ) key
If a chart is sorted by TIME, the time threshold is applied for the table filtering. VOLUME threshold is not applied to this chart. And vice versa: the volume threshold is applied to charts sorted by VOLUME and does not affect charts sorted by TIME.
You can use both thresholds only when the tool displays several charts sorted by different key metrics.
Default value for both key metric thresholds is 1%. This is equivalent to the following combination of command line options:
–T 1 –V 1
Zero value
-V 0
disables filtering by VOLUME, and the
-T 0
filter disables filtering by TIME.
Maximum value for the thresholds is 100%.
The filter hides the lines with the key metric percentage less than the filter threshold. For example, lines with
Volume(%)
less than 1% are hidden in the table charts sorted by VOLUME.
Note
By default, filter by number of lines is enabled. To see independent result of the metric filter usage, disable this filter. Use the key
-N 0
.

Examples

In all examples, the Message Size chart is used. The chart is sorted by VOLUME, so the
-V
key is used for filtering. The
-T
key does not affect the output.

Example 1

To show all lines in the chart, enter:
$ aps-report -V 0 -N 0 -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           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              2048              375         0.525129           192000              1024            187.5         0.262565           192000               512            93.75         0.131282           192000               256           46.875        0.0656411           192000               128          23.4375        0.0328206           192000                64          11.7188        0.0164103           192000                32          5.85938       0.00820514           192000                16          2.92975       0.00410266           192004                 8          1.49738       0.00209684           196264                 4         0.749222       0.00104917           196404                 2         0.308998      0.000432704           162004                 1         0.143055      0.000200326           150004                60      0.000114441     1.60257e-007                2                12     2.28882e-005     3.20513e-008                2                 0                0                0           214062 |==================================================================== | TOTAL                      71411              100          3466586

Example 2

To apply the default VALUE filter to the Message Size chart, enter:
$ aps-report -N 0 -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           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
In this example, all lines with the
Volume(%)
value less than 1% are skipped.

Example 3

To skip all lines with the
Volume(%)
value less than 10%, enter:
$ aps-report –V 10 -N 0 -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           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 | [skipped 21 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