com.tensegrity.graph.layout.energy
Class EnergyLayoutConstants

java.lang.Object
  com.tensegrity.graph.layout.energy.EnergyLayoutConstants

public class EnergyLayoutConstants

extends java.lang.Object

This class contains the configuration attributes as well as their default values, which are used primarily by class EnergyLayout

The EnergyLayout class uses an iterative procedure to arrange graphs. The larger the number of iterations, the better the results, but at a cost of a longer computation time. You are able to specify whether an EnergyLayout instance should use the current node positions to improve the graph arrangement or to set new node positions. For good results, the forces attraction and rejection play an important role. The following attributes may be used to influence the layout result:

• LAYOUT_QUALITY_DESC
• ATTRACTION_FORCE_DESC
• REJECTION_FORECE_DESC
• REJECTION_FORECE_DESC
• MAX_DURATION_DESC

The EnergyLayout class provides the following attributes to adjust the distance between nodes:

• IDEAL_DISTANCE_DESC
• GRAPH_CONCENTRATION_DESC

The process duration depends on the number of nodes that are to be arranged and the number of iterations specified by LAYOUT_QUALITY_DESC. Moreover, there is an attribute to limit the maximal layout processing time:

• MAX_DURATION_DESC

Version:

$Id: EnergyLayoutConstants.java,v 1.24 2005/10/19 13:27:30 BurkhardWick Exp $

Author:

Sharokh Khani

Field Summary

static double	ATTRACTION_FORCE_DEF The default value for ATTRACTION_FORCE_DESC.
static java.lang.String	ATTRACTION_FORCE_DESC Specifies the attraction force between nodes.
static java.lang.String	GRAPH_CATEGORY_DESC Description text of attributes.
static double	GRAPH_CONCENTRATION_DEF The default value for GRAPH_CONCENTRATION_DESC.
static java.lang.String	GRAPH_CONCENTRATION_DESC This attribute may be used to set the concentration factor of the positioned graph.
static MetricExpression	IDEAL_DISTANCE_DEF The default value for IDEAL_DISTANCE_DESC.
static java.lang.String	IDEAL_DISTANCE_DESC The ideal distance between nodes.
static java.lang.String	LAYOUT_NAME The name of this layout.
static double	LAYOUT_QUALITY_DEF The default value for LAYOUT_QUALITY_DESC.
static java.lang.String	LAYOUT_QUALITY_DESC The quality of the layout.
static int	MAX_DURATION_DEF The default value for MAX_DURATION_DESC.
static java.lang.String	MAX_DURATION_DESC Specifies the maximum allowed duration for arranging the graph, in milliseconds.
static double	REJECTION_FORECE_DEF The default value for REJECTION_FORECE_DESC.
static java.lang.String	REJECTION_FORECE_DESC Specifies the rejection force between nodes.
static boolean	USE_CURRENT_POSITION_DEF The default value for USE_CURRENT_POSITION_DESC
static java.lang.String	USE_CURRENT_POSITION_DESC Specifies whether the current position the nodes or a new starting position should be used.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LAYOUT_NAME

public static final java.lang.String LAYOUT_NAME

The name of this layout.

See Also:

Constant Field Values

GRAPH_CATEGORY_DESC

public static final java.lang.String GRAPH_CATEGORY_DESC

Description text of attributes.

See Also:

Constant Field Values

IDEAL_DISTANCE_DESC

public static final java.lang.String IDEAL_DISTANCE_DESC

The ideal distance between nodes.
Please note that the EnergyLayout is unable to exactly maintain the specified distance. The accuracy of the target distance also depends on LAYOUT_QUALITY_DESC and the balancing of forces REJECTION_FORECE_DESC and ATTRACTION_FORCE_DESC

See Also:

Constant Field Values

IDEAL_DISTANCE_DEF

public static final MetricExpression IDEAL_DISTANCE_DEF

The default value for IDEAL_DISTANCE_DESC.

LAYOUT_QUALITY_DESC

public static final java.lang.String LAYOUT_QUALITY_DESC

The quality of the layout. This value specifies the number of iterations x 100. The higher this value, the better the quality, but a longer computation time is required.

See Also:

Constant Field Values

LAYOUT_QUALITY_DEF

public static final double LAYOUT_QUALITY_DEF

The default value for LAYOUT_QUALITY_DESC.

See Also:

Constant Field Values

GRAPH_CONCENTRATION_DESC

public static final java.lang.String GRAPH_CONCENTRATION_DESC

This attribute may be used to set the concentration factor of the positioned graph. The higher the concentration factor, the more compact the output graph and the less clear its structure. The picture below shows the result graph after arranging it with a concentration factor of 1.0 and 10.0:

See Also:

Constant Field Values

GRAPH_CONCENTRATION_DEF

public static final double GRAPH_CONCENTRATION_DEF

The default value for GRAPH_CONCENTRATION_DESC.

See Also:

Constant Field Values

REJECTION_FORECE_DESC

public static final java.lang.String REJECTION_FORECE_DESC

Specifies the rejection force between nodes.
Please note that a good result can only be achieved by balancing the forces REJECTION_FORECE_DESC and ATTRACTION_FORCE_DESC.

See Also:

Constant Field Values

REJECTION_FORECE_DEF

public static final double REJECTION_FORECE_DEF

The default value for REJECTION_FORECE_DESC.

See Also:

Constant Field Values

ATTRACTION_FORCE_DESC

public static final java.lang.String ATTRACTION_FORCE_DESC

Specifies the attraction force between nodes.
Please note that a good result can only be achieved by a good balancing of both forces REJECTION_FORECE_DESC and ATTRACTION_FORCE_DESC.

See Also:

Constant Field Values

ATTRACTION_FORCE_DEF

public static final double ATTRACTION_FORCE_DEF

The default value for ATTRACTION_FORCE_DESC.

See Also:

Constant Field Values

MAX_DURATION_DESC

public static final java.lang.String MAX_DURATION_DESC

Specifies the maximum allowed duration for arranging the graph, in milliseconds.

See Also:

Constant Field Values

MAX_DURATION_DEF

public static final int MAX_DURATION_DEF

The default value for MAX_DURATION_DESC.

See Also:

Constant Field Values

USE_CURRENT_POSITION_DESC

public static final java.lang.String USE_CURRENT_POSITION_DESC

Specifies whether the current position the nodes or a new starting position should be used.

See Also:

Constant Field Values

USE_CURRENT_POSITION_DEF

public static final boolean USE_CURRENT_POSITION_DEF

The default value for USE_CURRENT_POSITION_DESC

See Also:

Constant Field Values