GVMAP.SH(1)

💖 GVMAP.SH(1) 💖

okay bestie, welcome to the General Commands Manual for gvmap.sh, no cap 🫶

---

✨ NAME ✨

gvmap.sh — the whole pipeline for running gvmap, like a little relay race but for graphs 🏃♀️💨

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — gvmap.sh takes a graph in DOT format as input, does a layout, runs the output through gvmap, and then renders the output. Three steps, one script, main character energy 👑

and lowkey? at some point, it is hoped to integrate all of these tasks into gvmap. so like, this script is doing a lot of emotional labor rn but one day it'll all be one program. we love a future plan 💅

---

💅 OPTIONS 💅

these are the options that are supported, periodt:

• -a k — the integer k says how many artificial points get added along the bounding box of the labels (on average). why tho? to avoid a country boundary cutting straight through the boundary box of the labels, which would be tragic 🙈 computing time is proportional to k, so for large graphs, bestie, use a small value of k. and if k = -1, a suitable value of k is automatically selected based on the graph size. by default k = -1.
• -K layout — picks which program should be used for the initial layout. by default, sfdp is run. also by default, the layout is passed the flag -Goverlap=prism. you can override that using a -g flag ✨
• -T format — sets the final output format. works exactly the same way as the -T flag for any Graphviz layout program. classic.
• -N attr=val — sets a default node attribute during the rendering phase. same energy as the -N flag for any Graphviz layout program.
• -G attr=val — sets a graph attribute during the rendering phase. same energy as the -G flag for any Graphviz layout program.
• -E attr=val — sets a default edge attribute during the rendering phase. same energy as the -E flag for any Graphviz layout program.
• -n attr=val — sets a default node attribute during the layout phase. same energy as the -N flag for any Graphviz layout program.
• -g attr=val — sets a graph attribute during the layout phase. same energy as the -G flag for any Graphviz layout program.
• -e attr=val — sets a default edge attribute during the layout phase. same energy as the -E flag for any Graphviz layout program.
• -A flag — passes a flag through to gvmap. for example, gvmap.sh -Ae -As3 causes gvmap -e -s3 to be run. slay 🎀
• -v — set verbose mode. she's chatty now 💬
• -V — print version information and exit. bye 👋
• -? — print usage information and exit. also bye 👋

---

🌈 EXAMPLES 🌈

this 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

and fr fr, it is equivalent to running this whole pipeline:

sfdp -Goverlap=prism foo.gv | gvmap -e | neato -n2 -Ecolor=#55555522 -Tpng > foo.png

like, same thing, just spelled out the long way 🧚

---

👑 AUTHOR 👑

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

---

🍓 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.

---

and that's the whole manual bestie, mwah 💖 this was the gvmap.sh page, dated 31 March 2011 — go forth and make maps, you absolute icon 🫶✨