Crate mathru

This Rust library provides a wide range of mathematical routines such as linear algebra, differential equations, integration, interpolation, statistics and numerical optimization.

Getting Started

Add a new dependency to your Cargo.toml file.

[dependencies]
mathru = "0.15"

You can check, if it works with a simple program like this:

 use mathru::vector;
 use mathru::algebra::linear::{vector::Vector, matrix::General};
 use mathru::algebra::linear::matrix::{Solve};

 fn main() {
     // set inputs:
     //
     // a = [1.0  -3.0]    b = [1.0]
     //     [2.0  -7.0]        [3.0]
     let a: General<f64> = General::new(2, 2, vec![1.0, 2.0, -3.0, -7.0]);
     let b: Vector<f64> = vector![1.0; 3.0];

     // Solve a * x = b
     let x: Vector<f64> = a.solve(&b).unwrap();
     assert_eq!(&a * &x, b);

     // Print result
     println!("x = [{} {}]", x[0], x[1]);
 }

BLAS/LAPACK Support

Mathru has a native Rust implementation of all its functions. However, linear algebra functions are also implemented with a BLAS/LAPACK backend. The interface is identical, but the BLAS/LAPACK backend may be somewhat more efficient. BLAS/LAPACK support can be enable in the Cargo.toml file like so:

[dependencies.mathru]
version = "^0.15"
default-features = false
features = "openblas"

One of the following implementations for linear algebra can be activated as a feature:

• native: Native Rust implementation(activated by default)
• openblas: Optimized BLAS library
• netlib: Collection of mathematical software, papers, and databases
• intel-mkl: Intel Math Kernel Library
• accelerate Make large-scale mathematical computations and image calculations, optimized for high performance and low-energy consumption. (macOS only)

Modules

• algebra
  Abstract and linear algebra.
• analysis
  Interpolations, integration, differential equations, etc.
• elementary
  Elementary functions (the ones you learn in high school)
• optimization
  Algorithms for minimizing objective functions.
• special
  Special functions
• statistics
  Probability distributions and statistical functions

Macros

• abs_diff_eq
  Approximate equality using the absolute difference.
• abs_diff_ne
  Approximate inequality using the absolute difference.
• assert_abs_diff_eq
  An assertion that delegates to abs_diff_eq!, and panics with a helpful error on failure.
• assert_abs_diff_ne
  An assertion that delegates to abs_diff_ne!, and panics with a helpful error on failure.
• assert_relative_eq
  An assertion that delegates to relative_eq!, and panics with a helpful error on failure.
• assert_relative_ne
  An assertion that delegates to relative_ne!, and panics with a helpful error on failure.
• matrix
  Macro to construct matrices
• relative_eq
  Approximate equality using both the absolute difference and relative based comparisons.
• relative_ne
  Approximate inequality using both the absolute difference and relative based comparisons.
• vector
  Macro to construct vectors