hyperspec-py 0.5.0

Fast processing library for hyperspectral imagery, written in Rust

hyperspec

Fast processing library for hyperspectral imagery. Rust core, Python bindings.

Built by Hyperstate — foundation models for Earth intelligence.

Install

Python:

pip install hyperspec-py
# or
uv add hyperspec-py

Rust:

cargo add hyperspec

or

[dependencies]
hyperspec = "0.5"

Quickstart

import numpy as np
from hyperspec import SpectralCube, sam, continuum_removal, pca, mnf_denoise

# Create a cube (bands, height, width) with wavelengths in nanometers
data = np.random.rand(200, 100, 100)
wavelengths = np.linspace(400, 2500, 200)

cube = SpectralCube(data, wavelengths)

# --- Spectral analysis ---

# Compare every pixel to a reference spectrum
reference = cube.spectrum(50, 50)
angles = sam(cube, reference)

# Isolate absorption features
cr_cube = continuum_removal(cube)

# Denoise using Minimum Noise Fraction
denoised_cube = mnf_denoise(cube, n_components=20)

# --- Dimensionality reduction ---

# Reduce spectral dimensionality
pca_result = pca(cube, n_components=10)

SpectralCube

Category	Methods
Dimensions	bands, height, width, shape
Data access	data(), wavelengths(), fwhm(), nodata
Pixel access	spectrum(row, col)
Band access	band(index), band_at(nm), band_nearest(nm)
Wavelength lookup	wavelength(index), wavelength_index(nm), nearest_band_index(nm)
Statistics	mean_spectrum()
Subsetting	sel_bands([i, j]), sel_wavelengths(min, max)

Algorithms

Spectral similarity

Operation	Function
Spectral Angle Mapper	sam(cube, reference)

Spectral preprocessing

Operation	Function
Continuum removal	continuum_removal(cube)

Spectral indices

Operation	Function
Normalized difference	normalized_difference(cube, a, b)
Band ratio	band_ratio(cube, a, b)
NDVI	ndvi(cube, nir, red)

Dimensionality reduction

Operation	Function
PCA	pca(cube, n_components)
MNF	mnf(cube, n_components)
MNF denoise	mnf_denoise(cube, n_components)

Spectral utilities

Operation	Function
Resample	resample(cube, target_wl, method)

Architecture

crates/hyperspec/           # Pure Rust library → crates.io
└── src/
    ├── cube.rs             # SpectralCube type
    ├── error.rs            # HyperspecError
    └── algorithms/
        ├── sam.rs
        ├── continuum.rs
        ├── indices.rs
        ├── pca.rs
        ├── mnf.rs
        └── resample.rs

pyo3-hyperspec/             # PyO3 bindings → PyPI: hyperspec-py
├── src/lib.rs
└── python/hyperspec/
    └── __init__.py

• Rust 2024 edition, using ndarray, rayon, thiserror
• Zero system dependencies — no LAPACK, GDAL, or numba
• Python 3.12+, NumPy bindings via PyO3

Development

uv venv && source .venv/bin/activate
uv pip install maturin pytest
cargo test
maturin develop
pytest

License

Apache-2.0