org._3pq.jgrapht.generate

Interface GraphGenerator

Known Implementing Classes:
EmptyGraphGenerator, LinearGraphGenerator, RingGraphGenerator, WheelGraphGenerator

public interface GraphGenerator

GraphGenerator defines an interface for generating new graph structures.
Author:
John V. Sichi
Since:
Sep 16, 2003

Method Summary

void
generateGraph(Graph target, VertexFactory vertexFactory, Map resultMap)
Generate a graph structure.

Method Details

generateGraph

public void generateGraph(Graph target,
                          VertexFactory vertexFactory,
                          Map 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.
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)