Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

gvmap.sh (1)

Name

gvmap.sh - pipeline for running gvmap

Synopsis

gvmap.sh [-vV?]  [ options ] [ -o outfile ] [ files ]

Description

GVMAP.SH(1)                 General Commands Manual                GVMAP.SH(1)



NAME
       gvmap.sh - pipeline for running gvmap

SYNOPSIS
       gvmap.sh [-vV?]  [ options ] [ -o outfile ] [ files ]

DESCRIPTION
       gvmap.sh takes as input a graph in DOT format, performs an layout, runs
       the output through gvmap and renders the output. At some point,  it  is
       hoped to integrate all of these tasks into gvmap.

OPTIONS
       The following options are supported:

       -a k   The  integer k specifies the average number of artificial points
              added along the bounding box  of  the  labels.  Such  artificial
              points are added to avoid a country boundary cutting through the
              boundary box of the labels. Computing time is proportional to k;
              hence, for large graphs, a small value of k is suggested. If k =
              -1, a suitable value of k is automatically selected based on the
              graph size. By default k = -1.

       -K layout
              specifies which program should be use for the initial layout. By
              default, sfdp is run. Also by default, the layout is passed  the
              flag -Goverlap=prism. This can be overridden using a -g flag.

       -T format
              specifies  the  final  output format. This works the same way as
              the -T flag for any Graphviz layout program.

       -N attr=val
              specifies the setting of a default  node  attribute  during  the
              rendering  phase. This works the same way as the -N flag for any
              Graphviz layout program.

       -G attr=val
              specifies the setting of a graph attribute during the  rendering
              phase.  This  works the same way as the -G flag for any Graphviz
              layout program.

       -E attr=val
              specifies the setting of a default  edge  attribute  during  the
              rendering  phase. This works the same way as the -E flag for any
              Graphviz layout program.

       -n attr=val
              specifies the setting of a default  node  attribute  during  the
              layout  phase.  This  works  the same way as the -N flag for any
              Graphviz layout program.

       -g attr=val
              specifies the setting of a graph  attribute  during  the  layout
              phase.  This  works the same way as the -G flag for any Graphviz
              layout program.

       -e attr=val
              specifies the setting of a default  edge  attribute  during  the
              layout  phase.  This  works  the same way as the -E flag for any
              Graphviz layout program.

       -A flag
              specifies a flag to be passed to gvmap.  For  example,  gvmap.sh
              -Ae -As3 causes gvmap -e -s3 to be run.

       -v     Set verbose mode.

       -V     Print version information and exit.

       -?     Print usage information and exit.


EXAMPLES
       The  following  invocation creates a map with edges in semi-transparent
       light gray and nodes laid out using sfdp:

       gvmap.sh -Ae -Ecolor=#55555522 -Tpng foo.gv > foo.png

       It is equivalent to running the pipeline

       sfdp -Goverlap=prism foo.gv | gvmap -e |  neato  -n2  -Ecolor=#55555522
       -Tpng > foo.png


AUTHOR
       Yifan Hu <yifanhu@research.att.com>


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | image/graphviz   |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+
SEE ALSO
       gvmap(1), sfdp(1), neato(1), gvpr(1)

       E.  R.  Gansner,  Y.  Hu, S. G. Kobourov, "GMap: Visualizing graphs and
       clusters as maps," Proc. Pacific Vis. 2010, pp. 201-208.



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded  from   http://www.graphviz.org/pub/graphviz/sta-
       ble/SOURCES/graphviz-2.28.0.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.graphviz.org/.



                                 31 March 2011                     GVMAP.SH(1)