Data.Graph.Inductive.Graph · fgl-5.8.2.0

Each class contains in addition to its essential operations those derived operations that might be overwritten by a more efficient implementation in an instance definition.

Note that labNodes is essentially needed because the default definition for matchAny is based on it: we need some node from the graph to define matchAny in terms of match. Alternatively, we could have made matchAny essential and have labNodes defined in terms of ufold and matchAny. However, in general, labNodes seems to be (at least) as easy to define as matchAny. We have chosen labNodes instead of the function nodes since nodes can be easily derived from labNodes, but not vice versa.

classclass Graph (gr :: Type -> Type -> Type) where

#

Minimum implementation: empty, isEmpty, match, mkGraph, labNodes

Methods

empty :: gr a b
An empty Graph.
isEmpty :: gr a b -> Bool
True if the given Graph is empty.
match :: Node -> gr a b -> Decomp gr a b
Decompose a Graph into the MContext found for the given node and the remaining Graph.
mkGraph :: [LNode a] -> [LEdge b] -> gr a b
Create a Graph from the list of LNodes and LEdges.
For graphs that are also instances of DynGraph, mkGraph ns es should be equivalent to (insEdges es . insNodes ns) empty.
labNodes :: gr a b -> [LNode a]
A list of all LNodes in the Graph.
matchAny :: gr a b -> GDecomp gr a b
Decompose a graph into the Context for an arbitrarily-chosen Node and the remaining Graph.
noNodes :: gr a b -> Int
The number of Nodes in a Graph.
nodeRange :: gr a b -> (Node, Node)
The minimum and maximum Node in a Graph.
labEdges :: gr a b -> [LEdge b]
A list of all LEdges in the Graph.

Instances2Graph

Graph GrDefined in fgl-5.8.2.0 · Data.Graph.Inductive.PatriciaTree
Graph GrDefined in fgl-5.8.2.0 · Data.Graph.Inductive.Tree

classclass Graph gr => DynGraph (gr :: Type -> Type -> Type) where

#

Methods

(&) :: Context a b -> gr a b -> gr a b
Merge the Context into the DynGraph.
Context adjacencies should only refer to either a Node already in a graph or the node in the Context itself (for loops).
Behaviour is undefined if the specified Node already exists in the graph.

Instances2DynGraph

DynGraph GrDefined in fgl-5.8.2.0 · Data.Graph.Inductive.PatriciaTree
DynGraph GrDefined in fgl-5.8.2.0 · Data.Graph.Inductive.Tree

Operations

3 declarations

valueinsert :: DynGraph gr => Context a b -> gr a b -> gr a b

#

A synonym for &, to avoid conflicts with the similarly named operator in Data.Function.

valueorder :: Graph gr => gr a b -> Int

#

The number of nodes in the graph. An alias for noNodes.

valuesize :: Graph gr => gr a b -> Int

#

The number of edges in the graph.

Note that this counts every edge found, so if you are representing an unordered graph by having each edge mirrored this will be incorrect.

If you created an unordered graph by either mirroring every edge (including loops!) or using the undir function in Data.Graph.Inductive.Basic then you can safely halve the value returned by this.

Graph Folds and Maps

valueufold :: Graph gr => (Context a b -> c -> c) -> c -> gr a b -> c

#

Fold a function over the graph by recursively calling match.

valuegmap :: DynGraph gr => (Context a b -> Context c d) -> gr a b -> gr c d

#

Map a function over the graph by recursively calling match.

valuenmap :: DynGraph gr => (a -> c) -> gr a b -> gr c b

#

Map a function over the Node labels in a graph.

valueemap :: DynGraph gr => (b -> c) -> gr a b -> gr a c

#

Map a function over the Edge labels in a graph.

valuenemap :: DynGraph gr => (a -> c) -> (b -> d) -> gr a b -> gr c d

#

Map functions over both the Node and Edge labels in a graph.

Graph Projection

valuenodes :: Graph gr => gr a b -> [Node]

#

List all Nodes in the Graph.

valueedges :: Graph gr => gr a b -> [Edge]

#

List all Edges in the Graph.

