Repository files navigation

Rust bindings and wrappers for BLAS (Basic Linear Algebra Subprograms).

RBLAS wraps each external call in a trait with the same name (but capitalized).This trait contains a single static method, of the same name. These traits aregeneric over the four main types of numbers BLAS supports:f32,f64,Complex32, andComplex64.

For example the functionscblas_saxpy,cblas_daxpy,cblas_caxypy, andcblas_zaxpy are called with the functionAxpy::axpy.

Additionally, RBLAS introduces a few traits to shorten calls to these BLASfunctions:Vector for types that implement vector-like characteristics andMatrix for types that implement matrix-like characteristics. TheVectortrait is already implemented byVec and[] types.

Documentation

By default, the library links withblas dynamically. To link to an alternateimplementation, like OpenBLAS, use the environment variableCARGO_BLAS. Ifyou've already built the bindings, you may need to clean and build again.

export CARGO_BLAS=openblas

externcrate rblas;use rblas::Dot;fnmain(){let x =vec![1.0, -2.0,3.0,4.0];let y =[1.0,1.0,1.0,1.0,7.0];let d =Dot::dot(&x,&y[..x.len()]);assert_eq!(d,6.0);}

#[macro_use]externcrate rblasas blas;use blas::math::Mat;use blas::{Matrix,Vector};use blas::math::Marker::T;fnmain(){let x =vec![1.0,2.0];let xr =&xas&Vector<_>;let i =mat![1.0,0.0;0.0,1.0];let ir =&ias&Matrix<_>;assert!(xr +&x ==2.0* xr);assert!(ir* xr == x);let dot =(xr ^T)* xr;assert!(dot ==5.0);}