org.jgrapht.generate

Class LinearGraphGenerator<V,E>

java.lang.Object

org.jgrapht.generate.LinearGraphGenerator<V,E>

Type Parameters:

V - the graph vertex type

E - the graph edge type

All Implemented Interfaces:

GraphGenerator<V,E,V>

public class LinearGraphGenerator<V,E>
extends Object
implements GraphGenerator<V,E,V>

Generates a linear graph of any size. For a directed graph, the edges are oriented from START_VERTEX to END_VERTEX.

Since:

Sep 16, 2003

Author:

John V. Sichi

Field Summary

Fields

Modifier and Type	Field and Description
static String	END_VERTEX Role for the last vertex generated.
static String	START_VERTEX Role for the first vertex generated.

Constructor Summary

Constructors

Constructor and Description
LinearGraphGenerator(int size) Construct a new LinearGraphGenerator.

Method Summary

Modifier and Type	Method and Description
void	generateGraph(Graph<V,E> target, VertexFactory<V> vertexFactory, Map<String,V> resultMap) Generate a graph structure.

Methods inherited from class java.lang.Object

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

Field Detail

START_VERTEX

public static final String START_VERTEX

Role for the first vertex generated.

See Also:

Constant Field Values

END_VERTEX

public static final String END_VERTEX

Role for the last vertex generated.

See Also:

Constant Field Values

Constructor Detail

LinearGraphGenerator

public LinearGraphGenerator(int size)

Construct a new LinearGraphGenerator.

Parameters:

size - number of vertices to be generated

Throws:

IllegalArgumentException - if the specified size is negative.

Method Detail

generateGraph

public void generateGraph(Graph<V,E> target,
                          VertexFactory<V> vertexFactory,
                          Map<String,V> resultMap)

Generate a graph structure. The topology of the generated graph is dependent on the implementation. For graphs in which not all vertices share the same automorphism equivalence class, the generator may produce a labeling indicating the roles played by generated elements. This is the purpose of the resultMap parameter. For example, a generator for a wheel graph would designate a hub vertex. Role names used as keys in resultMap should be declared as public static final Strings by implementation classes.

Specified by:

generateGraph in interface GraphGenerator<V,E,V>

Parameters:

target - receives the generated edges and vertices; if this is non-empty on entry, the result will be a disconnected graph since generated elements will not be connected to existing elements

vertexFactory - called to produce new vertices

resultMap - if non-null, receives implementation-specific mappings from String roles to graph elements (or collections of graph elements)