valuetoEdge :: LEdge b -> Edge

#

Drop the label component of an edge.

valueedgeLabel :: LEdge b -> b

#

The label in an edge.

valuetoLEdge :: Edge -> b -> LEdge b

#

Add a label to an edge.

valuenewNodes :: Graph gr => Int -> gr a b -> [Node]

#

List N available Nodes, i.e. Nodes that are not used in the Graph.

valuegelem :: Graph gr => Node -> gr a b -> Bool

#

True if the Node is present in the Graph.

Graph Construction and Destruction

valueinsNode :: DynGraph gr => LNode a -> gr a b -> gr a b

#

Insert a LNode into the Graph.

valueinsEdge :: DynGraph gr => LEdge b -> gr a b -> gr a b

#

Insert a LEdge into the Graph.

valuedelNode :: Graph gr => Node -> gr a b -> gr a b

#

Remove a Node from the Graph.

valuedelEdge :: DynGraph gr => Edge -> gr a b -> gr a b

#

Remove an Edge from the Graph.

NOTE: in the case of multiple edges, this will delete all such edges from the graph as there is no way to distinguish between them. If you need to delete only a single such edge, please use delLEdge.

valuedelLEdge :: (DynGraph gr, Eq b) => LEdge b -> gr a b -> gr a b

#

Remove an LEdge from the Graph.

NOTE: in the case of multiple edges with the same label, this will only delete the first such edge. To delete all such edges, please use delAllLEdge.

valuedelAllLEdge :: (DynGraph gr, Eq b) => LEdge b -> gr a b -> gr a b

#

Remove all edges equal to the one specified.

valueinsNodes :: DynGraph gr => [LNode a] -> gr a b -> gr a b

#

Insert multiple LNodes into the Graph.

valueinsEdges :: DynGraph gr => [LEdge b] -> gr a b -> gr a b

#

Insert multiple LEdges into the Graph.

valuedelNodes :: Graph gr => [Node] -> gr a b -> gr a b

#

Remove multiple Nodes from the Graph.

valuedelEdges :: DynGraph gr => [Edge] -> gr a b -> gr a b

#

Remove multiple Edges from the Graph.

valuebuildGr :: DynGraph gr => [Context a b] -> gr a b

#

Build a Graph from a list of Contexts.

The list should be in the order such that earlier Contexts depend upon later ones (i.e. as produced by ufold (:) []).

valuemkUGraph :: Graph gr => [Node] -> [Edge] -> gr () ()

#

Build a quasi-unlabeled Graph.

Subgraphs

valuegfiltermap

:: DynGraph gr
=> Context a b -> MContext c d
-> gr a b
-> gr c d

#

Build a graph out of the contexts for which the predicate is satisfied by recursively calling match.

valuenfilter :: DynGraph gr => (Node -> Bool) -> gr a b -> gr a b

#

Returns the subgraph only containing the nodes which satisfy the given predicate.

valuelabnfilter :: Graph gr => (LNode a -> Bool) -> gr a b -> gr a b

#

Returns the subgraph only containing the labelled nodes which satisfy the given predicate.

valuelabfilter :: DynGraph gr => (a -> Bool) -> gr a b -> gr a b

#

Returns the subgraph only containing the nodes whose labels satisfy the given predicate.

valuesubgraph :: DynGraph gr => [Node] -> gr a b -> gr a b

#

Returns the subgraph induced by the supplied nodes.

Graph Inspection

valuecontext :: Graph gr => gr a b -> Node -> Context a b

#

Find the context for the given Node. Causes an error if the Node is not present in the Graph.

valuelab :: Graph gr => gr a b -> Node -> Maybe a

#

Find the label for a Node.

valueneighbors :: Graph gr => gr a b -> Node -> [Node]

#

Find the neighbors for a Node.

valuelneighbors :: Graph gr => gr a b -> Node -> Adj b

#

Find the labelled links coming into or going from a Context.

valuesuc :: Graph gr => gr a b -> Node -> [Node]

#

Find all Nodes that have a link from the given Node.

valuepre :: Graph gr => gr a b -> Node -> [Node]

#

