Annotation of researchv10dc/man/adm/man9/graphdraw.9, revision 1.1.1.1

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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.