PyO3/rust-numpy — 1.4k★ on GitHub (Rust). PyO3-based Rust bindings of the NumPy C-API
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
numpy installed in your Python environments (e.g., via pip install numpy)
We recommend numpy >= 1.16.0, though older versions may work
Example
Write a Python module in Rust
Please see the simple example for how to get started.
There are also examples using ndarray-linalg and rayon.
[lib]
name = "rust_ext"
crate-type = ["cdylib"]
[dependencies]
pyo3 = { version = "0.30" }
numpy = "0.30"
#[pyo3::pymodule]
mod rust_ext {
use numpy::ndarray::{ArrayD, ArrayViewD, ArrayViewMutD};
use numpy::{IntoPyArray, PyArrayDyn, PyReadonlyArrayDyn, PyArrayMethods};
use pyo3::{pyfunction, PyResult, Python, Bound};
// example using immutable borrows producing a new array
fn axpy(a: f64, x: ArrayViewD<'_, f64>, y: ArrayViewD<'_, f64>) -> ArrayD<f64> {
a * &x + &y
}
// example using a mutable borrow to modify an array in-place
fn mult(a: f64, mut x: ArrayViewMutD<'_, f64>) {
x *= a;
}
// wrapper of `axpy`
#[pyfunction(name = "axpy")]
fn axpy_py<'py>(
py: Python<'py>,
a: f64,
x: PyReadonlyArrayDyn<'py, f64>,
y: PyReadonlyArrayDyn<'py, f64>,
) -> Bound<'py, PyArrayDyn<f64>> {
let x = x.as_array();
let y = y.as_array();
let z = axpy(a, x, y);
z.into_pyarray(py)
}
// wrapper of `mult`
#[pyfunction(name = "mult")]
fn mult_py<'py>(a: f64, x: &Bound<'py, PyArrayDyn<f64>>) {
let x = unsafe { x.as_array_mut() };
mult(a, x);
}
}
Execute a Python program from Rust and get results
[package]
name = "numpy-test"
[dependencies]
pyo3 = { version = "0.30", features = ["auto-initialize"] }
numpy = "0.30"
use numpy::{PyArray1, PyArrayMethods};
use pyo3::{types::{IntoPyDict, PyAnyMethods}, PyResult, Python};
fn main() -> PyResult<()> {
Python::attach(|py| {
let np = py.import("numpy")?;
let locals = [("np", np)].into_py_dict(py)?;
let pyarray = py
.eval(c"np.absolute(np.array([-1, -2, -3], dtype='int32'))", Some(&locals), None)?
.cast_into::<PyArray1<i32>>()?;
let readonly = pyarray.readonly();
let slice = readonly.as_slice()?;
assert_eq!(slice, &[1, 2, 3]);
Ok(())
})
}
Dependency on ndarray
This crate uses types from ndarray in its public API. ndarray is re-exported
in the crate root so that you do not need to specify it as a direct dependency.
Furthermore, this crate is compatible with multiple versions of ndarray and therefore depends
on a range of semver-incompatible versions, currently >= 0.15, <= 0.17. Cargo does not
automatically choose a single version of ndarray by itself if you depend directly or indirectly
on anything but that exact range. It can therefore be necessary to manually unify these dependencies.
For example, if you specify the following dependencies
numpy = "0.30"
ndarray = "0.15"
this will currently depend on both version 0.15.6 and 0.16.1 of ndarray by default
even though 0.15.6 is within the range >= 0.15, <= 0.17. To fix this, you can run
The most recent commit recorded on PyO3/rust-numpy was 15 days ago, based on the GitHub push timestamp. The repository has 141 forks — one of the better signals of community interest.
How many stars does PyO3/rust-numpy have?
PyO3/rust-numpy has 1.4k GitHub stars — refresh the page for the live number, or check github.com/PyO3/rust-numpy. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is PyO3/rust-numpy?
PyO3/rust-numpy (PyO3/rust-numpy) is a Rust project on GitHub. From the project's own README: PyO3-based Rust bindings of the NumPy C-API
What language is PyO3/rust-numpy written in?
PyO3/rust-numpy is written primarily in Rust. GitHub's language field is based on the largest share of bytes in the default branch.
What topics is PyO3/rust-numpy associated with?
GitHub's repository topics for PyO3/rust-numpy: "ndarray", "numpy", "numpy-capi", "rust-bindings", "rust-ndarray", "rust-numpy". TopGit's editorial category is open-source.
Read full README in the tab above.
Want a second opinion on rust-numpy?
Ask an AI that can read this page — one click and you get its take on rust-numpy.