41 releases

0.17.0 Jan 29, 2025
0.16.0 Oct 4, 2022
0.15.0 Aug 30, 2022
0.14.1 Aug 14, 2021
0.1.5 Nov 28, 2016

#29 in Algorithms

Download history 8088/week @ 2025-01-31 8209/week @ 2025-02-07 5798/week @ 2025-02-14 6965/week @ 2025-02-21 8363/week @ 2025-02-28 6634/week @ 2025-03-07 7547/week @ 2025-03-14 5672/week @ 2025-03-21 4710/week @ 2025-03-28 5680/week @ 2025-04-04 6215/week @ 2025-04-11 5049/week @ 2025-04-18 5153/week @ 2025-04-25 12568/week @ 2025-05-02 9048/week @ 2025-05-09 8863/week @ 2025-05-16

36,451 downloads per month
Used in 133 crates (107 directly)

MIT/Apache

355KB
8K SLoC

ndarray-linalg

crate docs.rs master

Linear algebra package for Rust with ndarray based on external LAPACK implementations.

Examples

See examples directory.

Note: To run examples, you must specify which backend will be used (as described below). For example, you can execute the solve example with the OpenBLAS backend like this:

cargo run --example solve --features=openblas

and run all tests of ndarray-linalg with OpenBLAS

cargo test --features=openblas

Backend Features

There are three LAPACK source crates:

ndarray_linalg must link just one of them for LAPACK FFI.

[dependencies]
ndarray = "0.14"
ndarray-linalg = { version = "0.13", features = ["openblas-static"] }

Supported features are following:

Feature Link type Requirements Description
openblas-static static gcc, gfortran, make Build OpenBLAS in your project, and link it statically
openblas-system dynamic/static libopenblas-dev Seek OpenBLAS in system, and link it
netlib-static static gfortran, make Same as openblas-static except for using reference LAPACK
netlib-system dynamic/static liblapack-dev Same as openblas-system except for using reference LAPACK
intel-mkl-static static (pkg-config) Seek static library of Intel MKL from system, or download if not found, and link it statically
intel-mkl-system dynamic (pkg-config) Seek shared library of Intel MKL from system, and link it dynamically
  • You must use just one feature of them.
  • dynamic/static means it depends on what is found in the system. When the system has /usr/lib/libopenblas.so, it will be linked dynamically, and /usr/lib/libopenblas.a will be linked statically. Dynamic linking is prior to static linking.
  • Requirements notices:
    • gcc and gfortran can be another compiler, e.g. icc and ifort.
    • libopenblas-dev is package name in Debian, Ubuntu, and other derived distributions. There are several binary packages of OpenBLAS, i.e. libopenblas-{openmp,pthread,serial}-dev. It can be other names in other distributions, e.g. Fedora, ArchLinux, and so on.
    • pkg-config is used for searching Intel MKL packages in system, and it is optional. See intel-mkl-src/README.md for detail.

For library developer

If you creating a library depending on this crate, we encourage you not to link any backend:

[dependencies]
ndarray = "0.13"
ndarray-linalg = "0.12"

The cargo's feature is additive. If your library (saying lib1) set a feature openblas-static, the application using lib1 builds ndarray_linalg with openblas-static feature though they want to use intel-mkl-static backend.

See the cargo reference for detail

Tested Environments

Only x86_64 system is supported currently.

Backend Linux Windows macOS
OpenBLAS ✔️ - -
Netlib ✔️ - -
Intel MKL ✔️ ✔️ ✔️

License

CAUTION Be sure that if you use intel-mkl-src backend, you have to accept Intel Simplified Software License in addition to the MIT-License or Apache-2.0 License.

Dual-licensed to be compatible with the Rust project. Licensed under the Apache License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0 or the MIT license http://opensource.org/licenses/MIT, at your option.

Dependencies

~70MB
~883K SLoC