1GVMAP.SH(1) General Commands Manual GVMAP.SH(1)
2
3
4
6 gvmap.sh - pipeline for running gvmap
7
9 gvmap.sh [-vV?] [ options ] [ -o outfile ] [ files ]
10
12 gvmap.sh takes as input a graph in DOT format, performs a layout, runs
13 the output through gvmap and renders the output. At some point, it is
14 hoped to integrate all of these tasks into gvmap.
15
17 The following options are supported:
18
19 -a k The integer k specifies the average number of artificial points
20 added along the bounding box of the labels. Such artificial
21 points are added to avoid a country boundary cutting through the
22 boundary box of the labels. Computing time is proportional to k;
23 hence, for large graphs, a small value of k is suggested. If k =
24 -1, a suitable value of k is automatically selected based on the
25 graph size. By default k = -1.
26
27 -K layout
28 specifies which program should be use for the initial layout. By
29 default, sfdp is run. Also by default, the layout is passed the
30 flag -Goverlap=prism. This can be overridden using a -g flag.
31
32 -T format
33 specifies the final output format. This works the same way as
34 the -T flag for any Graphviz layout program.
35
36 -N attr=val
37 specifies the setting of a default node attribute during the
38 rendering phase. This works the same way as the -N flag for any
39 Graphviz layout program.
40
41 -G attr=val
42 specifies the setting of a graph attribute during the rendering
43 phase. This works the same way as the -G flag for any Graphviz
44 layout program.
45
46 -E attr=val
47 specifies the setting of a default edge attribute during the
48 rendering phase. This works the same way as the -E flag for any
49 Graphviz layout program.
50
51 -n attr=val
52 specifies the setting of a default node attribute during the
53 layout phase. This works the same way as the -N flag for any
54 Graphviz layout program.
55
56 -g attr=val
57 specifies the setting of a graph attribute during the layout
58 phase. This works the same way as the -G flag for any Graphviz
59 layout program.
60
61 -e attr=val
62 specifies the setting of a default edge attribute during the
63 layout phase. This works the same way as the -E flag for any
64 Graphviz layout program.
65
66 -A flag
67 specifies a flag to be passed to gvmap. For example, gvmap.sh
68 -Ae -As3 causes gvmap -e -s3 to be run.
69
70 -v Set verbose mode.
71
72 -V Print version information and exit.
73
74 -? Print usage information and exit.
75
76
78 The following invocation creates a map with edges in semi-transparent
79 light gray and nodes laid out using sfdp:
80
81 gvmap.sh -Ae -Ecolor=#55555522 -Tpng foo.gv > foo.png
82
83 It is equivalent to running the pipeline
84
85 sfdp -Goverlap=prism foo.gv | gvmap -e | neato -n2 -Ecolor=#55555522
86 -Tpng > foo.png
87
88
90 Emden R. Gansner <erg@research.att.com>
91
93 gvmap(1), sfdp(1), neato(1), gvpr(1)
94
95 E. R. Gansner, Y. Hu, S. G. Kobourov, "GMap: Visualizing graphs and
96 clusters as maps," Proc. Pacific Vis. 2010, pp. 201‐208.
97
98
99
100 31 March 2011 GVMAP.SH(1)