Graphalyze-0.14.0.2: Graph-Theoretic Analysis library.

Maintainer Ivan.Miljenovic@gmail.com None

Data.Graph.Analysis.Algorithms.Directed

Description

Defines algorithms that work on directed graphs.

Synopsis

# Ending nodes

Find starting/ending nodes.

We define an ending node as one where, given a function:

f :: (Graph g) => g a b -> Node -> [Node]

the only allowed result is that node itself (to allow for loops).

endNode :: Graph g => (g a b -> Node -> NGroup) -> g a b -> LNode a -> BoolSource

Determine if this LNode is an ending node.

endNode' :: Graph g => (g a b -> Node -> NGroup) -> g a b -> Node -> BoolSource

Determine if this Node is an ending node.

endBy :: Graph g => (g a b -> Node -> NGroup) -> g a b -> LNGroup aSource

Find all LNodes that meet the ending criteria.

endBy' :: Graph g => (g a b -> Node -> NGroup) -> g a b -> NGroupSource

Find all Nodes that match the ending criteria.

## Root nodes

rootsOf :: Graph g => g a b -> LNGroup aSource

Find all roots of the graph.

rootsOf' :: Graph g => g a b -> NGroupSource

Find all roots of the graph.

isRoot :: Graph g => g a b -> LNode a -> BoolSource

Returns True if this LNode is a root.

isRoot' :: Graph g => g a b -> Node -> BoolSource

Returns True if this Node is a root.

## Leaf nodes

leavesOf :: Graph g => g a b -> LNGroup aSource

Find all leaves of the graph.

leavesOf' :: Graph g => g a b -> NGroupSource

Find all leaves of the graph.

isLeaf :: Graph g => g a b -> LNode a -> BoolSource

Returns True if this LNode is a leaf.

isLeaf' :: Graph g => g a b -> Node -> BoolSource

Returns True if this Node is a leaf.

## Singleton nodes

singletonsOf :: Graph g => g a b -> LNGroup aSource

Find all singletons of the graph.

singletonsOf' :: Graph g => g a b -> NGroupSource

Find all singletons of the graph.

isSingleton :: Graph g => g a b -> LNode a -> BoolSource

Returns True if this LNode is a singleton.

isSingleton' :: Graph g => g a b -> Node -> BoolSource

Returns True if this Node is a singleton.

# Subgraphs

coreOf :: (DynGraph g, Eq a, Eq b) => g a b -> g a bSource

The core of the graph is the part of the graph containing all the cycles, etc. Depending on the context, it could be interpreted as the part of the graph where all the work is done.

# Clustering

levelGraph :: (Ord a, DynGraph g) => g a b -> g (GenCluster a) bSource

Cluster the nodes in the graph based upon how far away they are from a root node. Root nodes are in the cluster labelled minLevel, nodes in level "n" (with n > minLevel) are at least n edges away from a root node.

levelGraphFrom :: (Ord a, DynGraph g) => NGroup -> g a b -> g (GenCluster a) bSource

As with levelGraph but provide a custom grouping of Nodes to consider as the "roots".

The level of the nodes in the NGroup provided to levelGraphFrom (or the root nodes for levelGraph). A level less than this indicates that the node is not accessible.

# Node accessibility

accessibleFrom :: Graph g => g a b -> [Node] -> [Node]Source

Find all Nodes that can be reached from the provided Nodes.

accessibleFrom' :: Graph g => g a b -> Set Node -> Set NodeSource

Find all Nodes that can be reached from the provided nodes using Sets rather than lists.

accessibleOnlyFrom :: Graph g => g a b -> [Node] -> [Node]Source

Find those Nodes that are reachable only from the provided Nodes.

accessibleOnlyFrom' :: Graph g => g a b -> Set Node -> Set NodeSource

Find those Nodes that are reachable only from the provided Nodes, using Sets rather than lists.

# Other

leafMinPaths :: Graph g => g a b -> [LNGroup a]Source

The shortest paths to each of the leaves in the graph (excluding singletons). This can be used to obtain an indication of the overall height/depth of the graph.

leafMinPaths' :: Graph g => g a b -> [NGroup]Source

The shortest paths to each of the leaves in the graph (excluding singletons). This can be used to obtain an indication of the overall height/depth of the graph.