use crate::core::util::array_util::ArrayUtil;
use crate::core::util::bit_util::BitUtil;
use crate::core::util::error::lucene_error::{LuceneError, Result};
#[derive(Clone, Debug, Default)]
pub struct BKDConfig {
pub num_dims: usize,
pub num_index_dims: usize,
pub bytes_per_dim: usize,
pub max_points_in_leaf_node: usize,
}
impl BKDConfig {
pub const DEFAULT_MAX_POINTS_IN_LEAF_NODE: usize = 512;
pub const MAX_DIMS: usize = 16;
pub const MAX_INDEX_DIMS: usize = 8;
pub fn new(
num_dims: usize,
num_index_dims: usize,
bytes_per_dim: usize,
max_points_in_leaf_node: usize,
) -> Result<Self> {
if !(1..=Self::MAX_DIMS).contains(&num_dims) {
return Err(LuceneError::illegal_argument(format!(
"num_dims must be 1 .. {} (got: {})",
Self::MAX_DIMS,
num_dims
)));
}
if !(1..=Self::MAX_INDEX_DIMS).contains(&num_index_dims) {
return Err(LuceneError::illegal_argument(format!(
"num_index_dims must be 1 .. {} (got: {})",
Self::MAX_INDEX_DIMS,
num_index_dims
)));
}
if bytes_per_dim == 0 {
return Err(LuceneError::illegal_argument(format!(
"bytes_per_dim must be > 0; got {bytes_per_dim}"
)));
}
if num_index_dims > num_dims {
return Err(LuceneError::illegal_argument(format!(
"num_index_dims cannot exceed num_dims (got: {num_dims} vs {num_index_dims})"
)));
}
if max_points_in_leaf_node == 0 {
return Err(LuceneError::illegal_argument(format!(
"max_points_in_leaf_node must be > 0; got {max_points_in_leaf_node}"
)));
}
if max_points_in_leaf_node > ArrayUtil::MAX_ARRAY_LENGTH {
return Err(LuceneError::illegal_argument(format!(
"max_points_in_leaf_node must be <= ArrayUtil::MAX_ARRAY_LENGTH (= {}); got {}",
ArrayUtil::MAX_ARRAY_LENGTH,
max_points_in_leaf_node
)));
}
Ok(Self {
num_dims,
num_index_dims,
bytes_per_dim,
max_points_in_leaf_node,
})
}
pub fn packed_bytes_length(&self) -> usize {
self.num_dims * self.bytes_per_dim
}
pub fn packed_index_bytes_length(&self) -> usize {
self.num_index_dims * self.bytes_per_dim
}
pub fn bytes_per_doc(&self) -> usize {
self.packed_bytes_length() + BitUtil::INT_BYTES
}
}