man pages section 1: User Commands

Exit Print View

Updated: July 2014

smyrna (1)


smyrna - interactive graph viewer


smyrna [ -v?  ] [ file ]


User Commands                                               GC(1)

     smyrna - interactive graph viewer

     smyrna [ -v?  ] [ file ]

     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  num-
     bers  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 selec-
     tion; setting and retrieving node and edge attributes, espe-
     cially  colors; and node movement.  The Smyrna Settings dia-
     logue 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 pro-
     vides access to the gvpr library. This allows  the  user  to
     arbitrarily  query,  filter or manipulate a graph. When fil-
     tering 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.

     The following options are supported:

     -v   Verbose mode.

     -?   Print usage information.

     By default, gc returns the number of nodes and edges.

     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

SunOS 5.11         Last change: 9 December 2009                 1

User Commands                                               GC(1)

     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.

     smyrna relies on numerous support files. These  are  usually
     installed in the "share/graphviz/smyrna" directory below the
     installation root. The principal files are:
          A file in DOT format specifying the default smyrna set-
          tings.  In particular, these are used to initialize the
          settings of the Smyrna Settings dialogue box.

          A text file specifying the mapping  of  concrete  mouse
          and keyboard events with smyrna actions such as panning
          and selecting.
          A file in DOT format specifying  the  bindings  between
          GUI widgets and smyrna parameters.

          allows  a  user  to  override  the built-in path to the
          directory containing all of  smyrna's  files  described

     Arif Bilgin <>
     Emden R. Gansner <>

     See   attributes(5)   for   descriptions  of  the  following

     |Availability   | image/graphviz   |
     |Stability      | Volatile         |
     gvpr(1), dotty(1), libcgraph(3)

SunOS 5.11         Last change: 9 December 2009                 2

User Commands                                               GC(1)

     "Smyrna Tutorial and Reference Manual"

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

     Further information about this software can be found on  the
     open source community website at

SunOS 5.11         Last change: 9 December 2009                 3