aGrUM 2.3.2
a C++ library for (probabilistic) graphical models
utils_random.h
Go to the documentation of this file.
1/****************************************************************************
2 * This file is part of the aGrUM/pyAgrum library. *
3 * *
4 * Copyright (c) 2005-2025 by *
5 * - Pierre-Henri WUILLEMIN(_at_LIP6) *
6 * - Christophe GONZALES(_at_AMU) *
7 * *
8 * The aGrUM/pyAgrum library is free software; you can redistribute it *
9 * and/or modify it under the terms of either : *
10 * *
11 * - the GNU Lesser General Public License as published by *
12 * the Free Software Foundation, either version 3 of the License, *
13 * or (at your option) any later version, *
14 * - the MIT license (MIT), *
15 * - or both in dual license, as here. *
16 * *
17 * (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html) *
18 * *
19 * This aGrUM/pyAgrum library is distributed in the hope that it will be *
20 * useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, *
21 * INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS *
22 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE *
23 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER *
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, *
25 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR *
26 * OTHER DEALINGS IN THE SOFTWARE. *
27 * *
28 * See LICENCES for more details. *
29 * *
30 * SPDX-FileCopyrightText: Copyright 2005-2025 *
31 * - Pierre-Henri WUILLEMIN(_at_LIP6) *
32 * - Christophe GONZALES(_at_AMU) *
33 * SPDX-License-Identifier: LGPL-3.0-or-later OR MIT *
34 * *
35 * Contact : info_at_agrum_dot_org *
36 * homepage : http://agrum.gitlab.io *
37 * gitlab : https://gitlab.com/agrumery/agrum *
38 * *
39 ****************************************************************************/
40
41
48
49#ifndef GUM_UTILS_RANDOM_H
50#define GUM_UTILS_RANDOM_H
51
52#include <chrono>
53#include <cstdlib>
54#include <ctime>
55#include <iostream>
56#include <numeric>
57#include <random>
58#include <utility>
59#include <vector>
60
61#include <agrum/agrum.h>
62
63namespace gum {
64 namespace _rand_namespace_ {
65 std::mt19937& generator();
66 }
67
70
76 Idx randomValue(const Size max = 2);
77
82 double randomProba();
83
90 template < typename GUM_SCALAR >
91 std::vector< GUM_SCALAR > randomDistribution(Size n);
92
97 unsigned int randomGeneratorSeed();
98
100 unsigned int currentRandomGeneratorValue();
101
105 void initRandom(unsigned int seed = 0);
106
110 std::mt19937& randomGenerator();
111
113} /* namespace gum */
114
115#ifndef GUM_NO_INLINE
117#endif // GUM_NO_INLINE
118
120#endif /* GUM_UTILS_RANDOM_H */
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition types.h:74
Size Idx
Type for indexes.
Definition types.h:79
Idx randomValue(const Size max=2)
Returns a random Idx between 0 and max-1 included.
unsigned int randomGeneratorSeed()
Returns the aGrUM's seed used by the std::generators.
void initRandom(unsigned int seed=0)
Initialize random generator seed.
std::mt19937 & randomGenerator()
define a random_engine with correct seed
unsigned int currentRandomGeneratorValue()
returns the current generator's value
double randomProba()
Returns a random double between 0 and 1 included (i.e.
std::vector< GUM_SCALAR > randomDistribution(Size n)
Return a random discrete distribution.
std::mt19937 & generator()
gum is the global namespace for all aGrUM entities
Definition agrum.h:46
Contains useful methods for random stuff.
Contains useful methods for random stuff.