/intel-mkl-src

Redistribute Intel MKL as a crate

Primary LanguageRustOtherNOASSERTION

intel-mkl-src

crate crate.io docs.rs master description
intel-mkl-src crate docs.rs crate Source crate for Intel-MKL
intel-mkl-sys Crate docs.rs Crate FFI for Intel-MKL vector math, and statistical functions
intel-mkl-tool Crate docs.rs Crate 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 #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).