gvmap (1)

Name

Synopsis

gvmap [-ekv?]  [ options ] [ -o outfile ] [ files ]

Description

User Commands                                            GVMAP(1)



NAME
     gvmap  -  find  clusters and create a geographical map high-
     lighting clusters.

SYNOPSIS
     gvmap [-ekv?]  [ options ] [ -o outfile ] [ files ]

DESCRIPTION
     gvmap takes as input a graph in DOT format, finds node clus-
     ters  and produces a rendering of the graph as a geographic-
     style map, with clusters highlighted, in xdot format.

     The input graph must have node  positions  and  width/height
     information defined, and nodes must not overlap.

OPTIONS
     The following options are supported:

     -a k The  integer  k specifies the average number of artifi-
          cial 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.

     -b v The real number v specifies the line width used to draw
          the  polygon  boundaries,  with  v  < 0 for no line. By
          default v = 0.

     -c k The integer k specifies color scheme used to color  the
          countries. By default k = 1.

        Acceptable values are:
             0 : no polygons
             1 : pastel
             2 : blue to yellow
             3 : white to red
             4 : light grey to red
             5 : primary colors
             6 : sequential single hue red
             7 : sequential single hue lighter red
             8 : light grey

     -C d The  integer d specifies the maximum number of clusters
          (countries) allowed. By default d = 0, which means that
          there is no limit.

     -d d The  integer  d  specifies  the random seed used during
          color assignment optimization that maximize color  dif-
          ference between neighbpring countries.



SunOS 5.11          Last change: 3 March 2011                   1






User Commands                                            GVMAP(1)



     -e   If  specified, edges will be included in the final out-
          put.

     -g c Specifies the bounding box color. If not  specified,  a
          bounding box is not drawn.

     -k   If  specified, increases the randomesss of outer bound-
          ary.

     -r k The number of random points k (integer) used to  define
          sea  and  lake  boundaries.  If  0,  auto  assigned. By
          default v = 0

     -s v The real number v specifies the depth of  the  sea  and
          lake  shores in points. If 0, auto assigned. By default
          v = 0.

     -O   Do NOT do color assignment optimization that  maximizes
          color difference between neighboring countries

     -o<file>
          Put output in <file>. Default output is stdout

     -v   Verbose mode.

     -z c Specified the polygon line color. Default is black.

EXAMPLES
     Given a graph foo.gv, one way to generate a layout and high-
     light the clusters is to first select a layout engine with a
     suitable  overlap  removal  method,  then feed the output to
     gvmap, and finally render the map  using  specific  graphics
     format.  For  example,  the following pipeline creates a map
     with edges in semi-transparent light gray and nodes laid out
     using sfdp:

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

     The shell script gvmap.sh  provides  a  shorthand  for  such
     pipelines.  For  example, the above pipeline can be achieved
     using

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



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






SunOS 5.11          Last change: 3 March 2011                   2






User Commands                                            GVMAP(1)



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

     +---------------+------------------+
     |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
     +---------------+------------------+
     |Availability   | image/graphviz   |
     +---------------+------------------+
     |Stability      | Volatile         |
     +---------------+------------------+
SEE ALSO
     gvmap.sh(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://java.net/projects/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/.


























SunOS 5.11          Last change: 3 March 2011                   3