https://github.com/MikeLankamp/fpm
C++ header-only fixed-point math library
https://github.com/MikeLankamp/fpm
cxx11 deterministic fixed-point header-only maths
Last synced: 6 months ago
JSON representation
C++ header-only fixed-point math library
- Host: GitHub
- URL: https://github.com/MikeLankamp/fpm
- Owner: MikeLankamp
- License: mit
- Created: 2019-01-16T20:03:29.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-09T18:09:58.000Z (about 1 year ago)
- Last Synced: 2024-11-19T07:39:21.362Z (12 months ago)
- Topics: cxx11, deterministic, fixed-point, header-only, maths
- Language: C++
- Homepage: https://mikelankamp.github.io/fpm
- Size: 452 KB
- Stars: 672
- Watchers: 20
- Forks: 85
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-embedded-software - FPM - C++ header-only fixed-point math library. (Data processing / Math)
README
# fpm
A C++ header-only fixed-point math library. "fpm" stands for "fixed-point math".
It is designed to serve as a drop-in replacement for floating-point types and aims to provide as much of the standard library's functionality as possible with exclusively integers. `fpm` requires C++11 or higher.
[](https://travis-ci.org/MikeLankamp/fpm)
[](https://ci.appveyor.com/project/MikeLankamp/fpm)
`fpm` is designed to guard against accidental conversion to and from floats and supports many of the standard C++ maths functions, including trigonometry, power and logarithmic functions, with performance and accuracy generally comparable to alternative libraries.
## Why use fixed-point math?
There are several reasons why you can not or choose not to use floating-point math, but still want a similar type:
* Your target platform lacks an FPU, does not support floating-point operations or its floating-point operations are
considerably slower than fixed-point integer operations.
* You require deterministic calculations.
If any of these reasons apply for you, and your problem domain has a clearly outlined range and required resolution,
then fixed-point numbers might be a solution for you.
## Quick Start
To use `fpm`, include its header `` and use the `fpm::fixed_16_16`, `fpm::fixed_24_8` or `fpm::fixed_8_24`
types as if they were native floating-pointer types:
```c++
#include // For fpm::fixed_16_16
#include // For fpm::cos
#include // For fpm::operator<<
#include // For std::cin, std::cout
int main() {
std::cout << "Please input a number: ";
fpm::fixed_16_16 x;
std::cin >> x;
std::cout << "The cosine of " << x << " radians is: " << cos(x) << std::endl;
return 0;
}
```
To use the fixed-point equivalents of the `` functions such as `sqrt`, `sin` and `log`, include the header ``.
To stream fixed-point values to or from streams, include the header ``.
## Documentation
Please refer to the [documentation](docs/index.md) for detailed information how to use `fpm`, or skip straight to the [performance](docs/performance.md) or [accuracy](docs/accuracy.md) results.
## Contributions
This library is a work-in-progress. We welcome any contributions that improve the functional coverage or the performance or accuracy of the mathematical functions.
## License
See the [LICENSE](LICENSE) file