|
|
1.1 root 1: .TH GRAPHDRAW 9.1
2: .CT 1 editor graphics
3: .SH NAME
4: graphdraw graphpic \- edit (combinatoric) graphs, convert to pic files
5: .SH SYNOPSIS
6: .B graphdraw
7: [
8: .I file
9: ]
10: .PP
11: .B graphpic
12: [
13: .I option ...
14: ]
15: .I file
16: .SH DESCRIPTION
17: .I Graphdraw
18: interactively edits and displays undirected graphs, and can also be used
19: to display real-time animation of algorithms.
20: If a
21: .I file
22: is mentioned, the graph stored in that file is edited.
23: .PP
24: Click button 1 in command line (at bottom of window) to type in commands:
25: .TP \w'\f5!\fI\ program\ file\ \ \fR'u
26: .BI r " file"
27: Read file and display graph.
28: .PD0
29: .TP
30: .BI w " file"
31: Write current graph to file.
32: .TP
33: .BI cd " directory"
34: Change directory.
35: .TP
36: .BI ! " program file"
37: Execute animation
38: .I program
39: with
40: .I file
41: as input.
42: .TP
43: .B q
44: Quit.
45: .PD
46: .PP
47: Button 3 gets a menu of actions, which are
48: usually accomplished by pointing with button 1.
49: The parenthesized equivalents in the following list are explained
50: under `Algorithm animation'.
51: .TP 0
52: .B create vertex
53: Vertex is placed where button 1 is clicked.
54: .RB ( vc
55: .IR "x y" )
56: .PD 0
57: .TP
58: .B delete
59: Delete selected vertex and associated edges.
60: .RB ( vd
61: .IR i )
62: .TP
63: .B move
64: Selected vertex moves with mouse until button 1 is released.
65: .RB ( vm
66: .IR i )
67: .TP
68: .B copy
69: Copy of selected vertex and associated edges moves with mouse.
70: .RB ( vc
71: .IR "i x y" )
72: .TP
73: .B create/delete edge
74: Point to first endpoint and click button 1.
75: Point to second endpoint and click button 1.
76: Continue selecting second endpoints with button 1.
77: To unselect first endpoint, click button 2.
78: .RB ( ec
79: .IB "i j " /
80: .B ed
81: .IR "i j" )
82: .TP
83: .B restart
84: Click button 1 to clear screen and discard current graph.
85: .RB ( pr )
86: .TP
87: .B standard window
88: Restart and reshape window to standard size,
89: in which the drawing area is square and as large as possible.
90: .TP
91: .B small/large/no grid
92: Impose/remove visible grid to which all new coordinates will be rounded.
93: .TP
94: .B exit
95: Click button 1 to confirm.
96: .TP
97: .B labels menu
98: .RS
99: .TP
100: .B label vertex
101: Select vertex with button 1.
102: Current label appears on command line.
103: To accept it, click button 1.
104: Otherwise, type in new label and hit return.
105: .RB ( vl
106: .IR "i w" )
107: .TP
108: .B number vertices
109: Vertex labels are set to the consecutive integers 1,2,...;
110: this is the default.
111: .RB ( vn )
112: .TP
113: .B label edge
114: Default is
115: .LR 1 .
116: .RB ( el
117: .IR "i j w" )
118: .HP
119: .B show/hide vertex labels
120: .RB ( vs ,
121: .BR vh )
122: .HP
123: .B show/hide edge labels
124: .RB ( es ,
125: .BR eh )
126: .TP
127: .B turn Euclidean edge labels on/off
128: Distances are measured in pixels.
129: .RB ( ee )
130: .TP
131: .B show/hide sum of edges
132: .RE
133: .TP
134: .B graphics menu
135: .RS
136: .TP
137: .B light/heavy/empty/full/invisible vertex
138: Select style from menu with button 3; select vertices to change with button 1.
139: The default is
140: .LR light .
141: .RB ( vg
142: .IR "i c" )
143: .HP
144: .B light/heavy edge
145: .RB ( eg
146: .IR "i j c" )
147: .RE
148: .TP
149: .B macros menu
150: Arrange for sets of vertices to act together.
151: Actions on any vertex in the set apply to the whole set.
152: Copying duplicates edges internal to the set.
153: Creating an edge between vertexes in two different sets
154: creates edges from every vertex in one set to every
155: vertex in the other (bipartite subgraph).
156: .RS
157: .TF unselect\ set
158: .TP
159: .B select set
160: Sweep a rectangle around the set with button 1.
161: Dissociate conflicting sets.
162: .TP
163: .B unselect set
164: Dissociate set containing selected vertex.
165: .TP
166: .B shrink/expand set
167: Selected set is shrunk/expanded about its center.
168: .TP
169: .B reshape set
170: Selected set is redrawn in swept rectangle.
171: .TP
172: .B complete/disconnect subgraph
173: Create/delete edges between every pair of vertices in a set.
174: .RE
175: .PP
176: .I Graphpic
177: is a filter which, when applied to a file in graphdraw format, outputs
178: .I pic
179: code for the graph.
180: The options are:
181: .TP
182: .B -v
183: Print vertex labels.
184: .TP
185: .B -e
186: Print edge labels.
187: .TP
188: .B -i
189: Optimize for imagen printer (default is d202).
190: .PD
191: .SS File format
192: Graphs are stored as adjacency lists.
193: .PP
194: First line:
195: .I n m t,
196: where
197: .I n
198: is the number of vertices,
199: .I m
200: is the number of edges, and
201: .I t
202: is an optional graph type.
203: The only legal type is the default type
204: .B u
205: (undirected).
206: .PP
207: For each vertex, an initial line:
208: .I d w x y c,
209: where
210: .I d
211: is the degree of the vertex,
212: .I w
213: is its label,
214: .I x
215: and
216: .I y
217: are its coordinates in the window, and
218: .I c
219: is an optional graphics code,
220: .BR L =light
221: (default),
222: .BR H =heavy
223: (circled dot),
224: .BR F =full
225: (large bullet),
226: .BR E =empty
227: (empty circle),
228: .B I =invisible.
229: Window coordinates will be scaled to fit when graph is read in.
230: .PP
231: After the initial line follow
232: .I d
233: lines for the vertex's edges:
234: .I i w c,
235: where
236: .I i
237: is the index (1 to
238: .IR n)
239: of the other endpoint,
240: .I w
241: is the edge label, and
242: .I c
243: is an optional graphics code,
244: .B L
245: or
246: .BR H .
247: .PD
248: .SS Algorithm animation
249: The typed command
250: .BI ! "program file"
251: causes the standard output of
252: .I program
253: to be captured by the host and
254: interpreted as commands to
255: .I graphdraw.
256: The resulting movie
257: can be killed or temporarily halted from the the terminal
258: by clicking button 2 and choosing the desired option from the resulting menu.
259: .PP
260: Animation codes (defined parenthetically with menu items above)
261: appear one per line.
262: Their arguments are:
263: .I i,
264: index of a vertex (normally the
265: .IR i th
266: to be created);
267: .I x, y,
268: integer coordinates in the range 0 to
269: .BR maxcoord ;
270: .I w
271: a label; or
272: .I c,
273: a graphic code.
274: .PP
275: Other animation codes are
276: .PD0
277: .TP \w'\f5pm\fI\ message\ \ \fR'u
278: .BI pw " n"
279: Change the value of
280: .B maxcoord to
281: .I n.
282: Default is 10,000.
283: .TP
284: .BI vl " i w"
285: Give vertex
286: .I i
287: the label
288: .I w.
289: .TP
290: .BI pd " t"
291: Delay program for
292: .I t
293: clicks of the 60Hz clock.
294: .TP
295: .B ps
296: Halt program until user clicks button 2 to continue.
297: .TP
298: .BI pm " message"
299: Print
300: .I message
301: on command line.
302: .PD
303: .SH SEE ALSO
304: .IR dag (1),
305: .IR pic (1)
306: .SH BUGS
307: It is impossible to move or reshape a
308: .I graphdraw
309: layer, except via
310: .LR "standard window" .
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.