Class ImmutableGraph<N>
- java.lang.Object
-
- com.google.common.graph.AbstractGraph<N>
-
- com.google.common.graph.ImmutableGraph<N>
-
- Type Parameters:
N- Node parameter type
- All Implemented Interfaces:
Graph<N>,PredecessorsFunction<N>,SuccessorsFunction<N>
@Beta public class ImmutableGraph<N> extends AbstractGraph<N>
AGraphwhose elements and structural relationships will never change. Instances of this class may be obtained withcopyOf(Graph).See the Guava User's Guide's discussion of the
Immutable*types for more information on the properties and guarantees provided by this class.- Since:
- 20.0
- Author:
- James Sexton, Joshua O'Madadhain, Omar Darwish
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description java.util.Set<N>adjacentNodes(N node)Returns the nodes which have an incident edge in common withnodein this graph.booleanallowsSelfLoops()Returns true if this graph allows self-loops (edges that connect a node to itself).static <N> ImmutableGraph<N>copyOf(Graph<N> graph)Returns an immutable copy ofgraph.static <N> ImmutableGraph<N>copyOf(ImmutableGraph<N> graph)Deprecated.no need to use thisintdegree(N node)Returns the count ofnode's incident edges, counting self-loops twice (equivalently, the number of times an edge touchesnode).protected com.google.common.graph.BaseGraph<N>delegate()protected longedgeCount()Defer toBaseGraph.edges()(based onGraph.successors(Object)) for full edges() implementation.java.util.Set<EndpointPair<N>>edges()An implementation ofBaseGraph.edges()defined in terms ofnodes()andSuccessorsFunction.successors(Object).booleanhasEdgeConnecting(N nodeU, N nodeV)Returns true if there is an edge directly connectingnodeUtonodeV.java.util.Set<EndpointPair<N>>incidentEdges(N node)intinDegree(N node)Returns the count ofnode's incoming edges (equal topredecessors(node).size()) in a directed graph.booleanisDirected()Returns true if the edges in this graph are directed.ElementOrder<N>nodeOrder()Returns the order of iteration for the elements ofGraph.nodes().java.util.Set<N>nodes()Returns all nodes in this graph, in the order specified byGraph.nodeOrder().intoutDegree(N node)Returns the count ofnode's outgoing edges (equal tosuccessors(node).size()) in a directed graph.java.util.Set<N>predecessors(N node)Returns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's incoming edges against the direction (if any) of the edge.java.util.Set<N>successors(N node)Returns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's outgoing edges in the direction (if any) of the edge.-
Methods inherited from class com.google.common.graph.AbstractGraph
equals, hashCode, toString
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.google.common.graph.Graph
edges, incidentEdges
-
-
-
-
Method Detail
-
copyOf
public static <N> ImmutableGraph<N> copyOf(Graph<N> graph)
Returns an immutable copy ofgraph.
-
copyOf
@Deprecated public static <N> ImmutableGraph<N> copyOf(ImmutableGraph<N> graph)
Deprecated.no need to use thisSimply returns its argument.
-
nodes
public java.util.Set<N> nodes()
Description copied from interface:GraphReturns all nodes in this graph, in the order specified byGraph.nodeOrder().
-
edgeCount
protected long edgeCount()
Defer toBaseGraph.edges()(based onGraph.successors(Object)) for full edges() implementation.
-
isDirected
public boolean isDirected()
Description copied from interface:GraphReturns true if the edges in this graph are directed. Directed edges connect asource nodeto atarget node, while undirected edges connect a pair of nodes to each other.
-
allowsSelfLoops
public boolean allowsSelfLoops()
Description copied from interface:GraphReturns true if this graph allows self-loops (edges that connect a node to itself). Attempting to add a self-loop to a graph that does not allow them will throw anIllegalArgumentException.
-
nodeOrder
public ElementOrder<N> nodeOrder()
Description copied from interface:GraphReturns the order of iteration for the elements ofGraph.nodes().
-
adjacentNodes
public java.util.Set<N> adjacentNodes(N node)
Description copied from interface:GraphReturns the nodes which have an incident edge in common withnodein this graph.
-
predecessors
public java.util.Set<N> predecessors(N node)
Description copied from interface:GraphReturns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's incoming edges against the direction (if any) of the edge.In an undirected graph, this is equivalent to
Graph.adjacentNodes(Object).
-
successors
public java.util.Set<N> successors(N node)
Description copied from interface:GraphReturns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's outgoing edges in the direction (if any) of the edge.In an undirected graph, this is equivalent to
Graph.adjacentNodes(Object).This is not the same as "all nodes reachable from
nodeby following outgoing edges". For that functionality, seeGraphs.reachableNodes(Graph, Object).
-
degree
public int degree(N node)
Description copied from interface:GraphReturns the count ofnode's incident edges, counting self-loops twice (equivalently, the number of times an edge touchesnode).For directed graphs, this is equal to
inDegree(node) + outDegree(node).For undirected graphs, this is equal to
incidentEdges(node).size()+ (number of self-loops incident tonode).If the count is greater than
Integer.MAX_VALUE, returnsInteger.MAX_VALUE.
-
inDegree
public int inDegree(N node)
Description copied from interface:GraphReturns the count ofnode's incoming edges (equal topredecessors(node).size()) in a directed graph. In an undirected graph, returns theGraph.degree(Object).If the count is greater than
Integer.MAX_VALUE, returnsInteger.MAX_VALUE.
-
outDegree
public int outDegree(N node)
Description copied from interface:GraphReturns the count ofnode's outgoing edges (equal tosuccessors(node).size()) in a directed graph. In an undirected graph, returns theGraph.degree(Object).If the count is greater than
Integer.MAX_VALUE, returnsInteger.MAX_VALUE.
-
hasEdgeConnecting
public boolean hasEdgeConnecting(N nodeU, N nodeV)Description copied from interface:GraphReturns true if there is an edge directly connectingnodeUtonodeV. This is equivalent tonodes().contains(nodeU) && successors(nodeU).contains(nodeV).In an undirected graph, this is equal to
hasEdgeConnecting(nodeV, nodeU).- Specified by:
hasEdgeConnectingin interfaceGraph<N>
-
edges
public java.util.Set<EndpointPair<N>> edges()
An implementation ofBaseGraph.edges()defined in terms ofnodes()andSuccessorsFunction.successors(Object).
-
incidentEdges
public java.util.Set<EndpointPair<N>> incidentEdges(N node)
-
-