Struct Cut 

pub struct Cut { /* private fields */ }

A random cut along one dimension at a given coordinate.

Implementations

impl Cut

pub fn new(dim: usize, value: f64) -> Self

Build a cut explicitly. Used by tests and the persistence layer.

pub fn dim(&self) -> usize

Cut dimension.

pub fn value(&self) -> f64

Cut coordinate.

pub fn left_of(&self, point: &[f64]) -> bool

Decide which side of the cut a point lies on.

Returns true when point[dim] <= self.value. The exact-tie behaviour is consistent with the AWS reference (left subtree gets the equal-or-below half).

Panics

Panics when self.dim() >= point.len() — call sites always size-check the point first via crate::domain::ensure_dim.

pub fn random_cut<const D: usize, R: Rng + ?Sized>( bbox: &BoundingBox<D>, rng: &mut R, ) -> RcfResult<Self>

Sample a random cut over bbox with the dimension chosen proportionally to its range and the value uniform in [min_d, max_d].

Errors

Returns RcfError::EmptyBoundingBox when every per-dimension range is zero (no cut is meaningful).

Examples

use rand::SeedableRng;
use rand_chacha::ChaCha8Rng;
use anomstream_core::domain::{BoundingBox, Cut};

let mut rng = ChaCha8Rng::seed_from_u64(42);
let mut bbox = BoundingBox::<2>::from_point(&[0.0, 0.0]).unwrap();
bbox.extend(&[1.0, 4.0]).unwrap(); // dim 1 has 4× the range of dim 0

let cut = Cut::random_cut(&bbox, &mut rng).unwrap();
assert!(cut.dim() < bbox.dim());
let lo = bbox.min()[cut.dim()];
let hi = bbox.max()[cut.dim()];
assert!(cut.value() >= lo && cut.value() <= hi);

Trait Implementations

impl Clone for Cut

fn clone(&self) -> Cut

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cut

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Cut

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Cut

fn eq(&self, other: &Cut) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Cut

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Cut

impl StructuralPartialEq for Cut