gvcolor(1)

1GVCOLOR(1)                  General Commands Manual                 GVCOLOR(1)
2
3
4

NAME

6       gvcolor - flow colors through a ranked digraph
7

SYNOPSIS

9       gvcolor [ files ]
10

USAGE

12       dot file.gv | gvcolor | dot -T<format>
13

DESCRIPTION

15       gvcolor  (previously known as colorize) is a filter that sets node col‐
16       ors from initial seed values.  Colors flow along  edges  from  tail  to
17       head,  and  are  averaged  (as  HSB  vectors) at nodes.  The graph must
18       already have been processed by dot.  Appropriate choice of initial col‐
19       ors  yields  drawings  in  which  node colors help to emphasize logical
20       relationships between nodes, even when they are spread far apart in the
21       layout.
22
23       Initial  colors  must be set externally, using the color attribute of a
24       node.  It is often effective to assign colors to a few  key  source  or
25       sink  nodes,  manually  setting their colors by editing the graph file.
26       Color names are as in dot(1): symbolic names or  RGB  triples.   It  is
27       best to choose some easily‐distinguished but related colors; not neces‐
28       sarily spaced evenly around the color wheel.  For example,  blue_green,
29       green, and light_yellow looks better than red, green, blue.
30
31       Certain  graph  attributes  control  the  gvcolor algorithm.  flow=back
32       reverses the flow of colors from heads to tails.  saturation=.1,.9  (or
33       any  two numbers between 0 and 1) adjusts the color saturation linearly
34       from least to greatest rank.  If Defcolor is set, this color  value  is
35       applied to any node not otherwise colored.
36

EXIT STATUS

38       The following exit values are returned:
39
40       0   Successful completion.
41
42       1   If nodes of the graph do not possess a ``pos'' attribute.
43

BUGS

45       It would be nice to make the program work without relying on an initial
46       pass through dot.
47

AUTHORS

49       Stephen C. North <north@research.att.com>
50       Emden R. Gansner <erg@research.att.com>
51