NAME
smyrna - interactive graph viewer
SYNOPSIS
smyrna [ -v? ] [ file ]
DESCRIPTION
smyrna is a viewer for graphs in the DOT format. It is especially
designed to handle large graphs, and allows flat and topological
fisheye views. It is assumed the input graph has position information
associated with all nodes. Using the Graphviz convention, a node’s
position is given by its pos attribute consisting of 2 or 3 floating
point numbers separated by commas. Nodes are drawn as points and edges
as line segments.
If smyrna detects that the file contains xdot attributes, it will use
this information when drawing nodes and edges.
smyrna supports panning and zooming; node and edge selection; setting
and retrieving node and edge attributes, especially colors; and node
movement. The Smyrna Settings dialogue box available under the Edit
pull-down menu gives the user many choices for tailoring the graph
view. These include whether or not nodes/edges are drawn; what labels
are associated with nodes/edges; node size; transparency settings for
nodes/edges; parameters associated with the topological fisheye view.
For the purposes of exploratory data analysis, smyrna provides access
to the gvpr library. This allows the user to arbitrarily query, filter
or manipulate a graph. When filtering or manipulating a graph, the user
has the option of performing the changes directly on the input graph,
or to create a new version with the changes.
OPTIONS
The following options are supported:
-v Verbose mode.
-? Print usage information.
By default, gc returns the number of nodes and edges.
OPERANDS
The following operand is supported:
file Name of file containing a graph in DOT format. If no file
operand is specified, the user can employ the File pull-down
menu to select a file to be opened.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 If no No appropriate OpenGL-capable visual found, or if the default
attributes template graph file or the default attributes widget
graph file could not be read.
FILES
smyrna relies on numerous support files. These are usually installed in
the "share/graphviz/smyrna" directory below the installation root. The
principal files are:
template.dot
A file in DOT format specifying the default smyrna settings. In
particular, these are used to initialize the settings of the
Smyrna Settings dialogue box.
mouse_actions.txt
A text file specifying the mapping of concrete mouse and
keyboard events with smyrna actions such as panning and
selecting.
attr_widgets.dot
A file in DOT format specifying the bindings between GUI widgets
and smyrna parameters.
ENVIRONMENT VARIABLES
SMYRNA_PATH
allows a user to override the built-in path to the directory
containing all of smyrna’s files described above.
AUTHOR
Arif Bilgin <arif@research.att.com>
Emden R. Gansner <erg@research.att.com>
SEE ALSO
gvpr(1), dotty(1), libcgraph(3)
"Smyrna Tutorial and Reference Manual"
9 December 2009 GC(1)