aGrUM 2.3.2
a C++ library for (probabilistic) graphical models
rational.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
47
48#ifndef GUM_RATIONAL_H
49#define GUM_RATIONAL_H
50
51#include <iomanip>
52#include <iostream>
53#include <sstream>
54#include <stdlib.h>
55#include <vector>
56
58
59// 64 bits for windows (long is 32 bits)
60#ifdef _MSC_VER
61typedef __int64 int64_t;
62typedef unsigned __int64 uint64_t;
63#else
64# include <stdint.h>
65#endif
66
67namespace gum {
68
78 template < typename GUM_SCALAR >
79 class Rational {
80 public:
81 // ========================================================================
83 // ========================================================================
85
103 static void farey(int64_t& numerator,
104 int64_t& denominator,
105 const GUM_SCALAR& number,
106 const int64_t& den_max = 1000000L,
107 const GUM_SCALAR& zero = 1e-6);
108
130 static void continuedFracFirst(int64_t& numerator,
131 int64_t& denominator,
132 const GUM_SCALAR& number,
133 const double& zero = 1e-6);
134
151 static void continuedFracBest(int64_t& numerator,
152 int64_t& denominator,
153 const GUM_SCALAR& number,
154 const int64_t& den_max = 1000000);
155
157 };
158
159} // namespace gum
160
161
162#ifndef GUM_NO_EXTERN_TEMPLATE_CLASS
163# ifndef GUM_NO_EXTERN_TEMPLATE_CLASS
164extern template class gum::Rational< double >;
165# endif
166#endif
167#ifndef GUM_NO_EXTERN_TEMPLATE_CLASS
168# ifndef GUM_NO_EXTERN_TEMPLATE_CLASS
169extern template class gum::Rational< long double >;
170# endif
171#endif
172
173
174// Always include template implementation in header file
176
177#endif // GUM_RATIONAL_H
Class template used to approximate decimal numbers by rationals.
Definition rational.h:79
static void continuedFracBest(int64_t &numerator, int64_t &denominator, const GUM_SCALAR &number, const int64_t &den_max=1000000)
Find the best rational approximation.
static void continuedFracFirst(int64_t &numerator, int64_t &denominator, const GUM_SCALAR &number, const double &zero=1e-6)
Find the first best rational approximation.
static void farey(int64_t &numerator, int64_t &denominator, const GUM_SCALAR &number, const int64_t &den_max=1000000L, const GUM_SCALAR &zero=1e-6)
Find the rational close enough to a given ( decimal ) number in [-1,1] and whose denominator is not h...
Useful macros for maths.
gum is the global namespace for all aGrUM entities
Definition agrum.h:46
Class template used to approximate decimal numbers by rationals.