{-| Module : Gargantext.Text.Metrics.Occurrences Description : Copyright : (c) CNRS, 2017-Present License : AGPL + CECILL v3 Maintainer : team@gargantext.org Stability : experimental Portability : POSIX Token and occurrence An occurrence is not necessarily a token. Considering the sentence: "A rose is a rose is a rose". We may equally correctly state that there are eight or three words in the sentence. There are, in fact, three word types in the sentence: "rose", "is" and "a". There are eight word tokens in a token copy of the line. The line itself is a type. There are not eight word types in the line. It contains (as stated) only the three word types, 'a', 'is' and 'rose', each of which is unique. So what do we call what there are eight of? They are occurrences of words. There are three occurrences of the word type 'a', two of 'is' and three of 'rose'. Source : https://en.wikipedia.org/wiki/Type%E2%80%93token_distinction#Occurrences -} {-# LANGUAGE NoImplicitPrelude #-} {-# LANGUAGE OverloadedStrings #-} module Gargantext.Text.Metrics.Occurrences where import Control.Arrow ((***)) import qualified Data.List as List import Data.Map.Strict (Map , empty, singleton , insertWith, insertWithKey, unionWith , toList, lookup, mapKeys ) import Data.Set (Set) import qualified Data.Set as Set import Data.Text (pack) import qualified Data.Map.Strict as DMS import Control.Monad ((>>),(>>=)) import Data.String (String()) import Data.Attoparsec.Text ------------------------------------------------------------------------ import Gargantext.Prelude import Gargantext.Core.Types ------------------------------------------------------------------------ type Occ a = Map a Int type Cooc a = Map (a, a) Int type FIS a = Map (Set a) Int data Group = ByStem | ByOntology type Grouped = Stems {- -- >> let testData = ["blue lagoon", "blues lagoon", "red lagoon"] -- >> map occurrences <$> Prelude.mapM (terms Mono EN) -- [fromList [(fromList ["blue"],1),(fromList ["lagoon"],1)],fromList [(fromList ["blue"],1),(fromList ["lagoon"],1)],fromList [(fromList ["lagoon"],1),(fromList ["red"],1)]] --λ: cooc <$> Prelude.map occurrences <$> Prelude.mapM (terms Mono EN) ["blue lagoon", "blues lagoon", "red lagoon"] --fromList [((fromList ["blue"],fromList ["lagoon"]),2),((fromList ["lagoon"],fromList ["red"]),1)] --λ: cooc <$> Prelude.map occurrences <$> Prelude.mapM (terms Mono EN) ["blue lagoon", "blues lagoon", "red lagoon", "red lagoon"] --fromList [((fromList ["blue"],fromList ["lagoon"]),2),((fromList ["lagoon"],fromList ["red"]),2)] --λ: cooc <$> Prelude.map occurrences <$> Prelude.mapM (terms Mono EN) ["blue lagoon", "blues lagoon", "red lagoon red lagoon", "red lagoon"] --fromList [((fromList ["blue"],fromList ["lagoon"]),2),((fromList ["lagoon"],fromList ["red"]),2)] --λ: cooc <$> Prelude.map occurrences <$> Prelude.mapM (terms Mono EN) ["blue lagoon", "blues lagoon blues lagoon", "red lagoon red lagoon", "red lagoon"] --fromList [((fromList ["blue"],fromList ["lagoon"]),2),((fromList ["lagoon"],fromList ["red"]),2)] ---- -} type Occs = Int type Coocs = Int removeApax :: Map (Label, Label) Int -> Map (Label, Label) Int removeApax = DMS.filter (> 1) cooc :: [[Terms]] -> Map (Label, Label) Int cooc tss = mapKeys (delta $ labelPolicy terms_occs) $ cooc' (map (Set.fromList . map _terms_stem) tss) where terms_occs = occurrences (List.concat tss) delta f = f *** f labelPolicy :: Map Grouped (Map Terms Occs) -> Grouped -> Label labelPolicy m g = case _terms_label <$> fst <$> maximumWith snd <$> DMS.toList <$> lookup g m of Just label -> label Nothing -> panic $ "Label of Grouped not found: " <> (pack $ show g) cooc' :: Ord b => [Set b] -> Map (b, b) Coocs cooc' tss = foldl' (\m (xy,c) -> insertWith ((+)) xy c m) empty xs where xs = [ ((x, y), 1) | xs <- tss , ys <- tss , x <- Set.toList xs , y <- Set.toList ys , x < y ] -- | Compute the grouped occurrences (occ) occurrences :: [Terms] -> Map Grouped (Map Terms Int) occurrences = occurrences' _terms_stem occurrences' :: (Ord a, Ord b) => (a -> b) -> [a] -> Map b (Map a Int) occurrences' f = foldl' (\m a -> insertWith (unionWith (+)) (f a) (singleton a 1) m) empty -- TODO add groups and filter stops sumOcc :: Ord a => [Occ a] -> Occ a sumOcc xs = foldl' (unionWith (+)) empty xs