gvmap.sh - pipeline for running gvmap
gvmap.sh [-vV?] [ options ] [ -o outfile ] [ files ]
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)