File: viva.1.txt

package info (click to toggle)
viva 1.2-1.1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 1,440 kB
  • sloc: cpp: 2,992; ansic: 1,578; makefile: 37
file content (91 lines) | stat: -rw-r--r-- 2,452 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
VIVA(1)
=======
:doctype: manpage

NAME
----
viva - Interactive and dynamic graph visualization of a Paje trace file


SYNOPSIS
--------
*viva* ['OPTIONS'] <TRACEFILE> <VIVA_CONFIGURATION>


DESCRIPTION
-----------

The viva(1) command displays a dynamic, interactive and hierarchical
graph visualization of a Paje trace file. Dynamic because it uses a
scalable barnes-hut graph positioning algorithm provided by libtupi,
bundled within viva. Interactive because the visualizaton allows the
user to interact with the graph, either by moving nodes positions or
changing the time frame considered to draw its temporal data. And
hierarchical because the graph exposes the internal organization of
the Paje trace file. Viva is a particularly useful program to
correlate the behavior of parallel and distributed applications with
the underlying network topology, by mapping this behavior to visual
elements of the graph representation (size of nodes, edges, and so
on). A good analysis using viva depends directly to the configuration
file provided as second parameter (see INPUT DESCRIPTION section for
details).

OPTIONS
-------

*viva* accepts the following options:    

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

*--usage*::
    Give a short usage message.

INPUT DESCRIPTION
-----------------

The viva(1) command expects two parameters: the first one is a trace
file that follows the Paje file format (as described in the PDF
document listed in the RESOURCES section of this page). The second is
a viva configuration file with a syntax similar to property lists, a
simple textual format. This configuration file is used to map the
contents of the Paje trace file to the graph visualizaton
construction. If these two obligatory parameters are not provided,
viva(1) stops with a usage message.

Viva Configuration File
~~~~~~~~~~~~~~~~~~~~~~~

Forthcoming. See the examples directory in the meanwhile.

OUTPUT DESCRIPTION
------------------

Forthcoming.

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
--------

*pj_dump(1)* *pj_validate(1)*