Awesome

intel-mkl-src

crate	crate.io	docs.rs	master	description
intel-mkl-src				Source crate for Intel-MKL
intel-mkl-sys				FFI for Intel-MKL vector math, and statistical functions
intel-mkl-tool				Seek Intel-MKL libraries from filesystem

Usage

intel-mkl-src crate is a *-src crate. This links MKL libraries to executable build by cargo, but does not provide Rust bindings. Please use blas-sys, lapack-sys, or fftw-sys to use BLAS, LAPACK, FFTW interface of MKL, e.g.

[dependencies]
fftw-sys = { version = "0.4", features = ["intel-mkl"] }

Binding to MKL specific features are provided by intel-mkl-sys crate. This contains

How to find system MKL libraries

intel-mkl-tool crate seeks system MKL library installed by various installer as following manner:

Seek using pkg-config command
Seek ${MKLROOT} directory
Seek default installation path
- /opt/intel/mkl for Linux
- C:/Program Files (x86)/IntelSWTools/ and C:/Program Files (x86)/Intel/oneAPI for Windows

If intel-mkl-tool does not find MKL library, intel-mkl-src try to download MKL binaries from GitHub Container Registry (ghcr.io).

Supported features

There are 8 (=2x2x2) mkl-*-*-* features to specify how to link MKL libraries. If any feature is set, default to mkl-static-ilp64-iomp.

Link type (`static` or `dynamic`)

dynamic means MKL is linked dynamically, i.e. the executable does not contains MKL libraries and will seek them from filesystem while execution. This is better choice when the MKL libraries are managed by the system package manager e.g. apt.

static means MKL is linked statically, i.e. the MKL binaries are embedded in the executable file. This is better choice when creating portable executable.

Data model (`lp64` or `ilp64`)

This specify the data model:

ilp64 means int (i), long (l), and pointers (p) are 64-bit.
lp64 means long (l) and pointers (p) are 64-bit, int is 32-bit.

Thread management (`iomp` or `seq`)

iomp means MKL uses Intel OpenMP runtime
seq means sequential (single thread) execution

Using GNU OpenMP runtime (libgomp) is not supported yet. Please see https://github.com/rust-math/intel-mkl-src/issues/97

License

MKL is distributed under the Intel Simplified Software License for Intel(R) Math Kernel Library, See License.txt. Some wrapper codes are licensed by MIT License (see the header of each file).