File: nearest_neighbour_dictionary.hpp

package info (click to toggle)
libsdsl 2.0.3-4
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 7,204 kB
  • ctags: 12,713
  • sloc: cpp: 64,225; python: 3,856; ansic: 3,651; makefile: 1,537; sh: 449
file content (270 lines) | stat: -rw-r--r-- 11,559 bytes parent folder | download | duplicates (12)
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
/* sdsl - succinct data structures library
    Copyright (C) 2009 Simon Gog

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see http://www.gnu.org/licenses/ .
*/
/*! \file nearest_neighbour_dictionary.hpp
    \brief nearest_neighbour_dictionary.hpp contains a class which supports rank/select for sparse populated sdsl::bit_vectors.
	\author Simon Gog
*/
#ifndef INCLUDED_SDSL_NEAREST_NEIGHBOUR_DICTIONARY
#define INCLUDED_SDSL_NEAREST_NEIGHBOUR_DICTIONARY

#include "int_vector.hpp"
#include "rank_support.hpp"
#include "util.hpp"
#include <stdexcept>
#include <string>

//! Namespace for the succinct data structure library.
namespace sdsl
{

//! Nearest neighbour dictionary for sparse uniform sets (described in Geary et al., A Simple Optimal Representation for Balanced Parentheses, CPM 2004).
/*!
 * Template parameter t_sample_dens corresponds to parameter t in the paper.
 * The data structure the following methods:
 *  - rank
 *  - select
 *  - prev
 *  - next
 * @ingroup rank_support_group
 * @ingroup select_support_group
 *
*/
// TODO: implement an iterator for the ones in the nearest neighbour dictionary!!! used in the construction of the balanced parentheses support
template<uint8_t t_sample_dens>
class nearest_neighbour_dictionary
{
    private:
        static_assert(t_sample_dens != 0 , "nearest_neighbour_dictionary: t_sample_dens should not be equal 0!");
    public:
        typedef bit_vector::size_type size_type;
    private:
        int_vector<> m_abs_samples; // absolute samples array corresponds to array \f$ A_1 \f$ in the paper
        int_vector<> m_differences; // vector for the differences in between the samples; corresponds to array \f$ A_2 \f$ in the paper
        size_type    m_ones; // corresponds to N in the paper
        size_type    m_size; // corresponds to M in the paper
        bit_vector   m_contains_abs_sample; // vector which stores for every block of length t_sample_dens of the original bit_vector if an absolute sample lies in this block.
        // Corresponds to array \f$ A_3 \f$ in the paper.
        rank_support_v<>  m_rank_contains_abs_sample; // rank support for m_contains_abs_sample. Corresponds to array \f$ A_4 \f$ in the paper.
        // NOTE: A faster version should store the absolute samples and the differences interleaved

        void copy(const nearest_neighbour_dictionary& nnd) {
            // copy all members of the data structure
            m_abs_samples 	= 		nnd.m_abs_samples;
            m_differences 	= 		nnd.m_differences;
            m_ones 			= 		nnd.m_ones;
            m_size			= 		nnd.m_size;
            m_contains_abs_sample =	nnd.m_contains_abs_sample;
            m_rank_contains_abs_sample = nnd.m_rank_contains_abs_sample;
            m_rank_contains_abs_sample.set_vector(&m_contains_abs_sample);
        }

    public:

        //! Default constructor
        nearest_neighbour_dictionary():m_ones(0),m_size(0) { }

        //! Constructor
        /*! \param v The supported bit_vector.
         */
        nearest_neighbour_dictionary(const bit_vector& v):m_ones(0), m_size(0) {
            size_type max_distance_between_two_ones = 0;
            size_type ones = 0; // counter for the ones in v

            // get maximal distance between to ones in the bit vector
            // speed this up by broadword computing
            for (size_type i=0, last_one_pos_plus_1=0; i < v.size(); ++i) {
                if (v[i]) {
                    if (i+1-last_one_pos_plus_1 > max_distance_between_two_ones)
                        max_distance_between_two_ones = i+1-last_one_pos_plus_1;
                    last_one_pos_plus_1 = i+1;
                    ++ones;

                }
            }
            m_ones = ones;
            m_size = v.size();
//			std::cerr<<ones<<std::endl;
            // initialize absolute samples m_abs_samples[0]=0
            m_abs_samples = int_vector<>(m_ones/t_sample_dens + 1, 0,  bits::hi(v.size())+1);
            // initialize different values
            m_differences = int_vector<>(m_ones - m_ones/t_sample_dens, 0, bits::hi(max_distance_between_two_ones)+1);
            // initialize m_contains_abs_sample
            m_contains_abs_sample = bit_vector((v.size()+t_sample_dens-1)/t_sample_dens, 0);
            ones = 0;
            for (size_type i=0, last_one_pos=0; i < v.size(); ++i) {
                if (v[i]) {
                    ++ones;
                    if ((ones % t_sample_dens) == 0) {  // insert absolute samples
                        m_abs_samples[ones/t_sample_dens] = i;
                        m_contains_abs_sample[i/t_sample_dens] = 1;
                    } else {
                        m_differences[ones - ones/t_sample_dens - 1] = i - last_one_pos;
                    }
                    last_one_pos = i;
                }
            }
            util::init_support(m_rank_contains_abs_sample, &m_contains_abs_sample);
        }

        //! Copy constructor
        nearest_neighbour_dictionary(const nearest_neighbour_dictionary& nnd) {
            // copy all members of the data structure
            copy(nnd);
        }

