summaryrefslogtreecommitdiff
path: root/extractor/precomputation.h
blob: 0a06349b7705e938521908ea6bd14bcdc1bf4918 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
#ifndef _PRECOMPUTATION_H_
#define _PRECOMPUTATION_H_

#include <memory>
#include <unordered_map>
#include <unordered_set>
#include <tuple>
#include <vector>

#include <boost/filesystem.hpp>
#include <boost/functional/hash.hpp>
#include <boost/serialization/serialization.hpp>
#include <boost/serialization/utility.hpp>
#include <boost/serialization/vector.hpp>

namespace fs = boost::filesystem;
using namespace std;

namespace extractor {

typedef boost::hash<vector<int>> VectorHash;
typedef vector<pair<vector<int>, vector<int>>> Collocations;

class SuffixArray;

/**
 * Data structure containing all the data needed for constructing an index with
 * all the occurrences of the most frequent discontiguous collocations in the
 * source data.
 *
 * Let a, b, c be contiguous phrases. The data structure will contain the
 * locations in the source data where every collocation of the following forms
 * occurs:
 * - aXb, where a and b are frequent
 * - aXbXc, where a and b are super-frequent and c is frequent or
 *                b and c are super-frequent and a is frequent.
 */
class Precomputation {
 public:
  // Constructs the index using the suffix array.
  Precomputation(
      shared_ptr<SuffixArray> suffix_array, int num_frequent_phrases,
      int num_super_frequent_phrases, int max_rule_span,
      int max_rule_symbols, int min_gap_size,
      int max_frequent_phrase_len, int min_frequency);

  // Creates empty precomputation data structure.
  Precomputation();

  virtual ~Precomputation();

  // Returns the list of the locations of the most frequent collocations in the
  // source data.
  virtual Collocations GetCollocations() const;

  bool operator==(const Precomputation& other) const;

  static int FIRST_NONTERMINAL;
  static int SECOND_NONTERMINAL;

 private:
  // Finds the most frequent contiguous collocations.
  vector<vector<int>> FindMostFrequentPhrases(
      shared_ptr<SuffixArray> suffix_array, const vector<int>& data,
      int num_frequent_phrases, int max_frequent_phrase_len,
      int min_frequency);

  // Given the locations of the frequent contiguous collocations in a sentence,
  // it adds new entries to the index for each discontiguous collocation
  // matching the criteria specified in the class description.
  void AddCollocations(const vector<std::tuple<int, int, int>>& locations,
                       const vector<int>& data, int max_rule_span,
                       int min_gap_size, int max_rule_symbols);

  // Creates a vector representation for the location of a binary collocation
  // containing the starting points of each subpattern.
  vector<int> GetLocation(int pos1, int pos2);

  // Creates a vector representation for the location of a ternary collocation
  // containing the starting points of each subpattern.
  vector<int> GetLocation(int pos1, int pos2, int pos3);

  // Appends a collocation to the list of collocations after shrinking the
  // vectors to avoid unnecessary memory usage.
  void AddCollocation(vector<int> collocation, vector<int> location);

  friend class boost::serialization::access;

  template<class Archive> void save(Archive& ar, unsigned int) const {
    int num_entries = collocations.size();
    ar << num_entries;
    for (pair<vector<int>, vector<int>> entry: collocations) {
      ar << entry;
    }
  }

  template<class Archive> void load(Archive& ar, unsigned int) {
    int num_entries;
    ar >> num_entries;
    for (size_t i = 0; i < num_entries; ++i) {
      pair<vector<int>, vector<int>> entry;
      ar >> entry;
      collocations.push_back(entry);
    }
  }

  BOOST_SERIALIZATION_SPLIT_MEMBER();

  Collocations collocations;
};

} // namespace extractor

#endif