The ndarray
crate provides an n-dimensional container for general elements and for numerics.
Please read the API documentation on docs.rs or take a look at the quickstart tutorial.
The following crate feature flags are available. They are configured in your Cargo.toml.
std
Rust standard library (enabled by default)
This crate can be used without the standard library by disabling the default std feature. To do so, use this in your Cargo.toml:
[dependencies] ndarray = { version = "0.x.y", default-features = false }
The geomspace linspace logspace range std var var_axis and std_axis methods are only available when std is enabled.
serde
rayon
par_azip!
.approx
blas
blas-src
for pluggable backend, which needs to be configured separately (see below).matrixmultiply-threading
threading
feature in the matrixmultiply packageportable-atomic-critical-section
portable-atomic
should use critical-section
[dependencies] ndarray = "0.16.0"How to enable BLAS integration
Blas integration is an optional add-on. Without BLAS, ndarray uses the matrixmultiply
crate for matrix multiplication for f64
and f32
arrays (and it's always enabled as a fallback since it supports matrices of arbitrary strides in both dimensions).
Depend and link to blas-src
directly to pick a blas provider. Ndarray presently requires a blas provider that provides the cblas-sys
interface. If further feature selection is wanted or needed then you might need to depend directly on the backend crate's source too. The backend version must be the one that blas-src
also depends on.
An example configuration using system openblas is shown below. Note that only end-user projects (not libraries) should select provider:
[dependencies] ndarray = { version = "0.16.0", features = ["blas"] } blas-src = { version = "0.10", features = ["openblas"] } openblas-src = { version = "0.10", features = ["cblas", "system"] }
Using system-installed dependencies can save a long time building dependencies. An example configuration using (compiled) netlib is shown below anyway:
[dependencies] ndarray = { version = "0.16.0", features = ["blas"] } blas-src = { version = "0.10.0", default-features = false, features = ["netlib"] }
When this is done, your program must also link to blas_src
by using it or explicitly including it in your code:
extern crate blas_src;
The following versions have been verified to work together. For ndarray 0.15 or later, there is no tight coupling to the blas-src
version, so version selection is more flexible.
ndarray
blas-src
openblas-src
netlib-src
0.16 0.10 0.10 0.8 0.15 0.8 0.10 0.8 0.15 0.7 0.9 0.8 0.14 0.6.1 0.9.0 0.13 0.2.0 0.6.0
Although ndarray
currently maintains an MSRV of 1.64.0, this is separate from the MSRV (either stated or real) of the various BLAS providers. As of the time of writing, openblas
currently supports MSRV of 1.71.1. So, while ndarray
and openblas-src
are compatible, they can only work together with toolchains 1.71.1 or above.
See RELEASES.md.
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. This file may not be copied, modified, or distributed except according to those terms.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4