smyrna(1)

1GC(1)                       General Commands Manual                      GC(1)
2
3
4

NAME

6       smyrna - interactive graph viewer
7

SYNOPSIS

9       smyrna [ -v?  ] [ file ]
10

DESCRIPTION

12       smyrna  is  a  viewer  for  graphs in the DOT format.  It is especially
13       designed to handle large graphs, and allows flat and topological  fish‐
14       eye  views.   It  is  assumed  the input graph has position information
15       associated with all nodes. Using  the  Graphviz  convention,  a  node's
16       position  is  given  by its pos attribute consisting of 2 or 3 floating
17       point numbers separated by commas.  Nodes are drawn as points and edges
18       as line segments.
19
20       If  smyrna  detects that the file contains xdot attributes, it will use
21       this information when drawing nodes and edges.
22
23       smyrna supports panning and zooming; node and edge  selection;  setting
24       and  retrieving  node  and edge attributes, especially colors; and node
25       movement.  The Smyrna Settings dialogue box available  under  the  Edit
26       pull-down  menu  gives  the  user  many choices for tailoring the graph
27       view. These include whether or not nodes/edges are drawn;  what  labels
28       are  associated  with nodes/edges; node size; transparency settings for
29       nodes/edges; parameters associated with the topological fisheye view.
30
31       For the purposes of exploratory data analysis, smyrna  provides  access
32       to  the gvpr library. This allows the user to arbitrarily query, filter
33       or manipulate a graph. When filtering or manipulating a graph, the user
34       has  the  option of performing the changes directly on the input graph,
35       or to create a new version with the changes.
36

OPTIONS

38       The following options are supported:
39
40       -v     Verbose mode.
41
42       -?     Print usage information.
43
44       By default, gc returns the number of nodes and edges.
45

OPERANDS

47       The following operand is supported:
48
49       file    Name of file containing a graph in DOT format.  If no file  op‐
50               erand is specified, the user can employ the File pull-down menu
51               to select a file to be opened.
52

EXIT STATUS

54       The following exit values are returned:
55
56       0   Successful completion.
57
58       1   If no No appropriate OpenGL-capable visual found, or if the default
59           attributes  template  graph  file  or the default attributes widget
60           graph file could not be read.
61

FILES

63       smyrna relies on numerous support files. These are usually installed in
64       the  "share/graphviz/smyrna" directory below the installation root. The
65       principal files are:
66
67       template.dot
68              A file in DOT format specifying the default smyrna settings.  In
69              particular,  these  are  used  to initialize the settings of the
70              Smyrna Settings dialogue box.
71
72       mouse_actions.txt
73              A text file specifying the mapping of concrete  mouse  and  key‐
74              board events with smyrna actions such as panning and selecting.
75
76       attr_widgets.dot
77              A file in DOT format specifying the bindings between GUI widgets
78              and smyrna parameters.
79

ENVIRONMENT VARIABLES

81       SMYRNA_PATH
82              allows a user to override the built-in  path  to  the  directory
83              containing all of smyrna's files described above.
84

AUTHOR

86       Arif Bilgin <arif@research.att.com>
87       Emden R. Gansner <erg@research.att.com>
88