Newer
Older
/*
* Copyright (c) 2015, Luca Fulchir<luker@fenrirproject.org>, All rights reserved.
*
* This file is part of "libRaptorQ".
*
* libRaptorQ is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation, either version 3
* of the License, or (at your option) any later version.
*
* libRaptorQ 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
* and a copy of the GNU Lesser General Public License
* along with libRaptorQ. If not, see <http://www.gnu.org/licenses/>.
*/
#include <fstream>
#include <iostream>
#include <random>
#include "../src/RaptorQ.hpp"
#include <vector>
// Demonstration of how to use the C++ interface
// it's pretty simple, we generate some input,
// then encode, drop some packets (source and repair)
// and finally decode everything.
template <typename in_enc_align, typename out_enc_align, typename out_dec_align>
bool decode (const uint32_t mysize, std::mt19937_64 &rnd, float drop_prob,
template <typename in_enc_align, typename out_enc_align, typename out_dec_align>
bool decode (const uint32_t mysize, std::mt19937_64 &rnd, float drop_prob,
// define the alignment of the input and output data, for
// decoder and encoder.
// note that this is independent from the "mysize" argument,
// which is always in bytes.
// used as template arguments
//typedef uint8_t in_enc_align;
//typedef uint16_t out_enc_align;
// NOTE: out_enc_align is the same as in_dec_align so that we
// can simulate data trnsmision just by passing along a vector, but
// they do not need to be the same.
std::vector<in_enc_align> myvec;
// initialize vector with random data
// fill remaining data (more than "mysize" bytes) with zeros
std::uniform_int_distribution<uint8_t> distr(0, 0xFF);
myvec.reserve (static_cast<size_t> (
std::ceil(static_cast<float> (mysize) / sizeof(in_enc_align))));
in_enc_align tmp = 0;
uint8_t shift = 0;
for (uint32_t i = 0; i < mysize; ++i) {
//tmp += static_cast<in_enc_align> (i) << shift * 8;
++shift;
if (shift >= sizeof(in_enc_align)) {
myvec.push_back (tmp);
shift = 0;
// std::pair<symbol id (esi), symbol>
std::vector<std::pair<uint32_t, std::vector<out_enc_align>>> encoded;
// sub symbol must be multiple of alignment,
// symbol must be multiple of subsymbol
std::uniform_int_distribution<uint16_t> sub_sym_distr (1, 16);
const uint16_t subsymbol = sizeof(in_enc_align) * sub_sym_distr(rnd);
std::uniform_int_distribution<uint16_t> sym_distr (1, 100);
const uint16_t symbol_size = subsymbol * sym_distr (rnd);
std::cout << "Subsymbol: " << subsymbol << " Symbol: " << symbol_size<<"\n";
std::ceil(static_cast<float> (symbol_size) / sizeof(out_enc_align)));
std::uniform_int_distribution<uint32_t> mem_distr (100, 200000);
RaptorQ::Encoder<typename std::vector<in_enc_align>::iterator,
typename std::vector<out_enc_align>::iterator> enc (
enc_it, myvec.end(), subsymbol, symbol_size, mem_distr(rnd));
std::cout << "Size: " << mysize << " Blocks: " <<
static_cast<int32_t>(enc.blocks()) << "\n";
if (!enc) {
std::cout << "Coud not initialize encoder.\n";
return false;
}
enc.compute (RaptorQ::Compute::COMPLETE | RaptorQ::Compute::NO_BACKGROUND);
if (drop_prob > static_cast<float> (90.0))
drop_prob = 90.0; // this is still too high probably.
std::uniform_real_distribution<float> drop (0.0, 100.0);
repair = overhead;
++blockid;
std::cout << "Block " << blockid << " with " << block.symbols() <<
" symbols\n";
// Now get the source and repair symbols.
// make sure that at the end we end with "block.symbols() + overhead"
// symbols, so that decoding is possible
for (auto sym_it = block.begin_source(); sym_it != block.end_source();
++sym_it) {
float dropped = drop (rnd);
if (dropped <= drop_prob) {
// we dropped one source symbol, we need one more repair.
++repair;
continue;
}
// create a place where to save our source symbol
std::vector<out_enc_align> source_sym;
source_sym.reserve (aligned_symbol_size);
source_sym.insert (source_sym.begin(), aligned_symbol_size, 0);
auto it = source_sym.begin();
// save the symbol
auto written = (*sym_it) (it, source_sym.end());
std::cout << written << "-vs-" << aligned_symbol_size <<
" Could not get the whole source symbol!\n";
return false;
}
// finally add it to the encoded vector
encoded.emplace_back ((*sym_it).id(), std::move(source_sym));
}
// now get (overhead + source_symbol_lost) repair symbols.
std::cout << "Source Packet lost: " << repair - overhead << "\n";
auto sym_it = block.begin_repair();
for (; repair >= 0 && sym_it != block.end_repair (block.max_repair());
++sym_it) {
// repair symbols can be lost, too!
float dropped = drop (rnd);
if (dropped <= drop_prob) {
continue;
}
--repair;
// create a place where to save our source symbol
std::vector<out_enc_align> repair_sym;
repair_sym.reserve (aligned_symbol_size);
repair_sym.insert (repair_sym.begin(), aligned_symbol_size, 0);
auto it = repair_sym.begin();
// save the repair symbol
auto written = (*sym_it) (it, repair_sym.end());
std::cout << written << "-vs-" << aligned_symbol_size <<
" bCould not get the whole repair symbol!\n";
return false;
}
// finally add it to the encoded vector
encoded.emplace_back ((*sym_it).id(), std::move(repair_sym));
}
if (sym_it == block.end_repair (block.max_repair())) {
// we dropped waaaay too many symbols! how much are you planning to
// lose, again???
std::cout << "Maybe losing " << drop_prob << "% is too much?\n";
return false;
}
}
auto oti_scheme = enc.OTI_Scheme_Specific();
auto oti_common = enc.OTI_Common();
// encoding done. now "encoded" is the vector with the trnasmitted data.
// let's decode it
RaptorQ::Decoder<typename std::vector<in_dec_align>::iterator,
typename std::vector<out_dec_align>::iterator>
auto async_dec = dec.compute (RaptorQ::Compute::COMPLETE);
std::vector<out_dec_align> received;
size_t out_size = static_cast<size_t> (
std::ceil(static_cast<float>(mysize) / sizeof(out_dec_align)));
// make sure that there's enough place in "received" to get the
// whole decoded data.
for (uint32_t i = 0; i < out_size; ++i)
received.push_back (static_cast<out_dec_align> (0));
for (size_t i = 0; i < encoded.size(); ++i) {
auto it = encoded[i].second.begin();
auto err = dec.add_symbol (it, encoded[i].second.end(),
encoded[i].first);
if (err != RaptorQ::Error::NONE && err != RaptorQ::Error::NOT_NEEDED) {
// you can actually call ".decode(...)" as many times
// as you want. It will only start decoding once
// it has enough data.
auto decoded = dec.decode(re_it, received.end(), 0);
if (decoded.first * sizeof(out_dec_align) != mysize) {
if (decoded.first == 0) {
std::cout << "Couldn't decode, RaptorQ Algorithm failure. "
"Can't Retry.\n";
} else {
std::cout << "Partial Decoding? This should not have happened: " <<
decoded.first * sizeof(out_dec_align) << " vs " <<
mysize << "\n";
return false;
} else {
std::cout << "Decoded: " << mysize << "\n";
}
// byte-wise check: did we actually decode everything the right way?
uint8_t *in, *out;
in = reinterpret_cast<uint8_t *> (myvec.data());
out = reinterpret_cast<uint8_t *> (received.data());
for (uint64_t i = 0; i < mysize; ++i) {
if (in[i] != out[i]) {
std::cout << "FAILED, but we thought otherwise! " << mysize << " - "
}
}
return true;
}
int main (void)
{
// get a random number generator
std::mt19937_64 rnd;
std::ifstream rand("/dev/random");
uint64_t seed = 0;
rand.read (reinterpret_cast<char *> (&seed), sizeof(seed));
rand.close ();
rnd.seed (seed);
std::uniform_int_distribution<uint32_t> distr(1, 10000);
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
for (size_t i = 0; i < 1000; ++i) {
std::cout << "08-08-08\n";
bool ret = decode<uint8_t, uint8_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-08-16\n";
ret = decode<uint8_t, uint8_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-08-32\n";
ret = decode<uint8_t, uint8_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-16-08\n";
ret = decode<uint8_t, uint16_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-16-16\n";
ret = decode<uint8_t, uint16_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-16-32\n";
ret = decode<uint8_t, uint16_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-32-08\n";
ret = decode<uint8_t, uint32_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-32-16\n";
ret = decode<uint8_t, uint32_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "08-32-32\n";
ret = decode<uint8_t, uint32_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-08-08\n";
ret = decode<uint16_t, uint8_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-08-16\n";
ret = decode<uint16_t, uint8_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-08-32\n";
ret = decode<uint16_t, uint8_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-16-08\n";
ret = decode<uint16_t, uint16_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-16-16\n";
ret = decode<uint16_t, uint16_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-16-32\n";
ret = decode<uint16_t, uint16_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-32-08\n";
ret = decode<uint16_t, uint32_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-32-16\n";
ret = decode<uint16_t, uint32_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "16-32-32\n";
ret = decode<uint16_t, uint32_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-08-08\n";
ret = decode<uint32_t, uint8_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-08-16\n";
ret = decode<uint32_t, uint8_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-08-32\n";
ret = decode<uint32_t, uint8_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-16-08\n";
ret = decode<uint32_t, uint16_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-16-16\n";
ret = decode<uint32_t, uint16_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-16-32\n";
ret = decode<uint32_t, uint16_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-32-08\n";
ret = decode<uint32_t, uint32_t, uint8_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-32-16\n";
ret = decode<uint32_t, uint32_t, uint16_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
std::cout << "32-32-32\n";
ret = decode<uint32_t, uint32_t, uint32_t> (distr(rnd), rnd, 20.0, 4);
if (!ret)
return -1;
}
std::cout << "All tests succesfull!\n";
return 0;