Struct Graph 

pub struct Graph { /* private fields */ }

A built proximity graph, before any encoding: over normalized vectors (angular) or the vectors as given (Euclidean). Holds a full-precision copy of the data, so it is a build-time object; the indexes keep only their encodings.

Implementations

impl Graph

Benchmark support: the graph structure (not the vectors) on disk, so that search experiments on one graph need not rebuild it.

pub fn save(&self, path: &Path) -> Result<()>

Writes the header (n, dim, degree, build_ef, alpha, seed, entry, data fingerprint, quantized_search, metric), the adjacency and the upper layers; the vectors are not stored.

pub fn load( data: &[f32], dim: usize, path: &Path, params: &BuildParams, ) -> Result<Self>

Reads a graph written by Graph::save for the same data (prepared here exactly as Graph::build does) and the same params. Any mismatch in the vector count, dimension, degree, build_ef, alpha, seed, quantized search, metric or the data fingerprint is an error, so a stale cache never stands in for a build; delete the file to rebuild.

impl Graph

pub fn metric(&self) -> Metric

The metric the graph was built for.

pub fn structure_hash(&self) -> u64

Stable 64-bit hash of the structure (adjacency, upper layers, entry): equal values mean a bit-identical graph, across builds, binaries and cache round trips.

pub fn build( data: &[f32], dim: usize, params: &BuildParams, ) -> Result<Self, HmsError>

Build over data (row-major, dim floats per vector). Angular rows are normalized; zero rows stay zero. Uses the rayon pool; the result depends only on the data and params (code_bits is not used).

pub fn build_owned( data: Vec<f32>, dim: usize, params: &BuildParams, ) -> Result<Self, HmsError>

Graph::build over an owned matrix, prepared in place: the caller’s copy is the one the graph keeps, so the vectors are resident once during construction instead of twice (the build’s own copy next to the caller’s).