-- | -- Module : Languages.UniquenessPeriods.Vector.General.Debug -- Copyright : (c) OleksandrZhabenko 2020 -- License : MIT -- Stability : Experimental -- Maintainer : olexandr543@yahoo.com -- -- Generalization of the functionality of the DobutokO.Poetry.General.Debug -- module from the @dobutokO-poetry-general-languages@ package. Since 0.3.0.0 version -- changed the names of most functions to more appropriate. The conversion table of -- the old to new names are given in a file ConversionTable.txt in the main source -- directory. {-# LANGUAGE BangPatterns #-} module Languages.UniquenessPeriods.Vector.General.Debug ( -- * Pure functions -- ** Self-recursive pure functions and connected with them ones maximumElBy , uniqNPropertiesN , uniqNPropertiesNAll , uniqNProperties2GN -- ** Pure functions , maximumElByAll , maximumElGBy , uniquenessVariantsGN , maximumElByVec , maximumElByVecAll -- * IO functions -- ** Printing subsystem , toFile , printUniquenessG1 , printUniquenessG1List -- *** With 'String'-based arguments , printUniquenessG1ListStr -- *** Auxiliary function , newLineEnding ) where import Data.Print.Info import Data.List (intersperse) import System.IO import qualified Data.Vector as V import Languages.UniquenessPeriods.Vector.Auxiliary import Languages.UniquenessPeriods.Vector.StrictV import Languages.UniquenessPeriods.Vector.Data -- | The function evaluates the 'V.Vector' of 'UniquenessG1' @a@ @b@ elements (related with the third argument) to retrieve the possibly maximum element -- in it with respect to the order and significance (principality) of the \"properties\" (represented as the functions @f :: [b] -> b@) being evaluated. -- The most significant and principal is the \"property\", which index in the 'V.Vector' of them is the 'Int' argument (so it is the first one) of the -- function minus 1, then less significant is the next to the left \"property\" and so on. -- The predefined library \"properties\" or related to them functions can be found in the package @uniqueness-periods-vector-properties@. maximumElBy :: (Eq a, Ord b) => Int -- ^ The quantity of the represented as functions \"properties\" to be applied from the second argument. The order is from the right to the left. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> UniqG2 a b -- ^ The data to be analyzed. -> UniquenessG1 a b -- ^ The maximum element in respect with the given parameters. maximumElBy k vN y | V.null . snd .get22 $ y = error "Languages.UniquenessPeriods.Vector.General.Debug.maximumElBy: undefined for the empty second element in the tuple. " | compare k (V.length vN) == GT = error "Languages.UniquenessPeriods.Vector.General.Debug.maximumElBy: undefined for that amount of norms. " | compare k 0 == GT = let !maxK = V.maximumBy (\(_,vN0,_) (_,vN1,_) -> compare (V.unsafeIndex vN0 (k - 1)) (V.unsafeIndex vN1 (k - 1))) . snd . get22 $ y vK = V.filter (\(_,vN2,_) -> V.unsafeIndex vN2 (k - 1) == V.unsafeIndex (secondFrom3 maxK) (k - 1)) . snd . get22 $ y in maximumElBy (k - 1) (V.unsafeSlice 0 (k - 1) vN) (UL2 (fst . get22 $ y,vK)) | otherwise = V.maximumBy (\(_,vN0,_) (_,vN1,_) -> compare (V.unsafeIndex vN0 0) (V.unsafeIndex vN1 0)) . snd . get22 $ y {-# INLINABLE maximumElBy #-} -- | Prints every 'String' from the list on the new line to the file. Uses 'appendFile' function inside. toFile :: FilePath -- ^ The 'FilePath' to the file to be written in the 'AppendMode' (actually appended with) the information output. -> [String] -- ^ Each 'String' is appended on the new line to the file. -> IO () toFile file xss = (mapM_ (appendFile file) . intersperse newLineEnding $ xss) >> appendFile file newLineEnding -- | Is used to print output specified to the 'stdout' or to the 'FilePath' specified as the inner argument in the 'Info2' parameter. printUniquenessG1 :: (Show a, Show b) => Info2 -- ^ A parameter to control the predefined behaviour of the printing. The 'I1' branch prints to the 'stdout' and the 'I2' - to the file. -> UniquenessG1 a b -- ^ The element, for which the information is printed. -> IO () printUniquenessG1 info uni | isI1 info = case (\(I1 x) -> x) info of A -> putStr "" -- nothing is printed B -> mapM_ putStrLn [show . lastFrom3 $ uni] C -> mapM_ putStrLn [show . firstFrom3 $ uni] D -> mapM_ putStrLn [show . secondFrom3 $ uni] E -> mapM_ putStrLn [show . lastFrom3 $ uni, show . firstFrom3 $ uni] F -> mapM_ putStrLn [show . lastFrom3 $ uni, show . secondFrom3 $ uni] G -> mapM_ putStrLn [show . firstFrom3 $ uni, show . secondFrom3 $ uni] _ -> mapM_ putStrLn [show . lastFrom3 $ uni, show . firstFrom3 $ uni, show. secondFrom3 $ uni] -- the most verbose output | otherwise = case (\(I2 x) -> x) info of Af _ -> putStr "" -- nothing is printed Bf xs -> toFile xs [show . lastFrom3 $ uni] Cf xs -> toFile xs [show . firstFrom3 $ uni] Df xs -> toFile xs [show . secondFrom3 $ uni] Ef xs -> toFile xs [show . lastFrom3 $ uni, show . firstFrom3 $ uni] Ff xs -> toFile xs [show . lastFrom3 $ uni, show . secondFrom3 $ uni] Gf xs -> toFile xs [show . firstFrom3 $ uni, show . secondFrom3 $ uni] ~(Hf xs) -> toFile xs [show . lastFrom3 $ uni, show . firstFrom3 $ uni, show. secondFrom3 $ uni] -- the most verbose output -- | Is used to print output specified to the 'stdout' or to the 'FilePath' specified as the inner argument in the 'Info2' parameter. printUniquenessG1List :: (Show a, Show b) => Info2 -- ^ A parameter to control the predefined behaviour of the printing. The 'I1' branch prints to the 'stdout' and the 'I2' - to the file. -> [UniquenessG1 a b] -- ^ The list of elements, for which the information is printed. -> IO () printUniquenessG1List info (y:ys) | isI1 info = case (\(I1 x) -> x) info of A -> putStr "" -- nothing is printed B -> mapM_ putStrLn . map (show . lastFrom3) $ (y:ys) C -> mapM_ putStrLn . map (show . firstFrom3) $ (y:ys) D -> mapM_ putStrLn . map (show . secondFrom3) $ (y:ys) E -> (putStrLn . show . lastFrom3 $ y) >> (putStrLn . show . firstFrom3 $ y) >> printUniquenessG1List info ys F -> (putStrLn . show . lastFrom3 $ y) >> (putStrLn . show . secondFrom3 $ y) >> printUniquenessG1List info ys G -> (putStrLn . show . firstFrom3 $ y) >> (putStrLn . show . secondFrom3 $ y) >> printUniquenessG1List info ys _ -> (putStrLn . show . lastFrom3 $ y) >> (putStrLn . show . firstFrom3 $ y) >> (putStrLn . show. secondFrom3 $ y) >> printUniquenessG1List info ys -- the most verbose output | otherwise = case (\(I2 x) -> x) info of Af _ -> putStr "" -- nothing is printed Bf xs -> toFile xs . map (show . lastFrom3) $ (y:ys) Cf xs -> toFile xs . map (show . firstFrom3) $ (y:ys) Df xs -> toFile xs . map (show . secondFrom3) $ (y:ys) Ef xs -> toFile xs . map (\t -> (show (lastFrom3 t) ++ newLineEnding ++ show (firstFrom3 t))) $ ys Ff xs -> toFile xs . map (\t -> (show (lastFrom3 t) ++ newLineEnding ++ show (secondFrom3 t))) $ ys Gf xs -> toFile xs . map (\t -> (show (firstFrom3 t) ++ newLineEnding ++ show (secondFrom3 t))) $ ys ~(Hf xs) -> toFile xs . map (\t -> (show (lastFrom3 t) ++ newLineEnding ++ show (firstFrom3 t) ++ newLineEnding ++ show (secondFrom3 t))) $ ys -- the most verbose output printUniquenessG1List _ [] = return () -- | A variant of the 'printUniquenessG1List' where @a@ is 'Char' so that the inner third arguments in the triples are 'String's. printUniquenessG1ListStr :: (Show b) => Info2 -- ^ A parameter to control the predefined behaviour of the printing. The 'I1' branch prints to the 'stdout' and the 'I2' - to the file. -> [UniquenessG1 Char b] -- ^ The list of elements, for which the information is printed. -> IO () printUniquenessG1ListStr info (y:ys) | isI1 info = case (\(I1 x) -> x) info of A -> putStr "" -- nothing is printed B -> mapM_ putStrLn . map lastFrom3 $ (y:ys) C -> mapM_ putStrLn . map (show . firstFrom3) $ (y:ys) D -> mapM_ putStrLn . map (show . secondFrom3) $ (y:ys) E -> (putStrLn . lastFrom3 $ y) >> (putStrLn . show . firstFrom3 $ y) >> printUniquenessG1ListStr info ys F -> (putStrLn . lastFrom3 $ y) >> (putStrLn . show . secondFrom3 $ y) >> printUniquenessG1ListStr info ys G -> (putStrLn . show . firstFrom3 $ y) >> (putStrLn . show . secondFrom3 $ y) >> printUniquenessG1ListStr info ys _ -> (putStrLn . lastFrom3 $ y) >> (putStrLn . show . firstFrom3 $ y) >> (putStrLn . show. secondFrom3 $ y) >> printUniquenessG1ListStr info ys -- the most verbose output | otherwise = case (\(I2 x) -> x) info of Af _ -> putStr "" -- nothing is printed Bf xs -> toFile xs . map lastFrom3 $ (y:ys) Cf xs -> toFile xs . map (show . firstFrom3) $ (y:ys) Df xs -> toFile xs . map (show . secondFrom3) $ (y:ys) Ef xs -> toFile xs . map (\t -> (lastFrom3 t ++ newLineEnding ++ show (firstFrom3 t))) $ ys Ff xs -> toFile xs . map (\t -> (lastFrom3 t ++ newLineEnding ++ show (secondFrom3 t))) $ ys Gf xs -> toFile xs . map (\t -> (show (firstFrom3 t) ++ newLineEnding ++ show (secondFrom3 t))) $ ys ~(Hf xs) -> toFile xs . map (\t -> (lastFrom3 t ++ newLineEnding ++ show (firstFrom3 t) ++ newLineEnding ++ show (secondFrom3 t))) $ ys -- the most verbose output printUniquenessG1ListStr _ [] = return () -- | Auxiliary printing function to define the line ending needed to be printed by 'printUniquenessG1List' function in some cases. newLineEnding :: String newLineEnding | nativeNewline == LF = "\n" | otherwise = "\r\n" -- | Variant of the 'maximumElBy' function where all the given \"properties\" are used. -- The predefined library \"properties\" or related to them functions can be found in the package @uniqueness-periods-vector-properties@. maximumElByAll :: (Eq a, Ord b, Show a, Show b) => V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> UniqG2 a b -- ^ The data to be analyzed. -> UniquenessG1 a b -- ^ The maximum element according to the given \"properties\". maximumElByAll vN = maximumElBy (V.length vN) vN {-# INLINE maximumElByAll #-} -- | The function evaluates -- the generated 'V.Vector' of 'UniquenessG1' @a@ @b@ elements to retrieve the possibly maximum element in it with respect to the order and significance (principality) -- of the \"properties\" being evaluated. The most significant and principal is the \"property\", which index in the 'V.Vector' of them is the 'Int' argument of the function -- minus 1, then less significant is the next to the left \"property\" and so on. maximumElGBy :: (Eq a, Ord b, Show a, Show b) => [a] -- ^ A list of \"whitespace symbols\" that delimits the sublists in the list to be processed. -> Preapp a -- ^ A parameter to specify the lists to be prepended and postpended to the given data to be processed before actual processment. -> Int -- ^ The quantity of the represented as functions \"properties\" to be applied from the second argument. The order is from the right to the left. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> FuncRep [a] (V.Vector c) [b] -- ^ Since version 0.5.0.0 it includes the previous variant with data constructor 'D2', but additionally allows to use just single argument with data constructor 'U1' -> [a] -- ^ The data to be processed. Often it can be a 'String' of the text. -> UniquenessG1 a b maximumElGBy whspss rr k vN frep xs | compare k (V.length vN) == GT = error "Languages.UniquenessPeriods.Vector.General.Debug.maximumElGBy: undefined for that amount of norms. " | compare k 0 == GT = let vM = uniquenessVariants2GNP (get1m rr) (get2m rr) whspss vN frep xs maxK = V.maximumBy (\(_,vN0,_) (_,vN1,_) -> compare (V.unsafeIndex vN0 (k - 1)) (V.unsafeIndex vN1 (k - 1))) vM vK = V.filter (\(_,vN2,_) -> V.unsafeIndex vN2 (k - 1) == V.unsafeIndex (secondFrom3 maxK) (k - 1)) vM in maximumElBy (k - 1) (V.unsafeSlice 0 (k - 1) vN) (UL2 ([],vK)) | otherwise = V.maximumBy (\(_,vN0,_) (_,vN1,_) -> compare (V.unsafeIndex vN0 0) (V.unsafeIndex vN1 0)) . uniquenessVariantsGN whspss rr vN frep $ xs -- | A variant for 'uniquenessVariants2GN' and 'uniquenessVariants2GNP' with the second argument defining, which one is used. uniquenessVariantsGN :: (Eq a, Ord b, Show a, Show b) => [a] -- ^ A list of \"whitespace symbols\" that delimits the sublists in the list to be processed. -> Preapp a -- ^ A parameter to specify the lists to be prepended and postpended to the given data to be processed before actual processment. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> FuncRep [a] (V.Vector c) [b] -- ^ Since version 0.5.0.0 it includes the previous variant with data constructor 'D2', but additionally allows to use just single argument with data constructor 'U1' -> [a] -- ^ The data to be processed. Often it can be a 'String' of the text. -> V.Vector (UniquenessG1 a b) uniquenessVariantsGN whspss (PA ts us) vN frep = uniquenessVariants2GNP ts us whspss vN frep uniquenessVariantsGN whspss K vN frep = uniquenessVariants2GN whspss vN frep {-# INLINE uniquenessVariantsGN #-} -- | Finds out the group of maximum elements with respect of the @k@ \"properties\" (the most significant of which is the rightest one, then to the left less significant etc.), -- which is given as the first argument, and then rearranges the input moving the elements equal by the first element in the triple to the maximum element -- to the first element in the tuple. -- -- The last \"property\" is the first element in the 'V.Vector' of \"properties\" (@[b] -> b@). maximumElByVec :: (Eq a, Ord b, Show a, Show b) => Int -- ^ The quantity of the represented as functions \"properties\" to be applied from the second argument. The order is from the right to the left. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> UniqG2 a b -- ^ The data to be analyzed. -> UniqG2 a b maximumElByVec k vN x | V.null . snd . get22 $ x = x | otherwise = let !uniq = maximumElBy k vN x in let !snD = secondFrom3 uniq in UL2 ((\(!v1,!v2) -> ((fst . get22 $ x) ++ V.toList v1,v2)) . V.unstablePartition (equalSnDs snD . secondFrom3) . snd . get22 $ x) {-# INLINE maximumElByVec #-} equalSnDs :: Ord b => V.Vector b -> V.Vector b -> Bool equalSnDs v1 v2 | V.null v1 = V.null v2 | V.null v2 = False | V.unsafeIndex v1 0 == V.unsafeIndex v2 0 = equalSnDs (V.unsafeSlice 1 (V.length v1 - 1) v1) (V.unsafeSlice 1 (V.length v2 - 1) v2) | otherwise = False -- | A variant of the 'maximumElByVec' where all the given \"properties\" are used. maximumElByVecAll :: (Eq a, Ord b, Show a, Show b) => V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> UniqG2 a b -- ^ The data to be analyzed. -> UniqG2 a b maximumElByVecAll vN = maximumElByVec (V.length vN) vN {-# INLINE maximumElByVecAll #-} -- | Finds out the @n@ (the first 'Int' argument) consequential maximum elements, and then rearranges the input moving the elements equal by the first element -- in the triple to the maximum element to the first element in the tuple. uniqNPropertiesN :: (Eq a, Ord b, Show a, Show b) => Int -- ^ A quantity of the recursive calls that returns each one a new resulting group from the rest of the data processed. -> Int -- ^ The quantity of the represented as functions \"properties\" to be applied from the second argument. The order is from the right to the left. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> UniqG2 a b -- ^ The data to be analyzed. -> UniqG2 a b uniqNPropertiesN n k vN y | n <= 0 = y | otherwise = uniqNPropertiesN (n - 1) k vN . maximumElByVec k vN $ y {-# INLINABLE uniqNPropertiesN #-} -- | A variant of the 'uniqNPropertiesN' where all the given \"properties\" are used. uniqNPropertiesNAll :: (Eq a, Ord b, Show a, Show b) => Int -- ^ A quantity of the recursive calls that returns each one a new resulting group from the rest of the data processed. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> UniqG2 a b -- ^ The data to be analyzed. -> UniqG2 a b uniqNPropertiesNAll n vN = uniqNPropertiesN n (V.length vN) vN {-# INLINE uniqNPropertiesNAll #-} -------------------------------------------------------------------------------------------- -- | The full analyzing and processment function. uniqNProperties2GN :: (Eq a, Ord b, Show a, Show b) => [a] -- ^ A list of \"whitespace symbols\" that delimits the sublists in the list to be processed. -> Preapp a -- ^ A parameter to specify the lists to be prepended and postpended to the given data to be processed before actual processment. -> Int -- ^ A quantity of the recursive calls that returns each one a new resulting group from the rest of the data processed. -> Int -- ^ The quantity of the represented as functions \"properties\" to be applied from the second argument. The order is from the right to the left. -> V.Vector ([b] -> b) -- ^ 'V.Vector' of the represented as functions \"properties\" to be applied consequently. -> FuncRep [a] (V.Vector c) [b] -- ^ Since version 0.5.0.0 it includes the previous variant with data constructor 'D2', but additionally allows to use just single argument with data constructor 'U1' -> [a] -- ^ The data to be processed. Often it can be a 'String' of the text. -> UniqG2 a b uniqNProperties2GN whspss rr n k vN frep xs | n <= 0 = UL2 ([],V.empty) | otherwise = let v = uniquenessVariants2GNP (get1m rr) (get2m rr) whspss vN frep xs in uniqNPropertiesN (n - 1) k vN . maximumElByVec k vN $ (UL2 ([],v))