Merge pull request #299 from fastfloat/document_bench

documenting benchmarks
This commit is contained in:
Daniel Lemire 2025-02-05 19:53:33 -05:00 committed by GitHub
commit 3a74bfb500
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 25 additions and 2 deletions

View File

@ -1,3 +1,4 @@
We have benchmarks, please consider running them: see our README for details.
Our CI tests check formatting automating. If such a test fails, please consider running the bash script:

View File

@ -428,8 +428,7 @@ abseil : 430.45 MB/s (+/- 2.2 %) 20.52 Mfl
fastfloat : 1042.38 MB/s (+/- 9.9 %) 49.68 Mfloat/s
```
See <https://github.com/lemire/simple_fastfloat_benchmark> for our benchmarking
code.
See the [Benchmarking](#benchmarking) Section for instructions on how to run our benchmarks.
## Video
@ -485,6 +484,29 @@ You may directly download automatically generated single-header files:
<https://github.com/fastfloat/fast_float/releases/download/v7.0.0/fast_float.h>
## Benchmarking
The project has its own benchmarks with realistic data inputs. Under Linux or macOS,
you can use it as follows if your system supports C++17:
```
cmake -B build -D FASTFLOAT_BENCHMARKS=ON
cmake --build build
./build/benchmarks/realbenchmark
```
Importantly, by default, the benchmark is built in Release mode.
The instructions are similar under Windows.
Under Linux and macOS, it is recommended to run the benchmarks in a privileged manner to get access
to hardware performance counters. You may be able to do so with the `sudo` command
in some cases:
```
sudo ./build/benchmarks/realbenchmark
```
## Packages
* The fast_float library is part of the [Conan package