{-# OPTIONS_HADDOCK ignore-exports #-} module Algorithms.GrahamScan where import Algebra.Vector import Diagrams.TwoD.Types import MyPrelude -- |Get all points on a convex hull by using the graham scan -- algorithm. {-- ========== FUNCTIONAL PSEUDO CODE ====================== input: unsorted list us' output: sorted convex hull list variables: (lowerHull, restl) = splitAt3IntoTuple (sort us') (upperHull, restu) = reverse (splitAt3IntoTuple (sort us')) main scope: return (scanHalf upperHull restu) ++ (stripFirstAndLastElem(scanHalf lowerHull restl)) === begin scanHalf function === scanHalf (min 3 elem => lowerHull) (min 1 elem => rest) | isNotClockWise (last3Elements lowerHull) == True = scanHalf (lowerHull + head rest) (tail rest) | otherwise = scanHalf (deleteSndToLastElem lowerHull + head rest) (rest) scanHalf (min 3 elem => lowerHull ) [] | isNotClockWise (last3Elements lowerHull) == True = return lowerHull | otherwise = scanHalf (deleteSndToLastElem lowerHull) [] scanHalf lowerHull (min 1 elem => rest) = scanHalf (lowerHull + head rest) (tail rest) scanHalf lowerHull _ = lowerHull === end scanHalf function === ============= SIMULATION =================================== xs = [(100, 100), (200, 450), (250, 250)] ys = [(300, 400), (400, 200)] notcw (100, 100) (200, 450) (250, 250) => false, pop snd2last of xs === move first of ys to end of xs xs = [(100, 100), (250, 250), (300, 400)] ys = [(400, 200)] notcw (100, 100), (250, 250) (300, 400) => true === move first of ys to end of xs xs = [(100, 100), (250, 250), (300, 400), (400, 200)] ys = [] notcw (250, 250) (300, 400) (400, 200) => false, pop snd2last of xs === xs = [(100, 100), (250, 250), (400, 200)] ys = [] notcw (100, 100) (250, 250) (400, 200) => false, pop snd2last of xs === xs = [(100, 100), (400, 200)] ys = [] === return [(100, 100), (400, 200)] ========================================================= --} grahamCH :: [P2 Double] -> [P2 Double] grahamCH vs = grahamUCH vs ++ (tailInit . grahamLCH $ vs) -- |Get the lower part of the convex hull. grahamLCH :: [P2 Double] -> [P2 Double] grahamLCH vs = uncurry (\x y -> last . scanH x $ y) (first reverse . splitAt 3 . sortedXY $ vs) -- |Get the upper part of the convex hull. grahamUCH :: [P2 Double] -> [P2 Double] grahamUCH vs = uncurry (\x y -> last . scanH x $ y) (first reverse . splitAt 3 . reverse . sortedXY $ vs) -- |This scans only a half of the convex hull, but all steps (the last -- is the end result). -- If it's the upper or lower half depends on the input. -- Also, the first list is expected to be reversed since we only care -- about the last 3 elements and want to stay efficient. scanH :: [P2 Double] -- ^ the first 3 starting points in reversed order -> [P2 Double] -- ^ the rest of the points -> [[P2 Double]] -- ^ all convex hull points iterations for the half scanH hs@(x:y:z:xs) (r':rs') | notcw z y x = hs : scanH (r':hs) rs' | otherwise = hs : scanH (x:z:xs) (r':rs') scanH hs@(x:y:z:xs) [] | notcw z y x = [hs] | otherwise = hs : scanH (x:z:xs) [] scanH hs (r':rs') = hs : scanH (r':hs) rs' scanH hs _ = [hs] -- |Compute all steps of the graham scan algorithm to allow -- visualizing it. -- Whether the upper or lower hull is computed depends on the input. grahamCHSteps :: Int -> [P2 Double] -> [P2 Double] -> [[P2 Double]] grahamCHSteps c xs' ys' = take c . scanH xs' $ ys' -- |Get all iterations of the upper hull of the graham scan algorithm. grahamUHSteps :: [P2 Double] -> [[P2 Double]] grahamUHSteps vs = (++) [getLastX 2 . sortedXY $ vs] . rmdups . grahamCHSteps ((* 2) . length $ vs) uH $ uHRest where (uH, uHRest) = first reverse . splitAt 3 . reverse . sortedXY $ vs -- |Get all iterations of the lower hull of the graham scan algorithm. grahamLHSteps :: [P2 Double] -> [[P2 Double]] grahamLHSteps vs = (++) [take 2 . sortedXY $ vs] . rmdups . grahamCHSteps ((* 2) . length $ vs) lH $ lHRest where (lH, lHRest) = first reverse . splitAt 3 . sortedXY $ vs