rssn 0.2.9

A comprehensive scientific computing library for Rust, aiming for feature parity with NumPy and SymPy.
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! Handle-based FFI API for physics RKM (Runge-Kutta Methods) functions.

use crate::numerical::matrix::Matrix;
use crate::physics::physics_rkm;

/// Simulates the Lorenz attractor scenario and returns the results as a Matrix handle.
#[unsafe(no_mangle)]
pub extern "C" fn rssn_physics_rkm_simulate_lorenz() -> *mut Matrix<f64> {
    let results = physics_rkm::simulate_lorenz_attractor_scenario();

    let rows = results.len();

    if rows == 0 {
        return std::ptr::null_mut();
    }

    let cols = results[0].1.len() + 1; // +1 for time
    let mut flattened = Vec::with_capacity(rows * cols);

    for (t, y) in results {
        flattened.push(t);

        flattened.extend(y);
    }

    Box::into_raw(Box::new(Matrix::new(rows, cols, flattened)))
}

/// Simulates the damped oscillator scenario and returns the results as a Matrix handle.
#[unsafe(no_mangle)]
pub extern "C" fn rssn_physics_rkm_simulate_damped_oscillator() -> *mut Matrix<f64> {
    let results = physics_rkm::simulate_damped_oscillator_scenario();

    let rows = results.len();

    if rows == 0 {
        return std::ptr::null_mut();
    }

    let cols = results[0].1.len() + 1;

    let mut flattened = Vec::with_capacity(rows * cols);

    for (t, y) in results {
        flattened.push(t);

        flattened.extend(y);
    }

    Box::into_raw(Box::new(Matrix::new(rows, cols, flattened)))
}

/// Simulates the Van der Pol oscillator scenario and returns the results as a Matrix handle.
#[unsafe(no_mangle)]
pub extern "C" fn rssn_physics_rkm_simulate_vanderpol() -> *mut Matrix<f64> {
    let results = physics_rkm::simulate_vanderpol_scenario();

    let rows = results.len();

    if rows == 0 {
        return std::ptr::null_mut();
    }

    let cols = results[0].1.len() + 1;

    let mut flattened = Vec::with_capacity(rows * cols);

    for (t, y) in results {
        flattened.push(t);

        flattened.extend(y);
    }

    Box::into_raw(Box::new(Matrix::new(rows, cols, flattened)))
}

/// Simulates the Lotka-Volterra predator-prey scenario and returns the results as a Matrix handle.
#[unsafe(no_mangle)]
pub extern "C" fn rssn_physics_rkm_simulate_lotka_volterra() -> *mut Matrix<f64> {
    let results = physics_rkm::simulate_lotka_volterra_scenario();

    let rows = results.len();

    if rows == 0 {
        return std::ptr::null_mut();
    }

    let cols = results[0].1.len() + 1;

    let mut flattened = Vec::with_capacity(rows * cols);

    for (t, y) in results {
        flattened.push(t);

        flattened.extend(y);
    }

    Box::into_raw(Box::new(Matrix::new(rows, cols, flattened)))
}