nii-rs

Rust library for reading/writing NIfTI-1 (nii.gz) files, with SimpleITK/Nibabel-like APIs, native Rust support, and Python bindings for cross-language performance.

If you have used SimpleITK/Nibabel, you will definitely love this and get started right away! 🕶

🎨Features

• 🚀Pure Rust Implementation: I/O speed is comparable to SimpleITK and slightly faster than nibabel.

• ✨ Carefully Designed API: Super easy to use, with no learning curve; enjoy a consistent experience in Rust as in Python.

• 🛠️Rust-Python bindings: you can write heavy operations in Rust and easily call them in Python.

🔨Install

cargo add nii-rs for rust project and pip install niirs for python.

🥒Develop

maturin dev

📘Examples

For details, please refer to the rust examples and python examples。

🦀Rust

use nii;

let im = nii::read_image::<f32>("test.nii.gz");

// get attrs, style same as SimpleITK
let spacing: [f32; 3] = im.get_spacing();
let origin: [f32; 3] = im.get_origin();
let direction: [[f32; 3]; 3] = im.get_direction();

// get affine, style same as nibabel
let affine = im.get_affine();

// get array, style same as SimpleITK, i.e.: [z, y, x]
let arr: &Array3<f32> = im.ndarray();

// write image
nii::write_image(&im, "result.nii.gz")

🐍Python

import niirs

im = niirs.read_image("test.nii.gz")

# get attrs, style same as like SimpleITK
spacing = im.get_spacing()
origin = im.get_origin()
direction = im.get_direction()

# get affine, style same as nibabel
affine = im.get_affine()

# get array, style same as SimpleITK, i.e.: [z, y, z]
arr = im.ndarray()

# write image
niirs.write_image(im, "result.nii.gz")

🔒License

Licensed under either of the following licenses, at your choice:

Apache License, Version 2.0
(See LICENSE-APACHE or visit http://www.apache.org/licenses/LICENSE-2.0)

MIT License
(See LICENSE-MIT or visit http://opensource.org/licenses/MIT)

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project, as defined by the Apache License 2.0, will be dual-licensed under the above licenses without any additional terms or conditions.