Back to docs

Chutoro

Work-in-progress FISHDBC engine written in Rust that merges a rayon-driven CPU path, Rust-CUDA kernels, and a C-ABI plugin system. Built for safe, iterative clustering across heterogeneous hardware—sushi-grade data science.

Audience and scope

Adding the crate

Running the clustering pipeline

Implementing data sources

Results and assignments

Error handling

Distance helpers

Feature flags and execution strategies

Source

View markdown

Source material

Contents

Audience and scope
- Audience and scope
Adding the crate
- Adding the crate
Running the clustering pipeline
- Running the clustering pipeline
Implementing data sources
- Implementing data sources
Results and assignments
- Results and assignments
Error handling
- Error handling
Distance helpers
- Distance helpers
Feature flags and execution strategies
- Feature flags and execution strategies

Error handling

Updated Oct 20, 2025

Builder validation returns ChutoroError::InvalidMinClusterSize when the provided minimum cluster size is zero. Chutoro::run surfaces runtime failures via ChutoroError variants:

EmptySource: returned when a DataSource yields zero items.
InsufficientItems: triggered if len() falls below min_cluster_size.
BackendUnavailable: emitted when the requested ExecutionStrategy is not compiled into the binary.
DataSource: raised when distance or distance_batch fails. Use ChutoroError::data_source_code() to recover the underlying DataSourceErrorCode and respond programmatically.

DataSourceError distinguishes out-of-bounds indices, dimension mismatches, and invalid buffers. Propagate these errors verbatim, so callers receive stable error codes via DataSourceError::code().