README.md

lav

Lane-Associated Vector (LAV): Portable SIMD vector trait as GAT of SIMD lane trait.

NOTE: This crate requires nightly Rust.

This example uses SIMD generically over floating-point types while hiding it from the user.

Features

• SIMD lane trait Real abstracting over f32 and f64.
• SIMD vector trait SimdReal<Real, N> abstracting over Simd<f32, N> and Simd<f64, N>.
• Generic associated type (GAT) Real::Simd<N> as part of SIMD lane trait Real implementing SIMD vector trait SimdReal<Self, N> for itself as lane type where the GAT is generic over the number of SIMD vector lanes N.
• AoS/SoA/AoSoA via Real::as_simd/Real::as_simd_mut abstracting over as_simd/as_simd_mut of f32 and f64 slices.
• Lanewise approximate equality test wrt to epsilon and ULP SIMD vectors.
• ApproxEq trait complementing PartialEq.

Optional Features

Following features are disabled by default unless their feature gate is enabled:

• target-features: Provides native number of SIMD vector lanes Real::NATIVE_LANE_COUNT for the current build target.
• libm: Enables no_std without loss of functionality.

Documentation Builds

Build and open documentation of this crate and its dependencies using KaTeX.

env RUSTDOCFLAGS="--html-in-header $PWD/katex.html" cargo doc --features target-features --open

Note that navigating the documentation requires web access as KaTeX is embedded via remote CDN.

License

Copyright © 2021-2024 Rouven Spreckels [email protected]

Licensed under the terms of the MPL-2.0.

The MPL allows the integration of MPL-licensed code into proprietary codebases, as long as the MPL-licensed components remain accessible under the terms of the MPL.

Contribution

Unless you explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Covered Software by You shall be licensed as above, without any additional terms or conditions.