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