|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg._3pq.jgrapht.graph.AbstractGraph
org._3pq.jgrapht.graph.Subgraph
A subgraph is a graph that has a subset of vertices and a subset of edges
with respect to some base graph. More formally, a subgraph G(V,E) that is
based on a base graph Gb(Vb,Eb) satisfies the following subgraph
property: V is a subset of Vb and E is a subset of Eb. Other than
this property, a subgraph is a graph with any respect and fully complies
with the Graph
interface.
If the base graph is a ListenableGraph
, the
subgraph listens on the base graph and guarantees the subgraph property. If
an edge or a vertex is removed from the base graph, it is automatically
removed from the subgraph. Subgraph listeners are informed on such removal
only if it results in a cascaded removal from the subgraph. If edges or
vertices are added to the base graph, the subgraph remains unaffected.
If the base graph is not a ListenableGraph, then the subgraph property cannot be guaranteed. If edges or vertices are removed from the base graph, they are not removed from the subgraph.
Modifications to Subgraph are allowed as long as the subgraph property is maintained. Addition of vertices or edges are allowed as long as they also exist in the base graph. Removal of vertices or edges is always allowed. The base graph is never affected by any modification made to the subgraph.
A subgraph may provide a "live-window" on a base graph, so that changes made
to its vertices or edges are immediately reflected in the base graph, and
vice versa. For that to happen, vertices and edges added to the subgraph
must be identical (that is, reference-equal and not only
value-equal) to their respective ones in the base graph. Previous versions
of this class enforced such identity, at a severe performance cost.
Currently it is no longer enforced. If you want to achieve a "live-window"
functionality, your safest tactics would be to NOT override the
equals()
methods of your vertices and edges. If you use a class
that has already overridden the equals()
method, such as
String
, than you can use a wrapper around it, or else use it
directly but exercise a great care to avoid having different-but-equal
instances in the subgraph and the base graph.
Graph
,
Set
,
Serialized FormConstructor Summary | |
Subgraph(Graph base,
java.util.Set vertexSubset,
java.util.Set edgeSubset)
Creates a new Subgraph. |
Method Summary | |
boolean |
addEdge(Edge e)
Adds the specified edge to this subgraph. |
Edge |
addEdge(java.lang.Object sourceVertex,
java.lang.Object targetVertex)
Creates a new edge in this graph, going from the source vertex to the target vertex, and returns the created edge. |
boolean |
addVertex(java.lang.Object v)
Adds the specified vertex to this subgraph. |
boolean |
containsEdge(Edge e)
Returns true if this graph contains the specified edge. |
boolean |
containsVertex(java.lang.Object v)
Returns true if this graph contains the specified vertex. |
int |
degreeOf(java.lang.Object vertex)
|
java.util.Set |
edgeSet()
Returns a set of the edges contained in this graph. |
java.util.List |
edgesOf(java.lang.Object vertex)
Returns a list of all edges touching the specified vertex. |
java.util.List |
getAllEdges(java.lang.Object sourceVertex,
java.lang.Object targetVertex)
Returns a list of all edges connecting source vertex to target vertex if such vertices exist in this graph. |
Edge |
getEdge(java.lang.Object sourceVertex,
java.lang.Object targetVertex)
Returns an edge connecting source vertex to target vertex if such vertices and such edge exist in this graph. |
EdgeFactory |
getEdgeFactory()
Returns the edge factory using which this graph creates new edges. |
java.util.List |
incomingEdgesOf(java.lang.Object vertex)
|
int |
inDegreeOf(java.lang.Object vertex)
|
boolean |
isVerifyIntegrity()
Deprecated. method will be deleted in future versions. |
int |
outDegreeOf(java.lang.Object vertex)
|
java.util.List |
outgoingEdgesOf(java.lang.Object vertex)
|
boolean |
removeEdge(Edge e)
Removes the specified edge from the graph. |
Edge |
removeEdge(java.lang.Object sourceVertex,
java.lang.Object targetVertex)
Removes an edge going from source vertex to target vertex, if such vertices and such edge exist in this graph. |
boolean |
removeVertex(java.lang.Object v)
Removes the specified vertex from this graph including all its touching edges if present. |
void |
setVerifyIntegrity(boolean verifyIntegrity)
Deprecated. method will be deleted in future versions. verifyIntegrity flag has no effect now. |
java.util.Set |
vertexSet()
Returns a set of the vertices contained in this graph. |
Methods inherited from class org._3pq.jgrapht.graph.AbstractGraph |
addAllEdges, addAllVertices, assertVertexExist, containsEdge, removeAllEdges, removeAllEdges, removeAllEdges, removeAllVertices, toStringFromSets |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public Subgraph(Graph base, java.util.Set vertexSubset, java.util.Set edgeSubset)
base
- the base (backing) graph on which the subgraph will be
based.vertexSubset
- vertices to include in the subgraph. If
null
then all vertices are included.edgeSubset
- edges to in include in the subgraph. If
null
then all the edges whose vertices found in the
graph are included.Method Detail |
public java.util.List getAllEdges(java.lang.Object sourceVertex, java.lang.Object targetVertex)
Graph
null
, returns null
. If both
vertices exist but no edges found, returns an empty list.
In undirected graphs, some of the returned edges may have their source and target vertices in the opposite order. In simple graphs the returned list is either singleton list or empty list.
getAllEdges
in interface Graph
sourceVertex
- source vertex of the edge.targetVertex
- target vertex of the edge.
Graph.getAllEdges(Object, Object)
public Edge getEdge(java.lang.Object sourceVertex, java.lang.Object targetVertex)
Graph
null
. If any of the specified vertices is
null
returns null
In undirected graphs, the returned edge may have its source and target vertices in the opposite order.
getEdge
in interface Graph
sourceVertex
- source vertex of the edge.targetVertex
- target vertex of the edge.
Graph.getEdge(Object, Object)
public EdgeFactory getEdgeFactory()
Graph
getEdgeFactory
in interface Graph
Graph.getEdgeFactory()
public void setVerifyIntegrity(boolean verifyIntegrity)
verifyIntegrity
- Subgraph
public boolean isVerifyIntegrity()
public Edge addEdge(java.lang.Object sourceVertex, java.lang.Object targetVertex)
Graph
null
.
The source and target vertices must already be contained in this graph. If they are not found in graph IllegalArgumentException is thrown.
This method creates the new edge e
using this graph's
EdgeFactory
. For the new edge to be added e
must not be equal to any other edge the graph (even if the graph
allows edge-multiplicity). More formally, the graph must not contain
any edge e2
such that e2.equals(e)
. If such
e2
is found then the newly created edge e
is
abandoned, the method leaves this graph unchanged returns
null
.
addEdge
in interface Graph
sourceVertex
- source vertex of the edge.targetVertex
- target vertex of the edge.
null
.Graph.addEdge(Object, Object)
public boolean addEdge(Edge e)
addEdge
in interface Graph
e
- the edge to be added.
true
if the edge was added, otherwise
false
.
java.lang.NullPointerException
java.lang.IllegalArgumentException
Subgraph
,
Graph.addEdge(Edge)
public boolean addVertex(java.lang.Object v)
addVertex
in interface Graph
v
- the vertex to be added.
true
if the vertex was added, otherwise
false
.
java.lang.NullPointerException
java.lang.IllegalArgumentException
Subgraph
,
Graph.addVertex(Object)
public boolean containsEdge(Edge e)
Graph
e2
such that e.equals(e2)
. If the
specified edge is null
returns false
.
containsEdge
in interface Graph
e
- edge whose presence in this graph is to be tested.
Graph.containsEdge(Edge)
public boolean containsVertex(java.lang.Object v)
Graph
u
such that u.equals(v)
. If the
specified vertex is null
returns false
.
containsVertex
in interface Graph
v
- vertex whose presence in this graph is to be tested.
Graph.containsVertex(Object)
public int degreeOf(java.lang.Object vertex)
UndirectedGraph.degreeOf(Object)
public java.util.Set edgeSet()
Graph
edgeSet
in interface Graph
Graph.edgeSet()
public java.util.List edgesOf(java.lang.Object vertex)
Graph
edgesOf
in interface Graph
vertex
- the vertex for which a list of touching edges to be
returned.
Graph.edgesOf(Object)
public int inDegreeOf(java.lang.Object vertex)
DirectedGraph.inDegreeOf(Object)
public java.util.List incomingEdgesOf(java.lang.Object vertex)
DirectedGraph.incomingEdgesOf(Object)
public int outDegreeOf(java.lang.Object vertex)
DirectedGraph.outDegreeOf(Object)
public java.util.List outgoingEdgesOf(java.lang.Object vertex)
DirectedGraph.outgoingEdgesOf(Object)
public boolean removeEdge(Edge e)
Graph
e2
such that e2.equals(e)
, if the graph
contains such edge. Returns true if the graph contained the
specified edge. (The graph will not contain the specified edge once the
call returns).
If the specified edge is null
returns false
.
removeEdge
in interface Graph
e
- edge to be removed from this graph, if present.
true
if and only if the graph contained the
specified edge.Graph.removeEdge(Edge)
public Edge removeEdge(java.lang.Object sourceVertex, java.lang.Object targetVertex)
Graph
null
otherwise.
removeEdge
in interface Graph
sourceVertex
- source vertex of the edge.targetVertex
- target vertex of the edge.
null
if no edge removed.Graph.removeEdge(Object, Object)
public boolean removeVertex(java.lang.Object v)
Graph
u
such that u.equals(v)
, the call removes all
edges that touch u
and then removes u
itself.
If no such u
is found, the call leaves the graph
unchanged. Returns true if the graph contained the specified
vertex. (The graph will not contain the specified vertex once the call
returns).
If the specified vertex is null
returns false
.
removeVertex
in interface Graph
v
- vertex to be removed from this graph, if present.
true
if the graph contained the specified vertex;
false
otherwise.Graph.removeVertex(Object)
public java.util.Set vertexSet()
Graph
vertexSet
in interface Graph
Graph.vertexSet()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |