graph-easy - render/convert graphs in/from various formats
Convert between graph formats and layout/render graphs:
graph-easy [options] [inputfile [outputfile]] graph-easy --input=graph.dot --as_ascii graph-easy --as_html --output=graph.html graph.txt graph-easy graph.txt graph.svg graph-easy graph.txt --as_dot | dot -Tpng -o graph.png echo "[ Bonn ] - car -> [ Berlin ]" | graph-easy --ascii
Print the full documentation, not just a short overview.
Specify the input file name. Example:
graph-easy --input=input.txt
Specify the output file name. Example:
graph-easy --output=output.txt input.txt
Specify the output format. Example:
graph-easy --as=ascii input.txt
Valid formats are:
ascii boxart html svg graphviz the DOT language dot an alias for "graphviz" txt Graph::Easy text
If unspecified, the default format will be determined by the output filename extension, and is ascii, if the output filename was not set.
ascii
Note that you can also use ONE argument of the form --as_ascii, --as_svg and so on.
--as_ascii
--as_svg
Specify the input format. Valid formats are:
graphviz the DOT language txt Graph::Easy text
If not specified, the input format is auto-detected.
Note that you can also use ONE argument of the form --from_graphviz or --from_txt,
--from_graphviz
--from_txt
Write info regarding the conversion process to STDERR.
Write debugging info to STDERR. Warning, this can create huge amounts of hard-to-understand output!
Example:
graph-easy input.txt --output=test.html --debug=1
When true, will only parse the input file and not output anything. This is usefull in combination with --debug=1.
--debug=1
graph-easy input.txt --parse --debug=1
Set the timeout in seconds for the layouter. If the layout does not finish in this time, it will be aborted.
graph-easy input.txt --timeout=500
graph-easy reads descriptions of graphs and then converts them to the desired output format.
graph-easy
By default, the input will be read from STDIN, and the output will go to STDOUT.
It understands the following formats as input:
Graph::Easy http://bloodgate.com/perl/graph/manual/ DOT http://www.graphviz.org/
The formats are automatically detected, regardless of the input file name, but you can also explicitely declare your input to be in one specific format.
The output can either be a dump of the graph in one of the two input formats, or a layout (rendering) of the graph in one of the output formats implemented by Graph::Easy:
HTML SVG ASCII BOXART
echo "[ Bonn ] -- car --> [ Berlin ], [ Ulm ]" | graph-easy --as=ascii +--------+ car +-----+ | Bonn | -----> | Ulm | +--------+ +-----+ | | car v +--------+ | Berlin | +--------+
echo "[ Bonn ] -- car --> [ Berlin ], [ Ulm ]" | graph-easy --as=dot digraph GRAPH_0 { // Generated by Graph::Easy 0.54 at Sat Feb 24 11:38:28 2007 edge [ arrowhead=open ]; graph [ rankdir=LR ]; node [ fontsize=11, fillcolor=white, style=filled, shape=box ]; Bonn -> Ulm Bonn -> Berlin }
This library is free software; you can redistribute it and/or modify it under the terms of the GPL.
See the LICENSE file of Graph::Easy for a copy of the GPL.
This product includes color specifications and designs developed by Cynthia Brewer (http://colorbrewer.org/). See the LICENSE file for the full license text that applies to these color schemes.
Copyright (C) 2004 - 2007 by Tels http://bloodgate.com
To install Graph::Easy, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Graph::Easy
CPAN shell
perl -MCPAN -e shell install Graph::Easy
For more information on module installation, please visit the detailed CPAN module installation guide.