Daniel@0: .TH UNFLATTEN 1 "21 January 2001"
Daniel@0: .SH NAME
Daniel@0: unflatten \- adjust directed graphs to improve layout aspect ratio
Daniel@0: .SH SYNOPSIS
Daniel@0: .B unflatten
Daniel@0: [\fB\-f\fR]
Daniel@0: [\fB\-l\fIlen\fR]
Daniel@0: [\fB\-c\fIlen\fR
Daniel@0: ] [
Daniel@0: .B \-o
Daniel@0: .I outfile
Daniel@0: ]
Daniel@0: [ files ]
Daniel@0: .SH DESCRIPTION
Daniel@0: .B unflatten
Daniel@0: is a preprocessor to 
Daniel@0: .B dot
Daniel@0: that is
Daniel@0: used to improve the aspect ratio of graphs having many leaves 
Daniel@0: or disconnected nodes.
Daniel@0: The usual layout for such a graph is generally very wide or tall.  
Daniel@0: .B unflatten
Daniel@0: inserts invisible edges or adjusts the \fBminlen\fP on edges
Daniel@0: to improve layout compaction.
Daniel@0: .SH OPTIONS
Daniel@0: The following options are supported:
Daniel@0: .TP
Daniel@0: .BI \-l " len"
Daniel@0: The minimum length of leaf edges is staggered
Daniel@0: between 1 and \fIlen\fP (a small integer).  
Daniel@0: .TP
Daniel@0: .B \-f
Daniel@0: Enables the staggering of the \fB-l\fP option to fanout nodes whose
Daniel@0: indegree and outdegree are both 1. This helps with structures such
Daniel@0: as \fIa -> {w x y z} -> b\fP.
Daniel@0: This option only works if the \fB-l\fP flag is set. 
Daniel@0: .TP
Daniel@0: .BI \-c " len"
Daniel@0: Form disconnected nodes into chains of up to \fIlen\fP nodes.
Daniel@0: .TP
Daniel@0: .BI \-o " outfile"
Daniel@0: causes the output to be written to the specified file; by default,
Daniel@0: output is written to \fBstdout\fP.
Daniel@0: .SH OPERANDS
Daniel@0: The following operand is supported:
Daniel@0: .TP 8
Daniel@0: .I files
Daniel@0: Names of files containing 1 or more graphs in dot format.
Daniel@0: If no
Daniel@0: .I files
Daniel@0: operand is specified,
Daniel@0: the standard input will be used.
Daniel@0: .SH AUTHORS
Daniel@0: Stephen C. North <north@research.att.com>
Daniel@0: .br
Daniel@0: Emden R. Gansner <erg@research.att.com>
Daniel@0: .SH "SEE ALSO"
Daniel@0: gc(1), dot(1), acyclic(1), gvpr(1), gvcolor(1), ccomps(1), tred(1), libgraph(3)