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

# [NAME](#NAME)

gvmap.sh - pipeline for running gvmap

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#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](#OPTIONS)

The following options are supported:

[**-a k**](#a)

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**](#K)

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**](#T)

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

[**-N attr=val**](#N)

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**](#G)

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**](#E)

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**](#n)

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**](#g)

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**](#e)

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**](#A)

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

[**-v**](#v)

Set verbose mode.

[**-V**](#V)

Print version information and exit.

**-?**

Print usage information and exit.

# [EXAMPLES](#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](#AUTHOR)

Emden R. Gansner <erg@research.att.com>

# [SEE ALSO](#SEE_ALSO)

[gvmap(1)](/man/os/graphviz/gvmap.1), [sfdp(1)](/man/os/graphviz/sfdp.1), [neato(1)](/man/os/graphviz/neato.1), [gvpr(1)](/man/os/graphviz/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

---

Document: gvmap.sh(1) from graphviz 15.1.1-r2 (Chainguard OS)
Source: https://gitlab.com/graphviz/graphviz