Seth Woolley's Man Viewer

fdp(1) - fdp - filter for drawing undirected graphs - man 1 fdp

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

FDP(1)                                                                  FDP(1)



NAME
       fdp - filter(1,3x,3x curs_util) for drawing undirected graphs

SYNOPSIS
       fdp  [-Gname=value] [-Nname=value] [-Ename=value] [-Tlang] [-l libfile]
       [-o outfile] [-v] [files]

DESCRIPTION
       fdp draws undirected graphs using a ``spring'' model. It  relies  on  a
       force-directed  approach in(1,8) the spirit of Fruchterman and Reingold (cf.
       Software-Practice & Experience 21(11),  1991,  pp.  1129-1164).   Input
       files  must  be  formatted  in(1,8)  the  dot attributed graph language.  By
       default, the output of fdp is the input graph with  layout  coordinates
       appended.   To  make  Postscript,  use the -Tps option.  FrameMaker MIF
       (-Tmif), HPGL (-Thpgl), JPEG (-Tjpg and GIF (-Tgif) are other  choices.

       Here is a brief synopsis of the graph language.

       graph name { statement-list }

       declares a top level graph. Statements may be:

       name=val;
       node [name=val];
       edge [name=val]; Set the default graph, node, or edge attribute name to
       val.  Any subgraph, node, or edge specified after one of  these  state-
       ments inherits these attributes.

       n0  [name0=val0,name1=val1,...];  Creates node n0 if(3,n) it does not exist,
       and sets its attributes according to the optional list.

       n0 -- n1  --  ...  --  nn  [name0=val0,name1=val1,...];  Creates  edges
       between nodes n0, n1, ..., nn and optionally sets the given attributes.
       Creates nodes as necessary.  Although typically applied  to  undirected
       graph,  fdp  will  also  layout directed graphs by simply ignoring edge
       direction.

       subgraph name { statement-list } Creates a subgraph.   A  subgraph  may
       appear  in(1,8)  place  of an individual node within an edge statement.  The
       subgraph name part is optional. If missing, the subgraph  is  given  an
       internal name.

       While  attribute  names  and  values  may be arbitrary strings, certain
       fixed attributes control fdp's layout algorithm.  Refer to  dot(1)  for
       general options for controlling layout size, font faces and sizes, col-
       ors, labels, node shape, line styles, etc.

GRAPH ATTRIBUTES
       K=val. Sets the default ideal node separation in(1,8) the layout.

       maxiter=val. Sets the maximum number of iterations used to  layout  the
       graph.

       start=val. Adjusts the random(3,4,6) initial placement of nodes with no speci-
       fied position.  If val is is an integer, it is used as the seed for the
       random(3,4,6)  number  generator.   If val is not an integer, a random(3,4,6) system-
       generated integer, such as the process ID or current time(1,2,n), is  used  as
       the seed.

       splines=val.  If  val  is  "true",  edges are drawn as splines to avoid
       nodes. By default, edges are draw as line segments.


NODE ATTRIBUTES
       pin=val. If val is "true", the node will remain at  its  initial  posi-
       tion.

EDGE ATTRIBUTES
       weight=f  sets the weight of an edge to the given floating point value.
       The default is 1.0; greater values make the edge tend more  toward  its
       optimal length.

       len=f sets the optimal length of an edge.  The default is K.

COMMAND LINE OPTIONS
       -v (verbose) prints a log of the layout.

       -V prints the version(1,3,5) and exits.

       -? prints the usage and exits.

SEE ALSO
       dot(1), circo(1), neato(1), twopi(1)



                                 1 April 2003                           FDP(1)

References for this manual (incoming links)