gvmap.sh - pipeline for running gvmap
Contents
Description
gvmap.sh takes as input a graph in DOT format, performs a layout, runs the output through gvmap and
renders the output. At some point, it is hoped to integrate all of these tasks into gvmap.
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
Name
gvmap.sh - pipeline for running gvmap
Options
The following options are supported:
-ak 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.
-Klayout
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.
-Tformat
specifies the final output format. This works the same way as the -T flag for any Graphviz layout
program.
-Nattr=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.
-Gattr=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.
-Eattr=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.
-nattr=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.
-gattr=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.
-eattr=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.
-Aflag
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.
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. 31 March 2011 GVMAP.SH(1)
Synopsis
gvmap.sh [-vV?] [ options ] [ -ooutfile ] [ files ]
