use crate::float::kdtree::Axis;
use crate::float_leaf_slice::leaf_slice::{LeafSliceFloat, LeafSliceFloatChunk};
use crate::generate_immutable_within;
use crate::immutable::float::kdtree::ImmutableKdTree;
use crate::nearest_neighbour::NearestNeighbour;
use crate::traits::Content;
use crate::traits::DistanceMetric;
use az::Cast;
macro_rules! generate_immutable_float_within {
($doctest_build_tree:tt) => {
generate_immutable_within!((
"Finds all elements within `dist` of `query`, using the specified
distance metric function.
Results are returned sorted nearest-first
# Examples
```rust
use kiddo::ImmutableKdTree;
use kiddo::SquaredEuclidean;
",
$doctest_build_tree,
"
let within = tree.within::<SquaredEuclidean>(&[1.0, 2.0, 5.0], 10f64);
assert_eq!(within.len(), 2);
```"
));
};
}
impl<A: Axis, T: Content, const K: usize, const B: usize> ImmutableKdTree<A, T, K, B>
where
A: Axis + LeafSliceFloat<T> + LeafSliceFloatChunk<T, K>,
T: Content,
usize: Cast<T>,
{
generate_immutable_float_within!(
"let content: Vec<[f64; 3]> = vec!(
[1.0, 2.0, 5.0],
[2.0, 3.0, 6.0]
);
let tree: ImmutableKdTree<f64, 3> = ImmutableKdTree::new_from_slice(&content);"
);
}
#[cfg(feature = "rkyv")]
use crate::immutable::float::kdtree::AlignedArchivedImmutableKdTree;
#[cfg(feature = "rkyv")]
impl<
A: Axis + rkyv::Archive<Archived = A>,
T: Content + rkyv::Archive<Archived = T>,
const K: usize,
const B: usize,
> AlignedArchivedImmutableKdTree<'_, A, T, K, B>
{
generate_immutable_float_within!(
"use std::fs::File;
use memmap::MmapOptions;
use kiddo::immutable::float::kdtree::AlignedArchivedImmutableKdTree;
let mmap = unsafe { MmapOptions::new().map(&File::open(\"./examples/immutable-doctest-tree.rkyv\").unwrap()).unwrap() };
let tree: AlignedArchivedImmutableKdTree<f64, u32, 3, 256> = AlignedArchivedImmutableKdTree::from_bytes(&mmap);"
);
}
#[cfg(test)]
mod tests {
use crate::float::distance::Manhattan;
use crate::float::kdtree::Axis;
use crate::immutable::float::kdtree::ImmutableKdTree;
use crate::traits::DistanceMetric;
use rand::Rng;
use std::cmp::Ordering;
type AX = f32;
#[test]
fn can_query_items_within_radius() {
let content_to_add: [[AX; 4]; 16] = [
[0.9f32, 0.0f32, 0.9f32, 0.0f32],
[0.4f32, 0.5f32, 0.4f32, 0.51f32],
[0.12f32, 0.3f32, 0.12f32, 0.3f32],
[0.7f32, 0.2f32, 0.7f32, 0.22f32],
[0.13f32, 0.4f32, 0.13f32, 0.4f32],
[0.6f32, 0.3f32, 0.6f32, 0.33f32],
[0.2f32, 0.7f32, 0.2f32, 0.7f32],
[0.14f32, 0.5f32, 0.14f32, 0.5f32],
[0.3f32, 0.6f32, 0.3f32, 0.6f32],
[0.10f32, 0.1f32, 0.10f32, 0.1f32],
[0.16f32, 0.7f32, 0.16f32, 0.7f32],
[0.1f32, 0.8f32, 0.1f32, 0.8f32],
[0.15f32, 0.6f32, 0.15f32, 0.6f32],
[0.5f32, 0.4f32, 0.5f32, 0.44f32],
[0.8f32, 0.1f32, 0.8f32, 0.15f32],
[0.11f32, 0.2f32, 0.11f32, 0.2f32],
];
let tree: ImmutableKdTree<AX, u32, 4, 4> = ImmutableKdTree::new_from_slice(&content_to_add);
assert_eq!(tree.size(), 16);
let query_point = [0.78f32, 0.55f32, 0.78f32, 0.55f32];
let radius = 0.2;
let expected = linear_search(&content_to_add, &query_point, radius);
let mut result: Vec<_> = tree
.within::<Manhattan>(&query_point, radius)
.into_iter()
.map(|n| (n.distance, n.item))
.collect();
stabilize_sort(&mut result);
assert_eq!(result, expected);
let mut rng = rand::thread_rng();
for _i in 0..1000 {
let query_point = [
rng.gen_range(0f32..1f32),
rng.gen_range(0f32..1f32),
rng.gen_range(0f32..1f32),
rng.gen_range(0f32..1f32),
];
let radius: f32 = 2.0;
let expected = linear_search(&content_to_add, &query_point, radius);
let mut result: Vec<_> = tree
.within::<Manhattan>(&query_point, radius)
.into_iter()
.map(|n| (n.distance, n.item))
.collect();
stabilize_sort(&mut result);
assert_eq!(result, expected);
}
}
#[test]
fn can_query_items_within_radius_large_scale() {
const TREE_SIZE: usize = 100_000;
const NUM_QUERIES: usize = 100;
const RADIUS: f32 = 0.2;
let content_to_add: Vec<[f32; 4]> =
(0..TREE_SIZE).map(|_| rand::random::<[f32; 4]>()).collect();
let tree: ImmutableKdTree<AX, u32, 4, 32> =
ImmutableKdTree::new_from_slice(&content_to_add);
assert_eq!(tree.size(), TREE_SIZE);
let query_points: Vec<[f32; 4]> = (0..NUM_QUERIES)
.map(|_| rand::random::<[f32; 4]>())
.collect();
for query_point in query_points {
let expected = linear_search(&content_to_add, &query_point, RADIUS);
let mut result: Vec<_> = tree
.within::<Manhattan>(&query_point, RADIUS)
.into_iter()
.map(|n| (n.distance, n.item))
.collect();
stabilize_sort(&mut result);
assert_eq!(result, expected);
}
}
fn linear_search<A: Axis, const K: usize>(
content: &[[A; K]],
query_point: &[A; K],
radius: A,
) -> Vec<(A, u32)> {
let mut matching_items = vec![];
for (idx, p) in content.iter().enumerate() {
let dist = Manhattan::dist(query_point, p);
if dist < radius {
matching_items.push((dist, idx as u32));
}
}
stabilize_sort(&mut matching_items);
matching_items
}
fn stabilize_sort<A: Axis>(matching_items: &mut [(A, u32)]) {
matching_items.sort_unstable_by(|a, b| {
let dist_cmp = a.0.partial_cmp(&b.0).unwrap();
if dist_cmp == Ordering::Equal {
a.1.cmp(&b.1)
} else {
dist_cmp
}
});
}
}