basin 1.9.0

Numerical optimization in pure Rust, with pluggable linear-algebra backends and WASM support.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

#![cfg(feature = "ndarray_all")]

//! Bfgs convergence over the ndarray backend (`Array1<f64>` and `Array2<f64>`).
//!
//! Mirrors `tests/bfgs.rs` (nalgebra), `tests/bfgs_vec.rs` (`Vec<f64>`), and
//! `tests/bfgs_faer.rs` (faer): the same generic `Solver` impl drives
//! ndarray's dense inverse-Hessian via `MatVec` + `GeneralRankOneUpdate` on
//! `Array2<f64>`.

use crate::backend_aliases::ndarray::array;
use basin::problems::Rosenbrock;
use basin::{
    Bfgs, Executor, GradientTolerance, NdarrayQuasiNewtonState,
    TerminationReason,
};

#[test]
fn bfgs_converges_on_rosenbrock() {
    let problem =
        Rosenbrock::<crate::backend_aliases::ndarray::Array1<f64>>::default();
    let initial = array![-1.2, 1.0];

    let result = Executor::new(
        problem,
        Bfgs::new(),
        NdarrayQuasiNewtonState::new(initial),
    )
    .max_iter(100)
    .run()
    .unwrap();

    assert!(
        result.cost() < 1e-8,
        "expected near-zero cost, got {}",
        result.cost()
    );
    assert!(
        (result.param()[0] - 1.0).abs() < 1e-4,
        "x[0] = {}",
        result.param()[0]
    );
    assert!(
        (result.param()[1] - 1.0).abs() < 1e-4,
        "x[1] = {}",
        result.param()[1]
    );
}

#[test]
fn bfgs_terminates_on_gradient_tolerance() {
    let problem =
        Rosenbrock::<crate::backend_aliases::ndarray::Array1<f64>>::default();
    let initial = array![-1.2, 1.0];

    let result = Executor::new(
        problem,
        Bfgs::new(),
        NdarrayQuasiNewtonState::new(initial),
    )
    .max_iter(200)
    .terminate_on(GradientTolerance(1e-6))
    .run()
    .unwrap();

    assert_eq!(result.reason, TerminationReason::GradientTolerance);
    assert!(result.cost() < 1e-10, "cost = {}", result.cost());
}

#[path = "support/backend_aliases.rs"]
mod backend_aliases;