KiCad PCB EDA Suite
Loading...
Searching...
No Matches
numeric.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2018 KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
29#ifndef NUMERIC__H
30#define NUMERIC__H
31
32#include <cmath>
33
34namespace KI_TEST
35{
36
42template <typename T> bool IsWithinWrapped( T aValue, T aNominal, T aWrap, T aError )
43{
44 double diff = std::fmod( aNominal - aValue + aWrap / 2.0, aWrap );
45
46 if( diff < 0 )
47 diff += aWrap;
48
49 return diff - aWrap / 2.0 <= aError;
50}
51
57template <typename T> bool IsWithin( T aValue, T aNominal, T aError )
58{
59 return ( aValue >= aNominal - aError ) && ( aValue <= aNominal + aError );
60}
61
68template <typename T> bool IsWithinBounds( T aValue, T aNominal, T aErrorAbove, T aErrorBelow )
69{
70 return ( aValue >= aNominal - aErrorBelow ) && ( aValue <= aNominal + aErrorAbove );
71}
72
76template <typename T> bool IsWithinAndBelow( T aValue, T aNominal, T aErrorBelow )
77{
78 return IsWithinBounds( aValue, aNominal, 0, aErrorBelow );
79}
80
84template <typename T> bool IsWithinAndAbove( T aValue, T aNominal, T aErrorAbove )
85{
86 return IsWithinBounds( aValue, aNominal, aErrorAbove, 0 );
87}
88
89} // namespace KI_TEST
90
91#endif // NUMERIC__H
bool IsWithinWrapped(T aValue, T aNominal, T aWrap, T aError)
Check if a value is within a tolerance of a nominal value, wrapping to a given val.
Definition: numeric.h:42
bool IsWithin(T aValue, T aNominal, T aError)
Check if a value is within a tolerance of a nominal value.
Definition: numeric.h:57
bool IsWithinAndAbove(T aValue, T aNominal, T aErrorAbove)
value is in range [aNominal, aNominal + aErrorAbove]
Definition: numeric.h:84
bool IsWithinAndBelow(T aValue, T aNominal, T aErrorBelow)
value is in range [aNominal - aErrorBelow, aNominal]
Definition: numeric.h:76
bool IsWithinBounds(T aValue, T aNominal, T aErrorAbove, T aErrorBelow)
Check if a value is within a tolerance of a nominal value, with different allowances for errors above...
Definition: numeric.h:68