Manual Page Result
0
Command: dag | Section: 1 | Source: UNIX v10 | File: dag.1
DAG(1) General Commands Manual DAG(1)
NAME
dag - preprocessor for drawing directed graphs
SYNOPSIS
dag [ option ... ] [ file ... ]
DESCRIPTION
Dag is a pic(1) or PostScript preprocessor for laying out directed
graphs. It does well on acyclic graphs (dags) and other graphs that
can be drawn hierarchically. Graph statements are contained between
.GD (node ranks increase downward) or .GR (rightward) and .GE. Edges
point in the direction of increasing rank if possible; the other direc-
tion is favored for edges within rank. A summary of statements fol-
lows.
edge from tail to head0 edge-items, to head1 edge-items, to head2 edge-
items...; Create edges from the tail node to the head node(s). Nodes
are created if they do not already exist. Edge-items (described below)
and the noise words edge, from, to, and comma are optional. Node names
may be quoted to protect blanks or keywords.
ordered tail head0 head1 head2...; Make edges with heads in given left-
to-right order on the same rank. May contain noise words and edge-
items.
path node0 node1 node2...; Make a path of edges. May contain noise
words and edge-items.
backedge tail head0 head1 head2...; Same as edges with opposite node
ranking preferred.
backpath node0 node1 node2...; Make a path of backedges.
draw nodes node-items; Set properties of subsequently created nodes.
Legal node-items:
as shape
Known shapes are Box, Circle, Doublecircle, Ellipse (de-
fault), Diamond, Square, Plaintext. Other shapes may be
specified within braces {} in the output language (e.g.
pic) or defined; see below.
label "string"
Label with string instead of node name.
pointsize points
heightinches
color "string"
Hue-saturation-brightness triple; works only with Post-
Script.
draw nodelist node-items; Set properties of listed nodes.
draw edges edge-items; Set properties of subsequently created edges.
Legal edge-items:
dotted, dashed, solid, invis
label "string"
weight n
High-weight edges are kept short. Default weight 1.
color "string"
pointsize points
minimum rank nodelist; Listed nodes must be on the topmost rank (left-
most with .GR).
maximum rank nodelist; Bottommost or rightmost rank.
same rank nodelist;
separate ranks inches how ; Set minimum separation between ranks. The
optional how is exactly or equally.
separate nodes inches ;
The options are
-O Place nodes `optimally'; practical for graphs of a few dozen
nodes.
-Tps Prepare output for PostScript rather than pic.
-Tsimple
Output similar to that of graphdraw(9.1).
-Tcip Output readable by cip(9.1).
-pwidthxheight,marginwidthxmarginheight
Set PostScript page dimensions; marginwidth and/or marginheight
may be omitted.
-l Disable automatic loading of the dag graphics library.
The introductory .GD or .GR line may carry optional parameters in the
form .GD width height fill. Width and height are maximum values in
inches; fill causes the graph to be stretched to the full dimensions.
Graphics code written in the output language (pic or PostScript) may be
embedded between .PS and .PE. Macros defined with three arguments--la-
bel, width, and height--may be used as shape names in node-items.
EXAMPLES
.GD 2 2
a b c;
path a x y;
draw nodes as Box;
a z label "hi" weight 1000;
draw edges dashed;
b x;
same rank b x;
.GE
FILES
default
TOOLS=/usr/lib
SEE ALSO
pic(1), lp(1), graphdraw(9.1), psi(9.1), troff(1)
E. R. Gansner, S. C. North, K. P. Vo, `DAG--A Program that
Draws Directed Graphs', this manual, Volume 2
BUGS
The delimiter .GD is nonstandard; it may be called .GS in installations
where ped(9.1) is not used.
Troff lacks dotted or dashed splines; use PostScript.
Edge labels may overlap.
DAG(1)