{-# OPTIONS_GHC -fno-warn-orphans #-} {-# LANGUAGE ScopedTypeVariables #-} module Data.Graph.DGraph where import Data.List (foldl') import Data.Hashable import qualified Data.HashMap.Lazy as HM import Test.QuickCheck import Data.Graph.Types import qualified Data.Graph.UGraph as UG -- | Directed Graph of Vertices in /v/ and Arcs with attributes in /e/ newtype DGraph v e = DGraph { unDGraph :: HM.HashMap v (Links v e) } deriving (Eq, Show) instance Graph DGraph where empty = DGraph HM.empty order (DGraph g) = HM.size g vertices (DGraph g) = HM.keys g edgePairs = arcs' containsVertex (DGraph g) = flip HM.member g areAdjacent (DGraph g) v1 v2 = HM.member v2 (getLinks v1 g) || HM.member v1 (getLinks v2 g) adjacentVertices g v = filter (\v' -> containsArc' g (v, v') || containsArc' g (v', v)) (vertices g) directlyReachableVertices (DGraph g) v = v : (HM.keys $ getLinks v g) -- | The total number of inbounding and outbounding 'Arc's of a vertex vertexDegree g v = vertexIndegree g v + vertexOutdegree g v insertVertex (DGraph g) v = DGraph $ hashMapInsert v HM.empty g insertVertices = foldl' insertVertex containsEdgePair = containsArc' incidentEdgePairs g v = fmap toPair $ incidentArcs g v insertEdgePair g (v1, v2) = insertArc g (Arc v1 v2 ()) removeEdgePair = removeArc' removeEdgePairAndVertices = removeArcAndVertices' isSimple = undefined isRegular = undefined fromAdjacencyMatrix m | length m /= length (head m) = Nothing | otherwise = Just $ insertArcs empty (foldl' genArcs [] labeledM) where labeledM :: [(Int, [(Int, Int)])] labeledM = zip [1..] $ fmap (zip [1..]) m genArcs :: [Arc Int ()] -> (Int, [(Int, Int)]) -> [Arc Int ()] genArcs as (i, vs) = as ++ fmap (\v -> Arc i v ()) connected where connected = fst <$> filter (\(_, v) -> v /= 0) vs toAdjacencyMatrix = undefined -- | The Degree Sequence of a 'DGraph' is a list of pairs (Indegree, Outdegree) type DegreeSequence = [(Int, Int)] instance (Arbitrary v, Arbitrary e, Hashable v, Num v, Ord v) => Arbitrary (DGraph v e) where arbitrary = insertArcs <$> pure empty <*> arbitrary -- | @O(n)@ Remove a vertex from a 'DGraph' if present -- | Every 'Arc' incident to this vertex is also removed removeVertex :: (Hashable v, Eq v) => v -> DGraph v e -> DGraph v e removeVertex v g = DGraph $ (\(DGraph g') -> HM.delete v g') $ foldl' removeArc g $ incidentArcs g v -- | @O(log n)@ Insert a directed 'Arc' into a 'DGraph' -- | The involved vertices are inserted if don't exist. If the graph already -- | contains the Arc, its attribute is updated insertArc :: (Hashable v, Eq v) => DGraph v e -> Arc v e -> DGraph v e insertArc g (Arc fromV toV edgeAttr) = DGraph $ HM.adjust (insertLink toV edgeAttr) fromV g' where g' = unDGraph $ insertVertices g [fromV, toV] -- | @O(m*log n)@ Insert many directed 'Arc's into a 'DGraph' -- | Same rules as 'insertArc' are applied insertArcs :: (Hashable v, Eq v) => DGraph v e -> [Arc v e] -> DGraph v e insertArcs g as = foldl' insertArc g as -- | @O(log n)@ Remove the directed 'Arc' from a 'DGraph' if present -- | The involved vertices are left untouched removeArc :: (Hashable v, Eq v) => DGraph v e -> Arc v e -> DGraph v e removeArc g = removeEdgePair g . toPair -- | Same as 'removeArc' but the arc is an ordered pair removeArc' :: (Hashable v, Eq v) => DGraph v e -> (v, v) -> DGraph v e removeArc' (DGraph g) (v1, v2) = case HM.lookup v1 g of Nothing -> DGraph g Just v1Links -> DGraph $ HM.adjust (const v1Links') v1 g where v1Links' = HM.delete v2 v1Links -- | @O(log n)@ Remove the directed 'Arc' from a 'DGraph' if present -- | The involved vertices are also removed removeArcAndVertices :: (Hashable v, Eq v) => DGraph v e -> Arc v e -> DGraph v e removeArcAndVertices g = removeEdgePairAndVertices g . toPair -- | Same as 'removeArcAndVertices' but the arc is an ordered pair removeArcAndVertices' :: (Hashable v, Eq v) => DGraph v e -> (v, v) -> DGraph v e removeArcAndVertices' g (v1, v2) = removeVertex v2 $ removeVertex v1 $ removeEdgePair g (v1, v2) -- | @O(n*m)@ Retrieve the 'Arc's of a 'DGraph' arcs :: forall v e . (Hashable v, Eq v) => DGraph v e -> [Arc v e] arcs (DGraph g) = linksToArcs $ zip vs links where vs :: [v] vs = vertices $ DGraph g links :: [Links v e] links = fmap (`getLinks` g) vs -- | Same as 'arcs' but the arcs are ordered pairs, and their attributes are -- | discarded arcs' :: (Hashable v, Eq v) => DGraph v e -> [(v, v)] arcs' g = toPair <$> arcs g -- | @O(log n)@ Tell if a directed 'Arc' exists in the graph containsArc :: (Hashable v, Eq v) => DGraph v e -> Arc v e -> Bool containsArc g = containsArc' g . toPair -- | Same as 'containsArc' but the arc is an ordered pair containsArc' :: (Hashable v, Eq v) => DGraph v e -> (v, v) -> Bool containsArc' graph@(DGraph g) (v1, v2) = containsVertex graph v1 && containsVertex graph v2 && v2 `HM.member` v1Links where v1Links = getLinks v1 g -- | Retrieve the inbounding 'Arc's of a Vertex inboundingArcs :: (Hashable v, Eq v) => DGraph v e -> v -> [Arc v e] inboundingArcs g v = filter (\(Arc _ toV _) -> v == toV) $ arcs g -- | Retrieve the outbounding 'Arc's of a Vertex outboundingArcs :: (Hashable v, Eq v) => DGraph v e -> v -> [Arc v e] outboundingArcs g v = filter (\(Arc fromV _ _) -> v == fromV) $ arcs g -- | Retrieve the incident 'Arc's of a Vertex -- | Both inbounding and outbounding arcs incidentArcs :: (Hashable v, Eq v) => DGraph v e -> v -> [Arc v e] incidentArcs g v = inboundingArcs g v ++ outboundingArcs g v -- | Tell if a 'DGraph' is symmetric -- | All of its 'Arc's are bidirected isSymmetric :: DGraph v e -> Bool isSymmetric = undefined -- | Tell if a 'DGraph' is oriented -- | There are none bidirected 'Arc's -- | Note: This is /not/ the opposite of 'isSymmetric' isOriented :: DGraph v e -> Bool isOriented = undefined -- | Indegree of a vertex -- | The number of inbounding 'Arc's to a vertex vertexIndegree :: DGraph v e -> v -> Int vertexIndegree = undefined -- | Outdegree of a vertex -- | The number of outbounding 'Arc's from a vertex vertexOutdegree :: DGraph v e -> v -> Int vertexOutdegree = undefined -- | Indegrees of all the vertices in a 'DGraph' indegrees :: DGraph v e -> [Int] indegrees = undefined -- | Outdegree of all the vertices in a 'DGraph' outdegrees :: DGraph v e -> [Int] outdegrees = undefined -- | Tell if a 'DGraph' is balanced -- | A Directed Graph is @balanced@ when its @indegree = outdegree@ isBalanced :: DGraph v e -> Bool isBalanced g = sum (indegrees g) == sum (outdegrees g) -- | Tell if a 'DGraph' is regular -- | A Directed Graph is @regular@ when all of its vertices have the same number -- | of adjacent vertices AND when the @indegree@ and @outdegree@ of each vertex -- | are equal to each toher. isRegular :: DGraph v e -> Bool isRegular _ = undefined -- | Tell if a vertex is a source -- | A vertex is a @source@ when its @indegree = 0@ isSource :: DGraph v e -> v -> Bool isSource g v = vertexIndegree g v == 0 -- | Tell if a vertex is a sink -- | A vertex is a @sink@ when its @outdegree = 0@ isSink :: DGraph v e -> v -> Bool isSink g v = vertexOutdegree g v == 0 -- | Tell if a vertex is internal -- | A vertex is a @internal@ when its neither a @source@ nor a @sink@ isInternal :: DGraph v e -> v -> Bool isInternal g v = not $ isSource g v || isSink g v -- | Get the transpose of a 'DGraph' -- | The @transpose@ of a directed graph is another directed graph where all of -- | its arcs are reversed transpose :: (Hashable v, Eq v) => DGraph v e -> DGraph v e transpose g = insertArcs empty (fmap reverseArc $ arcs g) where reverseArc (Arc fromV toV attr) = Arc toV fromV attr -- | Convert a directed 'DGraph' to an undirected 'UGraph' by converting all of -- | its 'Arc's into 'Edge's toUndirected :: (Hashable v, Eq v) => DGraph v e -> UG.UGraph v e toUndirected g = UG.insertEdges empty (fmap arcToEdge $ arcs g) where arcToEdge (Arc fromV toV attr) = Edge fromV toV attr -- | Tell if a 'DegreeSequence' is a Directed Graphic -- | A @Directed Graphic@ is a Degree Sequence for wich a 'DGraph' exists -- TODO: Kleitman–Wang | Fulkerson–Chen–Anstee theorem algorithms isDirectedGraphic :: DegreeSequence -> Bool isDirectedGraphic = undefined