graphml2gv.1 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. .TH GRAPHML2GV 1 "14 July 2011"
  2. .SH NAME
  3. graphml2gv \- GRAPHML-DOT converter
  4. .SH SYNOPSIS
  5. .B graphml2gv
  6. [
  7. .B \-?v
  8. ]
  9. [
  10. .BI \-g gname
  11. ]
  12. [
  13. .BI \-o outfile
  14. ]
  15. [
  16. .I files
  17. ]
  18. .SH DESCRIPTION
  19. .B graphml2gv
  20. converts a graph specified in the GRAPHML format to a graph in the GV (formerly DOT) format.
  21. .SH OPTIONS
  22. The following options are supported:
  23. .TP
  24. .B \-v
  25. Turns on verbose mode
  26. .TP
  27. .B \-?
  28. Prints usage information and exits.
  29. .TP
  30. .BI \-g "gname"
  31. The string \fIgname\fP is used as the name of the generated graph.
  32. If multiple graphs are generated, subsequent graphs use the name
  33. \fIgname\fP appended with an integer.
  34. .TP
  35. .BI \-o "outfile"
  36. Prints output to the file \fIoutfile\fP. If not given, \fBgraphml2gv\fP
  37. uses stdout.
  38. .TP
  39. .SH OPERANDS
  40. The following operand is supported:
  41. .TP 8
  42. .I files
  43. Names of files containing 1 or more graphs in GRAPHML.
  44. If no
  45. .I files
  46. operand is specified,
  47. the standard input will be used.
  48. .SH RETURN CODES
  49. Return \fB0\fP
  50. if there were no problems during conversion;
  51. and non-zero if any error occurred.
  52. .SH "LIMITATIONS"
  53. As both the graph and graphics models of GV and GML differ significantly, the
  54. conversion can only be at best approximate.
  55. In particular, GV currently has no notion of hyperedges or edges containing graphs.
  56. .P
  57. At present,
  58. .B graphml2gv
  59. only supports the basic graph topology. Specifically, the <KEY> and <DATA>
  60. elements are not handled, though they could be.
  61. .SH AUTHORS
  62. Emden R. Gansner <[email protected]>
  63. .SH "SEE ALSO"
  64. dot(1), libcgraph(3)