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)