summaryrefslogtreecommitdiff
path: root/extractor/precomputation.h
blob: 2b34fc29a140fa2ac490d1bbb8addfe6c6a29614 (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
#ifndef _PRECOMPUTATION_H_
#define _PRECOMPUTATION_H_

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

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

using namespace std;

namespace extractor {

typedef boost::hash<vector<int>> VectorHash;
typedef unordered_map<vector<int>, vector<int>, VectorHash> Index;

class DataArray;
class SuffixArray;
class Vocabulary;

/**
 * Data structure wrapping an index with all the occurrences of the most
 * frequent discontiguous collocations in the source data.
 *
 * Let a, b, c be contiguous collocations. The index will contain an entry for
 * every collocation of the form:
 * - 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<Vocabulary> vocabulary, shared_ptr<SuffixArray> suffix_array,
      int num_frequent_patterns, int num_super_frequent_patterns,
      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 whether a pattern is contained in the index of collocations.
  virtual bool Contains(const vector<int>& pattern) const;

  // Returns the list of collocations for a given pattern.
  virtual vector<int> GetCollocations(const vector<int>& pattern) const;

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

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

  vector<int> AnnotatePattern(shared_ptr<Vocabulary> vocabulary,
                              shared_ptr<DataArray> data_array,
                              const vector<int>& pattern) const;

  // 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 UpdateIndex(
      const vector<tuple<int, int, int>>& matchings,
      const vector<vector<int>>& annotations,
      int max_rule_span, int min_gap_size, int max_rule_symbols);

  void AppendSubpattern(vector<int>& pattern, const vector<int>& subpattern);

  // Adds an occurrence of a binary collocation.
  void AppendCollocation(vector<int>& collocations, int pos1, int pos2);

  // Adds an occurrence of a ternary collocation.
  void AppendCollocation(vector<int>& collocations, int pos1, int pos2, int pos3);

  friend class boost::serialization::access;

  template<class Archive> void save(Archive& ar, unsigned int) const {
    int num_entries = index.size();
    ar << num_entries;
    for (pair<vector<int>, vector<int>> entry: index) {
      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;
      index.insert(entry);
    }
  }

  BOOST_SERIALIZATION_SPLIT_MEMBER();

  Index index;
};

} // namespace extractor

#endif