NAME

gloss.pl - A commandline graph layout tool

SYNOPSIS

gloss.pl [options] [file ...]

DESCRIPTION

gloss.pl is a tool which does graph layout using the aglo (Aesthetic Graph Layout) method. The graph is read from the standard input or a file, layout is performed according to the aesthetic combination specified on the command line, and the resulting layout is printed on standard output.

There is a facility for monitoring the progress of the layout using gnuplot.

This program tries to mimic the interface of the gloss program that's part of the original aglo code.

OPTIONS

The floating point argument that all aesthetic options have is the weight for that aesthetic

-edges

display edges instead of coordinates. This is the output format the old gloss program gave.

-it integer

Number of iterations, defaults to 1000

-bt float

Beginning temperature, defaults to 100

-et float

Ending temperature, defaults to 0.001

-m

Turn monitor on

-mr integer

Monitor update rate in seconds, default 2

-s

Sleep until newline at end

-knr float

Node repulsion aesthetic

-kmel float

Minimize edge lengt aesthetic

-kcp float

Centripetal (repulsion from centroid) aesthetic

-kner float

Node/edge repulsion aesthetic

-kmei float

Minimize edge intersection aesthetic

-kmei2 float

Minimize edge intersections v2 aesthetic (stronger)

-kpl float

Place parent to left of children aesthetic

-kmlv float

Minimize intralevel variance aesthetic

-cin filename

Reads a file in coordinate format (the default output format of this program) and uses it as the initial coordinates of the nodes (the default is random placement).

-help

Print a brief help message and exits.

-man

Prints the manual page and exits.

EXAMPLE

Input files for the examples are found in the ex/ directory in the Graph::Layout::Aesthetic distribution.

  gloss.pl -s -mr 0 -knr 1 -kmel 1 ex/t04.in
  gloss.pl -s -mr 0 -knr 1 -kmel 1 -kner 1 -kmei2 6 ex/t12.in
  gloss.pl -s -mr 1 -knr 1 -kmel 1 -d 3 ex/ell.in

SEE ALSO

http://www.cs.ucla.edu/~stott/aglo/, Graph::Layout::Aesthetic, Graph::Layout::Aesthetic::Force, gnuplot(1), gloss(1)

AUTHOR

Ton Hospel, <Graph-Layout-Aesthetic@ton.iguana.be>

COPYRIGHT AND LICENSE

Copyright (C) 2004 by Ton Hospel

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6.1 or, at your option, any later version of Perl 5 you may have available.