From d637aea5263e6d290e5f8577d73d112efca52166 Mon Sep 17 00:00:00 2001 From: erg Date: Thu, 3 Mar 2011 03:12:52 +0000 Subject: [PATCH] Add new attributes used by sfdp --- doc/info/attrs.html | 33 +++++++++++++++++++++++++++------ doc/infosrc/attrs | 27 +++++++++++++++++++++------ 2 files changed, 48 insertions(+), 12 deletions(-) diff --git a/doc/info/attrs.html b/doc/info/attrs.html index 233fd7dfb..37122a835 100644 --- a/doc/info/attrs.html +++ b/doc/info/attrs.html @@ -204,7 +204,7 @@ This field indicates which graph component uses the attribute. height Ndouble0.50.02 href -EescString +GCNEescString ""svg, postscript, map only id GNEescString @@ -220,6 +220,8 @@ This field indicates which graph component uses the attribute. labelURL EescString ""svg, map only + label_scheme +Gint00sfdp only labelangle Edouble-25.0-180.0 labeldistance @@ -289,9 +291,9 @@ This field indicates which graph component uses the attribute. minlen Eint10dot only mode -Gstring"major"neato only +Gstringmajor
springsfdp, neato only model -Gstring"shortpath"neato only +Gstringshortpathneato only mosek Gbool falseneato only @@ -352,7 +354,7 @@ This field indicates which graph component uses the attribute. quadtree GquadType
bool -"normal"sfdp only +normalsfdp only quantum Gdouble0.00.0 rank @@ -384,6 +386,8 @@ This field indicates which graph component uses the attribute. <none>(graphs)
false(nodes)circo, twopi only rotate Gint0 + rotation +Gdouble0sfdp only samehead Estring""dot only sametail @@ -937,6 +941,15 @@ This field indicates which graph component uses the attribute. of an edge. This value overrides any URL defined for the edge. +
label_scheme +
The value indicates + whether to treat a node whose name has the form |edgelabel|* as a special node representing an edge label. + The default (0) produces no effect. + If the attribute is set to 1, sfdp uses a penalty-based method to make that kind of node close to the + center of its neighbor. With a value of 2, sfdp uses a penalty-based method to make that kind of node + close to the old center of its neighbor. Finally, a value of 3 invokes a two-step process of overlap + removal and straightening. +
labelangle
This, along with labeldistance, determine where the @@ -1111,17 +1124,22 @@ This field indicates which graph component uses the attribute.
Minimum edge length (rank difference between head and tail).
mode -
Technique for optimizing the layout. If mode is "major", +
Technique for optimizing the layout. For neato, if mode is "major", neato uses stress majorization. If mode is "KK", neato uses a version of the gradient descent method. The only advantage to the latter technique is that it is sometimes appreciably faster for small (number of nodes < 100) graphs. A significant disadvantage is that it may cycle.

- There are two new, experimental modes in neato, "hier", which adds a top-down + There are two experimental modes in neato, "hier", which adds a top-down directionality similar to the layout used in dot, and "ipsep", which allows the graph to specify minimum vertical and horizontal distances between nodes. (See the sep attribute.) +

+ For sfdp, the default mode is "spring", which corresponds to using + a spring-electrical model. Setting mode to "maxent" causes a similar + model to be run but one that also takes into account edge lengths specified by a the + "len" attribute.

model
This value specifies how the distance matrix is computed for the input @@ -1530,6 +1548,9 @@ This field indicates which graph component uses the attribute.
rotate
If 90, set drawing orientation to landscape. +
rotation +
Causes the final layout to be rotated counter-clockwise by the specified number of degrees. +
samehead
Edges with the same head and the same samehead value are aimed at the same point on the head. diff --git a/doc/infosrc/attrs b/doc/infosrc/attrs index b4e35142f..6ddcb4a38 100644 --- a/doc/infosrc/attrs +++ b/doc/infosrc/attrs @@ -389,7 +389,7 @@ In this case, if both the width or the height are set explicitly, the maximum of the two values is used. If neither is set explicitly, the minimum of the two default values is used. -:href:E:escString:""; map,ps,svg +:href:GCNE:escString:""; map,ps,svg Synonym for URL. :id:GNE:escString:""; map,ps,svg Allows the graph author to provide an id for graph objects which is to be included in the output. @@ -525,6 +525,14 @@ If undefined, the value of the target is used. Tooltip annotation attached to label of an edge. This is used only if the edge has a URL or labelURL attribute. +:label_scheme:G:int:0:0; sfdp +The value indicates +whether to treat a node whose name has the form |edgelabel|* as a special node representing an edge label. +The default (0) produces no effect. +If the attribute is set to 1, sfdp uses a penalty-based method to make that kind of node close to the +center of its neighbor. With a value of 2, sfdp uses a penalty-based method to make that kind of node +close to the old center of its neighbor. Finally, a value of 3 invokes a two-step process of overlap +removal and straightening. :landscape:G:bool:false; If true, the graph is rendered in landscape mode. Synonymous with rotate=90 or @@ -603,19 +611,24 @@ maximum number of iterations in each pass. Specifies the minimum separation between all nodes. :minlen:E:int:1:0; dot Minimum edge length (rank difference between head and tail). -:mode:G:string:"major"; neato -Technique for optimizing the layout. If mode is "major", +:mode:G:string:major/spring; neato,sfdp +Technique for optimizing the layout. For neato, if mode is "major", neato uses stress majorization. If mode is "KK", neato uses a version of the gradient descent method. The only advantage to the latter technique is that it is sometimes appreciably faster for small (number of nodes < 100) graphs. A significant disadvantage is that it may cycle.

-There are two new, experimental modes in neato, "hier", which adds a top-down +There are two experimental modes in neato, "hier", which adds a top-down directionality similar to the layout used in dot, and "ipsep", which allows the graph to specify minimum vertical and horizontal distances between nodes. (See the sep attribute.) -:model:G:string:"shortpath"; neato +

+For sfdp, the default mode is "spring", which corresponds to using +a spring-electrical model. Setting mode to "maxent" causes a similar +model to be run but one that also takes into account edge lengths specified by a the +"len" attribute. +:model:G:string:shortpath; neato This value specifies how the distance matrix is computed for the input graph. The distance matrix specifies the ideal distance between every pair of nodes. neato attemps to find a layout which best achieves @@ -867,7 +880,7 @@ neato, it is assumed the positions have been set by one of the layout programs, and are therefore in points. Thus, neato -n can accept input correctly without requiring a -s flag and, in fact, ignores any such flag. -:quadtree:G:quadType/bool:"normal"; sfdp +:quadtree:G:quadType/bool:normal; sfdp Quadtree scheme to use.

A TRUE bool value corresponds to "normal"; @@ -986,6 +999,8 @@ If the root attribute is defined as the empty string, twopi will reset it to name of the node picked as the root node. :rotate:G:int:0; If 90, set drawing orientation to landscape. +:rotation:G:double:0; sfdp +Causes the final layout to be rotated counter-clockwise by the specified number of degrees. :samehead:E:string:""; dot Edges with the same head and the same samehead value are aimed at the same point on the head. -- 2.40.0