unflatten.1 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. .TH UNFLATTEN 1 "21 January 2001"
  2. .SH NAME
  3. unflatten \- adjust directed graphs to improve layout aspect ratio
  4. .SH SYNOPSIS
  5. .B unflatten
  6. [\fB\-f?\fR]
  7. [\fB\-l\fIlen\fR]
  8. [\fB\-c\fIlen\fR
  9. ] [
  10. .B \-o
  11. .I outfile
  12. ]
  13. [ files ]
  14. .SH DESCRIPTION
  15. .B unflatten
  16. is a preprocessor to
  17. .B dot
  18. that is
  19. used to improve the aspect ratio of graphs having many leaves
  20. or disconnected nodes.
  21. The usual layout for such a graph is very wide or tall.
  22. .B unflatten
  23. creates chains with invisible edges or adjusts the \fBminlen\fP on edges
  24. to improve layout compaction.
  25. .SH OPTIONS
  26. The following options are supported:
  27. .TP
  28. .BI \-l " len"
  29. The \fBminlen\fP of leaf edges is staggered
  30. between 1 and \fIlen\fP (a small integer).
  31. .TP
  32. .B \-f
  33. Applies the \fB\-l\fP option to fanout nodes whose
  34. indegree and outdegree are both 1. This helps with structures such
  35. as \fIa -> {w x y z} -> b\fP.
  36. This option only works if the \fB\-l\fP flag is set.
  37. .TP
  38. .BI \-c " len"
  39. Form disconnected nodes into chains of up to \fIlen\fP edges.
  40. .TP
  41. .BI \-o " outfile"
  42. causes the output to be written to the specified file; by default,
  43. output is written to \fBstdout\fP.
  44. .TP
  45. .BI \-?
  46. Prints the usage and exits.
  47. .SH OPERANDS
  48. The following operand is supported:
  49. .TP 8
  50. .I files
  51. Names of files containing 1 or more graphs in dot format.
  52. If no
  53. .I files
  54. operand is specified,
  55. the standard input will be used.
  56. .SH AUTHORS
  57. Stephen C. North <[email protected]>
  58. .br
  59. Emden R. Gansner <[email protected]>
  60. .SH "SEE ALSO"
  61. gc(1), dot(1), acyclic(1), gvpr(1), gvcolor(1), ccomps(1), tred(1), libgraph(3)