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 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. 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 Emden R. Gansner <erg@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 Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from http://gitlab.com/graphviz/graphviz/-/ar- chive/2.47.1/graphviz-2.47.1.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)