Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

gvcolor (1)

Name

gvcolor - flow colors through a ranked digraph

Synopsis

gvcolor [ files ]

Description

GVCOLOR(1)                  General Commands Manual                 GVCOLOR(1)



NAME
       gvcolor - flow colors through a ranked digraph

SYNOPSIS
       gvcolor [ files ]

USAGE
       dot file.gv | gvcolor | dot -T<format>

DESCRIPTION
       gvcolor  (previously known as colorize) is a filter that sets node col-
       ors from initial seed values.  Colors flow along  edges  from  tail  to
       head,  and  are  averaged  (as  HSB  vectors) at nodes.  The graph must
       already have been processed by dot.  Appropriate choice of initial col-
       ors  yields  drawings  in  which  node colors help to emphasize logical
       relationships between nodes, even when they are spread far apart in the
       layout.

       Initial  colors  must be set externally, using the color attribute of a
       node.  It is often effective to assign colors to a few  key  source  or
       sink  nodes,  manually  setting their colors by editing the graph file.
       Color names are as in dot(1): symbolic names or  RGB  triples.   It  is
       best to choose some easily-distinguished but related colors; not neces-
       sarily spaced evenly around the color wheel.  For example,  blue_green,
       green, and light_yellow looks better than red, green, blue.

       Certain  graph  attributes  control  the  gvcolor algorithm.  flow=back
       reverses the flow of colors from heads to tails.  saturation=.1,.9  (or
       any  two numbers between 0 and 1) adjusts the color saturation linearly
       from least to greatest rank.  If Defcolor is set, this color  value  is
       applied to any node not otherwise colored.

EXIT STATUS
       The following exit values are returned:

       0   Successful completion.

       1   If nodes of the graph do not possess a ``pos'' attribute.

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

AUTHORS
       Stephen C. North <north@research.att.com>
       Emden R. Gansner <erg@research.att.com>


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | image/graphviz   |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       gc(1), dot(1), gvpr(1), ccomps(1), sccmap(1), tred(1), libgraph(3)



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded  from   http://gitlab.com/graphviz/graphviz/-/ar-
       chive/2.47.1/graphviz-2.47.1.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.graphviz.org/.



                                 21 March 2001                      GVCOLOR(1)