Find all Nodes that link to to the given Node.

valuelsuc :: Graph gr => gr a b -> Node -> [(Node, b)]

#

Find all Nodes that are linked from the given Node and the label of each link.

valuelpre :: Graph gr => gr a b -> Node -> [(Node, b)]

#

Find all Nodes that link to the given Node and the label of each link.

valueout :: Graph gr => gr a b -> Node -> [LEdge b]

#

Find all outward-bound LEdges for the given Node.

valueinn :: Graph gr => gr a b -> Node -> [LEdge b]

#

Find all inward-bound LEdges for the given Node.

valueoutdeg :: Graph gr => gr a b -> Node -> Int

#

The outward-bound degree of the Node.

valueindeg :: Graph gr => gr a b -> Node -> Int

#

The inward-bound degree of the Node.

valuedeg :: Graph gr => gr a b -> Node -> Int

#

The degree of the Node.

valuehasEdge :: Graph gr => gr a b -> Edge -> Bool

#

Checks if there is a directed edge between two nodes.

valuehasNeighbor :: Graph gr => gr a b -> Node -> Node -> Bool

#

Checks if there is an undirected edge between two nodes.

valuehasLEdge :: (Graph gr, Eq b) => gr a b -> LEdge b -> Bool

#

Checks if there is a labelled edge between two nodes.

valuehasNeighborAdj :: (Graph gr, Eq b) => gr a b -> Node -> (b, Node) -> Bool

#

Checks if there is an undirected labelled edge between two nodes.

valueequal :: (Eq a, Eq b, Graph gr) => gr a b -> gr a b -> Bool

#

Context Inspection

valuenode' :: Context a b -> Node

#

The Node in a Context.

valuelab' :: Context a b -> a

#

The label in a Context.

valuelabNode' :: Context a b -> LNode a

#

The LNode from a Context.

valueneighbors' :: Context a b -> [Node]

#

All Nodes linked to or from in a Context.

valuelneighbors' :: Context a b -> Adj b

#

All labelled links coming into or going from a Context.

valuesuc' :: Context a b -> [Node]

#

All Nodes linked to in a Context.

valuepre' :: Context a b -> [Node]

#

All Nodes linked from in a Context.

valuelpre' :: Context a b -> [(Node, b)]

#

All Nodes linked from in a Context, and the label of the links.

valuelsuc' :: Context a b -> [(Node, b)]

#

All Nodes linked from in a Context, and the label of the links.

valueout' :: Context a b -> [LEdge b]

#

All outward-directed LEdges in a Context.

valueinn' :: Context a b -> [LEdge b]

#

All inward-directed LEdges in a Context.

valueoutdeg' :: Context a b -> Int

#

The outward degree of a Context.

valueindeg' :: Context a b -> Int

#

The inward degree of a Context.

valuedeg' :: Context a b -> Int

#

The degree of a Context.

Pretty-printing

2 declarations

valueprettify :: (Graph gr, Show a, Show b) => gr a b -> String

#

Pretty-print the graph. Note that this loses a lot of information, such as edge inverses, etc.

valueprettyPrint :: (DynGraph gr, Show a, Show b) => gr a b -> IO ()

#

Pretty-print the graph to stdout.

Ordering of Graphs

1 declaration

newtypenewtype OrdGr (gr :: Type -> Type -> Type) a b

#

OrdGr comes equipped with an Ord instance, so that graphs can be used as e.g. Map keys.

Constructors

OrdGr
- unOrdGr :: gr a b

Instances4Eq, Ord, Read, Show

(Graph gr, Ord a, Ord b) => Eq (OrdGr gr a b)Defined in fgl-5.8.2.0 · Data.Graph.Inductive.Graph
(Graph gr, Ord a, Ord b) => Ord (OrdGr gr a b)Defined in fgl-5.8.2.0 · Data.Graph.Inductive.Graph
Read (gr a b) => Read (OrdGr gr a b)Defined in fgl-5.8.2.0 · Data.Graph.Inductive.Graph
Show (gr a b) => Show (OrdGr gr a b)Defined in fgl-5.8.2.0 · Data.Graph.Inductive.Graph