Files
wifi-densepose/scripts/patches/hnsw_rs/examples/utils/annhdf5.rs
ruv d803bfe2b1 Squashed 'vendor/ruvector/' content from commit b64c2172
git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900
2026-02-28 14:39:40 -05:00

234 lines
8.2 KiB
Rust

//! This file provides hdf5 utilities to load ann-benchmarks hdf5 data files
//! As the libray does not depend on hdf5 nor on ndarray, it is nearly the same for both
//! ann benchmarks.
use ndarray::Array2;
use ::hdf5::*;
use log::debug;
// datasets
// . distances (nbojects, dim) f32 matrix for tests objects
// . neighbors (nbobjects, nbnearest) int32 matrix giving the num of nearest neighbors in train data
// . test (nbobjects, dim) f32 matrix test data
// . train (nbobjects, dim) f32 matrix train data
/// a structure to load hdf5 data file benchmarks from https://github.com/erikbern/ann-benchmarks
pub struct AnnBenchmarkData {
pub fname: String,
/// distances from each test object to its nearest neighbours.
pub test_distances: Array2<f32>,
// for each test data , id of its nearest neighbours
#[allow(unused)]
pub test_neighbours: Array2<i32>,
/// list of vectors for which we will search ann.
pub test_data: Vec<Vec<f32>>,
/// list of data vectors and id
pub train_data: Vec<(Vec<f32>, usize)>,
/// searched results. first neighbours for each test data.
#[allow(unused)]
pub searched_neighbours: Vec<Vec<i32>>,
/// distances of neighbours obtained of each test
#[allow(unused)]
pub searched_distances: Vec<Vec<f32>>,
}
impl AnnBenchmarkData {
pub fn new(fname: String) -> Result<AnnBenchmarkData> {
let res = hdf5::File::open(fname.clone());
if res.is_err() {
println!("you must download file {:?}", fname);
panic!(
"download benchmark file some where and modify examples source file accordingly"
);
}
let file = res.ok().unwrap();
//
// get test distances
//
let res_distances = file.dataset("distances");
if res_distances.is_err() {
// let reader = hdf5::Reader::<f32>::new(&test_distance);
panic!("error getting distances dataset");
}
let distances = res_distances.unwrap();
let shape = distances.shape();
assert_eq!(shape.len(), 2);
let dataf32 = distances.dtype().unwrap().is::<f32>();
if !dataf32 {
// error
panic!("error getting type distances dataset");
}
// read really data
let res = distances.read_2d::<f32>();
if res.is_err() {
// some error
panic!("error reading distances dataset");
}
let test_distances = res.unwrap();
// a check for row order
debug!(
"First 2 distances for first test {:?} {:?} ",
test_distances.get((0, 0)).unwrap(),
test_distances.get((0, 1)).unwrap()
);
//
// read neighbours
//
let res_neighbours = file.dataset("neighbors");
if res_neighbours.is_err() {
// let reader = hdf5::Reader::<f32>::new(&test_distance);
panic!("error getting neighbours");
}
let neighbours = res_neighbours.unwrap();
let shape = neighbours.shape();
assert_eq!(shape.len(), 2);
println!("neighbours shape : {:?}", shape);
let datai32 = neighbours.dtype().unwrap().is::<i32>();
if !datai32 {
// error
panic!("error getting type neighbours");
}
// read really data
let res = neighbours.read_2d::<i32>();
if res.is_err() {
// some error
panic!("error reading neighbours dataset");
}
let test_neighbours = res.unwrap();
debug!(
"First 2 neighbours for first test {:?} {:?} ",
test_neighbours.get((0, 0)).unwrap(),
test_neighbours.get((0, 1)).unwrap()
);
println!("\n 10 first neighbours for first vector : ");
for i in 0..10 {
print!(" {:?} ", test_neighbours.get((0, i)).unwrap());
}
println!("\n 10 first neighbours for second vector : ");
for i in 0..10 {
print!(" {:?} ", test_neighbours.get((1, i)).unwrap());
}
//
// read test data
// ===============
//
let res_testdata = file.dataset("test");
if res_testdata.is_err() {
panic!("error getting test de notataset");
}
let test_data = res_testdata.unwrap();
let shape = test_data.shape(); // nota shape returns a slice, dim returns a t-uple
assert_eq!(shape.len(), 2);
let dataf32 = test_data.dtype().unwrap().is::<f32>();
if !dataf32 {
panic!("error getting type de notistances dataset");
}
// read really datae not
let res = test_data.read_2d::<f32>();
if res.is_err() {
// some error
panic!("error reading distances dataset");
}
let test_data_2d = res.unwrap();
let mut test_data = Vec::<Vec<f32>>::with_capacity(shape[1]);
let (nbrow, nbcolumn) = test_data_2d.dim();
println!(" test data, nb element {:?}, dim : {:?}", nbrow, nbcolumn);
for i in 0..nbrow {
let mut vec = Vec::with_capacity(nbcolumn);
for j in 0..nbcolumn {
vec.push(*test_data_2d.get((i, j)).unwrap());
}
test_data.push(vec);
}
//
// loaf train data
//
let res_traindata = file.dataset("train");
if res_traindata.is_err() {
panic!("error getting distances dataset");
}
let train_data = res_traindata.unwrap();
let train_shape = train_data.shape();
assert_eq!(shape.len(), 2);
if test_data_2d.dim().1 != train_shape[1] {
println!("test and train have not the same dimension");
panic!();
}
println!(
"\n train data shape : {:?}, nbvector {:?} ",
train_shape, train_shape[0]
);
let dataf32 = train_data.dtype().unwrap().is::<f32>();
if !dataf32 {
// error
panic!("error getting type distances dataset");
}
// read really data
let res = train_data.read_2d::<f32>();
if res.is_err() {
// some error
panic!("error reading distances dataset");
}
let train_data_2d = res.unwrap();
let mut train_data = Vec::<(Vec<f32>, usize)>::with_capacity(shape[1]);
let (nbrow, nbcolumn) = train_data_2d.dim();
for i in 0..nbrow {
let mut vec = Vec::with_capacity(nbcolumn);
for j in 0..nbcolumn {
vec.push(*train_data_2d.get((i, j)).unwrap());
}
train_data.push((vec, i));
}
//
// now allocate array's for result
//
println!(
" allocating vector for search neighbours answer : {:?}",
test_data.len()
);
let searched_neighbours = Vec::<Vec<i32>>::with_capacity(test_data.len());
let searched_distances = Vec::<Vec<f32>>::with_capacity(test_data.len());
// searched_distances
Ok(AnnBenchmarkData {
fname: fname.clone(),
test_distances,
test_neighbours,
test_data,
train_data,
searched_neighbours,
searched_distances,
})
} // end new
/// do l2 normalisation of test and train vector to use DistDot metrinc instead DistCosine to spare cpu
#[allow(unused)]
pub fn do_l2_normalization(&mut self) {
for i in 0..self.test_data.len() {
anndists::dist::l2_normalize(&mut self.test_data[i]);
}
for i in 0..self.train_data.len() {
anndists::dist::l2_normalize(&mut self.train_data[i].0);
}
} // end of do_l2_normalization
} // end of impl block
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_load_hdf5() {
env_logger::Builder::from_default_env().init();
//
let fname = String::from("/home.2/Data/ANN/glove-25-angular.hdf5");
println!("\n\n test_load_hdf5 {:?}", fname);
// now recall that data are stored in row order.
let _anndata = AnnBenchmarkData::new(fname).unwrap();
//
} // end of test_load_hdf5
} // end of module test