src/Gargantext/Viz/Phylo/Aggregates/Document.hs

   1 {-|
   2 Module      : Gargantext.Viz.Phylo.Tools
   3 Description : Phylomemy Tools to build/manage it
   4 Copyright   : (c) CNRS, 2017-Present
   5 License     : AGPL + CECILL v3
   6 Maintainer  : team@gargantext.org
   7 Stability   : experimental
   8 Portability : POSIX
   9
  10
  11 -}
  12
  13 {-# LANGUAGE NoImplicitPrelude #-}
  14 {-# LANGUAGE FlexibleContexts  #-}
  15 {-# LANGUAGE OverloadedStrings #-}
  16
  17 module Gargantext.Viz.Phylo.Aggregates.Document
  18   where
  19
  20 import Data.Map         (Map,fromListWith)
  21 import Data.Text        (Text)
  22 import Data.Tuple       (fst)
  23 import Data.Vector      (Vector)
  24 import Gargantext.Prelude
  25 import Gargantext.Text.Terms.Mono (monoTexts)
  26 import Gargantext.Viz.Phylo
  27 import qualified Data.List   as List
  28 import qualified Data.Map    as Map
  29 import qualified Data.Vector as Vector
  30
  31
  32 -- | To init a list of Periods framed by a starting Date and an ending Date
  33 initPeriods :: (Eq date, Enum date) => Grain -> Step -> (date, date) -> [(date, date)]
  34 initPeriods g s (start,end) = map (\l -> (head' "Doc" l, last' "Doc" l))
  35                             $ chunkAlong g s [start .. end]
  36
  37
  38 -- | To group a list of Documents by fixed periods
  39 groupDocsByPeriod :: (Ord date, Enum date) => (doc -> date) -> [(date,date)] -> [doc] -> Map (date, date) [doc]
  40 groupDocsByPeriod _ _   [] = panic "[ERR][Viz.Phylo.Example.docsToPeriods] Empty [Documents] can not have any periods"
  41 groupDocsByPeriod f pds es = Map.fromList $ zip pds $ map (inPeriode f es) pds
  42   where
  43     --------------------------------------
  44     inPeriode :: Ord b => (t -> b) -> [t] -> (b, b) -> [t]
  45     inPeriode f' h (start,end) =
  46       fst $ List.partition (\d -> f' d >= start && f' d <= end) h
  47     --------------------------------------
  48
  49
  50 -- | To parse a list of Documents by filtering on a Vector of Ngrams
  51 parseDocs :: Vector Ngrams -> [(Date,Text)] -> [Document]
  52 parseDocs roots c = map (\(d,t)
  53                 -> Document d ( filter (\x -> Vector.elem x roots)
  54                               $ monoTexts t)) c
  55
  56 -- | To count the number of documents by year
  57 countDocs :: [(Date,a)] -> Map Date Double
  58 countDocs corpus = fromListWith (+) $ map (\(d,_) -> (d,1)) corpus
  59
  60
  61
  62