1GVMAP.SH(1)                 General Commands Manual                GVMAP.SH(1)
2
3
4

NAME

6       gvmap.sh - pipeline for running gvmap
7

SYNOPSIS

9       gvmap.sh [-vV?]  [ options ] [ -o outfile ] [ files ]
10

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

AUTHOR

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

SEE ALSO

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)