        //! Move constructor
        nearest_neighbour_dictionary(nearest_neighbour_dictionary&& nnd) {
            *this = std::move(nnd);
        }

        //! Destructor
        ~nearest_neighbour_dictionary() {}

        nearest_neighbour_dictionary& operator=(const nearest_neighbour_dictionary& nnd) {
            if (this != &nnd) {
                copy(nnd);
            }
            return *this;
        }

        nearest_neighbour_dictionary& operator=(nearest_neighbour_dictionary&& nnd) {
            if (this != &nnd) {
                m_abs_samples   =       std::move(nnd.m_abs_samples);
                m_differences   =       std::move(nnd.m_differences);
                m_ones          =       std::move(nnd.m_ones);
                m_size          =       std::move(nnd.m_size);
                m_contains_abs_sample = std::move(nnd.m_contains_abs_sample);
                m_rank_contains_abs_sample = std::move(nnd.m_rank_contains_abs_sample);
                m_rank_contains_abs_sample.set_vector(&m_contains_abs_sample);
            }
            return *this;
        }

        void swap(nearest_neighbour_dictionary& nnd) {
            // copy all members of the data structure
            m_abs_samples.swap(nnd.m_abs_samples);
            m_differences.swap(nnd.m_differences);
            std::swap(m_ones, nnd.m_ones);
            std::swap(m_size, nnd.m_size);
            m_contains_abs_sample.swap(nnd.m_contains_abs_sample);
            util::swap_support(m_rank_contains_abs_sample, nnd.m_rank_contains_abs_sample,
                               &m_contains_abs_sample, &(nnd.m_contains_abs_sample));
        }

        //! Answers rank queries for the supported bit_vector
        /*! \param idx Argument for the length of the prefix v[0..idx-1].
         *  \return Number of 1-bits in the prefix [0..idx-1] of the supported bit_vector.
         *  \par Time complexity \f$ \Order{1} \f$
         */
        size_type rank(size_type idx)const {
            assert(idx <= m_size);
            size_type r = m_rank_contains_abs_sample.rank(idx/t_sample_dens); //
            size_type result = r*t_sample_dens;
            size_type i = m_abs_samples[r];
            while (++result <= m_ones) {
                if ((result % t_sample_dens) == 0) {
                    i = m_abs_samples[result/t_sample_dens];
                } else {
                    i = i+m_differences[result - result/t_sample_dens-1];
                }
                if (i >= idx)
                    return result-1;
            }
            return result-1;
        };

        //! Answers select queries for the supported bit_vector
        /*! \param i Select the \f$i\f$th 1 in the supported bit_vector. \f$i\in [1..ones()]\f$
         *  \return The position of the \f$i\f$th 1 in the supported bit_vector.
         *  \par Time complexity \f$ \Order{1} \f$
         */
        size_type select(size_type i)const {
            assert(i > 0 and i <= m_ones);
            size_type j = i/t_sample_dens;
            size_type result = m_abs_samples[j];
            j = j*t_sample_dens - j;
            for (size_type end = j + (i%t_sample_dens); j < end; ++j) {
                result += m_differences[j];
            }
            return result;
        }

        //! Answers "previous occurence of one" queries for the supported bit_vector.
        /*! \param i Position \f$ i \in [0..size()-1] \f$.
         *  \return The maximal position \f$j \leq i\f$ where the supported bit_vector v equals 1.
         *  \pre rank(i+1)>0
         *  \par Time complexity \f$ \Order{1} \f$
         */
        size_type prev(size_type i)const {
            size_type r = rank(i+1);
            assert(r>0);
            return select(r);
        }
        /*! Answers "next occurence of one" queries for the supported bit_vector.
         * \param i Position \f$ i \in [0..size()-1] \f$.
         * \return The minimal position \f$ j \geq i \f$ where the supported bit_vector v equals 1.
         * \pre rank(i) < ones()
         *  \par Time complexity \f$ \Order{1} \f$
         */
        size_type next(size_type i)const {
            size_type r = rank(i);
            assert(r < m_ones);
            return select(r+1);
        }

        size_type size()const {
            return m_size;
        }

        size_type ones()const {
            return m_ones;
        }

        //! Serializes the nearest_neighbour_dictionary.
        /*! \param out Out-Stream to serialize the data to.
        */
        size_type serialize(std::ostream& out, structure_tree_node* v=nullptr, std::string name="")const {
            size_type written_bytes = 0;
            structure_tree_node* child = structure_tree::add_child(v, name, util::class_name(*this));
            written_bytes += m_abs_samples.serialize(out, child, "absolute_samples");
            written_bytes += m_differences.serialize(out, child, "differences");
            written_bytes += write_member(m_ones, out, child, "ones");
            written_bytes += write_member(m_size,out,  child, "size");
            written_bytes += m_contains_abs_sample.serialize(out, child, "contains_abs_sample");
            written_bytes += m_rank_contains_abs_sample.serialize(out, child, "rank_contains_abs_sample");
            structure_tree::add_size(child, written_bytes);
            return written_bytes;
        }

        //! Loads the nearest_neighbour_dictionary.
        /*! \param in In-Stream to load the rank_support data from.
         */
        void load(std::istream& in) {
            m_abs_samples.load(in);
            m_differences.load(in);
            read_member(m_ones, in);
            read_member(m_size, in);
            m_contains_abs_sample.load(in);
            m_rank_contains_abs_sample.load(in, &m_contains_abs_sample);
        }
};


}// end namespace sdsl


#endif // end file