Struct Ellipsoid 

pub struct Ellipsoid { /* private fields */ }

Axis-aligned ellipsoid: center c with per-axis semi-axes a_i > 0.

A point p is inside iff sum_i ((p_i - c_i) / a_i)^2 <= 1. The anisotropic region type: an ellipsoid is a Gaussian/covariance concept whose extent differs per dimension (a Ball is the special case a_i = r).

Point queries (contains, distance_to_point, log_volume) are exact; the region-to-region predicates use the axis-aligned bounding box [c - a, c + a] as a tractable approximation (exact ellipsoid-ellipsoid containment and intersection volume have no closed form).

Implementations

impl Ellipsoid

pub fn new(center: Vec<f32>, semi_axes: Vec<f32>) -> Self

Create an ellipsoid from a center and per-axis semi-axes (all > 0).

pub fn semi_axes(&self) -> &[f32]

Trait Implementations

impl Clone for Ellipsoid

fn clone(&self) -> Ellipsoid

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Ellipsoid

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Region for Ellipsoid

fn dim(&self) -> usize

Dimensionality of the embedding space.

fn center(&self) -> &[f32]

Center of the region. Used as the proxy point for ANN indexing.

fn distance_to_point(&self, point: &[f32]) -> f32

Minimum L2 distance from point to the region surface. Returns 0.0 if the point is inside the region.

fn contains(&self, point: &[f32]) -> bool

Whether point lies inside (or on the boundary of) this region.

fn bounding_ball(&self) -> (Vec<f32>, f32)

A ball (center, radius) that encloses this region.

fn contains_region(&self, other: &Self) -> bool

Whether this region fully contains other (self ⊇ other).

fn overlaps_region(&self, other: &Self) -> bool

Whether this region intersects other (self ∩ other ≠ ∅).

fn log_volume(&self) -> f32

Natural log of the region’s volume.

fn entailment_prob(&self, other: &Self) -> f32

The probability that self subsumes other, P(self ⊒ other) = vol(self ∩ other) / vol(other).