Crate cuvs 

Runtime-bound safe Rust integration for the scoped cuVS surface used by Algeon.

Published as an Algeon implementation dependency. Applications use algeon-datafusion; workspace code uses this crate for its component contracts. See the API documentation boundary.

Structs

BruteForceIndex

A brute-force index that retains the dataset borrow and exact runtime binding.

CagraIndex

Query-local CAGRA index with a device-padded dataset. Rows already aligned to 16 bytes use a borrowed padded view; other rows use an owning padded copy. Native search requires a device-padded index (components/cuvs/cuvs/c/src/neighbors/cagra.cpp:1843).

CagraIndexParams

CagraSearchParams

CuvsResources

One serialized cuVS resource generation for an exact cudf runtime binding.

DeviceBuffer

A typed owner for a cudf runtime-allocated device buffer.

DeviceTensor

A lifetime-bound, read-only CUDA tensor descriptor.

DeviceTensorMut

A lifetime-bound, exclusive CUDA tensor descriptor.

Error

IvfFlatIndex

Query-local owned IVF-Flat index. Native build copies the indexed vectors.

IvfFlatIndexParams

IvfFlatSearchParams

IvfPqIndex

Query-local owned IVF-PQ index. Native build copies the indexed vectors.

IvfPqIndexParams

IvfPqSearchParams

KMeansFit

KMeansModel

KMeansParams

KMeansPrediction

KnnSearchOutput

OwnedMatrix

An owned contiguous numeric matrix on one exact cudf execution binding.

PcaFitTransform

PcaOutputBuffers

Caller-owned device outputs for one PCA fit-transform operation.

PcaParams

PreparedTensorLease

An activated prepared-export read plus its lifetime-bound tensor view.

PreparedValidatedTensorLease

A prepared list read with floating finite validation or integer structural validation.

StreamPoolCoverage

Retains query-domain members or backend routes until native work on the RAFT pool is finished. Drop this guard before the resources handle destroys or replaces its pool.

ValidatedDeviceTensor

A read-only tensor with finite-scanned floating values or validated integer shape.

Enums

CagraBuildAlgo

CagraSearchAlgo

DistanceMetric

ErrorKind

ErrorStatus

IvfPqCodebookKind

KMeansInit

KMeansMetric

MatrixLayout

PcaSolver

Traits

CagraElement

DeviceElement

Element type of a cuVS device buffer or tensor.

IvfElement

KMeansElement

PairwiseElement

Functions

fit_transform_owned

Run PCA against an exclusively owned packed matrix.

pairwise_distance_into

Writes the row-major [x.rows(), y.rows()] metric matrix to out. Both inputs must share dimensions, layout, binding, and device.

select_k_into

Selects k sorted values per row, writing [batch, k] row-major values and zero-based positions. Equal-value selection at the k boundary is unspecified.

Type Aliases

Result