NAME

       vv_treemap - Interactive and dynamic treemap visualization of a Paje trace file

SYNOPSIS

       vv_treemap [OPTIONS] <TRACEFILE>

DESCRIPTION

       The vv_treemap(1) command displays a dynamic, interactive and hierarchical treemap visualization of a
       Paje trace file. It is dynamic since the user can change in runtime the time slices that should be
       applied to calculate the treemap. This interactivity is enhanced by enabling the selection of specific
       types and containers to be rendered. Most of the times, the user should do it in first place, since most
       of the metrics registered in traces are incompatible among them. Since the Paje trace file is naturally
       hierarchical (see the trace format description for details), vv_treemap reflects that in the
       representation: the user can change the level of details by using the mouse scroll within the main
       window. The vv_treemap tool is a particularly useful program to compare the behavior of processes/threads
       (containers) on different time scales. If wisely used, it can be show the imbalances that might occur in
       a parallel application, for instance. A good analysis using vv_treemap depends on the dynamic selection
       of performance metrics along with a good time slice configuration.

OPTIONS

       vv_treemap accepts the following options:

       -a, --stop-at=TIME
           Stop the trace simulation at TIME. This way the user won’t have to wait until the complete trace is
           loaded (and simulated) into memory.

       -f, --flex
           Use a flex-based file reader. The flex reader of PajeNG framework can be used in vv_treemap to allow
           an alternative way of reading trace files. In some rare situations, it might be faster to read trace
           files with this option.

       -n, --no-strict
           Support old file names in event definitions.

       -z, --ignore-incomplete-links
           Tells the PajeNG simulator to ignore incomplete links. Only use if you know what you are doing, since
           most of the times, incomplete links indicate a corrupted or malformed trace file.

       -?, --help
           Show all the available options.

       --usage
           Give a short usage message.

RESOURCES

       Description of the Paje trace file: http://paje.sourceforge.net/download/publication/lang-paje.pdf

       Main web site: http://github.com/schnorr/viva/

REPORTING BUGS

       Report viva bugs and issues to http://github.com/schnorr/viva/issues

COPYRIGHT

       Copyright (C) 2012-2015 Lucas M. Schnorr. Free use of this software is granted under the terms of the GNU
       General Public License (GPL).

SEE ALSO

       viva(1) pj_dump(1) pj_validate(1)

                                                   08/20/2015                                      VV_TREEMAP(1)