A Random Number Generator Test Suite for the C++ ... - ETH Zürich

4. Using the “Random Number Generator Test Suite”4.2.3. SeedsAdding seeds is not such an easy task, because the Pseudo-random number engine requirementsdoes only specify the iterator based seeding, nothing else. But most generators supportalso a seed(seedType) method. So it is possible to add multiple seeds to use with thegenerators. If a generator does not support the seed(seedType) method the test suiteuses a pseudo-DES algorithm (see [25], sec. 7.5) to create a set of numbers and feeds thesenumbers into the generator with the mandatory iterator based seed method.void add_seed(uint32_t seed)The other way to seed the generator is filling its buffer with values. To do this thereis the seed(iterator, iterator) method. This method must be supported by allgenerators from Boost. The user has to check himself if there are enough values between thetwo iterators to fill the buffer. If there are insufficient values an exception might be thrown.template void add_seed_iterators(const seedIter begin, const seedIter end) type of iteratorbegin iterator to the begin of the buffer with seedsend iterator to the end of the buffer with seeds starting the testBefore a random number generator is seeded, it is reset to the initial state. This means tothe same state as it was while adding to the test suite. This guarantees the repeatability fordifferent seeding. If no seeds are added, the tests run with the initial state of the generator.If a generator has to be tested in a special state, e. g. with a special seeded buffer, there isthe method register_seeded_rng to handle this case.4.2.4. Random Number GeneratorsTo register the random number generators which have to be tested, the test suite provides thefollowing two methods. (The requirements of a random number generator are described insection 6.4)template void register_rng(std::string rng_name, uint64_t warmup = 0) type of the random number generator to testrng_name name of the generator, should be uniquewarmup number of random numbers to produce with the generator before starting the testThis method takes the type of the random number generator as a template parameter. Theconcrete generator object is created inside the test suite with the default constructor. Theseed calls are done in this initial state.template void register_seeded_rng(T mrng,std::string rng_name,std::string description,uint64_t warmup = 0)12