rhai-sci

Scientific computing for the Rhai scripting language, inspired by MATLAB, Octave, and R. Includes statistics, linear algebra, interpolation, integration, and regression.

Quickstart

Add the crate to your Cargo.toml:

rhai-sci = "0.4.0"

Evaluate a Rhai expression:

use rhai::INT;
use rhai_sci::eval;

let result = eval::<INT>("argmin([43, 42, -500])").unwrap();
assert_eq!(result, 2);

For a persistent engine, register SciPackage as shown in the Rust host example.

Numerical workflows

Use row, col, and mat to construct vectors and matrices from ordinary Rhai arrays. Statistics accept lists, rows, or columns; sequence results are flat lists. Use mtimes for matrix multiplication and dot for a scalar vector inner product.

regress(X, y) fits an intercept automatically and returns it separately from the predictor coefficients. See the workflow guide for shape conventions, predictions, and input validation.

Run the bundled CSV example to fit a model and summarize its residuals:

cargo run --example regression_workflow

More examples: matrix inversion, projectile motion, and XOR backpropagation.

Features

Feature	Default	Enables
`io`	On	CSV loading with `read_matrix`
`nalgebra`	On	Matrix operations and regression
`rand`	On	Random values and matrices
`metadata`	Off	Function metadata and Rhai documentation tests

Disable default features and select only what you need for smaller builds; CSV support brings in Polars.

Reference

API documentation · Changelog · Development checks

License