SIMD Library for Evaluating Elementary Functions, vectorized libm and DFT
SLEEF is a library that implements vectorized versions of C standard math functions. This library also includes DFT subroutines.
Due to limited test capacities, SLEEF is currently only officially supported on Linux with gcc or llvm/clang. This issue tracks progress on improving test coverage. Compilation of SLEEF on previously supported environments might still be safe, we just cannot verify it yet.
The following table summarises currently supported vector extensions, compilers and OS-es.
:green_circle: : Tested extensively in CI.
:x: : Currently failing some tests in CI.
:white_circle: : Not tested in CI. Might have passed tests in previous CI framework.
OS/Compiler | |||||||||
---|---|---|---|---|---|---|---|---|---|
Linux | MacOS | Windows | |||||||
Arch. | Vector Extensions | gcc | llvm | icc | gcc | llvm | gcc | llvm | msvc |
x86_64 | SSE2, SSE4, AVX, AVX2, AVX512F |
:green_circle: | :green_circle: | :white_circle: | :white_circle: | :white_circle: | :white_circle: | :white_circle: | :white_circle: |
x86 32bit (i386) | SSE | :green_circle: | :green_circle: | :white_circle: | :white_circle: | :white_circle: | :white_circle: | :white_circle: | :white_circle: |
AArch64 (arm) | Neon, SVE | :green_circle: | :green_circle: | N/A | Preliminary | N/A | |||
AArch32 (armhf) | NEON | :green_circle: | :green_circle: | N/A | Preliminary | N/A | |||
PowerPC (ppc64el) | VSX, VSX3 | :green_circle: | :green_circle: | N/A | N/A | N/A | |||
IBM/Z (s390x) | VXE, VXE2 | :green_circle: | :green_circle: | N/A | N/A | N/A | |||
RISC-V (riscv64) | RVV1, RVV2 | N/A (14+) | :green_circle: | N/A | N/A | N/A |
The above table is valid for libm in single, double and quadruple precision, as well as fast Discrete Fourier Transform (DFT).
Generation of inline headers is also supported for most vector extensions.
Results are displayed for gcc 11 and llvm 17, the compiler versions used in CI tests with GitHub Actions.
Older versions should be supported too, while newer ones are either not tested or have known issues.
Some compiler versions simply do not support certain vector extensions, for instance SVE is only supported for gcc version 9 onwards.
Similarly, the RISC-V interface in SLEEF is based on version 1.0 of the intrinsics, which is only supported from llvm version 17 and gcc version 14 onwards.
Toolchain files provide some information on supported compiler versions.
Only Linux distributions are currently tested in CI and thus officially supported.
Building SLEEF for MacOS and Windows on x86 machines was officially supported ( :white_circle: ), as of 3.5.1, however it is not currently tested.
Support for MacOS, iOS and Android is only preliminary on AArch64.
SVE is not supported on Darwin-based system and therefore automatically disabled by SLEEF on Darwin.
Refer to our web page for more on supported environment.
The library itself does not have any additional dependency.
However some tests require:
These tests can be disabled if necessary.
We recommend relying on CMake as much as possible in the build process to ensure portability. CMake 3.18+ is the minimum required.
git clone https://github.com/shibatch/sleef
cd sleef && mkdir build
cmake -S . -B build
cmake --build build -j --clean-first
ctest --test-dir build -j
For more detailed build instructions please refer to the dedicated section on CMake or to our web page.
Assuming following instructions were followed.
<prefix>
cmake --install build --prefix=<prefix>
SLEEF can also be directly installed using Spack.
spack install sleef@master
In order to uninstall SLEEF, run
sudo xargs rm -v < install_manifest.txt
The software is distributed under the Boost Software License, Version 1.0. See accompanying file LICENSE.txt or copy at http://www.boost.org/LICENSE_1_0.txt. Contributions to this project are accepted under the same license.
Copyright © 2010-2024 SLEEF Project, Naoki Shibata and contributors.